更新时间:2024-01-02 gmt 08:00

创建裸金属服务器-凯发k8国际娱乐官网入口

功能介绍

创建一台或多台裸金属服务器

背景信息(设置登录鉴权方式)

裸金属服务器的登录鉴权方式包括两种:密钥对、密码。为安全起见,推荐使用密钥对方式。

  • 密钥对

    指使用密钥对作为裸金属服务器的鉴权方式。

    接口调用方法:使用key_name字段,指定裸金属服务器登录时使用的密钥文件。key_name字段的使用方法请参见表2

  • 密码

    指使用设置初始密码方式作为裸金属服务器的鉴权方式,此时,您可以通过用户名密码方式登录裸金属服务器,linux操作系统时为root用户的初始密码。

    接口调用方法:

    • 方法一(推荐):使用adminpass字段,指定管理员帐号的初始登录密码,adminpass字段的使用方法请参见表2

      此时,对于安装了cloud-init镜像的linux裸金属服务器,若指定user_data字段,则该adminpass字段无效。

    • 方法二:
      • 对于镜像已安装cloud-init的linux裸金属服务器:使用user_data字段进行注入,具体请参见表2

    公共镜像默认已安装cloud-init或者cloudbase-init,私有镜像需要您自行确认是否安装。

约束

  • 不支持文件注入功能。
  • 目前仅支持创建包周期裸金属服务器
  • 不支持市场镜像创建裸金属服务器

注意事项

  • 该接口可以使用k8凯发的合作伙伴自身的ak/sk或者token调用,也可以用k8凯发的合作伙伴子客户的ak/sk或者token来调用。
  • 如果使用ak/sk认证方式,示例代码中的region请参考中“裸金属服务器 bms”下“区域”的内容,servicename(英文服务名称缩写)请指定为bms。
  • endpoint请参考中“裸金属服务器 bms”下“终端节点(endpoint)”的内容。
  • 请保证帐户余额充足,此接口无法使用优惠券支付,若余额不足会报“bms.0216”错误码。若想使用优惠券,请将request请求中的isautopay字段设置为false,然后在华为云k8凯发官网页面使用优惠券进行支付或者调用“”和“”接口进行支付。

调试

您可以在中调试该接口。

uri

post /v1/{project_id}/baremetalservers

参数说明请参见表1

表1 参数说明

参数

是否必选

描述

project_id

项目id。

获取方式请参见。

请求参数

参数

是否必选

参数类型

描述

server

object

裸金属服务器信息。详情请参见表2

表2 server字段数据结构说明

参数

是否必选

参数类型

描述

imageref

string

裸金属服务器使用的镜像id或者镜像资源的url。id格式为通用唯一识别码(universally unique identifier,简称uuid)。

镜像id可以从镜像服务控制台获取,或者参考《镜像服务api参考》的“”章节查询。

在使用“查询镜像列表”api查询时,可以添加过滤字段“?virtual_env_type=ironic”来筛选裸金属服务器镜像。

flavorref

string

裸金属服务器使用的规格id,格式为physical.x.x。

规格id可以从裸金属服务器控制台获取,也可以通过api查询。

说明:

裸金属服务器规格与镜像间的约束关系请参见。

对于physical.x.x.hba类型的规格,申请的租户只能是dec租户,且只能挂载dess卷。

name

string

裸金属服务器名称。

取值范围:

  • 只能由中文字符、英文字母(a~z,a~z)、数字(0~9)、下划线(_)、中划线(-)、点(.)组成,且长度为[1-63]个字符。
  • 创建的裸金属服务器数量大于1时,为区分不同裸金属服务器,创建过程中系统会自动在名称后加“-0000”的类似标记。故此时名称的长度为[1-58]个字符。

metadata

object

裸金属服务器元数据,key和value的长度均不大于255字节。详情请参见表3

user_data

string

创建裸金属服务器过程中待注入的用户数据。支持注入文本。

约束:

  • 注入内容,需要进行base64格式编码。注入内容(编码之前的内容)最大长度32kb。
  • 当key_name没有指定时,user_data注入的数据默认为裸金属服务器root帐户的登录密码。
  • 创建密码方式鉴权的linux裸金属服务器时为必填项,为root用户注入自定义初始化密码。

建议密码复杂度如下:

  • 长度为8-26位。
  • 密码至少必须包含大写字母(a-z)、小写字母(a-z)、数字(0-9)和特殊字符(!@$%^-_= [{}]:,./?)中的三种。
