在 ONTAP 模式中管理 ONTAP

本頁說明如何在 ONTAP 模式下管理 ONTAP。

基於安全性和記錄考量，NetApp Volumes 不允許直接連線至 ONTAP 管理 LIF。因此，您無法使用 SystemManager 或 SSH 等工具直接管理 ONTAP 系統。您可以使用 Google 代理 API，將 ONTAP 作業提交至 ONTAP 模式的儲存空間集區，以呼叫 ONTAP REST API。

管理工具 (例如 Terraform) 會使用 Google API Proxy 管理 ONTAP 資源。

使用 Google Proxy API 呼叫 ONTAP REST API

NetApp Volumes 會為每個 FlexUnified ONTAP 模式儲存集區提供 Google API 端點，讓您將 ONTAP REST API 呼叫傳送至基礎 ONTAP 叢集。您可以使用 API 控制 ONTAP 功能。

呼叫 ONTAP Proxy 時，必須使用下列網址格式：

  https://netapp.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME/ontap/ONTAP_REST_URL

這個網址包含下列元素：

  • 基準網址：https://netapp.googleapis.com/v1beta1/projects

  • 儲存集區的 Google URN：/PROJECT/locations/LOCATION/storagePools/POOL_NAME

    請替換下列資訊：

    • PROJECT：您的project ID或號碼。

    • LOCATION：區域集區的區域名稱，或區域集區的區域。

    • POOL_NAME：集區名稱。

  • ONTAP REST API 路徑：/ontap/ONTAP_REST_URL。 詳情請參閱 ONTAP REST API 參考資料。

列出儲存空間集區的所有磁碟區

以下範例顯示完整網址，可列出專案 myproject 中 us-central1-a 內儲存空間集區 mypool 的所有磁碟區。

https://netapp.googleapis.com/v1beta1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes

與所有 Google API 呼叫一樣，這項呼叫必須經過驗證。下列 CLI 範例會擷取 API 權杖，然後使用 curl 呼叫網址，列出集區中的所有磁碟區：

   TOKEN=$(gcloud auth print-access-token)
   curl --location
   'https://netapp.googleapis.com/v1beta1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes' 

   --header "Authorization: Bearer $TOKEN" 

   --header "Content-Type: application/json"

建立磁碟區

本節說明如何使用 ONTAP REST API，在現有的 Flex Unified ONTAP 模式儲存集區 (URN 為 /projects/myproject/locations/us-central1-a/storagePools/mypool) 中，建立名為 myvolume 的磁碟區。

如要建立磁碟區，請參閱 ONTAP REST API 線上說明文件。在說明文件中，前往「Storage」(儲存空間) 專區，然後展開「Manage storage volumes」(管理儲存空間磁碟區)。 本節提供幾個範例。

請按照下列操作說明建立磁碟區。

  1. 判斷 ONTAP REST API 端點。

    在 NetApp Volumes 中使用基本範例時，所需的 ONTAP API 端點為 /api/storage/volumes。這個端點會建立網址：https://netapp.googleapis.com/v1beta1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes。

  2. 建構要求酬載。

    使用 ONTAP 說明文件中的範例酬載，配合您的特定環境。例如：

    {
  "name": "vol1",
  "aggregates": [
    {
      "name": "aggr1"
    }
  ],
  "svm": {
    "name": "vs1"
  }
}

    建立磁碟區時，請使用 name 欄位指派磁碟區名稱。建立磁碟區的酬載需要 NetApp Volumes 在建立 ONTAP 模式集區時指派的聚合體和儲存空間虛擬機器 (SVM) 名稱。在 ONTAP 模式中，每個儲存空間集區都有一個 SVM 和一個儲存空間匯總。如要擷取這項資訊，請查詢 ONTAP 中的所有 SVM。

    如要擷取 SVM 和匯總名稱，請執行下列步驟：

    1. 使用 ontap_fields 選取欄位：在 NetApp Volumes ONTAP 模式集區中，請使用查詢參數 ontap_fields=，而非標準 ONTAP fields= 參數，指定要求的欄位。

    2. 選用：使用 jq 擷取欄位：以下範例使用 jq 開放原始碼工具，從 JSON 回應中擷取 name (SVM 名稱) 和 aggregates，這有助於在 Shell 指令碼中處理。

      TOKEN=$(gcloud auth print-access-token)
