调用DeleteSnapshotGroup删除指定的实例快照_云服务器 ECS-阿里云帮助中心

接口说明

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

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DeleteSnapshotGroup	系统规定参数。取值：DeleteSnapshotGroup。
RegionId	String	是	cn-hangzhou	实例快照所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。
SnapshotGroupId	String	是	ssg-j6c9lpuyxo2uxxny****	快照一致性组ID。您可以调用DescribeSnapshotGroups查询快照一致性组ID。

返回数据


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

示例

请求示例

https://ecs.aliyuncs.com/?Action=DeleteSnapshotGroup
&RegionId=cn-hangzhou
&SnapshotGroupId=ssg-j6c9lpuyxo2uxxny****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteSnapshotGroupResponse>
    <RequestId>6EDE885A-FDC1-4FAE-BC44-6EACAEA6CC6E</RequestId>
    <OperationProgressSet>
        <OperationProgress>
            <OperationStatus>Success</OperationStatus>
            <ErrorMsg/>
            <RelatedItemSet>
                <RelatedItem>
                    <Value>s-j6c9lpuyxo2uxxnx****</Value>
                    <Name>SnapshotId</Name>
                </RelatedItem>
            </RelatedItemSet>
            <ErrorCode/>
        </OperationProgress>
        <OperationProgress>
            <OperationStatus>Success</OperationStatus>
            <ErrorMsg/>
            <RelatedItemSet>
                <RelatedItem>
                    <Value>s-j6c9lpuyxo2uxxnx****</Value>
                    <Name>SnapshotId</Name>
                </RelatedItem>
            </RelatedItemSet>
            <ErrorCode/>
        </OperationProgress>
    </OperationProgressSet>
</DeleteSnapshotGroupResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码


HttpCode	错误码	错误信息	描述
403	SnapshotCreatedImage	The snapshot has been used to create user defined image(s).	如果快照已经被用于创建自定义镜像，将不能执行删除操作。您需要先删除已创建的自定义镜像（DeleteImage），才能继续删除快照。
403	Operation.Forbidden	The operation is not permitted.	该操作是不被允许的。

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