修改快照类型,可以通过该接口将标准快照转换为归档快照。
接口说明
请确保在使用该接口前,已充分了解归档快照产品的收费方式和价格。
-
归档快照不支持还原为标准快照。
-
标准快照创建完成之后,必须至少已保留 14 天,才能进行归档。
-
加密快照暂不支持归档。
-
共享来的快照、云产品托管的快照、云盒内的快照不支持归档。
-
目前仅华北 5(呼和浩特)和马来西亚(吉隆坡)地域支持归档快照功能。其他地域请关注后续功能变更通知。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用前面加 * 表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
ecs:ModifySnapshotCategory | update | *Snapshot acs:ecs:{#regionId}:{#accountId}:snapshot/{#snapshotId} |
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
SnapshotId | string | 是 | 快照 ID。 | s-123**sd |
Category | string | 否 | 快照类型。
| Archive |
RetentionDays | integer | 否 | 快照保留天数。起始时间为快照资源创建时间 CreationTime。 归档类型快照有保留时间限制,需要在归档类型中至少保留 60 天。不足 60 天删除归档快照会收取 60 天的归档存储费用,请参见快照计费。 取值范围[60,65536]
不填写该参数则表示永久保留。
| 60 |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "B48A12CD-1295-4A38-A8F0-0E92C937****",
"TaskId": "t-dxh34xds**d"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidRetentionDays.Malformed | The specified RetentionDays is not valid. | 指定的保留天数无效。请检查 RetentionDays 参数值是否正确。 |
400 | InvalidOperation.DecreaseRetentionDaysUnsupported | The requested operation to decrease retention days for the snapshot is not supported. | 不支持缩短快照保留天数。 |
400 | InvalidSnapshotId.NotReady | The specified snapshot has not completed yet. | 指定的快照未完成。 |
400 | InvalidOperation.ArchiveSharedSnapshotUnsupported | The specified shared snapshot is not support archive. | 来源为共享的快照无法进行归档。 |
400 | InvalidOperation.ArchiveCloudBoxSnapshotUnsupported | The specified snapshot in CloudBox is not support archive. | 存储在云盒的快照不支持归档。 |
400 | InvalidStatus.SnapshotUnfinished | The specified unfinished snapshot is not support archive. | 未完成的快照不支持归档。 |
400 | InvalidStatus.SnapshotAgeLimit | The specified snapshot created within 14 days is not support archive. | 创建时间不足14天的快照不支持归档。 |
400 | InvalidStatus.SnapshotInArchive | The specified snapshot is currently being archived. | 指定快照正在归档中。 |
400 | InvalidParameter.SnapshotCategory | The specified parameter category is invalid. | 指定参数category无效 |
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. | 此次操作不支持因为资源被云产品托管。请联系对应的云产品确认原因。 |
403 | InvalidOperation.InstantAccessEnabledUnsupport | The specified snapshot with legacy Instant Access enabled does not support archive. | 启用了旧版极速可用的快照不支持归档 |
403 | InvalidOperation.EncryptedSnapshotUnsupport | Archiving encrypted snapshots is not currently supported. | 暂不支持归档加密快照 |
404 | InvalidSnapshotId.NotFound | The specified SnapshotId does not exist. | 指定的快照不存在,请您检查快照是否正确。 |
访问错误中心查看更多错误码。