文档

DeleteSnapshotGroup - 删除快照分组

更新时间:

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

接口说明

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecs:DeleteSnapshotGroupdelete
  • SnapshotGroup
    acs:ecs:{#regionId}:{#accountId}:snapshotgroup/{#snapshotgroupId}

请求参数

名称类型必填描述示例值
RegionIdstring

实例快照所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
SnapshotGroupIdstring

快照一致性组 ID。您可以调用 DescribeSnapshotGroups 查询快照一致性组 ID。

ssg-j6c9lpuyxo2uxxny****

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

6EDE885A-FDC1-4FAE-BC44-6EACAEA6CC6E
OperationProgressSetarray<object>

删除实例快照时操作状态信息合集。

OperationProgressobject
ErrorMsgstring

错误信息。删除成功时返回空值。

错误码和错误信息,请参见错误中心

testErrorMsg
ErrorCodestring

错误码。删除成功时返回空值。

错误码和错误信息,请参见错误中心

400
OperationStatusstring

操作是否成功。成功返回 Success,失败返回 ErrorCode 和 ErrorMsg 信息。

Success
RelatedItemSetarray<object>

资源信息。

RelatedItemobject
Namestring

资源名称。

SnapshotId
Valuestring

资源 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错误码错误信息描述
403SnapshotCreatedImageThe snapshot has been used to create user defined image(s).如果快照已经被用于创建自定义镜像,将不能执行删除操作。您需要先删除已创建的自定义镜像(DeleteImage),才能继续删除快照。
403Operation.ForbiddenThe operation is not permitted.该操作是不被允许的。
403SnapshotCreatedDiskThe snapshot that you are trying to delete is in use by one or more Disks.您当前试图删除的快照已被用于创建一个或者多个磁盘。
404InvalidRegionId.NotFoundThe RegionId provided does not exist in our records.提供的RegionId不存在
404InvalidSnapshotGroup.NotFoundThe SnapshotGroupId provided does not exist in our records.-

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

变更历史

变更时间变更内容概要操作
暂无变更历史