示例:
1
2
#!/bin/bash 
echo 'root:$6$v6azyelwcd3chlpy$bn3vvq18fmckj66b4zdhlwevqcxlig' | chpasswd -e

其中,$6$v6azyelwcd3chlpy$bn3vvq18fmckj66b4zdhlwevqcxlig为密文密码,生成方法如下:

  1. 生成加密盐值
    1
    2
    [root@test linux]# python -c "import crypt, getpass, pwd;print crypt.mksalt()" 
    $6$v6azyelwcd3chlpy
    
  2. 根据盐值生成密文密码
    1
    2
    [root@test linux]# python -c "import crypt, getpass, pwd;print crypt.crypt('cloud.1234','\$6\$v6azyelwcd3chlpy')" 
     $6$v6azyelwcd3chlpy$bn3vvq18fmckj66b4zdhlwevqcxlig
    
说明:

使用linux镜像并且采用密码登录裸金属服务器时,不支持数据注入。如何注入请参见。

adminpass

string

如果需要使用密码方式登录裸金属服务器,可使用adminpass字段指定裸金属服务器管理员帐户初始登录密码。其中,linux管理员帐户为root。

密码复杂度要求:
  • 长度为8-26位。
  • 密码至少必须包含大写字母、小写字母、数字和特殊字符(!@$%^-_= [{}]:,./?)中的三种。
  • linux系统密码不能包含用户名或用户名的逆序。

key_name

string

扩展属性,指定密钥的名称。如果需要使用ssh密钥方式登录裸金属服务器,请指定已有密钥的名称。

密钥可以通过api创建,或者使用api查询已有的密钥。

约束:

  • 当key_name和user_data同时指定时,user_data只能用做用户数据注入。
  • 当使用windows镜像创建裸金属服务器时,该字段不能为空(即windows镜像只支持密钥登录)。
  • windows裸金属服务器登录时,首先需要将密钥解析为密码,然后通过远程登录工具进行登录。具体请参见“”。

security_groups

array of objects

指定裸金属服务器的安全组。详情请参见表4

nics

array of objects

指定裸金属服务器的网卡信息。详情请参见表5

约束:

一个裸金属服务器最多挂载2个网卡,参数中第一个网卡会作为裸金属服务器的主网卡。若用户指定了多组网卡参数,需保证各组参数都属于同一vpc。

availability_zone

string

裸金属服务器对应可用区信息,需要指定可用区(az)的名称。

请参考获取。

vpcid

string

裸金属服务器所属虚拟私有云(vpc),需要指定已有vpc的id,uuid格式。vpc的id可以从网络控制台或者参考《虚拟私有云api参考》的“”章节获取。

publicip

object

配置裸金属服务器的弹性公网ip信息,弹性公网ip有三种配置方式:

  • 不使用(无该字段)。
  • 自动分配,需要指定新创建弹性公网ip的信息。
  • 使用已有,需要指定已创建弹性公网ip的信息。

详情请参见表7

count

integer

创建裸金属服务器的数量。

约束:

  • 不传该字段时默认取值为1。
  • 租户的配额足够时,最大值为100。

root_volume

object

裸金属服务器对应系统盘相关配置。详情请参见表8

约束:

当规格是快速发放时,该参数必选;当规格不是快速发放时,不传该参数。查询规格是否为快速发放,参见。

data_volumes

array of objects

裸金属服务器对应数据盘相关配置。每一个数据结构代表一个待创建的数据盘。详情请参见表9

约束:

目前裸金属服务器最多可挂载60块云硬盘(包括系统盘和数据盘)。

extendparam

object

创建裸金属服务器的附加信息。详情请参见表10

schedulerhints

object

裸金属服务器的调度信息。当需要在专属云中创建裸金属服务器时,该字段必选。

详情请参见表11

server_tags

list

裸金属服务器的标签,详见表12

说明:

创建裸金属服务器时,一台裸金属服务器最多可以添加10个标签。其中,__type_baremetal为系统内部标签,因此实际能添加的标签为9个。

表3 metadata字段数据结构说明

参数

是否必选

参数类型

描述

op_svc_userid

string

用户id(登录管理控制台,进入我的凭证,即可看到“用户id”)。

byol

string

是否自带许可,取值“true”或“false”。

admin_pass

string

