文档首页/ 华为云Flexus云服务_Flexus应用服务器L实例/ API参考/ API/ 购买Flexus L实例
更新时间：2024-09-13 GMT+08:00
查看PDF
分享

购买Flexus L实例

功能介绍

订购一个或多个Flexus L实例。

本接口为异步接口，当前订购接口请求下发后会返回order_id和instances_ids，此时仅表示订单创建完成，Flexus L实例并没有创建完成。请使用本接口返回的order_id调用查询订单状态来确认status的值确认Flexus L实例的创建状态，status为5时表示Flexus L实例创建成功。

当前仅支持订购香港、新加坡区域的Flexus L实例。

API网关地址

https://hcss.cn-north-4.myhuaweicloud.com

URL

POST /v1/light-instances

请求消息

表1 header参数

参数

是否必选

参数类型

描述

Client-Request-Id

是

String

用户指定的，对于此请求的唯一ID，用于定位某个请求，推荐使用UUID。

字符长度为36~128。

X-Auth-Token

是

String

用户Token。

本接口的鉴权方式为token鉴权，通过调用获取IAM账号的 token接口获取。

X-Auth-Token的值为获取IAM账号的 token接口响应消息头中X-Subject-Token的值。
表2 body参数

参数名

是否必选

参数类型

描述

instance_name

是

String

实例名称。可以使用中文、大小写英文、数字、下划线、中划线。首字符需为中文或者英文，区分大小写。

字符长度为1~128。

description

否

String

实例描述。

字符长度为0~1024。

plan_spec

是

String

规格编码。

不同镜像支持的规格编码不同，具体信息请参考附录。

image_ref

否

ImageRef

镜像信息。详情请参见表3。

region

是

String

区域。

目前仅支持“ap-southeast-1"”（香港）、“ap-southeast-3” （新加坡）区域。

charging_mode

否

String

计费模式。默认为prePaid，表示预付费，即包年包月。

period_type

是

String

订购周期类型。

  • month：月。
  • year：年。

period_num

是

String

订购周期数。

  • periodType=month（周期类型为月）时，取值为[1,9]。
  • periodType=year（周期类型为年）时，取值为[1,3]。

purchase_quantity

否

int

购买数量。默认为1。

取值范围：[1,200]。

is_auto_renew

否

boolean

是否自动续订。默认false。

  • true：自动续订。
  • false：不自动续订。

is_auto_pay

否

boolean

下单订购后，是否自动从客户的账户中支付。默认false。

  • true：是，即自动支付。
  • false：否，即需要客户手动支付。

ExtraResources

否

Array of ExtraResources

附加资源信息。详情请参见表4。

tags

否

Array of Tags

用户自定义标签。详情请参见表5。
表3 ImageRef参数

参数名

是否必选

参数类型

描述

image_name

否

String

Flexus L实例支持的系统镜像的名称。

使用系统镜像创建Flexus L实例时，涉及此参数；使用私有镜像创建Flexus L实例，不涉该参数。

目前支持的镜像名称请参考系统镜像。

image_version

否

String

Flexus L实例支持的系统镜像的版本。

使用系统镜像创建Flexus L实例时，涉及此参数；使用私有镜像创建Flexus L实例，不涉该参数。

目前支持的镜像版本请参考系统镜像。

image_id

否

String

私有镜像ID。

仅使用私有镜像创建Flexus L实例时，由用户提供该私有镜像的image_id。如果使用系统镜像或者应用镜像创建Flexus L实例，则不涉及该参数。
表4 ExtraResources参数

参数名

是否必选

参数类型

描述

type

是

String

附加资源类型。

目前支持"evs"，"cbr"，"hss"。

  • “evs”为数据盘。
  • “cbr”为云备份。
  • “hss”为主机安全。

size

否

Int

附加“evs”、“cbr”资源的容量大小，容量单位为GB， 输入大小范围为[10,2048]。

"hss"附加资源类型不涉及此参数。
表5 Tags参数

参数名

是否必选

参数类型

描述

key

是

String

键。字符长度为1~32。

value

是

String

值。字符长度为0~2048。

响应消息

表6 Tags参数

参数名

参数类型

描述

order_id

String

订单号。

instance_ids

Array of strings

实例ID列表。

本接口为异步接口，当前订购接口请求下发后会返回order_id和instances_ids，此时仅表示订单创建完成，Flexus L实例并没有创建完成。请使用本接口返回的order_id调用查询订单状态来确认status的值确认Flexus L实例的创建状态，status为5时表示Flexus L实例创建成功。

请求示例

创建2台实例名为“test-0620-01”、规格编码为hf.large.1.40g.30m.win、镜像为WindowsServer 2012R2标准版、区域为新加坡、购买时长为1个月、自动支付、自动续费，并且加购20GB数据盘、20GB云备份、HSS的订单。

{
  "instance_name": "test-0620-01",
  "description": "test",
  "plan_spec": "hf.large.1.40g.30m.win",
  "image_ref": {
    "image_name": "WindowsServer",
    "image_version": "2012R2_standard_ch"
  },
  "region": "ap-southeast-3",
  "charging_mode": "prePaid",
  "period_type": "month",
  "period_num": 1,
  "purchase_quantity": 2,
  "is_auto_renew": true,
  "is_auto_pay": true
  ,"extra_resources": [
    {
      "type": "evs",
      "size": 20
    },
    {
      "type": "cbr",
      "size": 20
    },
    {
      "type": "hss"
    }
  ]
}

