调用CreateSnapshotGroup接口创建快照一致性组。 ## 注意事项单个云盘的手动快照数量限制为256，快照一致性组快照和其他手动快照总数大于256后，将无法创建新的快照。 ## 调试 ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** string %%require%% `示例值：CreateSnapshotGroup` 要执行的操作，取值：CreateSnapshotGroup。 **Version** string %%require%% `示例值：2020-04-01` API的版本，取值：2020\-04\-01。 **ProjectName** string `可选` `示例值：default` 快照一致性组所要加入的项目名称。 :::tip 如果您在创建快照一致性组时未设置ProjectName，则快照一致性组默认加入default项目。 ::: **VolumeIds.N** string[] %%require%% `示例值：vol-bp1s5fnvk4gn2tws0****` 云盘ID，说明如下： * 该云盘必须处于“已挂载”状态。 * 如果设置多个云盘，则这些云盘需要挂载在同一个ECS实例。 :::tip N表示云盘ID的序号，多个云盘ID之间用&分隔，取值范围为1～16。 ::: **InstanceId** string `可选` `示例值：i-ycwyd2mvpcs6iplj****` 挂载云盘的对应ECS实例ID。 **Name** string `可选` `示例值：testName` 快照一致性组的名称，说明如下： * 只能以中文、字母或下划线（_）开头。 * 只能包含中文、字母、数字、下划线（_）、中划线（\-）和英文句号（.）。 * 长度限制为1 ~ 128个字符。如果没有设置该参数，则在控制台上快照一致性组的名称默认为\-。 **Description** string `可选` `示例值：testDescription` 快照一致性组的描述，说明如下： * 只能以中文、字母或下划线（_）开头。 * 只能包含中文、字母、数字、下划线（_）、中划线（\-）和英文句号号（.）。 * 长度限制为1 ~ 255个字符。 **ClientToken** string `可选` `示例值：123e4567-e89b-12d3-a456-42665544****` 保证请求幂等性。该字符串由您的客户端生成，用以保证不同请求之间的唯一性。说明如下： * 大小写敏感。 * 不超过64个ASCII字符。 **Tags.N.Key** string[] `可选` `示例值：testKey` 快照一致性组的标签键。 * Tags.N.Key：N表示标签键的序号。取值范围：1～20。 * 多个标签键之间用&分隔。 **Tags.N.Value** string[] `可选` `示例值：testValue` 快照一致性组的标签值。 * Tags.N.Value：N表示标签值的序号。取值范围：1～20。 * 多个标签值之间用&分隔。 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **SnapshotGroupId** string `示例值：sg-3tigy72q3u3vj0x2****` 快照一致性组 ID。 ## 请求示例 ```text POST /?Action=CreateSnapshotGroup&Version=2020-04-01&VolumeIds.1=vol-bp1s5fnvk4gn2tws0**** HTTP/1.1 Host: open.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20251124T085453Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251124/cn-beijing/storage_ebs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f {} ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "2025112416545610721709005398D888", "Action": "CreateSnapshotGroup", "Version": "2020-04-01", "Service": "storage_ebs", "Region": "cn-beijing" }, "Result": { "SnapshotGroupId": "sg-3tigy72q3u3vj0x2****" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |SnapshotGroupVolumeCountExceed |The number of volumes in the snapshot consistency group exceeds the upper limit. |快照一致性组云盘数超过上限。 | |400 |SnapshotGroupInvalidAttachStatus |The state of the volume attached to the snapshot consistency group is abnormal. |快照一致性组云盘挂载状态异常。 | |400 |SnapshotGroupWithDiffInstances |The snapshot consistency group mount instance is not unique. |快照一致性组挂载实例不唯一。 | |400 |SnapshotGroupTotalSizeExceed |The snapshot consistency group exceeds the maximum capacity. |该快照一致性组超过最大容量。 | |400 |SnapshotGroupInvalidVolumeCount |The number of volumes in the snapshot consistency group is invalid. |快照一致性组云盘数量非法。 | |404 |MissingParameter.VolumeIds |The specified parameter volumeIds is missing. |缺少VolumeIds参数。 |

云服务器