功能介紹
查詢(xún)提交請(qǐng)求的租戶(hù)有權(quán)限操作的所有網(wǎng)絡(luò)ACL組信息。單次查詢(xún)最多返回2000條數(shù)據(jù)，超過(guò)2000后會(huì)返回分頁(yè)標(biāo)記。分頁(yè)查詢(xún)請(qǐng)參考分頁(yè)查詢(xún)。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /v2.0/fwaas/firewall_groups
分頁(yè)查詢(xún)樣例：
GET https://{Endpoint}/v2.0/fwaas/firewall_groups?limit=2&marker=cd600d47-0045-483f-87a1-5041ae2f513b&page_reverse=False
參數(shù)說(shuō)明請(qǐng)參見(jiàn)表1。
|
名稱(chēng) |
是否必選 |
參數(shù)類(lèi)型 |
說(shuō)明 |
|---|---|---|---|
|
id |
否 |
String |
按照網(wǎng)絡(luò)ACL組對(duì)應(yīng)的ID過(guò)濾查詢(xún) |
|
name |
否 |
String |
按照網(wǎng)絡(luò)ACL組的名稱(chēng)過(guò)濾查詢(xún) |
|
description |
否 |
String |
按照網(wǎng)絡(luò)ACL組的描述過(guò)濾查詢(xún) |
|
admin_state_up |
否 |
Boolean |
按照網(wǎng)絡(luò)ACL組的管理狀態(tài)過(guò)濾查詢(xún) 取值范圍：true or false |
|
tenant_id |
否 |
String |
按照網(wǎng)絡(luò)ACL組所屬的項(xiàng)目ID過(guò)濾查詢(xún) |
|
marker |
否 |
String |
分頁(yè)查詢(xún)的起始資源ID，表示從指定資源的下一條記錄開(kāi)始查詢(xún)。 marker需要和limit配合使用：
|
|
limit |
否 |
Integer |
分頁(yè)查詢(xún)每頁(yè)返回的記錄個(gè)數(shù)，取值范圍為0~intmax（2^31-1），默認(rèn)值2000。 limit需要和marker配合使用，詳細(xì)規(guī)則請(qǐng)見(jiàn)marker的參數(shù)說(shuō)明。 |
請(qǐng)求參數(shù)
無(wú)。
請(qǐng)求示例
GET https://{Endpoint}/v2.0/fwaas/firewall_groups
響應(yīng)參數(shù)
|
屬性 |
類(lèi)型 |
說(shuō)明 |
|---|---|---|
|
id |
String |
網(wǎng)絡(luò)ACL組的uuid標(biāo)識(shí)。 |
|
name |
String |
網(wǎng)絡(luò)ACL組名稱(chēng)。 |
|
description |
String |
網(wǎng)絡(luò)ACL組描述。 |
|
tenant_id |
String |
項(xiàng)目ID |
|
ingress_firewall_policy_id |
String |
入方向網(wǎng)絡(luò)ACL策略。 |
|
egress_firewall_policy_id |
String |
出方向網(wǎng)絡(luò)ACL策略。 |
|
ports |
Array of strings |
網(wǎng)絡(luò)ACL組綁定的端口列表。 |
|
public |
Boolean |
是否支持跨租戶(hù)共享。 |
|
status |
String |
網(wǎng)絡(luò)ACL組的狀態(tài)。 |
|
admin_state_up |
Boolean |
網(wǎng)絡(luò)ACL的管理狀態(tài)。 |
|
project_id |
String |
項(xiàng)目ID，請(qǐng)參見(jiàn)獲取項(xiàng)目ID。 |
|
created_at |
String |
資源創(chuàng)建時(shí)間，UTC時(shí)間 格式：yyyy-MM-ddTHH:mm:ss |
|
updated_at |
String |
資源更新時(shí)間，UTC時(shí)間 格式：yyyy-MM-ddTHH:mm:ss |
響應(yīng)示例
{
"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)碼
請(qǐng)參見(jiàn)狀態(tài)碼。
錯(cuò)誤碼
請(qǐng)參見(jiàn)錯(cuò)誤碼。
