导入镜像

POST

/v4/image/import

OperationId：iaasCtimageImportImage

使用指定的存在对象存储（原生版）Ⅰ 型的镜像文件来创建一份私有镜像。

请求参数

Body 参数application/json

regionID

string

资源池ID

必需

azName

string

必需

可用区 python为必传，公有云非必传，先暂时定为必传

source

string

必需

导入的镜像的源(地址)(兼容imageFileSource)

fromFormat

string

可选

导入镜像的格式:raw/qcow2/vmdk/vhd

imageProperties

object

镜像属性

必需

imageName

string

镜像名称

必需

diskFormat

string

必需

磁盘格式。取值范围：raw

containerFormat

string

必需

容器格式。取值范围：bare

architecture

string

必需

系统架构,x86_64/i386

osType

string

必需

操作系统类型,linux/windows/other

osDistro

string

必需

系统发行版,centos/ubuntu/windows

osVersion

string

必需

发行版本号，7.2/7.3/16.04/2008

systemDiskSize

integer <int32>

可选

系统盘大小单位GB(兼容diskSize)

description

string

描述

可选

imageType

string

可选

镜像类型非必传，不传的话默认是系统盘镜像文件；传data_disk_image_from_file，表示数据盘镜像文件

bootMode

string

可选

启动方式(暂不支持)

maximumRAM

integer <int32>

可选

最大内存，单位为 GB(暂不支持)

minimumRAM

integer <int32>

可选

最小内存，单位为 GB(暂不支持)

示例

{
    "regionID": "TestRegionID",
    "azName": "az1",
    "source": "http://203.193.231.238:45325/thrdTest-bucket-699/CentOS-6.0-x86_64.qcow2?AWSAccessKeyId=R2IXGWYBFQH7YN1Y5B0M&Signature=Rc5xXU5iadLvTgT4NqCm9n%2Bkh3M%3D&Expires=1680600460",
    "fromFormat": "qcow2",
    "imageProperties": {
        "imageName": "import-iamge-202304141035",
        "diskFormat": "raw",
        "containerFormat": "bare",
        "architecture": "x86_64",
        "osType": "linux",
        "osDistro": "centos",
        "osVersion": "6.0",
        "cpuSockets": 1,
        "cpuThreads": 1,
        "systemDiskSize": 40,
        "description": "import-iamge-202304141035"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v4/image/import' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "azName": "az1",
    "source": "http://203.193.231.238:45325/thrdTest-bucket-699/CentOS-6.0-x86_64.qcow2?AWSAccessKeyId=R2IXGWYBFQH7YN1Y5B0M&Signature=Rc5xXU5iadLvTgT4NqCm9n%2Bkh3M%3D&Expires=1680600460",
    "fromFormat": "qcow2",
    "imageProperties": {
        "imageName": "import-iamge-202304141035",
        "diskFormat": "raw",
        "containerFormat": "bare",
        "architecture": "x86_64",
        "osType": "linux",
        "osDistro": "centos",
        "osVersion": "6.0",
        "cpuSockets": 1,
        "cpuThreads": 1,
        "systemDiskSize": 40,
        "description": "import-iamge-202304141035"
    }
}'

返回响应

🟢200successful operation

application/json

Body

description

string

描述

可选

errorCode

string

错误码

可选

message

string

错误说明

可选

returnObj

array [object {2}]

响应对象

必需

taskId

string

任务ID(底层)

可选

jobId

string

必需

任务ID
混合云特有字段

statusCode

integer <int32>

可选

返回状态码(800:成功;900:失败)。默认值:800

示例

{
    "description": "成功",
    "errorCode": "SUCCESS",
    "message": "success",
    "returnObj": [
        {
            "jobId": "5ad02485-b28f-42cf-855f-5c9d743f1d07",
            "taskId": "f92edb78-10f1-4646-8d4c-af02f605b7d3"
        }
    ],
    "statusCode": 800
}

修改于 2024-05-13 10:08:43

删除一份自定义镜像

导出私有镜像