如果需要使用密码方式登录裸金属服务器,可使用admin_pass字段指定裸金属服务器管理员帐户初始登录密码。其中,linux管理员帐户为root。

密码复杂度要求:
  • 长度为8-26位。
  • 密码至少必须包含大写字母、小写字母、数字和特殊字符(!@$%^-_= [{}]:,./?)中的三种。
  • 密码不能包含用户名或用户名的逆序,不能包含用户名中超过两个连续字符的部分。

agency_name

string

委托的名称。

委托是由租户管理员在统一身份认证服务(identity and access management,iam)上创建的,可以作为其他租户访问此裸金属服务器的临时凭证。

说明:

委托获取、更新请参考如下步骤:

  1. 使用iam服务提供的接口,获取有效可用的委托名称。
  2. 使用接口,更新metadata中agency_name字段为新的委托名称。
表4 security_groups字段数据结构说明

参数

是否必选

参数类型

描述

id

string

裸金属服务器对应的安全组id,对创建裸金属服务器中配置的所有网卡生效。

  • 当该参数未指定时默认给裸金属服务器绑定default安全组。
  • 当该参数传值(uuid格式)时需要指定已有安全组的id。获取已有安全组的方法请参见《虚拟私有云api参考》的“”章节。
表5 nics字段数据结构说明

参数

是否必选

参数类型

描述

subnet_id

string

裸金属服务器网卡所在的子网信息。

需要指定vpcid对应vpc下已创建的子网(subnet)的网络id(network_id),uuid格式。子网(subnet)的网络id(network_id)可以从虚拟私有云控制台或者参考《虚拟私有云api参考》的“”章节获取。

ip_address

string

裸金属服务器网卡的ip地址,ipv4格式。

约束:

  • 不填或空字符串,默认在子网中自动分配一个未使用的ip作为网卡的ip地址。
  • 若指定ip地址,该ip地址必须在子网的网段内,且未被使用。
  • 批量创建裸金属服务器时,不支持指定ip地址。

allowed_address_pairs

array of allow_address_pair objects

ip/mac对列表,详情请参见表6(扩展属性)。

约束:ip地址不允许为 “0.0.0.0/0”

  • 如果allowed_address_pairs配置地址池较大的cidr(掩码小于24位),建议为该port配置一个单独的安全组
  • 如果allowed_address_pairs为“1.1.1.1/0”,表示关闭源目地址检查开关
  • 如果是虚拟ip绑定云服务器,
    • 则mac_address可为空或者填写被绑定云服务器网卡的mac地址。
    • 被绑定的云服务器网卡allowed_address_pairs的ip地址填“1.1.1.1/0”。
表6 allow_address_pair字段数据结构说明

名称

是否必选

参数类型

说明

ip_address

string

ip地址。

约束:不支持0.0.0.0/0

如果allowed_address_pairs配置地址池较大的cidr(掩码小于24位),建议为该port配置一个单独的安全组。

mac_address

string

mac地址。

表7 publicip字段数据结构说明

参数

是否必选

参数类型

描述

id

string

创建裸金属服务器分配已有弹性公网ip时,分配的弹性公网ip的id,uuid格式。弹性公网ip的id可以从网络控制台或者参考《弹性公网ip api参考》的“”章节获取。

约束:

  • 只能分配状态(status)为down的弹性公网ip。
  • 批量创建裸金属服务器时,不能使用已有弹性公网ip,即不支持此参数。

eip

object

配置裸金属服务器自动分配弹性公网ip时,创建弹性公网ip的配置参数。详情请参见表13

输入publicip字段数据结构中的id和eip参数值时,只能选择其中一个输入。

表8 root_volume字段数据结构说明

参数

是否必选

参数类型

描述

volumetype

string

裸金属服务器系统盘对应的磁盘类型,需要与系统所提供的磁盘类型相匹配。

  • gpssd:通用型ssd磁盘类型
  • sas:高io磁盘类型
  • ssd:超高io磁盘类型

size

integer

系统盘大小,容量单位为gb,输入大小范围为[40-1024]。

约束:

系统盘大小取值应不小于镜像中系统盘的最小值(min_disk属性)。

cluster_id

string

裸金属服务器系统盘对应的存储池的id。

说明:
  • 使用专属分布式存储时需要该字段。
  • 存储池id可以从管理控制台或者参考《专属分布式存储api参考》的“”章节获取。

cluster_type

string

