更新时间:2024-10-22 GMT+08:00

安全云脑按需订购

功能介绍

开通安全云脑按需服务

调用方法

请参见如何调用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

权限不足

错误码

请参见错误码