调用DescribeStorageBundles可以查询指定地域对应的集群列表信息。包括网关集群名称、描述及创建时间等。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | DescribeStorageBundles | 系统规定参数。取值:DescribeStorageBundles。 |
BackendBucketRegionId | String | 是 | cn-hangzhou | 网关集群所在的地域。可以通过DescribeRegions接口获得有效的regionId。 |
PageNumber | Integer | 否 | 1 | 网关集群列表信息的页码。 起始值:1。 默认值:1。 |
PageSize | Integer | 否 | 10 | 分页查询时设置的每页行数。 最大值:50。 默认值:10。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
TotalCount | Integer | 20 | 网关集群的总数。 |
RequestId | String | 1EB4639B-0812-4F2D-AB78-194E67645E357 | 请求ID。 |
Message | String | successful | 请求结果描述。 |
PageSize | Integer | 10 | 分页展示返回的网关集群列表时的每页行数。 |
PageNumber | Integer | 1 | 网关集群列表的页码。 |
Code | String | 200 | 状态码。状态码为200表示请求成功。 |
Success | Boolean | true | 请求是否成功。 |
StorageBundles | Array of StorageBundle | 网关集群信息。 |
|
StorageBundle | |||
Description | String | 测试使用 | 网关集群的描述。 |
BackendBucketRegionId | String | cn-hangzhou | 网关集群所在的地域。 |
StorageBundleId | String | sb-000ibk4xrlr03qrjr*** | 网关集群ID。 |
Name | String | zy-test*** | 网关集群名称。 |
CreatedTime | Long | 1565750633 | 网关集群创建时间。时间戳为秒(s)。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeStorageBundles
&BackendBucketRegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeStorageBundlesResponse>
<TotalCount>3</TotalCount>
<Message>successful</Message>
<PageSize>5</PageSize>
<RequestId>0F96A15D-BA06-4A34-9587-AA8C9C230E80</RequestId>
<PageNumber>1</PageNumber>
<Code>200</Code>
<StorageBundles>
<StorageBundle>
<CreatedTime>1568795768</CreatedTime>
<StorageBundleId>sb-0007y2889yyxkuqov***</StorageBundleId>
<BackendBucketRegionId>cn-shanghai</BackendBucketRegionId>
<Description>测试使用</Description>
<Name>sgw1-test***</Name>
</StorageBundle>
<StorageBundle>
<CreatedTime>1533283347</CreatedTime>
<StorageBundleId>sb-000dai44c82bp6i32***</StorageBundleId>
<BackendBucketRegionId>cn-shanghai</BackendBucketRegionId>
<Description>测试使用</Description>
<Name>sgw2-test***</Name>
</StorageBundle>
<StorageBundle>
<CreatedTime>1532663546</CreatedTime>
<StorageBundleId>sb-000e9qyjn694q148r***</StorageBundleId>
<BackendBucketRegionId>cn-shanghai</BackendBucketRegionId>
<Description>测试使用</Description>
<Name>sgw3-test***</Name>
</StorageBundle>
</StorageBundles>
<Success>true</Success>
</DescribeStorageBundlesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TotalCount" : 3,
"Message" : "successful",
"PageSize" : 5,
"RequestId" : "0F96A15D-BA06-4A34-9587-AA8C9C230E80",
"PageNumber" : 1,
"Code" : "200",
"StorageBundles" : {
"StorageBundle" : [ {
"CreatedTime" : 1568795768,
"StorageBundleId" : "sb-0007y2889yyxkuqov***",
"BackendBucketRegionId" : "cn-shanghai",
"Description" : "测试使用",
"Name" : "sgw1-test***"
}, {
"CreatedTime" : 1533283347,
"StorageBundleId" : "sb-000dai44c82bp6i32***",
"BackendBucketRegionId" : "cn-shanghai",
"Description" : "测试使用",
"Name" : "sgw2-test***"
}, {
"CreatedTime" : 1532663546,
"StorageBundleId" : "sb-000e9qyjn694q148r***",
"BackendBucketRegionId" : "cn-shanghai",
"Description" : "测试使用",
"Name" : "sgw3-test***"
} ]
},
"Success" : true
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
400 | BadPageSize | The specified number of pages is invalid. The number ranges from 1 to 50. | 无效的页数,取值范围:1~50。 |
400 | BadPageNumber | The specified page number is invalid. The page number must be greater than 0. | 无效的页码,不能小于0。 |
400 | InvalidRegionId | The specified RegionId does not exist. You must specify a valid RegionId. | 指定的RegionId不存在,请您确认该参数是否正确。 |
访问错误中心查看更多错误码。
文档内容是否对您有帮助?