# 创建镜像快照 - CreateV2TenantImageSnapshot #### 功能介绍 为指定镜像版本创建快照。此接口为异步接口，一个镜像版本最多创建一个快照，创建后状态为Creating，可通过[查询镜像快照列表](https://support.huaweicloud.com/api-aidatalake/ListV2TenantImageSnapshots.html)获得镜像快照创建结果。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-aidatalake/aidatalake_02_0003.html)。 #### URI POST /v2/images/{image_id}/versions/{version_id}/image-snapshots 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | image_id | 是 | String | **参数解释** ：镜像ID。可通过[查询自定义镜像列表](https://support.huaweicloud.com/api-aidatalake/ListV2TenantImages.html)获取镜像ID。 **约束限制**：不涉及。 **取值范围**：长度为32\~36的英文字符、数字和中划线的组合。 **默认取值**：不涉及。 | | version_id | 是 | String | **参数解释** ：镜像版本ID。可通过[查询自定义镜像版本列表](https://support.huaweicloud.com/api-aidatalake/ListV2TenantImageVersions.html)获取镜像版本ID。 **约束限制**：不涉及。 **取值范围**：长度为32\~36的英文字符、数字和中划线的组合。 **默认取值**：不涉及。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释** ：用户Token，通过调用[获取IAM用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取。 **约束限制**：不涉及。 **取值范围**：只能由英文字母、数字及特殊字符组成，长度不超过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 } ``` #### 响应示例 **状态码：200** ``` { "id" : "1a2b3c4d-5e6f-7890-abcd-1e2f3a4b5c6d", "image_id" : "1a2b3c4d-5e6f-7890-abcd-1e2f3a4b5c6d", "image_version_id" : "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d", "name" : "my-snapshot", "image_address" : "swr.example.com/ns/my-image:v1.0", "image_name" : "my-image", "image_version" : "v1.0", "status" : "Creating", "image_snapshot_size" : 60, "creation_mode" : "Created", "reserved_days" : 30, "expire_time" : "2026-09-25T10:00:00.000+00:00", "failed_message" : "", "create_time" : "2026-08-26T10:00:00.000+00:00", "update_time" : "2026-08-26T10:00:00.000+00:00" } ``` **状态码：400** ``` { "error_code" : "AIDataLake.00010151", "error_msg" : "Parameter value is invalid.", "solution_msg" : "Please input valid parameter value." } ``` **状态码：401** ``` { "error_code" : "APIGW.0301", "error_msg" : "Incorrect IAM authentication information: decrypt token fail.", "solution_msg" : "Check whether the IAM authentication information is correct." } ``` **状态码：403** ``` { "error_code" : "AIDataLake.00010150", "error_msg" : "The operation is not allowed.", "solution_msg" : "Check whether the operation is allowed in the current status." } ``` **状态码：404** ``` { "error_code" : "AIDataLake.00010411", "error_msg" : "Image version not found, image ID: b9e48f42-26ba-4be9-b6f0-9de1b048c053, version ID: cb46a24c-b5ec-4134-9f03-195477bdfe03.", "solution_msg" : "Please check whether the image ID and version ID are correct or exist in SWR." } ``` **状态码：500** ``` { "error_code" : "AIDataLake.00011001", "error_msg" : "Internal error.", "solution_msg" : "Contact technical support or try again later." } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 请求成功。 | | 400 | 请求参数错误。 | | 401 | 未授权。 | | 403 | 禁止访问。 | | 404 | 资源未找到。 | | 500 | 内部服务器错误。 |