日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

クラウドオーケストレーション API

寄稿者 netapp-manini netapp-reenu ciarm dmp-netapp このページの PDF をダウンロード

クラウドオーケストレーション API NetApp Service Engine では、 Cloud Volume サービスを NetApp Service Engine に接続し、 NetApp Service Engine 内から連携させることができます。Cloud Volume サービスでは、 Azure NetApp Files ( ANF )と Google Cloud Platform ( GCP )がサポートされます。

Cloud Volume サービスへのサブスクリプションは、 NetApp Service Engine の外部で管理されます。関連するクレデンシャルが NetApp Service Engine に提供され、クラウドサービスに接続できるようになります。

ここでは、の API について説明します。

  • Cloud Volumes Service インスタンスの管理

  • Azure NetApp Files アカウントの管理

  • Azure NetApp Files 容量プールの管理

  • Azure NetApp Files Volume の管理

  • Google Cloud Volume の管理

Cloud Volumes Service インスタンス

次の表に示すメソッドを使用して、 Cloud Volumes Service インスタンスを取得および作成します。

HTTP メソッド パス 説明

「 GET 」

「 /v2.1/cvs/instances 」というように設定します

すべての Cloud Volumes Service インスタンスを取得します。

「 POST 」

「 /v2.1/cvs/instances 」というように設定します

新しい Cloud Volumes Service インスタンスを作成します。

「 GET 」

/v2.1/cvs/instances/{id}

ID を使用して Cloud Volumes Service インスタンスを取得します。

「 GET 」

「 /v2.1/anf/accounts 」を参照してください

Azure NetApp Files アカウントを取得します。

「 POST 」

「 /v2.1/anf/accounts 」を参照してください

Azure NetApp Files アカウントを作成します

「 GET 」

/v2.1/anf/accounts/{id}

ID を使用して Azure NetApp Files アカウントを取得します。

「 GET 」

「 /v2.1/anf/pools 」を指定します

すべての容量プールを取得します。

「 POST 」

「 /v2.1/anf/pools 」

容量プールを作成

「 GET 」

/v2.1/anf/pools/{id}

ID を使用して Azure NetApp Files 容量プールを取得します。

Cloud Volumes Service インスタンスの属性

次の表に、 Cloud Volumes Service インスタンスの属性を示します。

属性 を入力します 説明

「 id` 」

文字列

Cloud Volumes Service インスタンスの一意の識別子。

「 name 」

文字列

Cloud Volumes Service インスタンスの名前。

'cc_working _env'

文字列

Cloud Manager 内の作業環境名。

'cc_client_id

文字列

Auth0 サービス ID 。

'cc_refresh_ctoken

文字列

Auth0 更新トークン。

cc_account_id

文字列

Cloud Central アカウント ID 。

cc_account_name

文字列

Cloud Central アカウント名。

'cc_credentials_id

文字列

Cloud Centra 作業環境の ID 。

「 azure_client_id 」です

文字列

アプリケーション(クライアント) ID 。Cloud Manager が Azure Active Directory での認証に使用する Active Directory サービスプリンシパルの ID 。

「 azure_client_secret 」というプロンプトが表示されます

文字列

サービスプリンシパルアプリケーションのクライアントシークレットの値。

「 azure_ttenant_id 」です

文字列

Azure Active Directory の ID 。これはテナント ID とも呼ばれます。

「 azure_subscription_id 」です

文字列

Azure Active Directory サブスクリプション ID 。

'ubtenant_id

文字列

サブテナント ID 。

「 tags 」

キーと値のペア。

Cloud Volumes Service インスタンスを取得します

HTTP メソッド パス 説明 パスパラメータ

「 GET 」

「 /v2.1/cvs/instances 」というように設定します

Cloud Volumes Service インスタンスを取得します。

tenant_id :( オプション ) 指定したテナントに属する Cloud Volumes Service インスタンスを返しますも参照してください "共通ページ付け" パラメータ

要求本文に必要なパラメータ : 「なし」

ID を使用して Cloud Volumes Service インスタンスを取得します

次の表に示すメソッドを使用して、 Cloud Volumes Service インスタンスを識別子で取得します。

HTTP メソッド パス 説明 パラメータ

「 GET 」

/v2.1/cvs/instances/{id}

ID を使用して Cloud Volumes Service インスタンスを取得します。

id(string) : Cloud Volumes Service インスタンスの一意の識別子。

要求本文の必須属性 : 「なし」

Cloud Volumes Service インスタンスを作成します

次の表に示すメソッドを使用して、新しい Cloud Volumes Service インスタンスを作成します。

HTTP メソッド パス 説明 パラメータ

「 POST 」

「 /v2.1/cvs/instances 」というように設定します

Cloud Volumes Service インスタンスを作成します。

なし

必要な要求本文の属性: name 、 cc_working _env 、 cc_client_id 、 cc_refresh_ctoken 、 cc_account_id 、 cc_account_name 、 azure_client_id 、 azure_client_secret 、 azure-tenant_id 、 azure_subscription_id 、 Subtenant _id

  • 要求本文の例: *

{
  "name": "instance1",
  "cc_working_env": "my-working-env",
  "cc_client_id": "Mu0V1ywgYteI6w1MbD15fKfVIUrNXGWC",
  "cc_refresh_token": "y1tMw3lNzE8JL9jtiE29oSRxOAzYu0cdnwS_2XhjQBr9G",
  "cc_account_id": "account-335jdf32",
  "cc_account_name": "my-account-name",
  "cc_credentials_id": "d336c449-aeb8-4bb3-af28-5b886c40dd00",
  "azure_client_id": "53ba6f2b-6d52-4f5c-8ae0-7adc20808854",
  "azure_client_secret": "NMubGVcDqkwwGnCs6fa01tqlkTisfUd4pBBYgcxxx=",
  "azure_tenant_id": "53ba6f2b-6d52-4f5c-8ae0-7adc20808854",
  "azure_subscription_id": "1933a261-d141-4c68-9d6c-13b607790910",
  "subtenant_id": "5d2fb0fb4f47df00015274e3",
  "tags": {
    "key1": "Value 1",
    "key2": "Value 2",
    "key3": "Value 3",
    "keyN": "Value N"
  }
}

Cloud Volumes Service インスタンスのタグを管理します

次の表に示すメソッドを使用して、指定した Cloud Volumes Service インスタンスのタグを指定します。

HTTP メソッド パス 説明 パラメータ

「 POST 」

`/v2.1/cvs/instances/{id}/tags'

