获取私网网段的信息 - ListPrivateNetworkSegments
功能介绍
东西向私网网段查询接口
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /v2/{project_id}/firewall/{fw_instance_id}/east-west/private-network-segments
请求参数
无
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
data |
ListPrivateNetworkSegmentsVO object |
参数解释： 私网网段信息列表 取值范围： 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
private_network_list |
Array of PrivateNetworkSegmentVO objects |
参数解释： 私网网段列表 取值范围： 不涉及 |
|
total |
Integer |
参数解释： 总条数 取值范围： 不涉及 |
|
quota |
Integer |
参数解释： 私网网段配额 取值范围： 不涉及 |
|
support_az_list |
Array of strings |
参数解释： 支持的可用区列表 取值范围： 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
conf_id |
String |
参数解释： 私网网段ID，更新私网网段时需要 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
protect_network |
String |
参数解释： 私网网段，格式为：IP/Mask 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
az_info |
String |
参数解释： 私网网段的可用区信息，如AZ1 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
subnet_name |
String |
参数解释： 子网名称 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释： 错误码 取值范围： 不涉及 |
|
error_msg |
String |
参数解释： 错误描述 取值范围： 不涉及 |
请求示例
查询东西向私网网段列表，项目ID为176d761dc156471c9c9b227376594160，防火墙ID为48e074e4-3b1a-448b-a17f-2fd2a12df1d2f
https://{Endpoint}v2/176d761dc156471c9c9b227376594160/firewall/48e074e4-3b1a-448b-a17f-2fd2a12df1d2/east-west/private-network-segments
响应示例
状态码：200
私网网段信息列表
{
"data" : {
"private_network_list" : [ {
"conf_id" : "4",
"protect_network" : "100.64.0.0/10"
}, {
"conf_id" : "1",
"protect_network" : "10.0.0.0/8",
"az_info" : "AZ1",
"subnet_name" : "test"
}, {
"conf_id" : "2",
"protect_network" : "172.16.0.0/12"
}, {
"conf_id" : "3",
"protect_network" : "192.168.0.0/16"
} ],
"total" : 4,
"quota" : 32,
"support_az_list" : [ "AZ1", "AZ3" ]
}
}
状态码：400
Bad Request
{
"error_code" : "CFW.00000008",
"error_msg" : "系统内部错误"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
私网网段信息列表 |
|
400 |
Bad Request |
错误码
请参见错误码。
