文档首页/ 安全云脑 SecMaster/ API参考/ API/ 计量计费管理/ 安全云脑按需订购
更新时间：2024-10-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

安全云脑按需订购

功能介绍

开通安全云脑按需服务

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/subscriptions/orders

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID

最小长度：32

最大长度：36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

最小长度：1

最大长度：2097152

X-Language

是

String

用户当前语言环境

最小长度：2

最大长度：6

枚举值：

  • zh-cn
  • en-us
表3 请求Body参数

参数

是否必选

参数类型

描述

region_id

是

String

区域ID，如cn-north-4

最小长度：1

最大长度：64

domain_id

是

String

domainId

最小长度：32

最大长度：36

tag_list

否

Array of TagInfo objects

计费标签

product_list

否

Array of ProductPostPaid objects

商品列表

operate_type

否

String

操作类型：create新购，addition增加配额

缺省值：create

最小长度：6

最大长度：10

枚举值：

  • create
  • addition
表4 TagInfo

参数

是否必选

参数类型

描述

key

是

String

标识 中文、字母、数字、_或者-，且长度范围[2, 36]

最小长度：2

最大长度：36

value

是

String

内容 中文、字母、数字、_或者-，且长度范围[2, 36]

最小长度：2

最大长度：36
表5 ProductPostPaid

参数

是否必选

参数类型

描述

id

是

String

ID标识，同一次询价中不能重复，用于标识返回询价结果和请求的映射关系

product_id

是

String

产品Id，通过向CBC询价获取该商品的标识

cloud_service_type

是

String

云服务类型，固定值为hws.service.type.sa

resource_type

是

String

用户购买云服务产品的资源类型，例如SecMaster中的典型场景配置，资源类型为hws.resource.type.secmaster.typical

resource_spec_code

是

String

用户购买云服务产品的资源规格，例如安全云脑中的的基础版，资源规格为secmaster.basic

usage_measure_id

是

Integer

使用量单位标识，按需询价必填，例如按小时询价，使用量值为1，使用量单位为小时，枚举值如下： 4：小时 10：GB（带宽按流量询价使用） 11：MB（带宽按流量询价使用）

最小值：1

最大值：20

枚举值：

  • 4
  • 10
  • 11

usage_value

是

Number

使用量值，按需询价必填，例如按小时询价，使用量值为1，使用量单位为小时

最小值：1

最大值：1

resource_size

是

Integer

配额个数

最小值：1

最大值：9999

usage_factor

是

String

使用量因子，按需计费必填，取值和话单中的使用量因子一致，云服务和使用量因子对应关系如下： 典型场景配置：Duration 态势管理：duration 安全编排：count 智能分析：flow

最小长度：4

最大长度：10

resource_id

否

String

资源id，仅在增加配额的时候传入

响应参数

无

请求示例

https://{endpoint}/v1/{projectId}/subscriptions/orders

{
  "domain_id" : "abcdef8a41164a2280ec65f1f4c4mlnyz",
  "region_id" : "cn-north-4",
  "product_list" : [ {
    "product_id" : "OFFI908269345109094402",
    "cloud_service_type" : "hws.service.type.sa",
    "id" : "E52E1A22-9408-459A-9F67-7B5C11B1E71A",
    "resource_spec_code" : "secmaster.professional",
    "resource_type" : "hws.resource.type.secmaster.typical",
    "usage_factor" : "duration",
    "usage_value" : 1,
    "usage_measure_id" : 4,
    "resource_size" : 1
  } ]
}

响应示例

状态码： 400

参数异常

{
  "error_msg" : "云脑已包含【xx版】，如有需要请升级版本或增加配额",
  "error_code" : "SecMaster.00010201"
}

状态码

状态码

描述

200

请求成功

400

参数异常

403

权限不足

错误码

请参见错误码。

父主题： 计量计费管理

相关文档