查詢VPC邊界防火牆(防護通過Express Connect串連的兩個VPC之間的流量)的資訊。
介面說明
本介面一般用於分頁查詢 VPC 邊界防火牆的資訊。該 VPC 邊界防火牆是防護通過Express Connect串連兩個 VPC 之間的流量。
QPS 限制
本介面的單使用者 QPS 限制為 10 次/秒。超過限制,API 呼叫將會被限流,這可能影響您的業務,請合理調用。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| Lang |
string |
否 |
請求和接收訊息的語言類型。取值:
|
zh |
| Lang |
string |
否 |
請求和接收訊息的語言類型。取值:
|
zh |
| RegionNo |
string |
否 |
VPC 所在的地區 ID。 說明
關於Cloud Firewall支援地區的詳細資料,請參見支援的地區。 |
cn-hangzhou |
| VpcId |
string |
否 |
VPC 執行個體 ID。 |
vpc-8vbwbo90rq0anm6t**** |
| FirewallSwitchStatus |
string |
否 |
VPC 邊界防火牆的狀態。取值:
說明
不設定該參數表示查詢所有狀態的 VPC 邊界防火牆。 |
opened |
| VpcFirewallId |
string |
否 |
VPC 邊界防火牆的執行個體 ID。 |
vfw-m5e7dbc4y**** |
| VpcFirewallName |
string |
否 |
VPC 邊界防火牆的執行個體名稱。 |
test-vpc-firewall |
| CurrentPage |
string |
否 |
分頁查詢時,設定當前頁面的頁碼。 預設值為 1,表示返回第 1 頁資料。 |
1 |
| PageSize |
string |
否 |
分頁查詢時,設定每頁包含 VPC 邊界防火牆的數量。 預設值為 10,表示每頁包含 10 條結果。最大值為 50。 |
10 |
| MemberUid |
string |
否 |
當前阿里雲帳號的成員帳號 UID。 |
258039427902**** |
| ConnectSubType |
string |
否 |
串連子類型。取值:
|
vpcpeer |
| PeerUid |
string |
否 |
對端 VPC 雲帳號 UID。 |
258039427902**** |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
VPC 防火牆的列表。 |
||
| TotalCount |
integer |
VPC 邊界防火牆的總數量。 |
10 |
| RequestId |
string |
本次請求的 ID。 |
850A84D6-0DE4-4797-A1E8-00090125k8g2 |
| VpcFirewalls |
array<object> |
VPC 邊界防火牆的詳細資料。 |
|
|
array<object> |
VPC 邊界防火牆的詳細資料。 |
||
| ConnectType |
string |
VPC 邊界防火牆的互連類型。取值:expressconnect,表示Express Connect。 |
expressconnect |
| VpcFirewallId |
string |
VPC 邊界防火牆的執行個體 ID。 |
vfw-m5e7dbc4y**** |
| RegionStatus |
string |
地區開放狀態。取值:
|
enable |
| Bandwidth |
integer |
Express Connect的頻寬規格。單位:Mbps。 |
2 |
| VpcFirewallName |
string |
VPC 邊界防火牆的執行個體名稱。 |
test-firewall |
| FirewallSwitchStatus |
string |
VPC 邊界防火牆開關的狀態。取值:
|
opened |
| LocalVpc |
object |
本端 VPC 的詳細資料。 |
|
| VpcName |
string |
本端 VPC 的執行個體名稱。 |
test-vpc1 |
| VpcId |
string |
本端 VPC 的執行個體 ID。 |
vpc-8vbwbo90rq0anm6t**** |
| AuthorizationStatus |
string |
本端 VPC 的授權狀態。取值:authorized,表示已授權。 |
authorized |
| OwnerId |
integer |
本端 VPC 所屬阿里雲帳號的 UID。 |
158039427902**** |
| RegionNo |
string |
本端 VPC 所屬地區 ID。 |
cn-hangzhou |
| VpcCidrTableList |
array<object> |
本端 VPC 的網段列表資訊。 |
|
|
array<object> |
本端 VPC 的網段列表資訊。 |
||
| RouteTableId |
string |
本端 VPC 的路由表 ID。 |
vtb-1234 |
| RouteEntryList |
array<object> |
本端 VPC 的路由條目列表。 |
|
|
object |
本端 VPC 的路由條目列表。 |
||
| NextHopInstanceId |
string |
本端 VPC 的下一跳執行個體 ID。 |
vrt-m5eb5me6c3l5sezae**** |
| DestinationCidr |
string |
本端 VPC 的目標網段。 |
192.168.XX.XX/24 |
| PeerVpc |
object |
對端 VPC 的詳細資料。 |
|
| VpcName |
string |
對端 VPC 的執行個體名稱。 |
test-vpc2 |
| VpcId |
string |
對端 VPC 的執行個體 ID。 |
vpc-8vbwbo90rq0anm6t**** |
| AuthorizationStatus |
string |
對端 VPC 的授權狀態。取值:authorized,表示已授權。 |
authorized |
| OwnerId |
integer |
對端 VPC 所屬的阿里雲帳號的 UID。 |
158039427902**** |
| RegionNo |
string |
對端 VPC 所屬地區 ID。 |
cn-hangzhou |
| VpcCidrTableList |
array<object> |
對端 VPC 網段列表資訊。 |
|
|
array<object> |
對端 VPC 網段列表資訊。 |
||
| RouteTableId |
string |
對端 VPC 的路由表 ID。 |
vtb-1256 |
| RouteEntryList |
array<object> |
對端 VPC 路由條目列表資訊。 |
|
|
object |
對端 VPC 路由條目列表資訊。 |
||
| NextHopInstanceId |
string |
對端 VPC 的下一跳執行個體 ID。 |
vrt-m5eb5me6c3l5sezae**** |
| DestinationCidr |
string |
對端 VPC 的目標網段。 |
192.168.XX.XX/24 |
| IpsConfig |
object |
IPS 配置資訊。 |
|
| BasicRules |
integer |
基礎規則開關。取值:
|
1 |
| EnableAllPatch |
integer |
虛擬補丁開關。取值:
|
1 |
| RunMode |
integer |
IPS 防禦模式。取值:
|
0 |
| RuleClass |
integer |
IPS 規則群組。取值:
|
1 |
| MemberUid |
string |
阿里雲成員帳號的 UID。 |
258039427902**** |
| ResultCode |
string |
建立 VPC 邊界防火牆的操作結果代碼。取值:
|
Unauthorized |
| ConnectSubType |
string |
串連子類型。取值:
|
vpcpeer |
| AclConfig |
object |
ACL 引擎模式。 |
|
| StrictMode |
integer |
是否啟用strict 模式
|
1 |
樣本
正常返回樣本
JSON格式
{
"TotalCount": 10,
"RequestId": "850A84D6-0DE4-4797-A1E8-00090125k8g2",
"VpcFirewalls": [
{
"ConnectType": "expressconnect",
"VpcFirewallId": "vfw-m5e7dbc4y****",
"RegionStatus": "enable",
"Bandwidth": 2,
"VpcFirewallName": "test-firewall",
"FirewallSwitchStatus": "opened",
"LocalVpc": {
"VpcName": "test-vpc1",
"VpcId": "vpc-8vbwbo90rq0anm6t****",
"AuthorizationStatus": "authorized",
"OwnerId": 0,
"RegionNo": "cn-hangzhou",
"VpcCidrTableList": [
{
"RouteTableId": "vtb-1234",
"RouteEntryList": [
{
"NextHopInstanceId": "vrt-m5eb5me6c3l5sezae****",
"DestinationCidr": "192.168.XX.XX/24"
}
]
}
]
},
"PeerVpc": {
"VpcName": "test-vpc2",
"VpcId": "vpc-8vbwbo90rq0anm6t****",
"AuthorizationStatus": "authorized",
"OwnerId": 0,
"RegionNo": "cn-hangzhou",
"VpcCidrTableList": [
{
"RouteTableId": "vtb-1256",
"RouteEntryList": [
{
"NextHopInstanceId": "vrt-m5eb5me6c3l5sezae****",
"DestinationCidr": "192.168.XX.XX/24"
}
]
}
]
},
"IpsConfig": {
"BasicRules": 1,
"EnableAllPatch": 1,
"RunMode": 0,
"RuleClass": 1
},
"MemberUid": "258039427902****",
"ResultCode": "Unauthorized",
"ConnectSubType": "vpcpeer",
"AclConfig": {
"StrictMode": 1
}
}
]
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | ErrorDBSelectError | A database select error occurred. | 內部錯誤:資料庫查詢錯誤 |
| 400 | ErrorPageNo | Either page number or page size is invalid. | 無效的page number 或者 page size |
| 400 | ErrorUnmarshalJSON | An error occurred while parsing JSON. | 內部錯誤:JSON解碼錯誤 |
| 400 | ErrorAliUid | Aliuid invalid. | aliuid無效 |
| 400 | ErrorFirewallStatus | Firewall status error, please try again later. | 防火牆狀態錯誤,請稍後再試 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。