Cloud Volumes Service インスタンスのタグを管理します。

id(string) `` : Cloud Volumes Service インスタンスの一意の識別子。

要求の本文属性 : キーと値のペア

  • 要求本文の例: *

{
  "env": "test"
}

Azure NetApp Files アカウント

Azure NetApp Files アカウント属性

次の表に、 Azure NetApp Files アカウントの属性を示します。

属性 を入力します 説明

「 id` 」

文字列

Azure NetApp Files アカウントの一意の識別子。

「 name 」

文字列

Azure NetApp Files アカウントの名前。

「 resource_group 」を参照してください

文字列

Azure リソースグループ。

「ロケーション」

文字列

Azure の場所(リージョン / ゾーン)。

'cvs_instance_id

文字列

Cloud Volumes Service インスタンスの識別子。

「 tags 」

キーと値のペア。

Azure NetApp Files アカウントを取得します

HTTP メソッド パス 説明 パスパラメータ

「 GET 」

「 /v2.1/anf/accounts 」を参照してください

Azure NetApp Files アカウントを取得します。

'ubtenant_id :(必須) Azure NetApp Files アカウントが属しているサブテナント ID`tenant_id :`( オプション ) は ' 指定したテナントに属する Azure NetApp Files アカウントを返しますも参照してください "共通ページ付け" パラメータ

要求本文に必要なパラメータ : 「なし」

Azure NetApp Files アカウントを名前で取得します

次の表に示すメソッドを使用して、 Azure NetApp Files アカウントを名前別に取得します。

HTTP メソッド パス 説明 パラメータ

「 GET 」

/v2.1/anf/accounts/{name}

名前を指定して Azure NetApp Files アカウントを取得します。

`name (string) : ` ( 必須 ) Azure NetApp Files アカウントの名前。「 ubtenant_id (文字列):」(必須) Azure NetApp Files アカウントが属しているサブテナント ID です。

要求本文の必須属性 : 「なし」

Azure NetApp Files アカウントを作成します

次の表に示すメソッドを使用して、新しい Azure NetApp Files アカウントを作成します。

HTTP メソッド パス 説明 パラメータ

「 POST 」

「 /v2.1/anf/accounts 」を参照してください

新しい Azure NetApp Files アカウントを作成します。

なし

要求される本文属性 : 'name’resource_group’location’cvs_instance_id

  • 要求本文の例: *

{
  "name": "string",
  "resource_group": "string",
  "location": "string",
  "cvs_instance_id": "5d2fb0fb4f47df00015274e3",
  "tags": {
    "key1": "Value 1",
    "key2": "Value 2",
    "key3": "Value 3",
    "keyN": "Value N"
  }
}

Azure NetApp Files の容量プール

容量プールの属性

次の表に、容量プールの属性を示します。

属性 を入力します 説明

「 id` 」

文字列

容量プールの一意の識別子。

「 name 」

文字列

容量プールの名前。

「 resource_group 」を参照してください

文字列

Azure リソースグループ。

「ロケーション」

文字列

