功能介紹
查詢提交請求的租戶有權限操作的所有網絡ACL組信息。單次查詢最多返回2000條數據，超過2000后會返回分頁標記。分頁查詢請參考分頁查詢。
調試
您可以在API Explorer中調試該接口。
URI
GET /v2.0/fwaas/firewall_groups
分頁查詢樣例：
GET https://{Endpoint}/v2.0/fwaas/firewall_groups?limit=2&marker=cd600d47-0045-483f-87a1-5041ae2f513b&page_reverse=False
|
名稱 |
是否必選 |
參數類型 |
說明 |
|---|---|---|---|
|
id |
否 |
String |
按照網絡ACL組對應的ID過濾查詢 |
|
name |
否 |
String |
按照網絡ACL組的名稱過濾查詢 |
|
description |
否 |
String |
按照網絡ACL組的描述過濾查詢 |
|
admin_state_up |
否 |
Boolean |
按照網絡ACL組的管理狀態(tài)過濾查詢 取值范圍：true or false |
|
tenant_id |
否 |
String |
按照網絡ACL組所屬的項目ID過濾查詢 |
|
marker |
否 |
String |
分頁查詢的起始資源ID，表示從指定資源的下一條記錄開始查詢。 marker需要和limit配合使用：
|
|
limit |
否 |
Integer |
分頁查詢每頁返回的記錄個數，取值范圍為0~intmax（2^31-1），默認值2000。 limit需要和marker配合使用，詳細規(guī)則請見marker的參數說明。 |
請求參數
無。
請求示例
GET https://{Endpoint}/v2.0/fwaas/firewall_groups
響應參數
|
參數名稱 |
類型 |
說明 |
|---|---|---|
|
firewall_groups |
||
|
firewall_groups_links |
firewall_groups_link對象列表。請參見表4。 只有在使用limit過濾，并且資源個數超過limit或者資源個數超過2000時（limit默認值），該參數的rel和href取值才會顯示為next和其對應的link。 |
|
屬性 |
類型 |
說明 |
|---|---|---|
|
id |
String |
網絡ACL組的uuid標識。 |
|
name |
String |
網絡ACL組名稱。 |
|
description |
String |
網絡ACL組描述。 |
|
tenant_id |
String |
項目ID |
|
ingress_firewall_policy_id |
String |
入方向網絡ACL策略。 |
|
egress_firewall_policy_id |
String |
出方向網絡ACL策略。 |
|
ports |
Array of strings |
網絡ACL組綁定的端口列表。 |
|
public |
Boolean |
是否支持跨租戶共享。 |
|
status |
String |
網絡ACL組的狀態(tài)。 |
|
admin_state_up |
Boolean |
網絡ACL的管理狀態(tài)。 |
|
project_id |
String |
項目ID，請參見獲取項目ID。 |
|
created_at |
String |
資源創(chuàng)建時間，UTC時間 格式：yyyy-MM-ddTHH:mm:ss |
|
updated_at |
String |
資源更新時間，UTC時間 格式：yyyy-MM-ddTHH:mm:ss |
響應示例
{
"firewall_groups": [
{
"status": "INACTIVE",
"public": false,
"egress_firewall_policy_id": null,
"name": "",
"admin_state_up": true,
"ports": [ ],
"tenant_id": "23c8a121505047b6869edf39f3062712",
"id": "cd600d47-0045-483f-87a1-5041ae2f513b",
"ingress_firewall_policy_id": null,
"description": "",
"project_id": "23c8a121505047b6869edf39f3062712",
"created_at": "2018-09-12T08:24:14",
"updated_at": "2018-09-12T08:24:14"
},
{
"status": "INACTIVE",
"public": false,
"egress_firewall_policy_id": "d939df29-fe76-4089-90c3-3778e4d53141",
"name": "fwg-1475475043",
"admin_state_up": true,
"ports": [ ],
"tenant_id": "0af57070695044ea9a70f04779e6aa1f",
"id": "ca971b45-70ce-4879-9734-b6cac1d00845",
"ingress_firewall_policy_id": "d939df29-fe76-4089-90c3-3778e4d53141",
"description": "",
"project_id": "0af57070695044ea9a70f04779e6aa1f",
"created_at": "2018-09-12T08:24:14",
"updated_at": "2018-09-12T08:24:14"
}
],
"firewall_groups_links": [
{ "rel": "previous",
"href": "https://{Endpoint}/v2.0/fwaas/firewall_groups?
marker=cd600d47-0045-483f-87a1-5041ae2f513b&page_reverse=True"
}
]
}
狀態(tài)碼
請參見狀態(tài)碼。
錯誤碼
請參見錯誤碼。