裸金属服务器系统盘对应的磁盘存储类型。磁盘存储类型枚举值:dss(专属分布式存储)。

说明:
  • 使用专属分布式存储时需要该字段。
  • 存储池类型可以从管理控制台或者参考《专属分布式存储api参考》的“”章节获取。
表9 data_volumes字段数据结构说明

参数

是否必选

参数类型

描述

volumetype

string

裸金属服务器数据盘对应的磁盘类型,需要与系统所提供的磁盘类型相匹配。

  • gpssd:通用型ssd磁盘类型
  • sas:高io磁盘类型
  • ssd:超高io磁盘类型

约束:

  • 在专属云中申请裸金属服务器时,须使用专属企业存储,此时该字段前缀必须是dess_。

    枚举值如下:

    dess_sas_iscsi:普通i/o企业存储

    dess_sas_fc:普通i/o企业存储(低延时)

    dess_mix_iscsi:高i/o企业存储

    dess_mix_fc:高i/o企业存储(低延时)

    dess_ssd_iscsi:超高i/o企业存储

    dess_ssd_fc:超高i/o企业存储(低延时)

  • 所有用户,包年包月场景下,不能挂载dess卷。
说明:

企业存储支持的存储类型说明可以从管理控制台或参考《专属企业存储服务用户指南》的“”章节获取。

size

integer

数据盘大小,容量单位为gb,输入大小范围为[10-32768]。

shareable

boolean

是否为共享磁盘。

  • true为共享盘
  • false为普通云硬盘

不指定时默认为false。

cluster_id

string

裸金属服务器数据盘对应的存储池id。

说明:
  • 使用专属分布式存储时需要该字段。
  • 存储池id可以从管理控制台或者参考《专属分布式存储api参考》的“”章节获取。

cluster_type

string

裸金属服务器数据盘对应的磁盘存储类型。磁盘存储类型枚举值:dss(专属分布式存储)。

说明:
  • 使用专属分布式存储时需要该字段。
  • 存储池类型可以从管理控制台或者参考《专属分布式存储api参考》的“”章节获取。
表10 创建裸金属服务器的extendparam字段数据结构说明

参数

是否必选

参数类型

描述

chargingmode

string

计费模式。取值范围:

prepaid:预付费,即包年包月。默认值是prepaid。

regionid

string

裸金属服务器所在区域id。

请参考获取。

periodtype

string

订购周期类型。取值范围:

  • month:月
  • year:年
说明:

chargingmode为prepaid时生效,且为必选值。

periodnum

integer

订购周期数。取值范围:

  • periodtype=month(周期类型为月)时,取值为[1-9]。
  • periodtype=year(周期类型为年)时,取值为1。
说明:

chargingmode为prepaid时生效,且为必选值。

isautorenew

string

是否自动续订。

  • true:自动续订
  • false:不自动续订
说明:

chargingmode为prepaid时生效,不指定该参数或者该参数值为空时默认为不自动续订。

isautopay

string

下单订购后,是否自动从客户的帐户中支付,而不需要客户手动去支付。

  • true:是(自动支付)
  • false:否(需要客户手动支付)
说明:

chargingmode为prepaid时生效,不指定该参数或者该参数值为空时默认为客户手动支付。

enterprise_project_id

string

企业项目id。

该字段不传(或传为字符串“0”),则将资源绑定给默认企业项目。

说明:

关于企业项目id的获取及企业项目特性的详细信息,请参见《》。

表11 schedulerhints字段数据结构说明

参数

是否必选

参数类型

描述

dec_baremetal

string

是否在专属云中创建裸金属服务器,参数值为share或dedicate。

约束:

  • 该值不传时默认为share。
  • 在专属云中创建裸金属服务器时,必须指定该字段为dedicate。
表12 server_tags字段数据结构说明

参数

是否必选

参数类型

描述

key

string

  • 最大长度36个unicode字符,不能为空。
  • 不能包含非打印字符ascii(0-31),以及以下特殊字符:=*<>\,|/
  • 同一资源的key值不能重复。

value

string

  • 每个值最大长度43个unicode字符,可以为空字符串。
  • 不能包含非打印字符ascii(0-31),以及以下特殊字符:=*<>\,|/
表13 eip字段数据结构说明

参数

是否必选

参数类型

描述

iptype

string

弹性公网ip地址类型。

类型枚举值:5_bgp、5_sbgp

详情请参见《弹性公网ip api参考》“”章节的“publicip”字段说明。

