ModifySnapshotCategory - 修改快照类型

更新时间:2025-02-19 03:10:27

修改快照类型,可以通过该接口将标准快照转换为归档快照。

接口说明

请确保在使用该接口前,已充分了解归档快照产品的收费方式和价格

  • 归档快照不支持还原为标准快照。

  • 标准快照创建完成之后,必须至少已保留 14 天,才能进行归档。

  • 加密快照暂不支持归档。

  • 共享来的快照、云产品托管的快照、云盒内的快照不支持归档。

  • 目前仅华北 5(呼和浩特)和马来西亚(吉隆坡)地域支持归档快照功能。其他地域请关注后续功能变更通知。

调试

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

授权信息

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

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

请求参数

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

快照 ID。

s-123**sd
Categorystring

快照类型。

  • Archive:归档快照
Archive
RetentionDaysinteger

快照保留天数。起始时间为快照资源创建时间 CreationTime。 归档类型快照有保留时间限制,需要在归档类型中至少保留 60 天。不足 60 天删除归档快照会收取 60 天的归档存储费用,请参见快照计费

取值范围[60,65536]

说明
不填写该参数则表示永久保留。
60

返回参数

名称类型描述示例值
名称类型描述示例值
object
RequestIdstring

请求 ID。

B48A12CD-1295-4A38-A8F0-0E92C937****
TaskIdstring

归档任务 ID。您可以通过 DescribeTasks 接口查询任务的状态、进度。

t-dxh34xds**d

示例

正常返回示例

JSON格式

{
  "RequestId": "B48A12CD-1295-4A38-A8F0-0E92C937****",
  "TaskId": "t-dxh34xds**d"
}

错误码

HTTP status code错误码错误信息描述
HTTP status code错误码错误信息描述
400InvalidRetentionDays.MalformedThe specified RetentionDays is not valid.指定的保留天数无效。请检查 RetentionDays 参数值是否正确。
400InvalidOperation.DecreaseRetentionDaysUnsupportedThe requested operation to decrease retention days for the snapshot is not supported.不支持缩短快照保留天数。
400InvalidSnapshotId.NotReadyThe specified snapshot has not completed yet.指定的快照未完成。
400InvalidOperation.ArchiveSharedSnapshotUnsupportedThe specified shared snapshot is not support archive.来源为共享的快照无法进行归档。
400InvalidOperation.ArchiveCloudBoxSnapshotUnsupportedThe specified snapshot in CloudBox is not support archive.存储在云盒的快照不支持归档。
400InvalidStatus.SnapshotUnfinishedThe specified unfinished snapshot is not support archive.未完成的快照不支持归档。
400InvalidStatus.SnapshotAgeLimitThe specified snapshot created within 14 days is not support archive.创建时间不足14天的快照不支持归档。
400InvalidStatus.SnapshotInArchiveThe specified snapshot is currently being archived.指定快照正在归档中。
400InvalidParameter.SnapshotCategoryThe specified parameter category is invalid.指定参数category无效
403InvalidOperation.ResourceManagedByCloudProductThe current operation is not supported because the resource is managed by a cloud product. Please contact the relevant cloud product to confirm the reason.此次操作不支持因为资源被云产品托管。请联系对应的云产品确认原因。
403InvalidOperation.InstantAccessEnabledUnsupportThe specified snapshot with legacy Instant Access enabled does not support archive.启用了旧版极速可用的快照不支持归档
403InvalidOperation.EncryptedSnapshotUnsupportArchiving encrypted snapshots is not currently supported.暂不支持归档加密快照
404InvalidSnapshotId.NotFoundThe specified SnapshotId does not exist.指定的快照不存在,请您检查快照是否正确。

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

  • 本页导读 (1)
  • 接口说明
  • 调试
  • 授权信息
  • 请求参数
  • 返回参数
  • 示例
  • 错误码
AI助理

点击开启售前

在线咨询服务

你好,我是AI助理

可以解答问题、推荐解决方案等