最近更新时间：2023.07.07 10:54:52
首次发布时间：2022.05.28 07:11:28
调用 ExportImage 接口导出自定义镜像。
导出镜像前，您需要了解前提条件以及注意事项，详细信息请参见导出自定义镜像。
导出任务开始后，您可以前往云服务器控制台查看导出详情或通过DescribeTasks接口查询任务进度。
| 名称 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | ExportImage | 要执行的操作，取值：ExportImage。 |
| Version | String | 是 | 2020-04-01 | 接口的版本，取值：2020-04-01。 |
| ImageId | String | 是 | image-4431h3l7hl31a0****** | 镜像ID。您可以调用DescribeImages接口并传入Visibility=private参数，查询获取自定义镜像ID。 |
| TOSBucket | String | 是 | bucket-1 | 导出镜像文件所在的TOS Bucket名称。您可以调用ListBuckets接口，查询获取TOS桶名称。 |
TOSPrefix | String | 是 | test123 | 自定义导出镜像文件的前缀名，需满足：
|
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| TaskId | String | t-3teco18f1w5a71****** | 导出镜像的任务ID。 |
GET /?Action=ExportImage&Version=2020-04-01&ImageId=image-4431h3l7hl31a0******&TOSBucket=bucket-1&TOSPrefix=test123 HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: ecs
{ "ResponseMetadata":{ "RequestId":"2021110417394001022514606307*****", "Action":"ExportImage", "Version":"2020-04-01", "Service":"ecs", "Region":"cn-beijing" }, "Result": { "TaskId": "t-3teco18f1w5a71******" } }
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | MissingParameter.ImageId | The required parameter ImageId is not supplied. | 镜像ID不能为空。 |
| 400 | MissingParameter.TOSBucket | The required parameter TOSBucket is not supplied. | TOS Bucket不能为空。 |
| 400 | MissingParameter.TOSPrefix | The required parameter TOSPrefix is not supplied. | 导出镜像文件的前缀名不能为空。 |
| 400 | InvalidTOSPrefix.Malformed | The specified TOSPrefix is malformed. | 自定义的文件前缀名不合法。 |
| 400 | InvalidImageStatus | The specified image is not in the correct status for the request. | 当前镜像的状态不支持此操作。 |
| 400 | InvalidImageForExportImage.UnSupported | The specified image cannot be used for ExportImage. | 指定的镜像不支持导出。 |
| 400 | InvalidTosPutObject.AccessDenied | The Action tos:PutObject is not authorized for ecs, please check your IAM policy of ecs. | ECS官方服务账号没有权限访问您指定的对象文件。 |
| 404 | InvalidTOSBucket.NotFound | The specified TOSBucket does not exist. | 指定的TOS Bucket不存在。 |
| 404 | InvalidImage.NotFound | The specified image does not exist. | 指定的镜像不存在。 |
| 412 | OperationDenied.ResourceLocked | The specified operation is denied as your resource is locked for another operation. | 指定的操作被拒绝，因为您的资源已被其他操作锁定。 |