更新时间:2025-12-29 GMT+08:00

创建防火墙

功能介绍

创建防火墙

URI

POST /v2/{project_id}/firewall

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID, 可以从调API处获取,也可以从控制台获取。项目ID获取方式

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。可通过如何获取用户Token获取。

Content-Type

String

内容类型,只有application/json的值是适用的

表3 请求Body参数

参数

是否必选

参数类型

描述

name

String

防火墙名称

enterprise_project_id

String

企业项目ID,用户根据组织规划企业项目,对应的ID为企业项目ID,可通过如何获取企业项目ID获取,用户未开启企业项目时为0

tags

Array of tags objects

服务资源标签列表,防火墙资源添加标签后,可根据键、值组合查询资源,同时可根据键、值组合进行话单合并统计。

flavor

flavor object

防火墙规格信息

charge_info

charge_info object

计费类型信息,默认为按需。

表4 tags

参数

是否必选

参数类型

描述

key

String

资源标签键

value

String

资源标签值

表5 flavor

参数

是否必选

参数类型

描述

version

String

防火墙版本,仅支持专业版。

表6 charge_info

参数

是否必选

参数类型

描述

charge_mode

String

计费模式。仅支持postPaid:后付费,即按需付费。

响应参数

状态码:200

表7 响应Body参数

参数

参数类型

描述

job_id

String

实例创建的任务id。仅创建按需实例时会返回该参数。

order_id

String

订单号,创建包年包月时返回该参数。

data

CreateFirewallReq object

创建防火墙请求体

表8 CreateFirewallReq

参数

参数类型

描述

name

String

防火墙名称

enterprise_project_id

String

企业项目ID,用户根据组织规划企业项目,对应的ID为企业项目ID,可通过如何获取企业项目ID获取,用户未开启企业项目时为0

tags

Array of tags objects

服务资源标签列表,防火墙资源添加标签后,可根据键、值组合查询资源,同时可根据键、值组合进行话单合并统计。

flavor

flavor object

防火墙规格信息

charge_info

charge_info object

计费类型信息,默认为按需。

表9 tags

参数

参数类型

描述

key

String

资源标签键

value

String

资源标签值

表10 flavor

参数

参数类型

描述

version

String

防火墙版本,仅支持专业版。

表11 charge_info

参数

参数类型

描述

charge_mode

String

计费模式。仅支持postPaid:后付费,即按需付费。

状态码:400

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

项目ID为124147da-5b08-471a-93d2-bc82acc290c6的客户开通标准版防火墙,防火墙名称为CFW-Test,企业项目ID为0,资源标签传入一个键值对,键为TagKey,值为TagValue,扩展防护EIP2000个,扩展EIP防护带宽5000Mbps,扩展防护VPC100个,按需计费。

https://{Endpoint}/v2/124147da-5b08-471a-93d2-bc82acc290c6/firewall

{
  "name" : "CFW-TEST",
  "enterprise_project_id" : "0",
  "tags" : [ {
    "key" : "TagKey",
    "value" : "TagVal"
  } ],
  "flavor" : {
    "version" : "standard",
    "extend_eip_count" : 2000,
    "extend_bandwidth" : 5000,
    "extend_vpc_count" : 100
  },
  "charge_info" : {
    "charge_mode" : "postPaid"
  }
}

响应示例

状态码:200

购买防火墙成功返回信息。

{
  "data" : {
    "charge_info" : {
      "charge_mode" : "postPaid"
    },
    "enterprise_project_id" : "0",
    "flavor" : {
      "extend_bandwidth" : 5000,
      "extend_eip_count" : 2000,
      "extend_vpc_count" : 100,
      "version" : "Standard"
    },
    "name" : "CFW-TEST",
    "tags" : [ {
      "key" : "TagKey",
      "value" : "TagVal"
    } ]
  },
  "job_id" : "CS2403271050ZEM0L"
}

状态码:400

错误返回信息。

{
  "error_code" : "CFW.00100001",
  "error_msg" : "系统繁忙,请稍后重试"
}

状态码

状态码

描述

200

购买防火墙成功返回信息。

400

错误返回信息。

错误码

请参见错误码