Azure の場所(リージョン / ゾーン)。

「 size 」

整数

容量プールのサイズ( TB )。

「サービスレベル」

文字列

適用可能なサービスレベル名: Ultra 、 Premium 、または Standard 。

'anf_account_name'

文字列

Azure NetApp Files アカウントインスタンスの識別子。

'ubtenant_id

文字列

サブテナント ID 。

「 tags 」

キーと値のペア。

容量プールを取得します

HTTP メソッド パス 説明 パスパラメータ

「 GET 」

「 /v2.1/anf/pools 」を指定します

容量プールを取得します。

'ubtenant_id : '(Mandatory) ANF アカウントが属するサブテナント ID`tenant_id :`( オプション ) 指定したテナントに属する容量プールを返しますも参照してください "共通ページ付け" パラメータ

要求本文に必要なパラメータ : 「なし」

  • 要求本文の例: *

none

名前を使用して容量プールを取得します

次の表に示すメソッドを使用して、名前別に容量プールを取得します。

HTTP メソッド パス 説明 パラメータ

「 GET 」

/v2.1/anf/pools/{name}

名前を指定して容量プールを取得します。

`name (string) : ` ( 必須 ) 容量プールの一意の名前。'ubtenant_id (文字列): '( 必須 ) 容量プールが属しているサブテナント ID

要求本文の必須属性 : 「なし」

容量プールを作成

次の表に示す方法を使用して、新しい容量プールを作成します。

HTTP メソッド パス 説明 パラメータ

「 POST 」

「 /v2.1/anf/pools 」を指定します

容量プールを作成

なし

要求本文の必須属性 : 'name’resource_group’location’size’SERVICE_LEVEL_', ANF アカウント名、サブテナント ID

  • 要求本文の例: *

{
  "name": "string",
  "resource_group": "string",
  "location": "string",
  "size": 10,
  "service_level": "Standard",
  "anf_account_name": "myaccount",
  "subtenant_id": "5d2fb0fb4f47df00015274e3",
  "tags": {
    "key1": "Value 1",
    "key2": "Value 2",
    "key3": "Value 3",
    "keyN": "Value N"
  }
}

容量プールのサイズを変更します

次の表に示す方法を使用して、容量プールのサイズを変更します。

HTTP メソッド パス 説明 パラメータ

「 PUT 」

/v2.1/anf/pools/{name}

容量プールのサイズを変更します。

'name (string) : 'Mandatory :容量プールの一意の名前

要求本文の必須属性 : 'name’resource_group’location’anf_account_name’size' SERVICE_LEVEL 、 Subtenant _id です

  • 要求本文の例: *

{
  "name": "myaccount",
  "resource_group": "string",
  "location": "string",
  "anf_account_name": "myaccount",
  "size": 4,
  "service_level": "Standard",
  "subtenant_id": "5d2fb0fb4f47df00015274e3",
  "tags": {
    "key1": "Value 1",
    "key2": "Value 2",
    "key3": "Value 3",
    "keyN": "Value N"
  }
}

Azure NetApp Files ボリューム

Azure NetApp Files ボリューム属性

次の表に、 Azure NetApp Files ボリュームの属性を示します。

属性 を入力します 説明

