查詢VPC邊界防火墻(防護通過高速通道連接的兩個VPC之間的流量)的詳細信息。
接口說明
本接口用于獲取 VPC 邊界防火墻的詳細信息。該 VPC 邊界防火墻是防護通過高速通道連接的兩個 VPC 之間的流量。 調用本接口前,必須已經調用 CreateVpcFirewallConfigure 接口創建了 VPC 邊界防火墻。
QPS 限制
本接口的單用戶 QPS 限制為 10 次/秒。超過限制,API 調用將會被限流,這可能影響您的業務,請合理調用。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
yundun-cloudfirewall:DescribeVpcFirewallDetail | get |
|
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Lang | string | 否 | 請求和接收消息的語言類型。取值:
| zh |
VpcFirewallId | string | 是 | VPC 邊界防火墻的實例 ID。 說明
您可以調用 DescribeVpcFirewallList 接口查詢 VPC 邊界防火墻的實例 ID。
| vfw-m5e7dbc4y**** |
LocalVpcId | string | 否 | 本端 VPC 的實例 ID。 | vpc-8vbwbo90rq0anm6t**** |
PeerVpcId | string | 否 | 對端 VPC 的實例 ID。 | vpc-90rq0anm6t8vbwbo**** |
返回參數
示例
正常返回示例
JSON
格式
{
"ConnectType": "expressconnect",
"VpcFirewallId": "vfw-m5e7dbc4y****",
"RequestId": "850A84D6-0DE4-4797-A1E8-00090125g4d2",
"Bandwidth": 2,
"VpcFirewallName": "測試防火墻",
"FirewallSwitchStatus": "opened",
"LocalVpc": {
"VpcId": "vpc-8vbwbo90rq0anm6t****",
"VpcName": "測試用實例",
"RegionNo": "cn-hangzhou",
"EniPrivateIpAddress": "192.168.XX.XX",
"RouterInterfaceId": "vrt-m5eb5me6c3l5sezae****",
"EniId": "eni-8vbhfosfqv2rff42****",
"VpcCidrTableList": [
{
"RouteTableId": "vtb-1234",
"RouteEntryList": [
{
"NextHopInstanceId": "vrt-m5eb5me6c3l5sezae****",
"DestinationCidr": "192.168.XX.XX/24"
}
]
}
]
},
"PeerVpc": {
"VpcId": "vpc-90rq0anm6t8vbwbo****",
"VpcName": "測試vpc2",
"RegionNo": "cn-hangzhou",
"EniPrivateIpAddress": "192.168.XX.XX",
"RouterInterfaceId": "vrt-m5eb5me6c3l5sezae****",
"EniId": "eni-8vbhfosfqv2rff42****",
"VpcCidrTableList": [
{
"RouteTableId": "vtb-1256",
"RouteEntryList": [
{
"NextHopInstanceId": "vrt-m5eb5me6c3l5sezae****",
"DestinationCidr": "192.168.XX.XX/24"
}
]
}
]
},
"MemberUid": "258039427902****"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | ErrorAliUid | The aliuid is invalid. | 無效的用戶id |
400 | ErrorFirewallNotFound | Firewall not found | 防火墻不存在 |
400 | ErrorDBSelectError | A database select error occurred. | 內部錯誤:數據庫查詢錯誤 |
400 | ErrorInvalidMemberUid | Member uid is invalid | 成員賬號錯誤. |
400 | ErrorFirewallStatus | firewall status error. | 防火墻狀態錯誤,請稍后再試。 |
400 | ErrorVpcIdPara | vpc id and firewall id parameter not exist. | 防火墻VPC參數錯誤,請重新選擇。 |
400 | ErrorLocalVpcIdPeerVpcIdError | local vpc id and peer vpc id cannot be empty at the same time. | 防火墻VPC參數錯誤,請重新選擇。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-09-05 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2022-12-08 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更、OpenAPI 返回結構發生變更 | 查看變更詳情 |