bandwidth

object

弹性公网ip带宽。详情请参见表14

extendparam

object

创建弹性公网ip的附加信息。详情请参见表15

表14 bandwidth字段数据结构说明

参数

是否必选

参数类型

描述

name

string

带宽名称。

sharetype

string

带宽的共享类型。

共享类型枚举:per,表示独享;whole,表示共享

id

string

共享带宽id。创建whole类型带宽的弹性公网ip时可以指定之前的共享带宽创建。

共享带宽的使用限制请参见“”。

说明:

当创建whole类型的带宽时,该字段必选。

size

integer

  • 取值范围:默认5mbit/s~2000mbit/s(具体范围以各region配置为准,请参见管理控制台对应页面显示)。
  • 功能说明:带宽大小。共享带宽的大小有最小值限制,默认为5m。
说明:
  • 如果传入的参数为小数(如10.2)或者字符类型(如10),会自动强制转换为整数。带宽小于300mbit/s时,步长支持1mbit/s;带宽为300mbit/s~1000mbit/s时,步长支持50mbit/s;带宽为1000mbit/s~2000mbit/s时,步长支持1000mbit/s。
  • 如果sharetype是per,该参数必选;如果sharetype是whole并且id有值,该参数会忽略。

chargemode

string

带宽的计费类型。

取值为:traffic(按流量计费)、bandwidth(按带宽计费)

  • 未传该字段,表示按带宽计费。
  • 字段值为空,表示按带宽计费。
说明:

如果sharetype是whole并且id有值,仅支持按带宽计费,该参数会忽略。

表15 创建弹性公网ip的extendparam字段数据结构说明

参数

是否必选

参数类型

描述

chargingmode

string

弹性公网ip的计费模式。若chargemode取值为bandwidth,则支持prepaid和postpaid;若chargemode取值为traffic,则仅支持postpaid。

取值范围:

  • prepaid:预付费,即包年包月
  • postpaid:后付费,即按需付费
说明:

如果bandwidth对象中sharetype是whole且id有值,弹性公网ip只能创建为按需付费的,故该参数传参“prepaid”无效。

