華為云計算 云知識 查詢所有網(wǎng)絡(luò)ACL策略NeutronListFirewallPolicies
查詢所有網(wǎng)絡(luò)ACL策略NeutronListFirewallPolicies

 

功能介紹

查詢提交請求的租戶有權(quán)限操作的所有網(wǎng)絡(luò)ACL策略信息。單次查詢最多返回2000條數(shù)據(jù),超過2000后會返回分頁標(biāo)記。分頁查詢請參考分頁查詢。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

GET /v2.0/fwaas/firewall_policies

分頁查詢樣例:

GET https://{Endpoint}/v2.0/fwaas/firewall_policies?limit=2&
marker=6b70e321-0c21-4b83-bb8a-a886d1414a5f&page_reverse=False

參數(shù)說明請參見表1

表1 參數(shù)說明

名稱

是否必選

參數(shù)類型

說明

id

String

按照網(wǎng)絡(luò)ACL策略對應(yīng)的ID過濾查詢

name

String

按照網(wǎng)絡(luò)ACL策略的名稱過濾查詢

description

String

按照網(wǎng)絡(luò)ACL策略的描述過濾查詢

tenant_id

String

按照網(wǎng)絡(luò)ACL策略所屬的項目ID過濾查詢

marker

String

分頁查詢的起始資源ID,表示從指定資源的下一條記錄開始查詢。

marker需要和limit配合使用:

  • 若不傳入marker和limit參數(shù),查詢結(jié)果返回第一頁全部資源記錄。
  • 若不傳入marker參數(shù),limit為10,查詢結(jié)果返回第1~10條資源記錄。
  • 若marker為第10條記錄的資源ID,limit為10,查詢結(jié)果返回第11~20條資源記錄。
  • 若marker為第10條記錄的資源ID,不傳入limit參數(shù),查詢結(jié)果返回第11條及之后的所有資源記錄。

limit

Integer

分頁查詢每頁返回的記錄個數(shù),取值范圍為0~intmax(2^31-1),默認(rèn)值2000。

limit需要和marker配合使用,詳細(xì)規(guī)則請見marker的參數(shù)說明。

請求參數(shù)

無。

請求示例

GET https://{Endpoint}/v2.0/fwaas/firewall_policies

響應(yīng)參數(shù)

表2 響應(yīng)參數(shù)

參數(shù)名稱

類型

說明

firewall_policies

Array of firewall Policy object

firewall policy對象列表。請參見表3。

firewall_policies_links

Array of firewall_policies_link object

firewall_policies_link對象。請參見表4。

只有在使用limit過濾,并且資源個數(shù)超過limit或者資源個數(shù)超過2000時(limit默認(rèn)值),該參數(shù)的rel和href取值才會顯示為next和其對應(yīng)的link。

表3 firewall_Policy對象

屬性

類型

說明

id

String

網(wǎng)絡(luò)ACL策略uuid標(biāo)識。

name

String

網(wǎng)絡(luò)ACL策略名稱。

description

String

網(wǎng)絡(luò)ACL策略描述。

tenant_id

String

項目ID

firewall_rules

Array of strings

策略引用的網(wǎng)絡(luò)ACL規(guī)則鏈。

audited

Boolean

審計標(biāo)記。

public

Boolean

是否支持跨租戶共享。

project_id

String

項目ID,請參見獲取項目ID。

表4 firewall_policies_link對象

名稱

參數(shù)類型

說明

href

String

API鏈接

rel

String

API鏈接與該API版本的關(guān)系

響應(yīng)示例

{
    "firewall_policies": [
        {
            "description": "", 
            "firewall_rules": [
                "6c6803e0-ca8c-4aa9-afb3-4f89275b6c32"
            ], 
            "tenant_id": "23c8a121505047b6869edf39f3062712", 
            "public": false, 
            "id": "6b70e321-0c21-4b83-bb8a-a886d1414a5f", 
            "audited": false, 
            "name": "fwp1",
            "project_id": "23c8a121505047b6869edf39f3062712"
        }, 
        {
            "description": "", 
            "firewall_rules": [
                "6c6803e0-ca8c-4aa9-afb3-4f89275b6c32"
            ], 
            "tenant_id": "23c8a121505047b6869edf39f3062712", 
            "public": false, 
            "id": "fce92002-5a15-465d-aaca-9b44453bb738", 
            "audited": false, 
            "name": "fwp2",
            "project_id": "23c8a121505047b6869edf39f3062712"
        }
    ],
    "firewall_policies_links": [
       {    "rel": "previous", 
            "href": "https://{Endpoint}/v2.0/fwaas/firewall_policies?
marker=6b70e321-0c21-4b83-bb8a-a886d1414a5f&page_reverse=True" } ] }

狀態(tài)碼

請參見狀態(tài)碼

錯誤碼

請參見錯誤碼。