本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。

雲端協調 API

貢獻者

Cloud Orchestration API NetApp Service Engine 支援將 Cloud Volumes Services 連接至 NetApp Service Engine 、並可在 NetApp Service Engine 內與他們合作。Cloud Volumes Services 支援的是支援的支援範圍( ANF )和 Google Cloud Platform ( GCP ) Azure NetApp Files 。

Cloud Volumes 服務的訂閱是在 NetApp 服務引擎之外進行管理。相關認證資料會提供給 NetApp 服務引擎、以便連線至雲端服務。

本節說明以下 API :

  • 管理 Cloud Volumes Service 執行個體

  • 管理 Azure NetApp Files 客戶需求

  • 管理 Azure NetApp Files 功能資源池

  • 管理 Azure NetApp Files 功能

  • 管理 Google Cloud Volumes

執行個體 Cloud Volumes Service

使用下表所列的方法來擷取及建立 Cloud Volumes Service 列舉的實例。

HTTP 方法 路徑 說明

《 Get 》(取得)

/v2.1 / CVS / 執行個體

擷取所有 Cloud Volumes Service 的實體執行個體。

貼文

/v2.1 / CVS / 執行個體

建立新 Cloud Volumes Service 的實體執行個體。

《 Get 》(取得)

/v2.1 / CVS / 執行個體 / { id }

依 ID 擷取 Cloud Volumes Service 實體執行個體。

《 Get 》(取得)

/v2.1 / anf/Accounts

擷 Azure NetApp Files 取不一樣的帳戶。

貼文

/v2.1 / anf/Accounts

建立 Azure NetApp Files 一個不一樣的帳戶

《 Get 》(取得)

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

依 ID 擷取 Azure NetApp Files 一個統一帳戶。

《 Get 》(取得)

/v2.1 / anf/Pools

擷取所有容量資源池。

貼文

/v2.1 / anf/Pools

建立容量資源池。

《 Get 》(取得)

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

依 ID 擷取 Azure NetApp Files 功能區資源池。

執行個體屬性 Cloud Volumes Service

下表列出 Cloud Volumes Service 了一些不執行個體屬性。

屬性 類型 說明

"id"

字串

適用於該實例的唯一識別碼 Cloud Volumes Service 。

名稱

字串

例項名稱 Cloud Volumes Service 。

「 cc_job_env 」

字串

Cloud Manager 中的工作環境名稱。

"cc_client_id"

字串

驗證 0 服務 ID 。

"cc_refresh_tokent"

字串

驗證 0 重新整理權杖。

"cc_account_id"

字串

Cloud Central 帳戶 ID :

"cc_account_name"

字串

Cloud Central 帳戶名稱。

"cc_entions_id"

字串

Cloud Centra 工作環境的 ID 。

《 azure_client_id 》

字串

應用程式(用戶端) ID 。Cloud Manager 可用來驗證 Azure Active Directory 的 Active Directory 服務主體 ID 。

《 azure_client_secret 》

字串

服務主體應用程式的用戶端機密值。

《 azure_enture_id 》

字串

Azure Active Directory ID 。這也稱為租戶 ID 。

《 azure_ention_id 》

字串

Azure Active Directory 訂閱 ID 。

《 Subenter_id 》

字串

子租戶 ID 。

標籤

關鍵價值配對。

擷 Cloud Volumes Service 取執行個體

HTTP 方法 路徑 說明 路徑參數

《 Get 》(取得)

/v2.1 / CVS / 執行個體

擷 Cloud Volumes Service 取實體執行個體。

「租戶 ID :」(選用)會傳回 Cloud Volumes Service 屬於指定租戶的實體執行個體。另請參閱 "常見分頁" 參數。

必要的要求內容參數:「無」

依 ID 擷取 Cloud Volumes Service 實體執行個體

請使用下表所列的方法、 Cloud Volumes Service 根據其識別碼來擷取一個實例。

HTTP 方法 路徑 說明 參數

《 Get 》(取得)

/v2.1 / CVS / 執行個體 / { id }

依 ID 擷取 Cloud Volumes Service 實體執行個體。

「 ID (字串):」 Cloud Volumes Service 這是一個獨特的例子。

必要的要求內容屬性:「無」

建立 Cloud Volumes Service 執行個體

使用下表所列的方法來建立新 Cloud Volumes Service 的例子。

HTTP 方法 路徑 說明 參數

貼文

/v2.1 / CVS / 執行個體

建立 Cloud Volumes Service 一個實例。

必要的要求內容屬性:「 name 、 cc_jobing_env 、 cc_client_id 、 cc_refresh_doken 、 cc_account_id 、 cc_account_name 、 azure_client_id 、 azure_client_secret 、 azure_enter_id 、 azure_ention_id 、 Sub租 戶 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 方法 路徑 說明 參數

貼文

/v2.1 / vCVS / 執行個體 / { id } / 標記

