调用DescribeRegions接口查询网络型负载均衡实例的可用地域。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeRegions |
系统规定参数。取值:DescribeRegions。 |
ServiceCode | String | 否 | nlb |
云产品的ServiceCode,仅取值:nlb。 |
AcceptLanguage | String | 否 | en-US |
支持的语言。取值:
|
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 |
客户端Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。 说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | CEF72CEB-54B6-4AE8-B225-F876FF7BA984 |
请求ID。 |
Regions | Array of Region |
地域列表。 |
|
LocalName | String | 华东1(杭州) |
地域名称。 |
RegionEndpoint | String | nlb.cn-hangzhou.aliyuncs.com |
地域服务的Endpoint地址。 |
RegionId | String | cn-hangzhou |
地域ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeRegions
&ServiceCode=200
&AcceptLanguage=zh-CN
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeRegionsResponse>
<RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
<Regions>
<LocalName>华东1(杭州)</LocalName>
<RegionEndpoint>nlb.cn-hangzhou.aliyuncs.com</RegionEndpoint>
<RegionId>cn-hangzhou</RegionId>
</Regions>
</DescribeRegionsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
"Regions" : [ {
"LocalName" : "华东1(杭州)",
"RegionEndpoint" : "nlb.cn-hangzhou.aliyuncs.com",
"RegionId" : "cn-hangzhou"
} ]
}
错误码
访问错误中心查看更多错误码。