# 创建实例 - CreateAdgInstance
#### 功能介绍
创建一个新的实例，需要提供实例的详细配置信息。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /v1/{project_id}/instances
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID |
   
#### 请求参数
表2请求Body参数 
| 参数                 | 是否必选 | 参数类型                                                                    | 描述       |
|:---|:---|:---|:---|
| availability_zone  | 否    | String                                                                  | 可用区      |
| charge_info        | 否    | [ChargeInfo] object             | 计费信息     |
| deploy_mode        | 否    | String                                                                  | 部署模式     |
| mode               | 否    | String                                                                  | 模式       |
| name               | 否    | String                                                                  | 实例名称     |
| outside_ins_config | 否    | [OutsideInsConfig] object | 云外实例配置信息 |
| password           | 否    | String                                                                  | 密码       |
| project_id         | 否    | String                                                                  | 项目ID     |
| publicip_id        | 否    | String                                                                  | 公网IP ID  |
| region             | 否    | String                                                                  | 区域       |
| security_group_id  | 否    | String                                                                  | 安全组ID    |
| specification      | 否    | String                                                                  | 规格       |
| subnet_id          | 否    | String                                                                  | 子网ID     |
| type               | 否    | String                                                                  | 类型       |
| vpc_id             | 否    | String                                                                  | VPC ID   |
   
 表3ChargeInfo 
| 参数             | 是否必选 | 参数类型    | 描述     |
|:---|:---|:---|:---|
| charge_mode    | 否    | String  | 计费模式   |
| is_auto_pay    | 否    | Boolean | 是否自动支付 |
| is_auto_renew  | 否    | Boolean | 是否自动续费 |
| period_num     | 否    | Integer | 周期数量   |
| period_type    | 否    | String  | 周期类型   |
| promotion_info | 否    | String  | 促销信息   |
   
 表4OutsideInsConfig 
| 参数             | 是否必选 | 参数类型   | 描述    |
|:---|:---|:---|:---|
| master_node_ip | 否    | String | 主节点IP |
| slave_node_ip  | 否    | String | 从节点IP |
| virtual_ip     | 否    | String | 虚拟IP  |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| 参数       | 参数类型   | 描述   |
|:---|:---|:---|
| job_id   | String | 作业ID |
| order_id | String | 订单ID |
   
**状态码：201**
创建成功
#### 请求示例
```
POST /v1/{project_id}/instances
{
  "availability_zone" : "string",
  "charge_info" : { },
  "deploy_mode" : "string",
  "mode" : "string",
  "name" : "string",
  "outside_ins_config" : { },
  "password" : "string",
  "project_id" : "string",
  "publicip_id" : "string",
  "region" : "string",
  "security_group_id" : "string",
  "specification" : "string",
  "subnet_id" : "string",
  "type" : "string",
  "vpc_id" : "string"
}
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述   |
|:---|:---|
| 200 | OK   |
| 201 | 创建成功 |
| 401 | 未授权  |
| 403 | 禁止访问 |
| 404 | 未找到  |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。