文档首页/ 智能数据湖 AI DataLake/ API参考/ 镜像快照管理/ 创建镜像快照 - CreateV2TenantImageSnapshot

更新时间：2026-10-19 GMT+08:00

创建镜像快照 - CreateV2TenantImageSnapshot

功能介绍

为指定镜像版本创建快照。此接口为异步接口，一个镜像版本最多创建一个快照，创建后状态为Creating，可通过查询镜像快照列表获得镜像快照创建结果。

调用方法

URI

POST /v2/images/{image_id}/versions/{version_id}/image-snapshots

表1 路径参数
参数	是否必选	参数类型	描述
image_id	是	String	参数解释：镜像ID。可通过查询自定义镜像列表获取镜像ID。约束限制：不涉及。取值范围：长度为32~36的英文字符、数字和中划线的组合。默认取值：不涉及。
version_id	是	String	参数解释：镜像版本ID。可通过查询自定义镜像版本列表获取镜像版本ID。约束限制：不涉及。取值范围：长度为32~36的英文字符、数字和中划线的组合。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token，通过调用获取IAM用户Token接口获取。约束限制：不涉及。取值范围：只能由英文字母、数字及特殊字符组成，长度不超过65534个字符。Token格式由IAM服务定义，具体字符集参见IAM服务相关文档。默认取值：不涉及。

表3 请求Body参数
参数	是否必选	参数类型	描述
name	是	String	参数解释：快照名称（用户指定，用于标识快照用途）。约束限制：不涉及。取值范围：以小写字母开头，小写字母、数字、中划线（-）组成，小写字母或数字结尾的1到190字符的字符串。默认取值：不涉及。
image_snapshot_size	否	Integer	参数解释：快照大小，单位GiB。约束限制：不涉及。取值范围：20~400。默认取值：不传则基于镜像大小的3倍自动估算。
reserved_days	否	Integer	参数解释：镜像快照保留天数。超过保留天数自动失效，0表示永久保留。约束限制：不涉及。取值范围：0~65536天。默认取值：0。

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
id	String	参数解释：镜像快照记录ID。取值范围：长度为32~36的英文字符、数字和中划线的组合。
image_id	String	参数解释：镜像ID。取值范围：长度为32~36的英文字符、数字和中划线的组合。
image_version_id	String	参数解释：镜像版本ID。取值范围：长度为32~36的英文字符、数字和中划线的组合。
name	String	参数解释：镜像快照名称（用户指定）。取值范围：以小写字母开头，小写字母、数字、中划线（-）组成，小写字母或数字结尾的1到190字符的字符串。
image_address	String	参数解释：镜像完整地址（含registry/namespace/name:version）。取值范围：支持英文字母、数字、小数点、冒号、斜杠及连字符，长度为0~1024个字符。
image_name	String	参数解释：镜像名称。取值范围：支持英文字母、数字、小数点、斜杠、冒号、下划线和连字符，长度为0~128个字符。
image_version	String	参数解释：镜像版本。取值范围：支持英文字母、数字、小数点、冒号、下划线和连字符，长度为0~1024个字符。
status	String	参数解释：镜像快照状态。取值范围： Creating：创建中。 Available：可用。 Unavailable：不可用。
image_snapshot_size	Integer	参数解释：快照大小，单位GiB。取值范围：20~400。
creation_mode	String	参数解释：创建方式。取值范围： Created：直接创建。 Associated：关联CCI已有快照。
reserved_days	Integer	参数解释：镜像快照保留天数。超过保留天数自动失效，0表示永久保留。取值范围：0~65536。
expire_time	String	参数解释：镜像快照超期时间，null表示永久有效。使用UTC时间，ISO 8601格式，yyyy-MM-dd'T'HH:mm:ss.SSSXXX，例如：2025-01-10T03:37:12.000+00:00。取值范围：不涉及。
failed_message	String	参数解释：镜像快照失效的提示信息。取值范围：支持中文字符、英文字母、数字及常用符号，长度为0~65535个字符。
create_time	String	参数解释：创建时间，使用UTC时间，ISO 8601格式，yyyy-MM-dd'T'HH:mm:ss.SSSXXX，例如：2025-01-10T03:37:12.000+00:00。取值范围：不涉及。
update_time	String	参数解释：更新时间，使用UTC时间，ISO 8601格式，yyyy-MM-dd'T'HH:mm:ss.SSSXXX，例如：2025-01-10T03:37:12.000+00:00。取值范围：不涉及。

状态码：400

表5 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：401

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：403

表7 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：404

表8 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：500

表9 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

请求示例

为指定镜像版本创建名称为"my-snapshot"的快照，快照大小60GiB，保留30天。

POST /v2/images/1a2b3c4d-5e6f-7890-abcd-1e2f3a4b5c6d/versions/7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d/image-snapshots

{
  "name" : "my-snapshot",
  "image_snapshot_size" : 60,
  "reserved_days" : 30
}

响应示例