创建私网网段 - BatchCreatePrivateNetworkSegments
功能介绍
添加私网网段的接口,添加私网网段后该网段的流量将引流到VPC防火墙防护
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
POST /v2/{project_id}/firewall/{fw_instance_id}/east-west/private-network-segments/batch-create
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
private_network_segments |
是 |
Array of PrivateNetworkSegmentVO objects |
参数解释: 私网网段的信息列表,用于东西向VPC防护引流 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
conf_id |
否 |
String |
参数解释: 私网网段ID,更新私网网段时需要 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
protect_network |
是 |
String |
参数解释: 私网网段,格式为:IP/Mask 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
az_info |
否 |
String |
参数解释: 私网网段的可用区信息,如AZ1 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
subnet_name |
否 |
String |
参数解释: 子网名称 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
data |
String |
参数解释: 防火墙ID 取值范围: 不涉及 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释: 错误码 取值范围: 不涉及 |
|
error_msg |
String |
参数解释: 错误描述 取值范围: 不涉及 |
请求示例
创建东西向私网网段,项目ID为176d761dc156471c9c9b227376594160,防火墙ID为48e074e4-3b1a-448b-a17f-2fd2a12df1d2f,可用区为cn-north-7a,私网地址段为10.0.0.0/8
https://{Endpoint}v2/176d761dc156471c9c9b227376594160/firewall/48e074e4-3b1a-448b-a17f-2fd2a12df1d2/east-west/private-network-segments/batch-create
{
"private_network_segments" : [ {
"protect_network" : "10.0.0.0/8",
"subnet_name" : "test",
"az_info" : "cn-north-7a"
} ]
}
响应示例
状态码:200
更新私网网段成功,返回防火墙实例ID
{
"data" : "48e074e4-3b1a-448b-a17f-2fd2a12df1d2"
}
状态码:400
Bad Request
{
"error_code" : "CFW.00000008",
"error_msg" : "系统内部错误"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
更新私网网段成功,返回防火墙实例ID |
|
400 |
Bad Request |
错误码
请参见错误码。