管理 Cloud Volumes Service 實體執行個體的標記。

「 id (字串)」: Cloud Volumes Service 此為整個過程的唯一識別碼。

必要的要求內容屬性:「金鑰值配對」

  • 索取本文範例: *

{
  "env": "test"
}

銷售帳戶 Azure NetApp Files

系統屬性 Azure NetApp Files

下表列出 Azure NetApp Files 了各個帳戶屬性。

屬性 類型 說明

"id"

字串

用於此帳戶的唯一識別碼 Azure NetApp Files 。

名稱

字串

這個帳戶的名稱 Azure NetApp Files 。

"RESOUR_TOUS"

字串

Azure 資源群組。

位置

字串

Azure 位置(地區 / 區域)。

"CVs_instance_id"

字串

執行個體識別碼。 Cloud Volumes Service

標籤

關鍵價值配對。

擷 Azure NetApp Files 取不一樣的帳戶

HTTP 方法 路徑 說明 路徑參數

《 Get 》(取得)

/v2.1 / anf/Accounts

擷 Azure NetApp Files 取不一樣的帳戶。

「 ubenture_id :」(必填) Azure NetApp Files 這個帳戶所屬的子租戶 ID 。「租戶 ID :」(選用)會傳回 Azure NetApp Files 屬於指定租戶的不確定帳戶。另請參閱 "常見分頁" 參數。

必要的要求內容參數:「無」

依 Azure NetApp Files 名稱擷取此帳戶

請使用下表所列的方法、 Azure NetApp Files 依名稱擷取一個不完整的帳戶。

HTTP 方法 路徑 說明 參數

《 Get 》(取得)

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

依 Azure NetApp Files 名稱擷取一個不完整的帳戶。

名稱(字串):(必填) Azure NetApp Files 。「 ubenture_id (字串):」(必填) Azure NetApp Files 此帳戶所屬的子租戶 ID 。

必要的要求內容屬性:「無」

建立 Azure NetApp Files 不一樣的帳戶

請使用下表所列的方法來建立新 Azure NetApp Files 的功能表。

HTTP 方法 路徑 說明 參數

貼文

/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"

字串

容量集區的唯一識別碼。

名稱

字串

容量集區的名稱。

"RESOUR_TOUS"

字串

Azure 資源群組。

位置

字串

Azure 位置(地區 / 區域)。

《大小》

整數

容量集區的大小(以 TB 為單位)。

' 服務層級 '

字串

適用的服務層級名稱: Ultra 、 Premium 或 Standard 。

"anf_account_name"

字串

此為實體帳戶執行個體識別碼。 Azure NetApp Files

《 Subenter_id 》

字串

子租戶 ID 。

標籤

關鍵價值配對。

擷取容量資源池

HTTP 方法 路徑 說明 路徑參數

《 Get 》(取得)

/v2.1 / anf/Pools

擷取容量資源池。

「 Subent租 戶 ID :」(必填) ANF 帳戶所屬的子租戶 ID 。「租戶 ID :」(選用)會傳回屬於指定租戶的容量資源池。另請參閱 "常見分頁" 參數。

必要的要求內容參數:「無」

  • 索取本文範例: *

none

依名稱擷取容量資源池

使用下表所列的方法、依名稱擷取容量資源池。

HTTP 方法 路徑 說明 參數

《 Get 》(取得)

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

依名稱擷取容量資源池。

名稱(字串):(必填)容量資源池的唯一名稱。「 ubtenter_id (字串):」(必填)容量資源池所屬的子租戶 ID 。

必要的要求內容屬性:「無」

建立容量資源池

使用下表所列的方法建立新的容量集區。

HTTP 方法 路徑 說明 參數

貼文

/v2.1 / anf/Pools

建立容量資源池。

必要的要求內容屬性:「 name 、 resource_group 、 location 、 size 、 service_level 、 ANf_account_name 、 sub租 戶 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 方法 路徑 說明 參數

《投入》

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

修改容量集區的大小。

名稱(字串):必填:容量資源池的唯一名稱。

必要的要求本文屬性:「 name 、 resource_group 、 location 、 anf_account_name 、 size 、 服務層級、子租戶 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 。

名稱

字串

名稱。 Azure NetApp Files

"RESOUR_TOUS"

字串

Azure 資源群組。

《 Subenter_id 》

字串

子租戶 ID 。

"anf_account_name"

字串

這個帳戶名稱。 Azure NetApp Files

"anf_pool 名稱 "

字串

這個資源池名稱。 Azure NetApp Files

位置

字串

Azure 位置(地區 / 區域)。

"file_path"

字串

建立權杖或檔案路徑。存取 Volume 的獨特檔案路徑。

配額大小

整數

GiB 允許的最大儲存配額。

《 SubNetID 》

字串

委派子網路的 Azure 資源 URL 。必須委派 Microsoft NetApp/Volumes 。

