Google Cloud NetApp Volumes 可讓您透過 Google Cloud Proxy 提交作業,管理 ONTAP 模式儲存空間集區中的 ONTAP 資源。
基於安全性和記錄考量,NetApp Volumes 不允許直接連線至 ONTAP 管理 LIF,因此您無法直接使用 SystemManager 或 SSH 等工具。不過,您可以使用下列方法,將 ONTAP 作業提交至 ONTAP 模式儲存空間集區:
Terraform 等管理工具會使用 Google API Proxy 管理 ONTAP 資源。
事前準備
Google Cloud CLI 必須為 559.0.0 以上版本,才能管理 ONTAP 模式儲存空間集區的 ONTAP 作業。如果版本較舊,Google Cloud CLI 會傳回錯誤,指出指令或旗標未定義。
使用 Google Cloud CLI ONTAP CLI Proxy
雖然無法透過 SSH 直接存取 ONTAP CLI,但您可以使用 Google Cloud CLI,將 ONTAP CLI 指令傳送至儲存空間集區。
gcloud
執行 ONTAP 指令:
gcloud netapp storage-pools execute POOL-NAME ONTAP-COMMAND --project PROJECT \ --location=LOCATION
替換下列資訊:
POOL-NAME:Flex Unified ONTAP 模式儲存空間集區的名稱。ONTAP-COMMAND:要在叢集或儲存空間集區執行的 ONTAP 指令。PROJECT:您的專案 ID。LOCATION:儲存空間集區的位置。
使用 Google Proxy API 呼叫 ONTAP REST API
NetApp Volumes 為每個 Flex Unified ONTAP 模式儲存空間集區提供 Google API 端點,可讓您將 ONTAP REST API 呼叫傳送至基礎 ONTAP 叢集。這樣一來,您就能使用 API 控制 ONTAP 功能。
呼叫 ONTAP Proxy 時,必須使用下列網址格式:
https://netapp.googleapis.com/v1/projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME/ontap/ONTAP_REST_URL
這個網址包含下列元素:
基準網址:
https://netapp.googleapis.com/v1儲存空間集區的 Google URN:/projects/
PROJECT/locations/LOCATION/storagePools/POOL_NAME替換下列資訊:
PROJECT:您的專案 ID 或編號。LOCATION:可用區集區的可用區名稱,或區域集區的區域。POOL_NAME:集區名稱。
ONTAP REST API 路徑:/ontap/
ONTAP_REST_URL。詳情請參閱 ONTAP REST API 參考資料。
列出儲存空間集區的所有磁碟區
下列範例顯示完整網址,用於列出專案 myproject 中 us-central1-a 內儲存空間集區 mypool 的所有磁碟區。
https://netapp.googleapis.com/v1/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/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json"
列出磁碟區的所有快照
以下範例顯示完整網址,用於列出專案 myproject 中 us-central1-a 內儲存空間集區 mypool 和磁碟區 volume-uuid 的所有快照。
https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes/volume-uuid/snapshots
與所有 Google API 呼叫一樣,這項呼叫必須經過驗證。下列 CLI 範例會擷取 API 權杖,然後使用 curl 呼叫網址,列出磁碟區的所有快照:
TOKEN=$(gcloud auth print-access-token) curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes/volume-uuid/snapshots' \ --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」(管理儲存空間磁碟區)。本節提供幾個範例。
請按照下列操作說明建立磁碟區。
判斷 ONTAP REST API 端點。
使用 NetApp Volumes 中的基本範例,所需的 ONTAP API 端點為
/api/storage/volumes。這個端點會建立網址:https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes。建構要求酬載。
請根據 ONTAP 說明文件中的範例酬載,調整為符合您特定環境的設定。例如:
{ "name": "vol1", "aggregates": [ { "name": "aggr1" } ], "svm": { "name": "vs1" } }建立磁碟區時,請使用
name欄位指派磁碟區名稱。磁碟區建立酬載需要 NetApp Volumes 在建立 ONTAP 模式集區時指派的匯總和儲存空間虛擬機器 (SVM) 名稱。在 ONTAP 模式中,每個儲存空間集區都有一個 SVM 和一個儲存空間匯總。如要擷取這項資訊,請查詢 ONTAP 的所有 SVM。如要擷取 SVM 和匯總名稱,請按照下列步驟操作:
使用
ontap_fields選取欄位:在 NetApp Volumes ONTAP 模式集區中,使用查詢參數ontap_fields=,而非標準 ONTAPfields=參數,指定要求的欄位。選用:使用
jq擷取欄位:下列範例使用 jq 開放原始碼工具,從 JSON 回應中擷取name(SVM 名稱) 和aggregates,這在殼層指令碼中處理時非常實用。TOKEN=$(gcloud auth print-access-token) curl --location 'https://netapp.googleapis.com/v1/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" }
執行磁碟區建立 API 呼叫。
使用匯總名稱 (
aggr1) 和 SVM 名稱 (gcnv-7cf6ee41c1a94f0-svm-01),建立最終磁碟區建立酬載,並提交 API 呼叫。請注意,ONTAP API 酬載必須包含在 NetApp Volumes 的body: {}封包中。以下範例會建立名為
myvolume的磁碟區,大小為 2 GB:curl --location 'https://netapp.googleapis.com/v1/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。資源說明文件頁面會列出所有可用參數,包括必要和選用參數。並提供酬載和回應主體的詳細範例。如要在 ONTAP REST API 中設定自動調整級別,請在要求主體中加入
tieringJSON 物件:如要將磁碟區的分層政策設為
all,請使用"tiering": {"policy": "all"}。選用:如要設定冷卻天數,請使用
"tiering": {"policy": "auto", "min_cooling_days": 31}。您可以在
min_cooling_days欄位中指定 2 到 183 天的冷卻門檻。預設冷資料判定門檻值為 31 天。
如要略過熱門層,直接將資料寫入讀寫 (RW) 磁碟區的雲端層,請使用具備進階權限的 Google Cloud CLI ONTAP CLI Proxy:
set -privilege advanced; volume modify -vserver SVM_NAME -volume VOLUME_NAME -tiering-policy all -is-cloud-write-enabled true
監控 ONTAP 工作。
大多數 ONTAP API 呼叫 (例如建立或更新資源的
POST或PATCH作業) 都不會同步執行。而是會傳回 ONTAP 工作資源,如建立磁碟區的範例所示。工作回應範例:
{ "body": { "job": { "_links": { "self": { "href": "curl --location 'https://netapp.googleapis.com/v1/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/v1/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 設定。
使用 Terraform 管理 ONTAP 模式
您可以使用 CLI Proxy 管理 ONTAP 模式資源。CLI Proxy 適用於互動式用途,但自動化作業可能較為複雜。Terraform 可一致管理雲端資源的生命週期,您可以使用 Terraform 管理 NetApp Volumes 和 ONTAP 資源。
請參閱功能管理總覽表格,判斷要使用哪家供應商。
Google 供應商會透過 NetApp Volumes API 管理資源。
NetApp-ONTAP 供應商會透過 ONTAP REST API 管理資源。
舉例來說,您可以使用 Google 供應商 7.27.0 以上版本,建立 ONTAP 模式儲存空間集區。接著,如要在該 ONTAP 模式集區中建立磁碟區,請使用 NetApp-ONTAP 供應商 2.6.0 以上版本。
如要進一步瞭解設定和範例,請參閱 NetApp-ONTAP 供應商說明文件。
允許的 ONTAP 動作
透過 API 或 CLI Proxy 存取 ONTAP 模式集區時,您不具備完整權限,無法執行所有 ONTAP 指令。這項限制有助於保護系統完整性,並防止變更服務管理的基礎實體資源。
對於某些 API,系統會篩選 API 要求和回應酬載。舉例來說,NetApp Volumes 會依邏輯容量計費,因此系統會封鎖設定實體容量的參數。如果傳送不允許的參數,API 會傳回錯誤。
如要進一步瞭解計費方式,請參閱「計費:邏輯與實體容量」。
支援的 ONTAP 指令
您可以使用 Google Cloud CLI ONTAP CLI Proxy 提交 ONTAP 指令,管理 ONTAP 模式。NetApp Volumes 支援大部分用於管理 SVM、LUN、磁碟區和 ONTAP 功能的指令。部分指令會遭到封鎖,以保護系統完整性,或因為這些指令會管理與 NetApp Volumes 等代管服務無關的實體資源。
您必須以 ONTAP 管理員權限層級執行指令。如要將權限等級切換為進階,請在指令開頭加上 set advanced; 或 set -privilege advanced;。部分指令也支援診斷 (diag) 權限等級,只要在指令開頭加上 set diag; 即可存取。這些權限變更並非永久。
由於 Proxy 不是互動式殼層,因此一次只能執行一個指令。這項限制表示 Proxy 不支援要求額外資訊的互動式指令。舉例來說,您無法建立需要 Active Directory 管理員憑證的 CIFS 或 SMB vserver (SVM)。CLI Proxy 也不支援叢集對等互連,因為這是互動式指令。如要執行這些作業,請使用 ONTAP REST API。
下表列出 ONTAP CLI Proxy 支援的指令系列、指令和限制:
| 指令系列 | 目的 | 支援的指令 | 附註 |
|---|---|---|---|
| 叢集 | SnapMirror、FlexCache 的對等互連叢集,以及顯示叢集的特定資訊 | cluster peer - 完整存取權cluster show、identity show、date show、ha show、statistics show 和 time-service ntp server show - 唯讀 |
CLI Proxy 不支援互動式 cluster peer create 指令,請改用 REST API。您可以使用其他 cluster peer 指令,例如 show。 |
| 偵錯 | 支援封包追蹤 (tcpdump)、LUN 和鎖定疑難排解 | debug network tcpdump、debug san lun和debug lock persistence - 完整存取權 |
所有允許的偵錯指令都需要 diag 權限等級。以下是常見的偵錯指令。 |
| 事件 | 建立篩選器,將感興趣的 ONTAP 事件傳送至 SMTP 或 syslog 目的地 | event catalog show 和 event log show - 唯讀event config、event filter 和 event notification - 完整存取權 |
可將事件記錄到自訂目的地。您可以使用 event log show,依時間或類型顯示記錄事件。 |
| 工作 | 在節點和叢集層級管理 ONTAP 工作 | job show、job schedule、job private、job stop和job resume - 完整存取權 |
|
| LUN | 建立及管理 LUN 和啟動器群組,以及匯入外部 LUN | lun create、lun bind和igroup - 完整存取權 |
雖然允許 lun import,但無法將外部磁碟連線至 ONTAP 模式系統。 |
| 網路 | 顯示網路通訊埠、介面、路由和 IP 空間設定,對外部 IP 位址執行 ping 和 traceroute,並依通訊協定顯示用戶端連線 | network ping、network traceroute、network port interface、network ipspace 和 network connections - 唯讀 |
|
| QoS | 建立及管理 QoS 政策群組 (QPG),並指派給磁碟區。集區的總處理量和 IOPS 會設定整體上限。 | qos policy-group create、qos policy-group modify 和 qos policy-group delete:完整存取權qos policy-group show:唯讀volume create -qos-policy-group 和 volume modify -qos-policy-group:將磁碟區附加至 QPG、移至其他 QPG,或使用 none 卸載 |
|
| 安全性 | 顯示稽核設定、啟用反勒索軟體功能,以及建立和安裝憑證 | security audit - 唯讀security anti-ransomware volume和security certificate - 完整存取權 |
建立磁碟區時,可以設定反勒索軟體參數。您只能建立伺服器和用戶端憑證。 |
| SnapLock | 管理 SnapLock 時鐘和記錄,以及控制 SnapLock 事件型保留和訴訟保留作業 | snaplock compliance-clock和snaplock log - 完整存取權 |
使用 volume snaplock modify 指令,為個別磁碟區設定 SnapLock。SnapLock 指令 snaplock event-retention 和 snaplock legal-hold 只能透過 ONTAP REST API 管理。 |
| SnapMirror | 建立及管理 SnapMirror 關係 | snapmirror create、snapmirror initialize、snapmirror break 和 snapmirror resync - 完整存取權 |
|
| 統計資料 | 顯示定期系統統計資料,或建立特定統計資料的樣本 | statistics samples、statistics start、statistics stop和statistics show-periodic - 完整存取權statistics volume、statistics lun、statistics aggregate、statistics qtree和statistics SVM - 唯讀 |
許多指令需要進階模式才能指定參數。 |
| 系統 | 通常不支援系統指令,但可叫用 AutoSupport 和效能封存傳輸 | system node autosupport invoke和system node autosupport invoke-performance-archive - 完整存取權 |
NetApp 支援團隊可取得 AutoSupport 檔案。 |
| 音量 | 建立及管理磁碟區 | volume create、volume delete、volume modify、volume clone、volume expand (FlexGroup)、volume flexcache、volume flexgroup、qtree、quota、snaplock和 snapshot - 完整存取權 |
系統會自動管理部分磁碟區功能,例如邏輯空間回報/強制執行和空間保證 (無)。將磁碟區級別政策設為使用集區層級設定的自動調整級別功能。 |
| Vserver | 管理 SVM (vserver),以便透過檔案 (SMB、NFS)、區塊 (iSCSI、NVMe) 和物件 (S3) 存取磁碟區。 管理用於磁碟區的政策,例如 NFS 的匯出政策。 啟用 SVM 功能,例如稽核記錄 (檔案存取權)、一致性群組、政策、名稱服務 (DNS、LDAP) 和防毒軟體 (vscan)。 為 SnapMirror 和 FlexCache 對等互連 SVM。 |
vserver cifs create (加入 Active Directory 網域)、vserver nfs create、vserver iscsi create 和 vserver nvme create - 完整存取權vserver object-store-server - 完整存取權 |
使用 vserver modify 指令,為所有磁碟區設定預設語言、安全性樣式、快照和配額政策。目前不支援 vserver create。密碼變更指令無法以互動方式執行,必須使用指令參數或 REST API 指定。 |
| 舊版指令 | timezone和version - 完整存取權 |
刪除 ONTAP 模式集區
如要刪除 ONTAP 模式集區,請先刪除集區中的所有磁碟區。