文档首页/ 弹性云服务器 ECS/ API参考/ API/ 规格管理/ 查询规格推荐可用区 - PreferAvailableZone
更新时间：2026-07-06 GMT+08:00
查看PDF
分享

查询规格推荐可用区 - PreferAvailableZone

功能介绍

查询规格的推荐可用区。

接口约束

该接口通过查询规格的推荐可用区，不考虑由反亲和性和故障域等云服务器组策略导致的变化。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

ecs:cloudServerFlavors:get

read

-

-

-

-

URI

GET /v1/{project_id}/cloudservers/flavors/{flavor_id}/resources

参数说明请参见表1。
表1 参数说明

参数

是否必选

描述

project_id

是

参数解释：

项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

flavor_id

是

参数解释：

规格ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

请求消息

请求参数如表2所示。

表2 请求参数

参数

是否必选

参数类型

描述

region_ids

否

String

参数解释：

待查询规格所在Region列表，不同Region ID使用逗号隔开。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

响应消息

响应参数如表3所示。

表3 响应参数

参数

参数类型

描述

resources

Array of objects

参数解释：

规格推荐可用区列表，详情请参见表4。

取值范围：

不涉及
表4 resources参数信息

参数

参数类型

描述

region_id

String

参数解释：

规格所属区域ID。

取值范围：

不涉及

availability_zone

String

参数解释：

规格所属可用区。

取值范围：

不涉及

prefer

Boolean

参数解释：

当前可用区是否为规格的推荐可用区。

取值范围：

  • true: 是，表示是该规格的推荐可用区。
  • false: 不是，表示不是该规格的推荐可用区。

请求示例

查询规格推荐可用区。

GET https://{endpoint}/v1/{project_id}/cloudservers/flavors/{flavor_id}/resources

响应示例

{
	"resources": [{
		"region_id": "region_01",
		"availability_zone": "az1",
		"prefer": false
	}]
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 规格管理

相关文档