文档首页> > API参考> 实例管理类接口> 创建实例

创建实例

分享
更新时间: 2019/05/31 08:43

功能介绍

创建实例,该接口创建的实例为按需计费的方式。

URI

POST /v1.0/{project_id}/instances

参数说明见表1

表1 参数说明

参数

类型

必选

说明

project_id

String

项目ID。

请求消息

请求参数

参数说明见表2

表2 参数说明

参数

类型

是否必选

说明

name

String

实例名称。

由英文字符开头,只能由英文字母、数字、中划线组成,长度为4~64的字符。

description

String

实例的描述信息。

长度不超过1024的字符串。

说明:

\与"在json报文中属于特殊字符,如果参数值中需要显示\或者"字符,请在字符前增加转义字符\,比如\\或者\"

engine

String

消息引擎,支持rabbitmq、kafka。

engine_version

String

消息引擎的版本。

specification

String

当engine为kafka时,该参数必选。

Kafka实例的基准带宽,表示单位时间内传送的最大数据量,单位Byte/秒。

取值范围:

  • 100M
  • 300M
  • 600M
  • 1200M

storage_space

Integer

消息存储空间,单位GB。

  • 单机RabbitMQ实例的存储空间的取值范围100GB~90000GB。
  • 集群RabbitMQ实例的存储空间的取值范围为100GB*节点数~90000GB、200GB*节点数~90000GB、300GB*节点数~90000GB。
  • Kafka实例规格为100MB时,存储空间取值范围600GB ~ 90000GB。
  • Kafka实例规格为300MB时,存储空间取值范围1200GB ~ 90000GB。
  • Kafka实例规格为600MB时,存储空间取值范围2400GB ~ 90000GB。
  • Kafka实例规格为1200MB,存储空间取值范围4800GB ~ 90000GB。

partition_num

Integer

当engine为kafka时,该参数必选。

Kafka实例的最大分区数量。

  • 参数specification为100MB时,取值300
  • 参数specification为300MB时,取值900
  • 参数specification为600MB时,取值1800
  • 参数specification为1200MB时,取值1800

access_user

String

当engine为rabbitmq时,该参数必选。

当engine为kafka时,并且ssl_enable为true时,该参数必选, ssl_enable为false时,该参数无效。

认证用户名,只能由英文字母、数字、中划线组成,长度为4~64的字符。

password

String

当engine为rabbitmq时,该参数必选。

当engine为kafka时,并且ssl_enable为true时,该参数必选, ssl_enable为false时,该参数无效。

实例的认证密码。

复杂度要求:

  • 输入长度为8到32位的字符串。
  • 必须包含如下四种字符中的两种组合:
    • 小写字母
    • 大写字母
    • 数字
    • 特殊字符包括(`~!@#$%^&*()-_=+\|[{}]:'",<.>/?)

vpc_id

String

租户VPC ID。

security_group_id

String

租户安全组ID。

subnet_id

String

子网ID。

available_zones

Array

创建节点到指定的AZ ID,该参数不能为空数组或者数组的值为空,详情请参考查询可用区信息查询得到。

product_id

String

产品标识。

详情请参考查询产品规格列表

maintain_begin

String

维护时间窗开始时间,格式为HH:mm。

  • 维护时间窗开始和结束时间必须为指定的时间段,可参考查询维护时间窗时间段获取。
  • 开始时间必须为22:00、02:00、06:00、10:00、14:00和18:00。
  • 该参数不能单独为空,若该值为空,则结束时间也为空。系统分配一个默认开始时间02:00。

maintain_end

String

维护时间窗结束时间,格式为HH:mm。

  • 维护时间窗开始和结束时间必须为指定的时间段,可参考查询维护时间窗时间段获取。
  • 结束时间在开始时间基础上加四个小时,即当开始时间为22:00时,结束时间为02:00。
  • 该参数不能单独为空,若该值为空,则开始时间也为空,系统分配一个默认结束时间06:00。

enable_publicip

Boolean

RabbitMQ实例是否开启公网访问功能。

  • true:开启
  • false:比开启

publicip_id

String

RabbitMQ实例绑定的弹性IP地址的ID。

如果开启了公网访问功能(即enable_publicip为true),该字段为必选。

ssl_enable

Boolean

是否打开SSL加密访问。

  • true:打开SSL加密访问。
  • false:不打开SSL加密访问。

storage_spec_code

String

存储IO规格。如何选择磁盘类型请参考磁盘类型及性能介绍

RabbitMQ实例的取值范围:

  • dms.physical.storage.normal:
  • dms.physical.storage.high
  • dms.physical.storage.ultra

Kafka实例的取值范围:

  • 参数specification为300MB时,取值dms.physical.storage.high或者dms.physical.storage.ultra
  • 参数specification为600MB时,取值dms.physical.storage.ultra
  • 参数specification为1200MB时,取值dms.physical.storage.ultra

enterprise_project_id

String

企业项目ID。

RabbitMQ实例的请求示例

{ 
    "name" : "rabbitmq-instance", 
    "description" : "Create a instance", 
    "engine" : "rabbitmq", 
    "engine_version" : "3.7.0", 
    "storage_space" : 100,
    "ssl_enable": "true", 
    "access_user": "user",
    "password" : "******", 
    "vpc_id" : "27d99e17-42f2-4751-818f-5c8c6c03ff15", 
    "security_group_id" : "1477393a-29c9-4de5-843f-18ef51257c7e", 
    "subnet_id" : "ec2f34b9-20eb-4872-85bd-bea9fc943128", 
    "available_zones" : ["1d7b939b382c4c3bb3481a8ca10da768"], 
    "product_id" : "00300-30101-0--0", 
    "maintain_begin" : "22:00", 
    "maintain_end" : "02:00",
    "enable_publicip": true, 
    "publicip_id": "b7940732-11ef-459b-acab-cab0d26c74a3"
}
Kafka 实例的请求示例
{
    "name" : "kafka-instance", 
    "description" : "Create a instance", 
    "engine" : "kafka", 
    "engine_version" : "1.1.0", 
    "specification" : "1200MB",
    "storage_space" : 4800,
    "partition_num" : 1800,
    "ssl_enable": "true", 
    "access_user": "user"
    "password" : "******", 
    "vpc_id" : "27d99e17-42f2-4751-818f-5c8c6c03ff15", 
    "security_group_id" : "1477393a-29c9-4de5-843f-18ef51257c7e", 
    "subnet_id" : "ec2f34b9-20eb-4872-85bd-bea9fc943128", 
    "available_zones" : ["1d7b939b382c4c3bb3481a8ca10da768"], 
    "product_id" : "00300-30306-0--0", 
    "maintain_begin" : "22:00", 
    "maintain_end" : "02:00",
    "storage_spec_code": "dms.physical.storage.ultra",
    "enterprise_project_id": "0"
}

响应消息

响应参数

参数说明见表3

表3 参数说明

参数

类型

说明

instance_id

String

实例ID

响应示例

{  
    "instance_id": "8959ab1c-7n1a-yyb1-a05t-93dfc361b32d"  
}

状态码

操作成功的状态码如表4所示,其他响应见状态码

表4 状态码

状态码

描述

200

创建实例成功。

如果您喜欢这篇文档,您还可以:

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区