请求示例

  • 创建一个裸金属服务器,镜像id为766a545a-02e1-433e-b1d1-733b5dc95e94,规格为physical.s3.large,计费模式为包年包月,使用密码方式远程登录。
    1
    post https://{bms endpoint}/v1/{project_id}/baremetalservers
    
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    {
        "server": {
            "availability_zone": "az1",
            "name": "bms-75c7",
            "imageref": "766a545a-02e1-433e-b1d1-733b5dc95e94",
            "flavorref": "physical.s3.large",
            "data_volumes": [
                {
                    "volumetype": "sas",
                    "size": 10,
                    "shareable": false
                }
            ],
            "vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb",
            "nics": [
                {
                    "subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616",
                    "ip_address": ""
                }
            ],
            "count": 1,
            "schedulerhints": {
                "dec_baremetal": "share"
            },
            "extendparam": {    
                "chargingmode": "prepaid",
                "periodtype": "month",
                "periodnum": 1,
                "isautorenew": "true",
                "isautopay": "true",
                "regionid": "region01"
            },
            "metadata": {
                "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81",
                "byol": "false",
                "admin_pass": ""
            },
            "publicip": {
                "id": "1b036bce-26b4-465c-acea-99fdbb0573a3"
            },
            "user_data":  "iyevymlul2jhc2gkzwnobyancm9vddoknir0y0pzamuknghhuhlnzfr4vwvhc2dtmwfml1nsmm4vbxzzdy5wsfdjbtvbc084owfhufhgnxuvvnj5oxjiymzzsw45smzac2k3slrmd2z6djjpbtbhrfzuztd6rdenihwgy2hwyxnzd2qglwu7",
            "security_groups": [
                {
                    "id": "993f2916-5bad-4f24-bc3c-db539f1a6d19"
                }
            ]
        }
    }
    
  • 创建一个包年包月的linux裸金属服务器,可用区为az1,名称为bms-3b91,镜像id为766a545a-02e1-433e-b1d1-733b5dc95e94规格为physical.o2.large且使用密钥方式远程登录。
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    {
        "server": {
            "availability_zone": "az1",
            "name": "bms-3b91",
            "imageref": "766a545a-02e1-433e-b1d1-733b5dc95e94",
            "flavorref": "physical.o2.large",
            "data_volumes": [
                {
                    "volumetype": "sas",
                    "size": 10,
                    "shareable": true
                }
            ],
            "vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb",
            "nics": [
                {
                    "subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616",
                    "ip_address": ""
                },
                {
                    "subnet_id": "2b8bcf33-33f2-4a63-aa9c-b1e17ff0ed7f",
                    "ip_address": ""
                }
            ],
            "count": 1,
            "schedulerhints": {
                "dec_baremetal": "share"
            },
            "extendparam": {
                "chargingmode": "prepaid",
                "periodtype": "month",
                "periodnum": 1,
                "isautorenew": "true",
                "isautopay": "true",
                "regionid": "region01"
            },
            "metadata": {
                "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81",
                "byol": "false"
            },
            "publicip": {
                "eip": {
                    "iptype": "5_bpg",
                    "bandwidth": {
                        "chargemode": "",
                        "name": "bms-3b91-bandwidth",
                        "size": 1,
                        "sharetype": "per"
                    },
                    "extendparam": {
                       "chargingmode": "prepaid"
                    }
                }
            },
            "security_groups": [
                {
                    "id": "993f2916-5bad-4f24-bc3c-db539f1a6d19"
                }
            ],
            "key_name": "keypair-zbb29"
        }
    }
    

    java语言生成user_data示例如下:

    1
    2
    3
    string userdata_org = "#!/bin/bash \r\n echo    'root:xxxxx' | chpasswd ;";
    byte[] userdata_byte = userdata_org.getbytes();
    string userdata = new base64encoder().encode(userdata_byte);
    
  • 创建包年包月的windows操作系统的裸金属服务器,可用区为az1,名称为bms-6a1e,镜像id为fd04041a-5f35-45ae-a27c-bf30f921c6b5,规格为physical.s3.large且使用密钥方式远程登录。
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    { 
         "server": { 
             "availability_zone": "az1", 
             "name": "bms-6a1e", 
             "imageref": "fd04041a-5f35-45ae-a27c-bf30f921c6b5", 
             "flavorref": "physical.s3.large", 
             "data_volumes": [ 
                 { 
                     "volumetype": "sas", 
                     "size": 10, 
                     "shareable": false 
                 } 
             ], 
             "vpcid": "0adc2847-c160-4263-be1f-e03d36e93e32", 
             "nics": [ 
                 { 
                     "subnet_id": "4f1cf6cc-4cc3-41d3-8192-625293dccce0", 
                     "ip_address": "" 
                 } 
             ], 
             "count": 1, 
             "schedulerhints": { 
                 "dec_baremetal": "share" 
             }, 
            "extendparam": { 
                "chargingmode": "prepaid", 
                "periodtype": "month", 
                "periodnum": 1, 
                "isautorenew": "true", 
                "isautopay": "true", 
                "regionid": "region1" 
             }, 
             "metadata": { 
                "op_svc_userid": "8a74baed155b47e8b59fbca853d6cb48", 
                "byol": "false" 
             }, 
             "publicip": { 
                 "id": "db9c4f39-fabd-4cc2-8685-82e7715d099f" 
             }, 
             "user_data": "cwf6pteymw==", 
             "security_groups": [ 
                 { 
                     "id": "33cf5e40-0b65-4e03-867d-4c67947c49be" 
                 } 
             ], 
             "key_name": "keypair-maoz" 
         } 
     }
    

响应参数

表16 正常响应要素说明

名称

参数类型

说明

order_id

string

提交订单成功后返回的订单id,用户可以使用该id对订单的处理情况进行查询(在管理控制台的“费用中心 > 我的订单”页面查询)。

job_id

string

提交任务成功后返回的任务id,用户可以使用该id对任务执行情况进行查询。

如何根据job_id来查询job的执行状态,请参考。

表17 异常响应要素说明

名称

参数类型

说明

error

字典数据结构[1]

提交任务异常时返回的异常信息,详情请参见表18

表18 error数据结构

名称

参数类型

说明

message

string

任务异常错误信息描述。

code

string

任务异常错误信息编码。

响应示例

  • 正常响应
    { 
        "order_id": "cs2009141523oqseq",
        "job_id": "ff808081748b760c01748b7f80370003"
    }

返回值

正常返回值:

返回值

说明

200

服务器已成功处理了请求。

其他返回值请参考。

错误码

请参考。

分享:
网站地图