DeleteSnapshotGroup - 删除快照一致性组 - 云服务器 ECS

调用DeleteSnapshotGroup删除指定的实例快照。

接口说明

如果快照一致性组中的云盘快照已经用于创建自定义镜像，则快照一致性组删除时相关的云盘快照不会被删除。您如果需要删除相关的云盘快照，请先删除已创建的自定义镜像（ DeleteImage ），再删除相关的云盘快照（ DeleteSnapshot ）。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
ecs:DeleteSnapshotGroup	delete	*SnapshotGroup `acs:ecs:{#regionId}:{#accountId}:snapshotgroup/{#snapshotgroupId}`	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	快照一致性组所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
SnapshotGroupId	string	是	快照一致性组 ID。您可以调用 DescribeSnapshotGroups 查询快照一致性组 ID。	ssg-j6c9lpuyxo2uxxny****

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	6EDE885A-FDC1-4FAE-BC44-6EACAEA6CC6E
OperationProgressSet	array<object>	删除快照一致性组时操作状态信息合集。
OperationProgress	object
ErrorMsg	string	错误信息。删除成功时返回空值。错误码和错误信息，请参见错误中心。	testErrorMsg
ErrorCode	string	错误码。删除成功时返回空值。错误码和错误信息，请参见错误中心。	400
OperationStatus	string	操作是否成功。成功返回 Success，失败返回 ErrorCode 和 ErrorMsg 信息。	Success
RelatedItemSet	array<object>	资源信息。
RelatedItem	object
Name	string	资源名称。	SnapshotId
Value	string	资源 ID。	s-j6c9lpuyxo2uxxnx****

示例

正常返回示例

JSON格式

{
  "RequestId": "6EDE885A-FDC1-4FAE-BC44-6EACAEA6CC6E",
  "OperationProgressSet": {
    "OperationProgress": [
      {
        "ErrorMsg": "testErrorMsg",
        "ErrorCode": "400",
        "OperationStatus": "Success",
        "RelatedItemSet": {
          "RelatedItem": [
            {
              "Name": "SnapshotId",
              "Value": "s-j6c9lpuyxo2uxxnx****"
            }
          ]
        }
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
403	SnapshotCreatedImage	The snapshot has been used to create user defined image(s).	如果快照已经被用于创建自定义镜像，将不能执行删除操作。您需要先删除已创建的自定义镜像（DeleteImage），才能继续删除快照。
403	Operation.Forbidden	The operation is not permitted.	该操作是不被允许的。
403	SnapshotCreatedDisk	The snapshot that you are trying to delete is in use by one or more Disks.	您当前试图删除的快照已被用于创建一个或者多个磁盘。
403	InvalidOperation.ResourceManagedByCloudProduct	The current operation is not supported because the resource is managed by a cloud product. Please contact the relevant cloud product to confirm the reason.	此次操作不支持因为资源被云产品托管。请联系对应的云产品确认原因。
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	提供的RegionId不存在
404	InvalidSnapshotGroup.NotFound	The SnapshotGroupId provided does not exist in our records.	-

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2024-11-27	OpenAPI 描述信息更新、OpenAPI 去除了 deprecated 标记、OpenAPI 错误码发生变更	查看变更详情