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

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

`datacenter`カテゴリの REST API は、データセンター内のクラスター、ノード、アグリゲート、ボリューム、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サービスのエクスポート ポリシーの詳細を表示できます。

クラスターまたはストレージVMのエクスポートポリシーを照会し、エクスポートポリシーキーをNFSファイル共有のプロビジョニングに再利用できます。ワークロードに対するエクスポートポリシーの割り当てと再利用の詳細については、「Provisioning CIFS and NFS file shares」を参照してください。

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 を作成する際に、アクセス権を割り当てるストレージ VM を指定できます。

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

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

GET

POST

DELETE

PATCH

/datacenter/svm/svms

/datacenter/svm/svms/{key}

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

注意事項:

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

    メモ 環境でSLOベースのワークロード プロビジョニングを有効にしている場合、Storage VMを作成する際に、そのStorage VMにLUNおよびファイル共有をプロビジョニングするために必要なすべてのプロトコル(たとえば、SMB、CIFS、NFS、FCP、iSCSI)をサポートするようにしてください。Storage VMが必要なサービスをサポートしていないと、プロビジョニング ワークフローが失敗することがあります。対応するワークロード タイプのサービスも有効にすることを推奨します。
  • DELETE:特定のストレージVMを削除するには、ストレージVMキーを指定する必要があります。

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