响应示例

{
    "order_id": "CS24022811305H1EW",
    "instance_ids": [
        "65dea8d23005da564c78d9d2"
    ]
 }

返回值

表7 返回值

状态码

描述

202

请求接受，异步处理。

400

用户请求非法。

401

用户身份认证失败。

403

用户无权限调用此API。

429

请求数量过多。

500

服务器内部错误。

错误码

表8 错误码

HTTP状态码

错误码

错误描述

400

HCSS.14000001

参数非法。

400

HCSS.14000002

cors服务请求异常。

400

HCSS.14000003

cbc服务请求异常。

400

HCSS.14000004

ecs服务请求异常。

400

HCSS.14000005

evs服务请求异常。

400

HCSS.14000006

eip服务请求异常。

400

HCSS.14000007

elb服务请求异常。

400

HCSS.14000008

ims服务请求异常。

400

HCSS.14000009

市场镜像服务请求异常。

400

HCSS.14000010

规格容量不足。

400

HCSS.14000011

额度不足。

429

HCSS.14290001

请求过多，请稍后再试。

500

HCSS.15000001

服务器异常。

附录

本节介绍本接口支持的各类镜像对应的规格编码。

本接口支持的系统镜像版本及其对应的规格编码如下表，对应的具体规格见表11、表12。
表9 系统镜像规格编码

支持的规格编码

支持的规格编码

支持的规格编码

Ubuntu

22.04/20.04/18.04/16.04

hf.large.05.40g.30m.linux

hf.large.1.40g.30m.linux

hf.large.2.60g.30m.linux

hf.large.4.80g.30m.linux

hf.xlarge.2.160g.30m.linux

hf.xlarge.4.240g.30m.linux

Huawei Cloud EulerOS

2.0

hf.large.025.30m.linux

hf.large.05.40g.30m.linux

hf.large.1.40g.30m.linux

hf.large.2.60g.30m.linux

hf.large.4.80g.30m.linux

hf.xlarge.2.160g.30m.linux

hf.xlarge.4.240g.30m.linux

CentOS

8.2/8.1/8.0/7.9/7.8/7.7/7.6/7.5/ 7.4/7.3/7.2

hf.large.025.30m.linux（仅7.6镜像版本支持）

hf.large.05.40g.30m.linux

hf.large.1.40g.30m.linux

hf.large.2.60g.30m.linux

hf.large.4.80g.30m.linux

hf.xlarge.2.160g.30m.linux

hf.xlarge.4.240g.30m.linux

Debian

11.1/9.0

hf.large.025.30m.linux（仅11.1镜像版本支持）

hf.large.05.40g.30m.linux

hf.large.1.40g.30m.linux

hf.large.2.60g.30m.linux

hf.large.4.80g.30m.linux

hf.xlarge.2.160g.30m.linux

hf.xlarge.4.240g.30m.linux

WindowsServer

2019_standard_ch

2016_standard_ch

2012R2_standard_ch

hf.large.1.40g.30m.win

hf.large.2.60g.30m.win

hf.large.4.80g.30m.win

hf.xlarge.2.160g.30m.win

hf.xlarge.4.240g.30m.win

本接口支持的私有镜像对应的规格编码如下表，对应的具体规格见表11、表12。

表10 私有镜像规格编码

操作系统

规格编码

Linux操作系统

hf.large.025.30m.linux

hf.large.05.40g.30m.linux

hf.large.1.40g.30m.linux

hf.large.2.60g.30m.linux

hf.large.4.80g.30m.linux

hf.xlarge.2.160g.30m.linux

hf.xlarge.4.240g.30m.linux

Windows操作系统

hf.large.1.40g.30m.win

hf.large.2.60g.30m.win

hf.large.4.80g.30m.win

hf.xlarge.2.160g.30m.win

hf.xlarge.4.240g.30m.win

规格编码对应的具体规格如下表所示。

表11 Linux系统规格编码的规格

规格编码

vCPU

内存（GiB）

系统盘（GB）

峰值带宽（Mbps）

流量包（GB）

hf.large.025.30m.linux

2

0.5

20

30

1024

hf.large.05.40g.30m.linux

2

1

40

30

1024

hf.large.1.40g.30m.linux

2

2

40

30

1024

hf.large.2.60g.30m.linux

2

4

60

30

2048

hf.large.4.80g.30m.linux

2

8

80

30

3072

hf.xlarge.2.160g.30m.linux

4

8

160

30

4096

hf.xlarge.4.240g.30m.linux

4

16

240

30

5120
表12 Windows系统规格编码的规格

规格编码

vCPU

内存（GiB）

系统盘（GB）

峰值带宽（Mbps）

流量包（GB）

hf.large.1.40g.30m.win

2

2

40

30

1024

hf.large.2.60g.30m.win

2

4

60

30

2048

hf.large.4.80g.30m.win

2

8

80

30

3072

hf.xlarge.2.160g.30m.win

4

8

160

30

4096

hf.xlarge.4.240g.30m.win

4

16

240

30

5120
父主题： API

相关文档