调用CreatePlacementGroup创建存储放置组。

使用说明

存储放置组指定了该组所在可用区和存储子放置组的数量。您可以在创建云盘时绑定存储放置组，并指定存储子放置组的编号，系统会根据集群健康程度、水位等指标，将不同子放置组编号的云盘部署在不同集群，实现数据隔离和保护。

存储放置组（PlacementGroup）：用于设置存储子放置组数量，1个存储放置组下可以设置多个存储子放置组，最多可以设置 10 个存储子放置组。

存储子放置组（SubGroup）：每个存储子放置组会映射到一个集群或多个集群。创建云盘时会根据存储放置组和存储子放置组编号（如果传入）在对应集群内进行创盘。如果存储子放置组的数量小于集群的数量，同时某个集群的水位高，则云盘会调度到其他集群中进行创建，即一个存储子放置组会映射到多个集群。

注意事项

在线上资源缩容、机器维修的场景下，存储放置组所属可用区的集群数量会变少。如果用户指定的存储子放置组的数量超过了集群数量，在集群资源不足的情况下 ECS 会优先保障创盘成功，导致有可能存在云盘创建成功，但是反亲和未生效的现象。

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：CreatePlacementGroup

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

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

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

Name string 必选示例值：test-pg

存储放置组名称，说明如下：

首字符仅支持中文、字母或下划线（_）。

可包含中文、字母、数字、下划线（_）或中划线（-）或点(.)。

长度限制为1~128字符。

Description string 可选示例值：testDescription

存储放置组的描述信息，默认为空，说明如下：

首字符仅支持中文、字母或下划线（_）。

可包含中文、字母、数字、下划线（_）或中划线（-）或点（.）。

长度限制为1~128字符。

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

存储放置组所属可用区。

说明

存储放置组的可用区必须位于请求的地域内。

SubgroupCount integer 必选示例值：2

存储子放置组的个数，最小为2，最大为min{可用区集群数量, 10}。

说明

如果某个可用区集群的数量少于SubgroupCount值时，则报错SubGroupCountExceedClusters，并返回当前实际可用区集群数量。

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

AutoAssign boolean 可选示例值：true

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

true：开启自动分配功能。

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

默认为false。

说明

如果开启自动分配功能，同时在创建云盘时设置了SubgroupNumber参数，将为云盘自动分配存储子放置组，SubgroupNumber参数则无效。

返回参数

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

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

存储放置组ID。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	SubGroupCountExceedClusters	The subgroup count exceeds the cluster count for the placement group, with a maximum of {{param}}.	反亲和组数量超过集群数，最高为 {{param}}。

云服务器