修改快照类型,可以通过该接口将标准快照转换为归档快照。
接口说明
请确保在使用该接口前，已充分了解归档快照产品的收费方式和价格。
-
归档快照不支持还原为标准快照。
-
标准快照创建完成之后，必须至少已保留 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 | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 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. | 指定的快照不存在，请您检查快照是否正确。 |
访问错误中心查看更多错误码。