# 包年包月计费模式创建审计实例 - CreateInstancesPeriodOrderNew #### 功能介绍 包年包月计费模式创建审计实例 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DBSS/doc?api=CreateInstancesPeriodOrderNew)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dbss/dbss_01_0428.html)。 #### URI POST /v2/{project_id}/audit/charge/period/order 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目ID。可通过IAM服务\[查询指定IAM用户的项目列表\]接口获取。 **约束限制**： 不涉及 **取值范围**： 以IAM服务接口返回值为准，字符长度32-64。 **默认取值**： 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释**： 用户Token。通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值）。 **约束限制**： 不涉及 **取值范围**： IAM服务查询用户Token接口为准 **默认取值**： 不涉及 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | 实例名称。取值范围： - 只能由中文字符、英文字母、数字、下划线、中划线组成，且长度小于等于64个字符。 | | flavor_ref | 是 | String | 云服务器使用的规格ID | | vpc_id | 是 | String | 虚拟私有云的ID | | availability_zone | 是 | String | 云服务器对应可用分区信息。(两个主备分区，中间用","分隔，例如az1.dc1,az2.dc2)。 | | enterprise_project_id | 否 | String | 企业项目ID。对接EPS必输。 | | nics | 是 | Array of [nics] objects | 云服务器对应的网卡信息 | | security_groups | 是 | Array of [security_groups] objects | 云服务器对应安全组信息 | | comment | 否 | String | 备注信息 | | region | 是 | String | 云服务器所在区域ID | | cloud_service_type | 是 | String | 服务类型： - hws.service.type.dbss: 数据库审计 | | charging_mode | 是 | Integer | 计费模式： - 0：包周期计费 - 1：按需计费 | | period_type | 是 | Integer | -订购周期类型 - 0：天 - 1：周 - 2：月 - 3：年 - 4：小时 - 5：绝对时间 | | period_num | 是 | Integer | 订购周期数 | | subscription_num | 是 | Integer | 订购数量： DBSS只支持订购1套，不支持多套 | | product_infos | 是 | Array of [product_infos] objects | 产品信息列表 | | tags | 否 | Array of [KeyValueBean] objects | 资源标签 | | promotion_info | 否 | String | 折扣信息 | | is_auto_renew | 是 | Integer | 自动续费 - 1：自动续费 - 0：不自动续费 | 表4nics | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | subnet_id | 是 | String | 网卡对应的子网ID | | ip_address | 否 | String | IP地址，不填或空字符串为自动分配 | 表5security_groups | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | id | 是 | String | 云服务器对应的安全组ID，会对创建云服务器中配置的网卡生效 | 表6product_infos | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | product_id | 是 | String | 产品ID | | cloud_service_type | 是 | String | 服务类型： - hws.service.type.dbss: 数据库审计 | | resource_type | 是 | String | 资源类型: - hws.resource.type.dbss：数据库审计 | | resource_spec_code | 是 | String | 资源规格： - dbss.bypassaudit.low：基础版 - dbss.bypassaudit.medium：高级版 - dbss.bypassaudit.high：专业版 | | product_spec_desc | 否 | String | 产品规格描述。json字符串格式 ：{"specDesc":{"zh-cn":{"key1":"value1"},"en-us":{"key1":"value1"}}} | 表7KeyValueBean | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 是 | String | 键。最大长度128个字符。 | | value | 否 | String | 值。每个值最大长度255个字符。 | #### 响应参数 **状态码：200** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | description | String | 描述 | | code | String | 返回码 | | order_id | String | 订单ID | **状态码：400** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | details | Array of [DbssErrorDetail] objects | PDP5鉴权异常信息 | | encoded_authorization_message | String | PDP5鉴权异常信息 | | error_code | String | 错误码 | | error_msg | String | 错误信息 | 表10DbssErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码 | | error_msg | String | PDP5错误信息 | **状态码：403** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | details | Array of [DbssErrorDetail] objects | PDP5鉴权异常信息 | | encoded_authorization_message | String | PDP5鉴权异常信息 | | error_code | String | 错误码 | | error_msg | String | 错误信息 | 表12DbssErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码 | | error_msg | String | PDP5错误信息 | **状态码：500** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | details | Array of [DbssErrorDetail] objects | PDP5鉴权异常信息 | | encoded_authorization_message | String | PDP5鉴权异常信息 | | error_code | String | 错误码 | | error_msg | String | 错误信息 | 表14DbssErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码 | | error_msg | String | PDP5错误信息 | #### 请求示例 ``` /v2/{project_id}/audit/charge/period/order { "flavor_ref" : "st6.xlarge.4", "name" : "DBSS-acc3", "vpc_id" : "4c035747-f77b-4c6d-b23b-cb3a2b96c7e6", "availability_zone" : "cn-north-7c", "comment" : "", "region" : "cn-north-7", "nics" : [ { "subnet_id" : "6201dcf2-1374-43ec-ae8b-78b4081572d3" } ], "security_groups" : [ { "id" : "04088976-9c63-4e6b-9070-84e6a30c782b" } ], "cloud_service_type" : "hws.service.type.dbss", "charging_mode" : 0, "period_type" : 2, "period_num" : 1, "subscription_num" : 1, "is_auto_renew" : 0, "product_infos" : [ { "product_id" : "00301-xxxxxxx-0--0", "cloud_service_type" : "hws.service.type.dbss", "resource_type" : "hws.resource.type.dbss", "resource_spec_code" : "dbss.bypassaudit.low", "product_spec_desc" : "{\"specDesc\":{\"zh-cn\":{},\"en-us\":{\"instance Name\":\"DBSS-test\",\"VPC\":\"default_vpc\",\"Subnet\":\"subnet-af32\"}}}" } ], "promotion_info" : "", "enterprise_project_id" : "0", "tags" : [ { "key" : "key_test", "value" : "1" } ] } ``` #### 响应示例 **状态码：200** 成功 ``` { "description" : "Success", "code" : "0", "order_id" : "CS1710190909OGQIS" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 成功 | | 400 | 失败 | | 403 | 认证失败 | | 500 | 服务端错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-dbss/ErrorCode.html)。