更新时间:2024-10-31 GMT+08:00
分享

创建东西向防火墙

功能介绍

创建东西向防火墙

调用方法

请参见如何调用API

URI

POST /v1/{project_id}/firewall/east-west

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

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

fw_instance_id

String

防火墙id,可通过防火墙ID获取方式获取

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

表4 请求Body参数

参数

是否必选

参数类型

描述

er_id

String

出方向关联ER ID,可通过ER服务查询企业路由器列表接口获得,返回值中instances.id即为erid(.表示各对象之间层级的区分)

inspection_cidr

String

创建引流VPC时使用的网段

mode

String

东西向防火墙模式,填写er

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

data

CreateEWFirewallResp object

创建东西向防火墙返回值

表6 CreateEWFirewallResp

参数

参数类型

描述

id

String

东西向防护id,对应object_id字段

er

ER object

ER信息

inspertion_vpc

CreateEWFirewallInspectVpcResp object

引流vpc信息

表7 ER

参数

参数类型

描述

er_id

String

ER ID,创建东西向防护引用的 ID

er_attach_id

String

企业路由器连接id,该连接用于连接防火墙和企业路由器,此字段可在通过id在ER界面查询指定er后在管理连接界面查询连接了解连接具体情况。

表8 CreateEWFirewallInspectVpcResp

参数

参数类型

描述

vpc_id

String

引流VPC的ID

subnet_ids

Array of strings

创建的引流VPC的子网ID列表

请求示例

项目09bb24e6f280d23d0f9fc0104b901480下防火墙55b26ab5-e4b0-40e8-941c-a1778fe2a500创建er模式防火墙inspection_cidr为10.1.0.0/24,er_id为e0b22a23-02cf-4092-ace9-34b39e10dc77。

https://{Endpoint}/v1/09bb24e6f280d23d0f9fc0104b901480/firewall/east-west?fw_instance_id=55b26ab5-e4b0-40e8-941c-a1778fe2a500&enterprise_project_id=default

{
  "inspection_cidr" : "10.1.0.0/24",
  "mode" : "er",
  "er_id" : "e0b22a23-02cf-4092-ace9-34b39e10dc77"
}

响应示例

状态码: 200

创建东西向防火墙返回值

{
  "data" : {
    "id" : "acc86ca7-818b-4c3d-8a9a-3915a2b21651",
    "er" : {
      "er_id" : "f0f5275a-40aa-4d1e-ac78-2550f7818d43",
      "er_attach_id" : "bd62ddd3-5e20-482b-aefa-9e2940e2b1a9"
    },
    "inspertion_vpc" : {
      "vpc_id" : "00672633-0466-4c35-99ef-5e3f5c813a4b",
      "subnet_ids" : [ "294682a0-1e85-45f5-92c8-e52bee09c204", "a86277bb-35d5-4442-bc0b-2e9d4e6a9080", "95829240-14e0-47e6-b9e7-2ac228e7b00f" ]
    }
  }
}

状态码

状态码

描述

200

创建东西向防火墙返回值

错误码

请参见错误码

相关文档