Skip to main content
Active IQ Unified Manager 9.7
9.7
本製品の最新リリースがご利用いただけます。
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

データセンターを管理するためのAPI

共同作成者
PDF

のREST API datacenter カテゴリによって、クラスタ、ノード、アグリゲート、ボリューム、LUNに関する情報が提供されます。データセンター内のファイル共有、名前空間、およびその他の要素。これらの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 を使用して、クラスタ、ボリューム、 Storage VM などの特定のストレージオブジェクトについての結果をフィルタリングできます。
HTTP 動詞 パス 説明

GET

/datacenter/cluster/clusters

/datacenter/cluster/clusters/{key}

このメソッドを使用して、データセンター全体の ONTAP クラスタの詳細を表示できます。

GET

/datacenter/cluster/nodes

/datacenter/cluster/nodes/{key}

このメソッドを使用して、データセンター内のノードの詳細を表示できます。

GET

/datacenter/protocols/cifs/shares

/datacenter/protocols/cifs/shares/{key}

このメソッドを使用して、データセンター内の CIFS 共有の詳細を表示できます。

GET

/datacenter/protocols/nfs/export-policies

/datacenter/protocols/nfs/export-policies/{key}

このメソッドを使用して、サポートされている NFS サービスのエクスポートポリシーの詳細を表示できます。

このメソッドを使用して、クラスタまたは Storage VM のエクスポートポリシーを照会し、 NFS ファイル共有のプロビジョニングに使用できます。ワークロードでのエクスポートポリシーの割り当てと再利用の詳細については、「 CIFS および NFS ファイル共有のプロビジョニング」を参照してください。

GET

/datacenter/storage/aggregates

/datacenter/storage/aggregates/{key}

このメソッドを使用して、データセンター全体のすべてのアグリゲートを表示し、ワークロードのプロビジョニングや監視を行うことができます。

GET

/datacenter/storage/luns

/datacenter/storage/luns/{key}

このメソッドを使用して、データセンター全体のすべての LUN を表示できます。

GET

/datacenter/storage/qos/policies

/datacenter/storage/qos/policies/{key}

このメソッドを使用して、データセンター内のすべてのQoSポリシーの詳細を表示し、必要に応じてポリシーを適用できます。

GET

/datacenter/storage/qtrees

/datacenter/storage/qtrees/{key}

このメソッドを使用して、データセンター全体のqtreeの詳細を表示できます。

GET

/datacenter/storage/volumes

/datacenter/storage/volumes/{key}

このメソッドを使用して、データセンター内のすべてのボリュームを表示できます。

GET

POST

DELETE

PATCH

/datacenter/protocols/san/igroups

/datacenter/protocols/san/igroups/{key}

特定の LUN ターゲットへのアクセスを許可されたイニシエータグループ（ igroup ）を割り当てることができます。既存の igroup がある場合は、その igroup を割り当てることができます。igroup を作成して、 LUN に割り当てることもできます。

これらのメソッドを使用して、 igroup の照会、作成、削除、および変更を実行できます。

注意事項：

  • POST：igroupの作成中に、アクセスを割り当てるStorage VMを指定できます。

  • DELETE：特定のigroupを削除するには、入力パラメータとしてigroupキーを指定する必要があります。すでに LUN に割り当てられている igroup は削除できません。

  • PATCH：特定のigroupを変更するには、入力パラメータとしてigroupキーを指定する必要があります。また、更新するプロパティとその値を入力する必要があります。

GET

POST

DELETE

PATCH

/datacenter/svm/svms

/datacenter/svm/svms/{key}

これらのメソッドを使用して、 Storage Virtual Machine （ Storage VM ）を表示、作成、削除、および変更できます。

注意事項：

  • POST：作成するStorage VMオブジェクトを入力パラメータとして指定する必要があります。カスタムの Storage VM を作成して、必要なプロパティを割り当てることができます。

    メモ 環境でSLOベースのワークロードプロビジョニングを有効にしている場合、Storage VMを作成する際には、SMB / CIFS、NFS、FCPなど、LUNとファイル共有のプロビジョニングに必要なすべてのプロトコルがこの環境でサポートされていることを確認してください。およびiSCSIなどです。Storage VM が必要なサービスをサポートしていないと、プロビジョニングワークフローが失敗することがあります。対応するワークロードタイプのサービスも有効にすることを推奨します。

  • DELETE：特定のStorage VMを削除するには、Storage VMキーを指定する必要があります。

    メモ 環境で SLO ベースのワークロードプロビジョニングを有効にしている場合、ストレージワークロードがプロビジョニングされている Storage VM は削除できません。CIFS / SMBサーバが設定されているStorage VMを削除すると、そのCIFS / SMBサーバとローカルのActive Directory設定も削除されます。ただし、CIFS / SMBサーバ名はActive Directory設定に残っているため、Active Directoryサーバから手動で削除する必要があります。

  • PATCH：特定のStorage VMを変更するには、Storage VMキーを指定する必要があります。また、更新するプロパティとその値を入力する必要があります。