接口功能介绍

使用指定的云主机数据盘来创建一份私有镜像。

接口约束

接口请求成功需至少满足：
1. 可创建的私有镜像数量未达上限。
2. 要创建的镜像的名称不能与以下名称重复：
- 已有的私有镜像的名称（可使用查询可以使用的镜像资源接口来查询您可使用的镜像资源）；
- 处于 pending 任务状态的创建私有镜像（镜像文件）任务的镜像名称（可使用查询创建私有镜像（镜像文件）任务列表接口来查询使用镜像文件来创建私有镜像的任务列表）。
3. 在创建镜像前，所指定的云主机应处于关机状态。可使用查询一台或多台云主机详细信息接口来查询您的云主机的详细信息。
4. 在创建镜像过程中，请勿对所指定的云主机及相关联资源进行其他操作。

URI

POST /v4/image/create-from-data-disk

路径参数
无

Query参数
无

请求参数

请求头header参数
无

请求体body参数

响应参数

表 returnObj

表 image

枚举参数

无

请求示例

请求url

无

请求头header

无

请求体body

{
  "dataDiskID": "8888a888-b888-8888-a888-baee8d8ce88c",
  "imageName": "CentOS-test",
  "instanceID": "88f888ea-88ff-88ec-a8bc-888888888fe8",
  "regionID": "88f8888888dd88ec888888888d888d8b",
  "description": "Test CentOS",
  "projectID": "0"
}

响应示例

{
  "statusCode": 800,
  "errorCode": "",
  "message": "SUCCESS",
  "description": "成功",
  "returnObj": {
    "totalCount": 1,
    "images": [
      {
        "architecture": "x86_64",
        "azName": null,
        "bootMode": "bios",
        "containerFormat": "bare",
        "createdTime": 1664409600,
        "description": "Test CentOS",
        "destinationUser": null,
        "diskFormat": "raw",
        "diskID": "8888a888-b888-8888-a888-baee8d8ce88c",
        "diskSize": 40,
        "imageClass": "ECS",
        "imageID": "8d8e8888-8ed8-88b8-88cb-888f8b8cf8fa",
        "imageName": "CentOS-test",
        "imageType": "data_disk_image",
        "maximumRAM": 0,
        "minimumRAM": 0,
        "osDistro": "centos",
        "osType": "linux",
        "osVersion": "7.8",
        "projectID": "0",
        "sharedListLength": 0,
        "size": 42949672960,
        "sourceServerID": "88f888ea-88ff-88ec-a8bc-888888888fe8",
        "sourceUser": null,
        "status": "queued",
        "tags": null,
        "updatedTime": 1664409600,
        "visibility": "private"
      }
    ]
  }
}

状态码

请参考 状态码

错误码

请参考 错误码