文档中心

云服务器

请输入

快照一致性组

CreateSnapshotGroup - 创建快照一致性组

调用CreateSnapshotGroup接口创建快照一致性组。

注意事项

单个云盘的手动快照数量限制为256，快照一致性组快照和其他手动快照总数大于256后，将无法创建新的快照。

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：CreateSnapshotGroup

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

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

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

ProjectName string 可选示例值：default

快照一致性组所要加入的项目名称。

说明

如果您在创建快照一致性组时未设置ProjectName，则快照一致性组默认加入default项目。

VolumeIds.N string[] 必选示例值：vol-bp1s5fnvk4gn2tws0****

云盘ID，说明如下：

该云盘必须处于“已挂载”状态。

如果设置多个云盘，则这些云盘需要挂载在同一个ECS实例。

说明

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。

多个标签值之间用&分隔。

返回参数

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

SnapshotGroupId string 示例值：sg-3tigy72q3u3vj0x2****

快照一致性组 ID。

请求示例

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​
​
{}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "2025112416545610721709005398****",​
    "Action": "CreateSnapshotGroup",​
    "Version": "2020-04-01",​
    "Service": "storage_ebs",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "SnapshotGroupId": "sg-3tigy72q3u3vj0x2****"​
  }​
}​

错误码

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

状态码	错误码	错误信息	说明
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.	快照一致性组云盘数量非法。
400	ErrorAccountIsOverdue	Account is in arrears, and some snapshot features are unavailable.	账号已欠费，快照部分功能不可用。
400	VolumeInCreatingSnapshot	The operation is not permitted due to the volume is creating a snapshot.	指定的云盘有正在创建的快照。
404	MissingParameter.VolumeIds	The specified parameter volumeIds is missing.	缺少VolumeIds参数。

最近更新时间：2026.01.08 11:19:59

这个页面对您有帮助吗？

有用

无用