You need to enable JavaScript to run this app.
文档中心
云服务器

云服务器

请输入
  • 文档首页
    • 云服务器云服务器ECSAPI参考地域DescribeRegions - 查询地域列表
复制全文
下载 pdf
我的收藏
地域
DescribeRegions - 查询地域列表
复制全文
下载 pdf
我的收藏
DescribeRegions - 查询地域列表
调用 DescribeRegions 接口查询地域信息。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值：DescribeRegions​
要执行的操作，取值：DescribeRegions。​
​
Version string 必选 示例值：2020-04-01​
API的版本，取值：2020-04-01。​
​
MaxResults integer 可选 示例值：10​
分页查询时设置的每页行数。​
  • 最大值：20​
  • 最小值：1​
  • 默认值：10​
​
NextToken string 可选 示例值：--​
分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。​
​
RegionIds.N string[] 可选 示例值：RegionIds.1=cn-beijing​
地域ID，最多支持20个ID。​
  • 参数 - N：表示地域ID的序号。​
  • 多个RegionId之间用&分隔。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
NextToken string 示例值：bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******​
本次调用返回的查询凭证值，返回为空表示该页为末页。​
​
Regions object[] 示例值：--​
符合条件的地域信息。​
RegionId string 示例值：cn-beijing​
地域ID。​
​
​
​
​
请求示例​
​
GET /?Action=DescribeRegions&Version=2020-04-01 HTTP/1.1​
Host: ecs.cn-beijing.volcengineapi.com​
Region: cn-beijing​
Service: ecs​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202106111445100102252431000052****",​
"Action": "DescribeRegions",​
"Version": "2020-04-01",​
"Service": "ecs",​
"Region": "cn-beijing"​
},​
"Result": {​
"NextToken": "eWJwMHd3MzE2dmVwMjkyMnk******",​
"Regions": [​
{​
"RegionId": "cn-beijing"​
}​
]​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
LimitExceeded.MaximumRegionIds​
The number of specified RegionIds exceeds the maximum limit.​
指定的RegionIds超过最大限制。​
400​
InvalidArgument​
The specified argument is invalid.​
指定的参数不合法。​
429​
FlowLimitExceeded​
You've reach the limit on request rate of resources.​
您已超过资源请求限速。​
500​
InternalError​
An internal error has occurred.​
内部错误，请重试。如果多次尝试失败，请提交工单。​
​
​
最近更新时间：2025.09.04 16:59:41
这个页面对您有帮助吗？
有用
有用
无用
无用