curl --location
'https://netapp.googleapis.com/v1beta1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/svm/svms?ontap_fields=name,aggregates' \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/json" | jq '.rawResponse.records[] | {name: .name, aggregates: .aggregates[].name}'

      回應範例：

      {
 "name": "gcnv-7cf6ee41c1a94f0-svm-01",
 "aggregates": "aggr1"
}

  3. 執行磁碟區建立 API 呼叫。

    使用匯總名稱 (aggr1) 和 SVM 名稱 (gcnv-7cf6ee41c1a94f0-svm-01)，建立最終的磁碟區建立酬載，並提交 API 呼叫。請注意，ONTAP API 酬載必須封裝在 body: {} 信封中，才能用於 NetApp Volumes。

    以下範例會建立名為 myvolume 的磁碟區，大小為 2 GB：

    curl --location
'https://netapp.googleapis.com/v1beta1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes' \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/json" \
--data '{
  "body": {
    "name": "myvolume",
    "aggregates": [
      {
        "name": "aggr1"
      }
    ],
    "svm": {
      "name": "gcnv-7cf6ee41c1a94f0-svm-01"
    },
    "size": "2GB"
  }
}'

    建立磁碟區時支援多個選用參數，例如 size。舉例來說，酬載指定的大小為 2 GB。資源的說明文件頁面會列出所有可用參數，包括必要和選用參數。此外，還提供酬載和回應內容的詳細範例。

  4. 監控 ONTAP 工作。

    大多數 ONTAP API 呼叫 (例如建立或更新資源的 POST 或 PATCH 作業) 不會同步執行。這些呼叫會傳回 ONTAP 工作資源，如磁碟區建立範例所示。

    工作回應範例：

    {
  "body": {
    "job": {
      "_links": {
        "self": {
          "href": "curl --location
'https://netapp.googleapis.com/v1beta1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/cluster/jobs/15be1c46-fd2c-11f0-b3c2-7f15697be61c' \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/json""
        }
      },
      "uuid": "15be1c46-fd2c-11f0-b3c2-7f15697be61c"
    }
  }
}

    如要檢查工作狀態，請使用傳回的 uuid 查詢工作資源：

    curl --location
'https://netapp.googleapis.com/v1beta1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/cluster/jobs/15be1c46-fd2c-11f0-b3c2-7f15697be61c' \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/json"

    回應範例：

    {
  "rawResponse": {
    "uuid": "15be1c46-fd2c-11f0-b3c2-7f15697be61c",
    "description": "POST
/api/storage/volumes/15be0ad9-fd2c-11f0-b3c2-7f15697be61c",
    "state": "success",
    "message": "success",
    "code": 0,
    "start_time": "2026-01-29T16:03:43+00:00",
    "end_time": "2026-01-29T16:03:44+00:00",
    "svm": {
      "name": "gcnv-7cf6ee41c1a94f0-svm-01",
      "uuid": "8a29c15d-fb31-11f0-ab03-03e1bb49206d"
   }
  }
}

    如果 state 為 success，系統就會建立磁碟區。

    這個工作流程範例會引導您在 ONTAP REST API 說明文件中查詢 ONTAP 動作。此外，本教學課程也會說明如何建立必要酬載格式，並使用 Google API 將其提交至儲存集區。最後，本範例會示範如何監控 ONTAP 工作，直到資源建立完成為止。採用這種方法，您就能控管儲存集區的大部分 ONTAP 設定。

允許的 ONTAP 動作

透過 API 或 CLI 代理程式存取集區時，您只有有限的權限，無法執行所有 ONTAP 指令。確保系統完整性。對於部分 API，系統會篩選 API 要求和回應酬載。舉例來說，由於 NetApp Volumes 會根據邏輯容量計費，系統會封鎖設定實體容量的參數。如果您傳送不允許的參數，API 會傳回錯誤。

刪除 ONTAP 模式集區

如要刪除 ONTAP 模式集區，請先刪除集區中的所有磁碟區。