本接口用于查詢存儲(chǔ)容量單位包SCU(Storage Capacity Unit)的詳細(xì)信息列表,支持根據(jù)名稱、狀態(tài)以及容量大小等條件進(jìn)行查詢。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別:是指每個(gè)操作的訪問級(jí)別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對(duì)于必選的資源類型,用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
ecs:DescribeStorageCapacityUnits | get | *StorageCapacityUnit acs:ecs:{#regionId}:{#accountId}:scu/* *StorageCapacityUnit acs:ecs:{#regionId}:{#accountId}:scu/{#scuId} |
| 無 |
請(qǐng)求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | SCU 所屬的地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
PageNumber | integer | 否 | SCU 列表的頁碼。 起始值:1。 默認(rèn)值:1。 | 1 |
PageSize | integer | 否 | 分頁查詢時(shí)的每頁行數(shù)。 最大值:100。 默認(rèn)值:10。 | 1 |
Name | string | 否 | SCU 的名稱,長(zhǎng)度為 2~128 個(gè)英文或中文字符。必須以大小寫字母或中文開頭,不能以 | testScuName |
Capacity | integer | 否 | SCU 容量大小,單位為 GiB。取值范圍:{20, 40, 100, 200, 500, 1024, 2048, 5120, 10240, 20480, 51200}。 | 20 |
AllocationType | string | 否 | 分配類型。取值范圍:
默認(rèn)值:Normal。 | Normal |
StorageCapacityUnitId | array | 否 | SCU 的 ID 數(shù)組。數(shù)組長(zhǎng)度:1~100。 | |
string | 否 | SCU 的 ID。 | scu-bp67acfmxazb4p**** | |
Status | array | 否 | SCU 的狀態(tài)數(shù)組,數(shù)組長(zhǎng)度為 1~4。 | |
string | 否 | SCU 的狀態(tài)值。狀態(tài)的取值范圍:
| Active | |
Tag | array<object> | 否 | 標(biāo)簽數(shù)組。數(shù)組長(zhǎng)度:0~20。 | |
object | 否 | |||
Key | string | 否 | SCU 的標(biāo)簽鍵。 | TestKey |
Value | string | 否 | SCU 的標(biāo)簽值。 | TestValue |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"PageSize": 10,
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"PageNumber": 1,
"TotalCount": 1,
"StorageCapacityUnits": {
"StorageCapacityUnit": [
{
"CreationTime": "2021-08-17T02:55Z",
"Status": "Active",
"StartTime": "2021-08-17T02:55Z",
"Capacity": 20,
"Description": "testScuDescription",
"AllocationStatus": "allocated",
"ExpiredTime": "2021-09-17T16:00Z",
"StorageCapacityUnitId": "scu-bp67acfmxazb4p****",
"Name": "testScuName",
"RegionId": "cn-hangzhou",
"Tags": {
"Tag": [
{
"TagValue": "TestKey",
"TagKey": "TestValue"
}
]
}
}
]
}
}
錯(cuò)誤碼
HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
---|---|---|---|
400 | MissingParameter.RegionId | The specified RegionId should not be null. | RegionId是必選參數(shù)。 |
400 | InvalidParameter.Name | The specified Name is invalid. | 指定的 Name 參數(shù)無效。 |
400 | InvalidParameter.CapacityExceed | The specified Capacity exceeds the limitation of quota. | 指定的 Capacity 參數(shù)超出了最大有效取值。 |
400 | InvalidAllocationType.ValueNotSupported | The specified AllocationType is not supported. | 指定的分配類型無效。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。