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

接口说明

如果实例快照中的云盘快照已经用于创建自定义镜像,则实例快照删除时相关的云盘快照不会被删除。您如果需要删除相关的云盘快照,请先删除已创建的自定义镜像(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. 该操作是不被允许的。

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