文档中心

云服务器

存储放置组

DescribePlacementGroups - 查询放置组

DescribePlacementGroups - 查询放置组

调用DescribePlacementGroups接口查询存储放置组的信息。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DescribePlacementGroups

要执行的操作，取值：DescribePlacementGroups。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

ZoneId string 可选示例值：cn-beijing-a

存储放置组所属可用区。

Ids.N string[] 可选示例值：pg-bp67acfmxazb4ph****

存储放置组ID。

Name string 可选示例值：test-pg

存储放置组名称，支持模糊查询。

PageNumber integer 可选示例值：1

起始页码，默认为1。

PageSize integer 可选示例值：15

页大小，最大100，默认为15。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

PlacementGroups object[] 示例值：-

存储放置组信息。

Id string 示例值：pg-bp67acfmxazb4ph****

存储放置组ID。

Name string 示例值：test-pg

存储放置组名称

Description string 示例值：testDescription

存储放置组描述信息。

ZoneId string 示例值：cn-beijing-a

存储放置组所属可用区。

SubgroupCount integer 示例值：2

存储子放置组的数量。

说明

系统会自动按照数字顺序为存储子放置组进行编号，编号最小值为1，最大值为存储子放置组的个数。

AutoAssign boolean 示例值：true

是否开启为云盘自动分配存储子放置组功能，开启后，在创建云盘时绑定存储放置组，并开启自动分配存储子放置组功能后，将为云盘自动分配存储子放置组。取值说明如下：

true：开启自动分配功能。

false：不开启自动分配功能。

CreatedAt string 示例值：2023-07-05T15:48:58+08:00

存储放置组创建时间。

UpdatedAt string 示例值：2023-07-05T15:48:58+08:00

存储放置组更新时间。

PageNumber integer 示例值：1

页数。

PageSize integer 示例值：100

每页大小。

TotalCount integer 示例值：3

存储放置组的数量。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
500	ErrUnknown	unknown error	未知错误。

最近更新时间：2026.01.09 15:37:00

这个页面对您有帮助吗？

有用

有用

无用

无用