調用DescribeSDGs查詢共用資料群組資訊-邊緣節點服務 ENS-阿里雲

查詢已建立的共用資料群組資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ens:DescribeSDGs

none

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
SDGIds	array	否	待查詢的 SDG 列表 ID。
	string	否	指定查詢的 SDG ID。若參數值為空白，預設查詢全部。	["sdg-1", "sdg-2", "sdg-3"]
InstanceIds	array	否	待查詢的 AIC 執行個體 ID。
	string	否	指定查詢的 AIC 執行個體 ID，若參數值為空白，預設查詢全部。說明若指定了 SDGIds，同時指定了 InstanceIds，則查詢結果為上述兩個條件的交集。	["aic-1", "aic-2", "aic-3"]

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	3703C4AC-9396-458C-8F25-1D701334D309
SDGs	array<object>	SDG 資訊列表。
	array<object>	SDG 資訊列表。
AvaliableRegionIds	array<object>	可用節點列表。
	object	可用節點列表。
CreationTime	string	該節點內 SDG 的建立時間。	2023-02-27 15:13:26
RegionId	string	節點 ID。	cn-hangzhou-26
SnapshotId	string	快照 ID。	mock-clone_snapshot_id
Status	string	該節點 SDG 的狀態，包括： sdg_making：製作中。 sdg_saving：儲存中。 sdg_copying：跨節點同步中。 failed：製作失敗。 success：製作成功。	success
CreationDiskType	string	建立 SDG 的母盤磁碟類型。	standard
CreationRegionId	string	建立 SDG 的節點 ID。	cn-hangzhou-26
CreationTime	string	SDG 首次建立時間。	2023-02-27 15:07:21
DeployedInstanceIds	array<object>	部署狀態資訊列表
	object	部署狀態資訊列表
CreationTime	string	SDG 在該執行個體上的部署時間。	2023-02-27 16:48:43
InstanceId	string	AIC 執行個體 ID。	aic-5x20dyeos****
Status	string	部署狀態，包括： sdg_deploying：部署中。 failed：部署失敗。 success：部署成功。	sdg_deploying
DeploymentType	string	SDG 部署類型，包括： common: 普通部署 overlay: 讀寫分離部署	overlay
Description	string	SDG 的描述資訊。	測試SDG
ParentSDGId	string	增量製作時，來源 SDG 的 ID，即 CreateSDG 時傳入的 FromSDGId。	sdg-xxxxx
SDGId	string	SDG 的 ID。	sdg-30e1fdba7196bc****
Size	integer	SDG 大小，單位 GB。	20
Status	string	SDG 製作狀態，包括： sdg_making：製作中。 sdg_saving：儲存中。 failed：製作失敗。 success：製作成功。	success
UpdateTime	string	SDG 最後更新時間。	2023-02-27 16:04:39
CreationInstanceId	string	建立 SDG 的執行個體 ID。	aic-5x20dyeos****
BillingType	string	計費類型	Open
PerformanceLevel	integer	SDG 的共用比。	100
BillingCycle	string	共用盤的計費周期。	Hour

樣本

正常返回樣本

JSON格式

{
  "RequestId": "3703C4AC-9396-458C-8F25-1D701334D309",
  "SDGs": [
    {
      "AvaliableRegionIds": [
        {
          "CreationTime": "2023-02-27 15:13:26",
          "RegionId": "cn-hangzhou-26",
          "SnapshotId": "mock-clone_snapshot_id",
          "Status": "success"
        }
      ],
      "CreationDiskType": "standard",
      "CreationRegionId": "cn-hangzhou-26",
      "CreationTime": "2023-02-27 15:07:21",
      "DeployedInstanceIds": [
        {
          "CreationTime": "2023-02-27 16:48:43",
          "InstanceId": "aic-5x20dyeos****",
          "Status": "sdg_deploying",
          "DeploymentType": "overlay"
        }
      ],
      "Description": "測試SDG",
      "ParentSDGId": "sdg-xxxxx",
      "SDGId": "sdg-30e1fdba7196bc****",
      "Size": 20,
      "Status": "success",
      "UpdateTime": "2023-02-27 16:04:39",
      "CreationInstanceId": "aic-5x20dyeos****",
      "BillingType": "Open",
      "PerformanceLevel": 100,
      "BillingCycle": "Hour"
    }
  ]
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	Interface.Call.Failed	%s.	請求失敗
400	Parameter.Invalid	The parameter is invalid. Please check your parameters and try it again.	參數不合法
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。