エフサステクノロジーズ株式会社

本ページの製品は2024年4月1日より、エフサステクノロジーズ株式会社に統合となり、順次、切り替えを実施してまいります。一部、富士通表記が混在することがありますので、ご了承ください。

Active IQ Unified Manager 9.14

to English version

APIを使用したデータセンター内のストレージ オブジェクトの管理

datacenterカテゴリーのREST APIを使用して、クラスタ、ノード、アグリゲート、Storage 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では、クラスタ、ボリューム、Storage VMなどの特定のストレージ オブジェクトについての結果をフィルターできます。

データセンター内のストレージ オブジェクト用のAPI

HTTP動詞 パス 説明

GET

/datacenter/cluster/clusters

/datacenter/cluster/clusters/{key}

このメソッドを使用して、データセンター全体のONTAPクラスタの詳細を表示できます。クラスタのIPv4アドレスまたはIPv6アドレスなどの情報、健全性、パフォーマンス容量、ハイアベイラビリティ(HA)ペアなどのノードに関する情報、クラスタがオールSANアレイであるかを示す情報が返されます。

GET

/datacenter/cluster/licensing/licenses /datacenter/cluster/licensing/licenses/{key}

データセンター内のクラスタにインストールされているライセンスの詳細が返されます。必要な基準に基づいて結果をフィルタリングできます。ライセンス キー、クラスタ キー、有効期限、ライセンス範囲などの情報が返されます。ライセンス キーを入力すると特定のライセンスの詳細を取得できます。

GET

/datacenter/cluster/nodes

/datacenter/cluster/nodes/{key}

このメソッドを使用して、データセンター内のノードの詳細を表示できます。ノードのクラスタ、健全性、パフォーマンス容量、およびハイアベイラビリティ(HA)ペアに関する情報を確認できます。

GET

/datacenter/protocols/cifs/shares

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

このメソッドを使用して、データセンター内のCIFS共有の詳細を表示できます。クラスタ、SVM、およびボリュームの詳細のほか、アクセス制御リスト(ACL)に関する情報も返されます。

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を表示できます。クラスタとSVMの詳細、QoSポリシー、igroupなど、LUNに関する情報を確認できます。

GET

/datacenter/storage/qos/policies

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

このメソッドを使用して、データセンター内のストレージ オブジェクトに適用可能なすべてのQoSポリシーの詳細を表示できます。クラスタとSVMの詳細、固定またはアダプティブのポリシーの詳細、そのポリシーに該当するオブジェクトの数などの情報が返されます。

GET

/datacenter/storage/qtrees

/datacenter/storage/qtrees/{key}

このメソッドを使用して、すべてのFlexVolまたはFlexGroupボリュームについて、データセンター全体のqtreeの詳細を表示できます。クラスタとSVMの詳細、FlexVol、エクスポート ポリシーなどの情報が返されます。

GET

/datacenter/storage/volumes

/datacenter/storage/volumes/{key}

このメソッドを使用して、データセンター内のすべてのボリュームを表示できます。SVMとクラスタの詳細、QoSポリシーとエクスポート ポリシー、ボリュームのタイプ(読み書き可能、データ保護、負荷共有)など、ボリュームに関する情報が返されます。

FlexVolおよびFlexCloneボリュームについては、それぞれのアグリゲートに関する情報を確認できます。FlexGroupボリュームについては、構成 アグリゲートのリストが返されます。

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を作成して、必要なプロパティを割り当てることができます。

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

  • PATCH: 特定のStorage VMを変更するには、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動詞 パス 説明

GET

/datacenter/network/ethernet/ports

/datacenter/network/ethernet/ports/{key}

データセンター環境内のすべてのイーサネット ポートに関する情報を取得します。入力パラメーターとしてポート キーを使用すると、そのポートの情報を確認できます。クラスタの詳細、ブロードキャスト ドメイン、ポートの状態、速度、タイプなどの詳細、ポートが有効になっているかなどの情報が返されます。

GET

/datacenter/network/fc/interfaces

/datacenter/network/fc/interfaces/{key}

このメソッドを使用して、データセンター環境内のFCインターフェイスの詳細を表示できます。入力パラメーターとしてインターフェイス キーを使用すると、そのインターフェイスの情報を確認できます。クラスタの詳細、ホーム ノードの詳細、ホーム ポートの詳細などの情報が返されます。

GET

/datacenter/network/fc/ports

/datacenter/network/fc/ports/{key}

データセンター環境内のノードで使用されているすべてのFCポートに関する情報を取得します。入力パラメーターとしてポート キーを使用すると、そのポートの情報を確認できます。クラスタの詳細、ポートの説明、サポートされているプロトコル、ポートの状態などの情報が返されます。

GET

/datacenter/network/ip/interfaces

/datacenter/network/ip/interfaces/{key}

このメソッドを使用して、データセンター環境内のIPインターフェイスの詳細を表示できます。入力パラメーターとしてインターフェイス キーを使用すると、そのインターフェイスの情報を確認できます。クラスタの詳細、IPspaceの詳細、ホーム ノードの詳細、フェイルオーバーが有効になっているかなどの情報が返されます。

Top of Page