# 包周期购买数据库运维实例 - CreateDbOmInstancePeriod #### 功能介绍 包周期购买数据库运维实例 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DBSS/doc?api=CreateDbOmInstancePeriod)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dbss/dbss_01_0428.html)。 #### URI POST /v2/{project_id}/db-om/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参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | tags | 否 | Array of [ResourceTagInfoBean] objects | 资源标签列表 | | asset_nums | 是 | Integer | 资产数量 | | availability_zone | 是 | String | 可用分区 | | charging_mode | 是 | Integer | 计费模式 | | cloud_service_type | 是 | String | 服务类型 | | comment | 否 | String | 备注信息 | | composite_product_id | 否 | String | 组合套餐 | | deploy_mode | 是 | String | 实例部署方式，默认为云上 - CLOUD：云上 - OUTSIDE：云外 | | discount_id | 否 | String | 折扣ID | | enterprise_project_id | 是 | String | 企业项目ID | | flavor_ref | 是 | String | ECS规格ID | | hx_password | 是 | String | 前端登录密码 | | image_business_type | 是 | Integer | 镜像业务类型 | | is_auto_renew | 是 | Integer | 自费续费 - 1：自动 - 0：不自动 | | name | 是 | String | 实例名称 | | nics | 是 | Array of [Nic] objects | 网卡信息 | | outside_ins_config | 否 | [OutsideInsConfig] object | 云实例配置 | | period_num | 是 | Integer | 订购周期数目 | | period_type | 是 | Integer | 订购周期类型 | | product_infos | 是 | Array of [ProductInfoBeanNew] objects | 产品列表 | | promotion_activity_id | 否 | String | 促销ID | | promotion_info | 否 | String | 折扣信息 | | public_ip | 否 | [PublicIp] object | 弹性IP | | region_id | 否 | String | 区域ID | | security_groups | 是 | Array of [SecurityGroup] objects | 安全组信息 | | subscription_num | 是 | Integer | 订购数量，当前仅支持1台 | | vpc_id | 是 | String | VPC ID | 表4ResourceTagInfoBean | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 否 | String | 标签KEY | | value | 是 | String | 标签VALUE | 表5Nic | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | ip_address | 否 | String | IP地址，不填或空字符串为自动分配 | | subnet_id | 否 | String | 子网ID | 表6OutsideInsConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | master_node_ip | 否 | String | 主节点IP | | slave_node_ip | 否 | String | 从节点IP | | virtual_ip | 否 | String | 虚拟IP | 表7ProductInfoBeanNew | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | all_resource_names | 否 | Array of strings | 所有资源名称 | | cloud_service_type | 否 | String | 云服务类型 | | display_id | 否 | String | 显示ID | | product_id | 否 | String | 产品ID | | product_spec_desc | 否 | String | 产品规格描述 | | resource_name | 否 | String | 资源名称 | | resource_spec_code | 否 | String | 资源规格 | | resource_type | 否 | String | 资源类型: - hws.resource.type.dbss：数据库审计 | 表8PublicIp | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | eip | 否 | [EIP] object | EIP信息 | | id | 否 | String | IP地址ID | 表9EIP | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | bandwidth | 否 | [BandWidth] object | 带宽参数 | | ipproductid | 否 | String | IP产品ID | | iptype | 否 | String | EIP类型 | 表10BandWidth | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | chargemode | 否 | String | 计费类型 | | productid | 否 | String | 带宽对应产品ID | | sharetype | 否 | String | 共享类型，目前仅支持PER | | size | 否 | Integer | 带宽，按需1-100M，包年包月1-300M | 表11SecurityGroup | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | id | 否 | String | 安全组ID | #### 响应参数 **状态码：200** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | 返回码 | | description | String | 描述信息 | | order_id | String | 订单ID | **状态码：400** 表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错误信息 | **状态码：401** 表15响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | details | Array of [DbssErrorDetail] objects | PDP5鉴权异常信息 | | encoded_authorization_message | String | PDP5鉴权异常信息 | | error_code | String | 错误码 | | error_msg | String | 错误信息 | 表16DbssErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码 | | error_msg | String | PDP5错误信息 | **状态码：403** 表17响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | details | Array of [DbssErrorDetail] objects | PDP5鉴权异常信息 | | encoded_authorization_message | String | PDP5鉴权异常信息 | | error_code | String | 错误码 | | error_msg | String | 错误信息 | 表18DbssErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码 | | error_msg | String | PDP5错误信息 | **状态码：500** 表19响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | details | Array of [DbssErrorDetail] objects | PDP5鉴权异常信息 | | encoded_authorization_message | String | PDP5鉴权异常信息 | | error_code | String | 错误码 | | error_msg | String | 错误信息 | 表20DbssErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码 | | error_msg | String | PDP5错误信息 | #### 请求示例 ``` /v2/{project_id}/db-om/charge/period/order { "deploy_mode" : "CLOUD", "flavor_ref" : "s6.2xlarge.2", "name" : "DBSS-f5e1", "vpc_id" : "21f3dac4-f460-4173-ba5e-cb7a0d528605", "availability_zone" : "cn-north-7c,cn-north-7c", "nics" : [ { "subnet_id" : "cbed162e-045a-4afd-aa2b-0da11219989c" } ], "security_groups" : [ { "id" : "0070ec22-bae4-4df3-af3d-9f928297b3b7" } ], "cloud_service_type" : "hws.service.type.dbss", "charging_mode" : 0, "period_type" : 2, "period_num" : 1, "subscription_num" : 1, "is_auto_renew" : 0, "promotion_info" : "", "product_infos" : [ { "product_id" : "OFFI10097xxxxxxxxxxxx693761", "cloud_service_type" : "hws.service.type.dbss", "resource_type" : "hws.resource.type.dbss.opsmgmt", "resource_spec_code" : "dbss.opsmgmt.high", "product_spec_desc" : "{\"specDesc\":{\"zh-cn\":{\"主机名称\":\"DBSS-e3f5\",\"规格\":\"数据库审计运维增强版\",\"虚拟私有云\":\"VPC-IPV4-请勿开启ipv6\",\"子网\":\"subnet-ipv4\"},\"en-us\":{\"Instance Name\":\"DBSS-e3f5\",\"Edition\":\"数据库审计运维增强版\",\"VPC\":\"VPC-IPV4-请勿开启ipv6\",\"Subnet\":\"subnet-ipv4\"}}}" } ], "region_id" : "cn-north-7", "hx_password" : "Firelxxxxxxx123!", "asset_nums" : 10, "image_business_type" : 1, "public_ip" : { "id" : "df0d32e1-671e-482b-bafd-413fa67d3add", "eip" : null }, "enterprise_project_id" : "0" } ``` #### 响应示例 **状态码：200** OK ``` { "description" : "Success", "code" : "0", "order_id" : "CS250825171489W7N" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | 请求参数有误 | | 401 | 认证失败 | | 403 | 未授权 | | 500 | 服务端错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-dbss/ErrorCode.html)。