標籤

關鍵價值配對。

擷 Azure NetApp Files 取功能區

使用下表所列的方法來擷取 Azure NetApp Files 功能區。指定「租戶 ID 」只會傳回屬於該租戶的帳戶。

HTTP 方法 路徑 說明 路徑參數

《 Get 》(取得)

/v2.1 / anf/Volumes

擷 Azure NetApp Files 取功能區。

「 ubenture_id :」(必填) ANF 磁碟區所屬的子租戶 ID 。「租戶 ID :」(選用)會傳回屬於指定租戶的 ANF Volume 。另請參閱 "常見分頁" 參數。

必要的要求內容參數:「無」。

依 Azure NetApp Files 名稱擷取本區

請使用下表所列的方法、 Azure NetApp Files 依名稱擷取一份不完整的功能。

HTTP 方法 路徑 說明 參數

《 Get 》(取得)

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

依 Azure NetApp Files 名稱擷取一份流通量。

名稱(字串):必填: Azure NetApp Files 唯一的名稱。必須填寫「 Subenture_id: 」(字串)。子租戶 ID 、 Azure NetApp Files 而此 ID 屬於該磁碟區。

必要的要求內容屬性:「無」

  • 索取本文範例: *

none

建立 Azure NetApp Files 功能區

請使用下表所列的方法來建立新 Azure NetApp Files 的功能區。

HTTP 方法 路徑 說明 參數

貼文

/v2.1 / anf/Volumes

建立 Azure NetApp Files 一個流通量。

必要的要求本文屬性:「 name 、 resource_group 、 sub租 戶 _id 、 anf_account_name 、 anf_pool 名稱、 virtual_network 、位置、 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 的功能

Cloud Orchestration 類別下的「 /v2.1 / GCP / Volume 」 API 可讓您管理 Google Cloud 執行個體的雲端磁碟區。在執行此 API 之前、請確定 Cloud Volumes Service 子租戶已啟用 Google Cloud Platform ( GCP )的支援功能。

HTTP Verb 路徑 說明 必要參數 / 要求本文

《 Get 》(取得)

/v2.1 / GCP / Volume

您可以使用 Get 方法來擷取所有為子租戶 Cloud Volumes Service 訂閱而建立的 Google Cloud Volumes 詳細資料。

「偏移」:開始收集結果集之前要跳過的項目數。「限制」:要退回的項目數量。「 ub租 戶 ID 」:訂閱 Google Cloud 的子租戶 ID 。「 REGion 」:訂閱服務的地區。

《 Get 》(取得)

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

您可以使用此方法擷取專為租戶 Cloud Volumes Service 訂閱而建立的特定 Google Cloud Volume 詳細資料。

「 id 」: GCP 磁碟區的 ID 。「 ub租 戶 ID 」:訂閱 Google Cloud 的子租戶 ID 。「 REGion 」:訂閱服務的地區。

貼文

/v2.1 / GCP / Volume

為子租戶建立 GCP 磁碟區。新增要求實體中的值、以使用指定的參數建立 Volume 。

「」、「 name 」:「 <Volume_name> 」、「 region 」:「 <region> 」、「 Zone 」:「 <region> 」、「 Zone 」:「 <region> 」、「 creation_token 」:「 <token > 」、 「 allowed_clients 」:「 <允許 存取 GCP>" 的用戶端 IP 位址、「 network 」:「 < 為 GCP 訂閱服務輸入的網路詳細資料 > 」、「傳輸協定類型」:「 < 連接的傳輸協定、例如 NFSv3>" 、「 quota _gib」 : < 以位元組為單位的磁碟區配額 > 、「 service_level 」:「 < 此為標籤類型為標籤:」、「 < 此為標籤類型為標籤

放入

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

修改已為子租戶建立的 GCP 磁碟區。在要求本文中新增您要修改的 Volume ID 、以及您要修改的參數值。

「」、「 name 」:「 <Volume 名稱 > 」、「 region 」:「 <region> 」、「區域」:「 <region> 」、「區域」:「 <region> 」、「 <region> 」、「 < 允許存取 GCP> 的用戶端 IP 位址」、「 quota _gib" Sv: <volume quota in bytes> 、 < 服務層級的磁碟配額字節數 > 、 < 服務類型: < 服務類型 > 、「、 < 服務類型的標籤、 < 效能類型: < 服務類型:」、「 <f< 服務層級的標籤類型:」、「 < 效能類型:」、「 < 服務層級」、「 < 服務類型」、「 <scalscal_regation> 、「

刪除

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

您可以使用此方法刪除專為子租戶 Cloud Volumes Service 的訂閱所建立的特定 Google Cloud Volume 。

「 id 」: GCP 磁碟區的 ID 。「 ubtenter_id 」:訂閱 Cloud Volumes Service 適用於 Google Cloud 的子租戶 ID 。「 REGion 」:訂閱服務的地區。