调用DescribeRegions查询块存储EBS相关功能支持的地域信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeRegions |
系统规定参数。取值:DescribeRegions。 |
ResourceType | String | 否 | ear |
资源类型。目前仅支持查询异步复制功能支持的地域信息。取值:ear。 默认值为ear。 |
AcceptLanguage | String | 否 | zh-CN |
地域和可用区名称的语言类型。对应返回参数中
默认值为zh-CN。 |
RegionId | String | 否 | cn-beijing |
要查询的地域ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 17EE62D8-064E-5404-8B0D-72122478**** |
请求ID。 |
Regions | Array of region |
地域和可用区信息合集。 |
|
LocalName | String | 美国(硅谷) |
地域名称。 |
RegionEndpoint | String | ebs.us-west-1.aliyuncs.com |
地域对应的接入地址(Endpoint)。 |
RegionId | String | us-west-1 |
地域ID。 |
Zones | Array of zone |
可用区信息合集。 |
|
LocalName | String | 硅谷 可用区A |
可用区名称。 |
ZoneId | String | us-west-1a |
可用区ID。 |
示例
请求示例
http(s)://ebs.cn-beijing.aliyuncs.com/?Action=DescribeRegions
&ResourceType=ear
&AcceptLanguage=zh-CN
&RegionId=cn-beijing
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeRegionsResponse>
<RequestId>17EE62D8-064E-5404-8B0D-72122478****</RequestId>
<Regions>
<LocalName>美国(硅谷)</LocalName>
<RegionEndpoint>ebs.us-west-1.aliyuncs.com</RegionEndpoint>
<RegionId>us-west-1</RegionId>
<Zones>
<LocalName>硅谷 可用区A</LocalName>
<ZoneId>us-west-1a</ZoneId>
</Zones>
</Regions>
</DescribeRegionsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "17EE62D8-064E-5404-8B0D-72122478****",
"Regions" : [ {
"LocalName" : "美国(硅谷)",
"RegionEndpoint" : "ebs.us-west-1.aliyuncs.com",
"RegionId" : "us-west-1",
"Zones" : [ {
"LocalName" : "硅谷 可用区A",
"ZoneId" : "us-west-1a"
} ]
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定的RegionId不存在。 |
404 | InvalidZoneId.NotFound | The specified ZoneId does not exist. | 指定的ZoneId不存在。 |
404 | NoSuchResource | The specified resource does not exist. | 指定的资源不存在。 |
504 | RequestTimeout | The request is timeout, please try again later. | 该请求超时,请稍后再重试。 |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误。 |
403 | InvalidPayMethod | The specified pay method is not valid. | 不支持该购买方式。请检查您传入的参数chargeType是否正确。 |
403 | Forbidden | User is not authorized to operate. | 当前用户无权限对当前资源执行任何操作。请检查您的账号权限或者咨询您的主账号管理员。 |
403 | Forbidden.Action | User is not authorized to operate this action. | 当前用户无权限执行该操作。请检查您的账号权限或者咨询您的主账号管理员。 |
403 | NoPermission.SLR | The RAM user does not have the permission to create service linked role: AliyunServiceLinkedRoleForEBS. | 当前用户无权限创建SLR。 |
403 | LastTokenProcessing | The last token request is processing. | 相同clientToken的请求正在执行,请稍后再重试。 |
403 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | 您的账户余额不足。 |
403 | InvalidDiskCategory.NotSupported | The specified disk category is not supported. | 当前操作不支持您指定的磁盘类型。请检查您的输入参数和API文档。 |
403 | OperationDenied | The operation is not allowed. | 当前操作不允许执行。 |
403 | OperationDenied.QuotaExceed | The operation is not allowed due to quota exceed. | 当前操作已超过使用配额。 |
403 | NotOnSale.Region | The specified region is not on sale. | 当前Region停售或无库存。 |
403 | NotOnSale.Zone | The specified zone is not on sale. | 当前Zone停售或无库存。 |
403 | OperationDenied.PairInAnotherGroup | The operation is not allowed because pair is already in another group. | 当前操作不允许执行,因为复制对已被加入另一个一致性组中。 |
403 | OperationDenied.PairNotInGroup | The operation is not allowed because pair is not in any group. | 当前操作不允许执行,因为指定的异步复制对未加入任何一致性组中。 |
403 | OperationDenied.NoPairInGroup | The operation is not allowed because no pair in the group. | 当前操作不允许执行,因为指定的一致性组中没有复制对。 |
403 | OperationDenied.PairsExceedInGroup | The operation is not allowed due to too much pair in the group. | 当前操作不允许执行,因为已超过一致性组可支持的最大复制对数量。 |
403 | OperationDenied.ManualSyncLimit | One shot start manual syncing too frequently, please try again later. | 手动同步冷却时间未满足。 |
403 | OperationDenied.GroupTotalDiskCapacityLimit | Operation failed because of total disk capacity in group over limit. | 复制组中的云盘总容量过大。 |
访问错误中心查看更多错误码。