APIを使用してデータセンター内のストレージオブジェクトを管理する
変更を提案
PDF
REST APIは、 `datacenter`カテゴリを使用すると、クラスター、ノード、アグリゲート、ストレージ VM、ボリューム、LUN、ファイル共有、名前空間など、データセンター内のストレージ オブジェクトを管理できます。オブジェクトの設定を照会するためのAPIや、オブジェクトの追加、削除、変更処理を実行できるAPIがあります。
これらのAPIの大半はクラスタをまたいだ集計値を提供するGET呼び出しで、フィルタ、ソート、およびページ付けをサポートします。これらのAPIを実行すると、データベースからデータが返されます。したがって、新たに作成されたオブジェクトは、次の取得サイクルで検出されるまで応答に表示されません。
特定のオブジェクトの詳細を照会するには、そのオブジェクトの一意のIDを入力する必要があります。たとえば、ストレージオブジェクトのメトリックと分析情報については、以下を参照してください。"パフォーマンス指標の表示" 。
curl -X GET "https://<hostname>/api/datacenter/cluster/clusters/4c6bf721-2e3f-11e9-a3e2-00a0985badbb" -H "accept: application/json" -H "Authorization: Basic <Base64EncodedCredentials>"
|
cURLコマンド、例、要求、およびAPIへの応答は、Swagger APIインターフェイスで参照できます。Swaggerにも記載されているとおり、結果を特定のパラメータでフィルタおよび順序付けすることができます。これらの API を使用すると、クラスター、ボリューム、ストレージ VM などの特定のストレージ オブジェクトの結果をフィルターできます。 |
データセンター内のストレージ オブジェクト用のAPI
| HTTP動詞 | パス | 説明 |
|---|---|---|
|
|
このメソッドを使用して、データセンター全体のONTAPクラスタの詳細を表示できます。クラスタのIPv4アドレスまたはIPv6アドレスなどの情報、健全性、パフォーマンス容量、ハイアベイラビリティ（HA）ペアなどのノードに関する情報、クラスタがオールSANアレイであるかどうかを示す情報が返されます。 |
|
|
データセンター内のクラスタにインストールされているライセンスの詳細が返されます。必要な基準に基づいて結果をフィルタリングできます。ライセンス キー、クラスタ キー、有効期限、ライセンス範囲などの情報が返されます。ライセンス キーを入力すると特定のライセンスの詳細を取得できます。 |
|
|
このメソッドを使用して、データセンター内のノードの詳細を表示できます。ノードのクラスタ、健全性、パフォーマンス容量、およびハイアベイラビリティ（HA）ペアに関する情報を確認できます。 |
|
|
このメソッドを使用して、データセンター内のCIFS共有の詳細を表示できます。クラスタ、SVM、およびボリュームの詳細のほか、アクセス制御リスト（ACL）に関する情報も返されます。 |
|
|
このメソッドを使用して、サポートされているNFSサービスのエクスポート ポリシーの詳細を表示できます。 このメソッドを使用して、クラスタまたはStorage VMのエクスポート ポリシーを照会し、NFSファイル共有のプロビジョニングに使用できます。ワークロードへのエクスポート ポリシーの割り当てと再利用の詳細については、「 |
|
|
このメソッドを使用して、データセンター全体のすべてのアグリゲートまたは特定のアグリゲートを表示し、ワークロードのプロビジョニングや監視を行うことができます。クラスタとノードの詳細、使用済みパフォーマンス容量、使用可能スペースと使用済みスペース、ストレージ効率などの情報が返されます。 |
|
|
このメソッドを使用して、データセンター全体のすべてのLUNを表示できます。クラスタとSVMの詳細、QoSポリシー、igroupなど、LUNに関する情報を確認できます。 |
|
|
このメソッドを使用して、データセンター内のストレージ オブジェクトに適用可能なすべてのQoSポリシーの詳細を表示できます。クラスタとSVMの詳細、固定またはアダプティブのポリシーの詳細、そのポリシーに該当するオブジェクトの数などの情報が返されます。 |
|
|
このメソッドを使用して、すべてのFlexVolまたはFlexGroupボリュームについて、データセンター全体のqtreeの詳細を表示できます。クラスタとSVMの詳細、FlexVol、エクスポート ポリシーなどの情報が返されます。 |
|
|
このメソッドを使用して、データセンター内のすべてのボリュームを表示できます。SVMとクラスタの詳細、QoSポリシーとエクスポート ポリシー、ボリュームのタイプ（読み書き可能、データ保護、負荷共有）など、ボリュームに関する情報が返されます。 FlexVolおよびFlexCloneボリュームについては、それぞれのアグリゲートに関する情報を確認できます。FlexGroupボリュームについては、コンスティチュエント アグリゲートのリストが返されます。 |
|
|
特定のLUNターゲットへのアクセスを許可されたイニシエータ グループ（igroup）を割り当てることができます。既存のigroupがある場合は、そのigroupを割り当てることができます。igroupを作成して、LUNに割り当てることもできます。 これらのメソッドを使用して、igroupの照会、作成、削除、および変更を実行できます。 注意事項：
|
|
|
これらのメソッドを使用して、Storage Virtual Machine（Storage VM）を表示、作成、削除、および変更できます。
|
|
|
注意事項： |
環境でSLOベースのワークロード プロビジョニングを有効にしている場合、Storage VMを作成する際に、そのStorage VMにLUNおよびファイル共有をプロビジョニングするために必要なすべてのプロトコル（たとえば、CIFSまたはSMB、NFS、FCP、iSCSI）をサポートするようにしてください。Storage VMが必要なサービスをサポートしていないと、プロビジョニング ワークフローが失敗することがあります。対応するワークロード タイプのサービスも有効にすることを推奨します。
環境でSLOベースのワークロード プロビジョニングを有効にしている場合、ストレージ ワークロードがプロビジョニングされているStorage VMは削除できません。CIFSまたはSMBサーバが設定されているStorage VMを削除すると、そのCIFSまたはSMBサーバとローカルのActive Directory設定も削除されます。ただし、CIFSまたはSMBサーバ名はActive Directory設定に残っているため、Active Directoryサーバから手動で削除する必要があります。
データセンター内のネットワーク要素用のAPI
datacenterカテゴリの次のAPIは、環境内のポートとネットワーク インターフェイス、具体的にはFCポート、FCインターフェイス、イーサネット ポート、およびIPインターフェイスに関する情報を取得します。
| HTTP動詞 | パス | 説明 |
|---|---|---|
|
|
データセンター環境内のすべてのイーサネット ポートに関する情報を取得します。入力パラメータとしてポート キーを使用すると、そのポートの情報を確認できます。クラスタの詳細、ブロードキャスト ドメイン、ポートの状態、速度、タイプなどの詳細、ポートが有効になっているかどうかなどの情報が返されます。 |
|
|
このメソッドを使用して、データセンター環境内のFCインターフェイスの詳細を表示できます。入力パラメータとしてインターフェイス キーを使用すると、そのインターフェイスの情報を確認できます。クラスタの詳細、ホーム ノードの詳細、ホーム ポートの詳細などの情報が返されます。 |
|
|
データセンター環境内のノードで使用されているすべてのFCポートに関する情報を取得します。入力パラメータとしてポート キーを使用すると、そのポートの情報を確認できます。クラスタの詳細、ポートの説明、サポートされているプロトコル、ポートの状態などの情報が返されます。 |
|
|
このメソッドを使用して、データセンター環境内のIPインターフェイスの詳細を表示できます。入力パラメータとしてインターフェイス キーを使用すると、そのインターフェイスの情報を確認できます。クラスタの詳細、IPspaceの詳細、ホーム ノードの詳細、フェイルオーバーが有効になっているかどうかなどの情報が返されます。 |