Google Cloud NetApp Volumes では、 Google Cloud プロキシを介してオペレーションを送信することで、ONTAP モードのストレージ プール内の ONTAP リソースを管理できます。
セキュリティとロギング上の理由から、NetApp Volumes では ONTAP 管理 LIF への直接接続が許可されていないため、SystemManager や SSH などのツールを直接使用することはできません。代わりに、次の方法を使用して ONTAP オペレーションを ONTAP モードのストレージ プールに送信できます。
Terraform などの管理ツールは、Google API プロキシを使用して ONTAP リソースを管理します。
始める前に
ONTAP モードのストレージ プールの ONTAP オペレーションを管理するには、Google Cloud CLI のバージョンが 559.0.0 以降である必要があります。バージョンが古い場合、Google Cloud CLI はコマンドまたはフラグが定義されていないというエラーを返します。
Google Cloud CLI ONTAP CLI プロキシを使用する
ONTAP CLI への直接 SSH アクセスは利用できませんが、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: ストレージ プールのロケーション。
ONTAP REST API 呼び出しに Google プロキシ API を使用する
NetApp Volumes は、Flex Unified ONTAP モードのストレージ プールごとに Google API エンドポイントを提供します。これにより、基盤となる ONTAP クラスタに ONTAP REST API 呼び出しを送信できます。これにより、API を使用して ONTAP 機能を制御できます。
ONTAP プロキシの呼び出しには、次の URL 形式を使用する必要があります。
https://netapp.googleapis.com/v1/projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME/ontap/ONTAP_REST_URL
この URL は次の要素で構成されています。
ベースライン 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 のすべてのボリュームを一覧表示する完全な URL を示しています。
https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes
すべての Google API 呼び出しと同様に、この呼び出しは認証される必要があります。次の CLI の例では、API トークンを取得し、curl を使用して URL を呼び出して、プール内のすべてのボリュームを一覧表示します。
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 のすべてのスナップショットを一覧表示する完全な URL を示しています。
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 を使用して URL を呼び出して、ボリュームのすべてのスナップショットを一覧表示します。
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 を使用して、URN /projects/myproject/locations/us-central1-a/storagePools/mypool で識別される既存の Flex Unified ONTAP モード ストレージ プールに myvolume という名前のボリュームを作成する方法について説明します。
ボリュームを作成するには、ONTAP REST API のオンライン ドキュメントをご覧ください。ドキュメントで、[ストレージ] セクションに移動し、[ストレージ ボリュームを管理する] を開きます。このセクションでは、いくつかの例を示します。
ボリュームを作成する手順は次のとおりです。
ONTAP REST API エンドポイントを特定します。
NetApp Volumes の基本的な例を使用する場合、必要な ONTAP API エンドポイントは
/api/storage/volumesです。このエンドポイントにより、URLhttps://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フィールドを使用してボリューム名を割り当てます。ボリューム作成ペイロードには、ONTAP モードプールの作成時に NetApp Volumes によって割り当てられたアグリゲートとストレージ仮想マシン(SVM)の名前が必要です。ONTAP モードでは、各ストレージ プールに 1 つの SVM と 1 つのストレージ集約があります。この情報は、すべての SVM について ONTAP にクエリを実行することで取得できます。SVM と集約名を取得するには:
フィールドの選択に
ontap_fieldsを使用する: NetApp Volumes ONTAP モードのプールでは、標準の ONTAPfields=パラメータではなく、クエリ パラメータontap_fields=を使用してリクエストされたフィールドを指定します。省略可:
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: {}エンベロープで囲む必要があります。次の例では、サイズが 2 GB の
myvolumeという名前のボリュームを作成します。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 プロキシを使用します。
set -privilege advanced; volume modify -vserver SVM_NAME -volume VOLUME_NAME -tiering-policy all -is-cloud-write-enabled true
ONTAP ジョブをモニタリングします。
リソースを作成または更新する
POSTオペレーションやPATCHオペレーションなど、ほとんどの ONTAP API 呼び出しは同期的に実行されません。代わりに、ボリューム作成の例に示すように、これらの呼び出しは 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 モードを管理する
ONTAP モードのリソースは、CLI プロキシを使用して管理できます。CLI プロキシはインタラクティブな使用には効果的ですが、自動化が複雑になる可能性があります。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 プロキシを介して ONTAP モードのプールにアクセスする場合、完全な権限がないため、すべての ONTAP コマンドを実行することはできません。この制限により、システムの整合性が保護され、サービスによって管理されている基盤となる物理リソースの変更が防止されます。
一部の API では、システムが API リクエストとレスポンスのペイロードをフィルタします。たとえば、NetApp Volumes は論理容量に対して課金されるため、システムは物理容量を構成するパラメータをブロックします。許可されていないパラメータを送信すると、API からエラーが返されます。
課金方法の詳細については、課金: 論理容量と物理容量をご覧ください。
サポートされている ONTAP コマンド
ONTAP モードを管理するには、Google Cloud CLI ONTAP CLI プロキシを使用して ONTAP コマンドを送信します。NetApp Volumes は、SVM、LUN、ボリューム、ONTAP 機能を管理するほとんどのコマンドをサポートしています。一部のコマンドは、システムの整合性を保護するため、または NetApp Volumes などのマネージド サービスに関連しない物理リソースを管理するためにブロックされます。
コマンドは ONTAP 管理者権限レベルで実行します。権限レベルを高度に切り替えるには、コマンドの先頭に set advanced; または set -privilege advanced; を追加します。一部のコマンドでは、診断(diag)権限レベルもサポートされています。このレベルにアクセスするには、コマンドの先頭に set diag; を追加します。これらの権限の変更は永続的ではありません。
プロキシはインタラクティブ シェルではないため、一度に 1 つのコマンドしか実行できません。この制限により、プロキシは追加情報をリクエストするインタラクティブなコマンドをサポートしません。たとえば、Active Directory 管理者の認証情報を必要とする CIFS または SMB vserver(SVM)を作成することはできません。CLI プロキシはインタラクティブなコマンドであるため、クラスタ ピアリングもサポートしていません。これらの操作を行うには、ONTAP REST API を使用する必要があります。
次の表に、ONTAP CLI プロキシでサポートされているコマンド ファミリー、コマンド、制限事項を示します。
| コマンド ファミリー | 目的 | サポートされているコマンド | メモ |
|---|---|---|---|
| クラスタ | SnapMirror、FlexCache のピアクラスタ、クラスタに関する選択した情報を表示する | cluster peer - フルアクセスcluster show、identity show、date show、ha show、statistics show、time-service ntp server show - 読み取り専用 |
CLI プロキシは、インタラクティブな cluster peer create コマンドをサポートしていません。代わりに REST API を使用してください。show などの他の cluster peer コマンドを使用できます。 |
| デバッグ | パケット トレース(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 モードのシステムに接続することはできません。 |
| ネットワーク | ネットワーク ポート、インターフェース、ルート、IPspace の構成を表示し、外部 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 - フルアクセス |
AutoSupport ファイルは NetApp サポートで利用できます。 |
| ボリューム | ボリュームを作成して管理する | volume create、volume delete、volume modify、volume clone、volume expand(FlexGroup)、volume flexcache、volume flexgroup、qtree、quota、snaplock、snapshot - フルアクセス |
論理スペースのレポート / 適用やスペース保証(なし)などの一部のボリューム機能は、システムによって自動的に管理されます。プールレベルで設定された自動階層化を使用するようにボリューム階層化ポリシーを設定します。 |
| Vserver | ボリュームへのファイル(SMB、NFS)、ブロック(iSCSI、NVMe)、オブジェクト(S3)アクセス用の SVM(vserver)を管理します。 NFS のエクスポート ポリシーなど、ボリュームに使用されるポリシーを管理します。 監査ロギング(ファイル アクセス)、整合性グループ、ポリシー、名前サービス(DNS、LDAP)、ウイルス対策(vscan)などの SVM 機能を有効にします。 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 モードのプールを削除するには、まずプール内のすべてのボリュームを削除する必要があります。