「 id` 」

文字列

Azure NetApp Files ボリュームの一意の識別子。

「 name 」

文字列

Azure NetApp Files ボリュームの名前。

「 resource_group 」を参照してください

文字列

Azure リソースグループ。

'ubtenant_id

文字列

サブテナント ID 。

'anf_account_name'

文字列

Azure NetApp Files アカウント名。

'anf_pool_name

文字列

Azure NetApp Files プール名。

「ロケーション」

文字列

Azure の場所(リージョン / ゾーン)。

「 file_path 」

文字列

作成トークンまたはファイルパス。ボリュームにアクセスするための一意のファイルパス。

'QUOTA_size'

整数

GiB 単位で許可される最大ストレージクォータ。

'ubNetID'

文字列

委任されたサブネットの Azure リソース URL 。Microsoft の NetApp またはボリュームの委譲が必要です。

「 tags 」

キーと値のペア。

Azure NetApp Files ボリュームを取得します

次の表に示すメソッドを使用して、 Azure NetApp Files ボリュームを取得します。「 tenant_id 」を指定すると、そのテナントに属するアカウントだけが返されます。

HTTP メソッド パス 説明 パスパラメータ

「 GET 」

「 /v2.1/anf/volumes 」

Azure NetApp Files ボリュームを取得します。

「 ubtenant_id 」(必須) ANF ボリュームが属しているサブテナント ID です。tenant_id :(任意)指定したテナントに属する ANF ボリュームを返します。も参照してください "共通ページ付け" パラメータ

要求本文に必要なパラメータ : 「なし」。

名前を使用して Azure NetApp Files ボリュームを取得します

次の表に示すメソッドを使用して、 Azure NetApp Files ボリュームを名前別に取得します。

HTTP メソッド パス 説明 パラメータ

「 GET 」

/v2.1/anf/volumes /{name}

名前を指定して Azure NetApp Files ボリュームを取得します。

'name (string) : 'Mandatory : Azure NetApp Files ボリュームの一意の名前’ubtenant_id :(文字列)必須。Azure NetApp Files ボリュームが属しているサブテナント ID 。

要求本文の必須属性 : 「なし」

  • 要求本文の例: *

none

Azure NetApp Files ボリュームを作成します

次の表に示す方法を使用して、新しい Azure NetApp Files ボリュームを作成します。

HTTP メソッド パス 説明 パラメータ

「 POST 」

「 /v2.1/anf/volumes 」

Azure NetApp Files ボリュームを作成します

なし

必要な要求本文の属性: 'name’resource_group’Subtenant _id ' anf_account_name ' anf_pool_name ' virtual_network 、 location 、 file_path 、 QUOTA_SIZE 、 subNetID

  • 要求本文の例: *

{
  "name": "myVolume",
  "resource_group": "string",
  "subtenant_id": "5d2fb0fb4f47df00015274e3",
  "anf_account_name": "myaccount",
  "anf_pool_name": "myaccount",
  "virtual_network": "anf-vnet",
  "location": "string",
  "file_path": "myVolume",
  "quota_size": 100,
  "subNetId": "string",
  "protocol_types": [
    "string"
  ],
  "tags": {
    "key1": "Value 1",
    "key2": "Value 2",
    "key3": "Value 3",
    "keyN": "Value N"
  }
}

Cloud Volumes Service for Google Cloud の管理

クラウド・オーケストレーション・カテゴリーの「 /v2.1/GCP/VOLUMES 」 API を使用すると、 Google Cloud インスタンスの Cloud Volume を管理できます。この API を実行する前に、サブテナントに対して Google Cloud Platform ( GCP )サブスクリプションの Cloud Volumes Service アカウントが有効になっていることを確認してください。

HTTP 動詞 パス 説明 必須パラメータ / 要求本文

「 GET 」

「 /v2.1/GCP/volumes 」

GET メソッドを使用すると、サブテナントの Cloud Volumes Service サブスクリプション用に作成されたすべての Google Cloud Volume の詳細を取得できます。

offset :結果セットの収集を開始する前にスキップする項目の数。limit :返される項目の数。「 ubtenant_id 」: Google Cloud にサブスクライブされているサブテナントの ID 。re Gion: 加入したサービスの地域。

「 GET 」

/v2.1/GCP/volumes /{id}

このメソッドを使用して、サブテナントの Cloud Volumes Service サブスクリプション用に作成された特定の Google Cloud ボリュームの詳細を取得できます。

id : GCP ボリュームの ID 。「 ubtenant_id 」: Google Cloud にサブスクライブされているサブテナントの ID 。re Gion: 加入したサービスの地域。

「 POST 」

「 /v2.1/GCP/volumes 」

サブテナント用の GCP ボリュームを作成します。要求の本文に値を追加して、指定したパラメータでボリュームを作成します。

`{" サブテナント _id" : "<ID> " 、 "name" : "<Volume_name> " 、 "region" : "<region>" 、 "zone>" : "<zone>" 、 "creation_token" : "<token>" 、 "allowed_clients" : "<IP address of the clients allowed to access GCP>" 、 "network" : "GCP サブスクライブサービスに入力されたネットワークの詳細 >" 、 "protocol_types" : [<<NFSv3 のような接続のプロトコル、 "QUOTA_GIB" : <volume quota in bytes> 、 "SERVICE_LEVEL of Service"> レベルなどの "types"

PUT

/v2.1/GCP/volumes /{id}

サブテナント用にすでに作成されている GCP ボリュームを変更します。変更するボリュームのボリューム ID と変更するパラメータの値を要求の本文に追加します。

'`{" サブテナント _id" : "<ID> " 、 "name" : "<volume_name>" 、 "region>" : "zone>" 、 "allowed_clients" : "<IP アドレス of the clients allowed to access GCP>" 、 "QUOTA_GIB" : <volume_group>" 、 "service.groups" : <protocols' <protocols' <protocol> などの標準の "service" レベル <groups" 、 "types"

削除

/v2.1/GCP/volumes /{id}

このメソッドを使用して、サブテナントの Cloud Volumes Service サブスクリプション用に作成された特定の Google Cloud ボリュームを削除できます。

id : GCP ボリュームの ID 。「 ubtenant_id 」: Cloud Volumes Service for Google Cloud にサブスクライブされているサブテナントの ID 。re Gion: 加入したサービスの地域。