创建实例 - CreateInstance

功能介绍

创建实例(要求账号有支付权限，若没有支付权限，仍然会生成订单，但不会自动支付)

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
aad:instance:create
Write
instance *
g:EnterpriseProjectId
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
aad:instance:create	Write	instance *	g:EnterpriseProjectId	-	-

URI

POST /v2/aad/instance

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	token
Content-Type	是	String	Content-Type

表2 请求Body参数
参数	是否必选	参数类型	描述
ip_type	是	Integer	ip类型：0-IPV4,1-IPV6。当resource_region为asia_pacific时，ip_type仅支持0-IPV4。
resource_region	是	String	资源区域：north_china-华北、east_china-华东、asia_pacific-亚太。
basic_bandwidth	否	Integer	保底带宽。当resource_region为north_china、east_china时，basic_bandwidth不可为空；当resource_region为asia_pacific时，basic_bandwidth必须为空。
elastic_bandwidth	否	Integer	弹性带宽。当resource_region为north_china、east_china时，elastic_bandwidth不可为空；当resource_region为asia_pacific时，elastic_bandwidth必须为空。
protection_package	否	String	防护套餐：basic-保险防护，unlimited-无限防护。当resource_region为asia_pacific时，protection_package不可为空，当resource_region不为asia_pacific时，protection_package必须为空。
instance_access_type	是	String	实例接入类型：0-网站类，1-IP接入。
protected_domain	否	Integer	防护域名数，步长为5。当instance_access_type为1-IP接入时，protected_domain必须为空，当instance_access_type为0-网站类时，protected_domain不可为空；当resource_region为north_china、east_china时，protected_domain取值范围[50,500]，当resource_region为asia_pacific时，protected_domain取值范围[10,200]。
forwarding_rule	否	Integer	转发规则数，步长为5。当instance_access_type为1-IP接入时，forwarding_rule不可为空，当instance_access_type为0-网站类时，forwarding_rule必须为空；当resource_region为north_china、east_china时，forwarding_rule取值范围[50,500]，当resource_region为asia_pacific时，forwarding_rule取值范围[5,200]。
basic_qps	否	Integer	业务qps。当instance_access_type为1-IP接入时，basic_qps必须为空，当instance_access_type为0-网站类时，basic_qps不可为空；当resource_region为north_china、east_china时，basic_qps取值范围[3000,100000]，当resource_region为asia_pacific时，basic_qps取值范围[1000,100000]。
duration	是	Integer	订购时长, 月：1,2,3,4,5,6,7,8,9个月，年：1年。
amount	是	Integer	购买数量。
instance_name	是	String	实例名称。一次创建多个实例时，系统会自动在实例名后增加后缀，例如：CAD-0001。
service_bandwidth	是	Integer	业务带宽。
period_type	是	Integer	订购周期类型：2：月；3：年。
enterprise_project_id	否	String	企业项目id。
elastic_service_bandwidth_type	否	Integer	弹性业务带宽类型, 置空表示不开启，2-日95，3-月95。当resource_region为north_china、east_china时，仅支持月95。
elastic_service_bandwidth	否	Integer	弹性业务带宽增加值

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
order_id	String	订单id

状态码：400

表4 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_description	String	错误描述

请求示例

POST https://{endpoint}/v2/aad/instance

{
  "ip_type" : 0,
  "resource_region" : "north_china",
  "basic_bandwidth" : "10",
  "forwarding_rule" : 50,
  "duration" : 1,
  "amount" : 1,
  "elastic_bandwidth" : 100,
  "service_bandwidth" : 100,
  "instance_access_type" : 1,
  "period_type" : 2,
  "instance_name" : "实例",
  "enterprise_project_id" : "0"
}