查询网络ACL详情 - ShowFirewall
功能介绍
查询网络ACL详情。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
GET /v1/firewalls/{firewall_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
firewall_id |
是 |
String |
网络ACL ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
firewall |
Firewall object |
网络ACL对象。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
网络ACL ID |
|
name |
String |
网络ACL名称。 |
|
admin_state_up |
Boolean |
网络ACL使能开关。 取值范围：true（开启），false（关闭）。默认为true |
|
status |
String |
网络ACL状态。 取值范围：INACTIVE |
|
description |
String |
网络ACL描述。 |
|
domain_id |
String |
租户domainID |
|
egress_firewall_policy |
FirewallPolicyResp object |
出方向网络ACL策略。 创建或查询防火墙列表时只返回ACL策略ID。 |
|
egress_firewall_rule_count |
Integer |
出方向网络ACL规则个数。 |
|
ingress_firewall_policy |
FirewallPolicyResp object |
入方向网络ACL策略。 创建或查询防火墙列表时只返回ACL策略ID。 |
|
ingress_firewall_rule_count |
Integer |
入方向网络ACL规则个数。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
网络ACL策略ID。 |
|
name |
String |
网络ACL策略名称。 |
|
firewall_rules |
Array of FirewallRuleResp objects |
网络ACL规则列表对象。 |
|
insert_after |
String |
ACL规则ID，表示在此ACL规则之后添加ACL规则 |
|
insert_before |
String |
ACL规则ID，表示在此ACL规则之前添加ACL规则 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
action |
String |
策略是否允许 取值范围：allow，deny，reject |
|
description |
String |
网络ACL规则描述。 |
|
destination_ip_address |
String |
目的地IP地址，IPv4或IPv6的CIDR格式 |
|
destination_port |
String |
目的地端口范围 取值范围：整数，比如80，或者以"-"隔开的范围，比如80-90 |
|
enabled |
Boolean |
网络ACL规则使能开关。 取值范围：true，false |
|
id |
String |
网络ACL规则ID。 进行更新规则时，如果operate_type为add，则该值为空。 |
|
ip_version |
Integer |
IP协议版本 取值范围：4, 表示ipv4；6, 表示ipv6 |
|
name |
String |
网络ACL规则名称。 |
|
operate_type |
String |
网络ACL规则操作状态，作为请求时取值为"add"/"modify"/"delete"，作为返回值时为"normal"。 当请求更新规则时，本参数值为delete时，除id之外，本请求体其他参数均可为空。 |
|
protocol |
String |
IP协议，为any时代表所有协议 取值范围： icmp，tcp，udp，icmpv6，any |
|
source_ip_address |
String |
源IP地址，IPv4或IPv6的CIDR格式 |
|
source_port |
String |
源地端口范围 取值范围：整数，比如80，或者以"-"隔开的范围，比如80-90 |
请求示例
GET https://{endpoint}/v1/firewalls/c2c5234b-67ff-11ea-a41a-00e04c9bd2a3
响应示例
状态码：200
OK
{
"firewall" : {
"id" : "c2c5234b-67ff-11ea-a41a-00e04c9bd2a3",
"domain_id" : "2b76febbe5d34eac85d26435c1f15809",
"name" : "test",
"description" : "test",
"admin_state_up" : true,
"status" : "INACTIVE",
"ingress_firewall_policy" : {
"id" : "dd1b46d8-bff8-41d5-b79d-b96c300371d7",
"name" : "ingress_firewall_policy",
"firewall_rules" : [ {
"id" : "1d49edb1-6845-11ea-95d5-00e04c9bd2a3",
"name" : "test",
"description" : "test",
"enabled" : true,
"action" : "allow",
"protocol" : "tcp",
"ip_version" : 4,
"destination_ip_address" : "0.0.0.0/12",
"destination_port" : "443",
"source_ip_address" : "0.0.0.0/24",
"source_port" : "35",
"operate_type" : "normal"
} ]
},
"egress_firewall_policy" : {
"id" : "55821488-d69b-596c-b529-9c5e16734811",
"name" : "egress_firewall_policy",
"firewall_rules" : [ {
"id" : "5cb41787-6804-11ea-a41a-00e04c9bd2a3",
"name" : "testt",
"description" : "testt",
"enabled" : true,
"action" : "allow",
"protocol" : "tcp",
"ip_version" : 4,
"destination_ip_address" : "0.0.0.0/12",
"destination_port" : "443",
"source_ip_address" : "0.0.0.0/24",
"source_port" : "35",
"operate_type" : "normal"
} ]
}
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。
