Consulta de grupos de ACL de red
Función
Esta API se utiliza para consultar todos los grupos de ACL de red accesibles para el tenant que envía la solicitud. Se puede devolver un máximo de 2000 registros para cada operación de consulta. Si el número de registros es superior a 2000, se devolverá el marcador de paginación. Para obtener más información, consulte la sección Paginación.
URI
GET /v2.0/fwaas/firewall_groups
Ejemplo de consulta de grupos por página
GET https://{Endpoint}/v2.0/fwaas/firewall_groups?limit=2&marker=cd600d47-0045-483f-87a1-5041ae2f513b&page_reverse=False
Tabla 1 describe los parámetros.
Nombre |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
id |
No |
String |
Especifica que el ID del grupo de ACL de red se utiliza como condición de filtrado. |
name |
No |
String |
Especifica que el nombre del grupo de ACL de red se utiliza como condición de filtrado. |
description |
No |
String |
Especifica que la descripción del grupo de ACL de red se utiliza como condición de filtrado. |
admin_state_up |
No |
Boolean |
Especifica que el estado de administrador del grupo de ACL de red se utiliza como condición de filtrado. El valor puede ser true o false. |
tenant_id |
No |
String |
Especifica que el ID de proyecto del grupo de ACL de red se utiliza como condición de filtrado. |
marker |
No |
String |
Especifica un ID de recurso para la consulta de paginación, que indica que la consulta comienza en el siguiente registro del ID de recurso especificado. Este parámetro puede funcionar junto con el parámetro limit.
|
limit |
No |
Integer |
Especifica el número de registros que se devolverán en cada página. El valor es de 0 a intmax (2^31-1). limit se puede utilizar junto con marker. Para obtener más información, consulte la descripción de parámetros de marker. |
Mensaje de solicitud
No hay
Ejemplo de la solicitud
GET https://{Endpoint}/v2.0/fwaas/firewall_groups
Mensaje de la respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
firewall_groups |
Array of Firewall Group objects |
Especifica la lista de grupos de cortafuegos. Para obtener más información, véase Tabla 3. |
firewall_groups_links |
Array of firewall_groups_link objects |
Especifica la lista de objeto firewall_groups_link. Para obtener más información, véase Tabla 4. Solo cuando se utiliza limit para filtrar y el número de recursos excede el valor de limit o 2000 (valor predeterminado de limit), se devolverá el valor next para rel y un enlace para href. |
Atributo |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el UUID del grupo de ACL de red. |
name |
String |
Especifica el nombre del grupo de ACL de red. |
description |
String |
Proporciona la información adicional sobre el grupo de ACL de red. |
tenant_id |
String |
Especifica el ID del proyecto. |
ingress_firewall_policy_id |
String |
Especifica la política de ACL de red para el tráfico entrante. |
egress_firewall_policy_id |
String |
Especifica la política de ACL de red para el tráfico saliente. |
ports |
Array of strings |
Especifica la lista de los puertos enlazados con el grupo de ACL de red. |
public |
Boolean |
Especifica si la política de firewall puede ser compartida por los tenants diferentes. |
status |
String |
Especifica el estado de la política de la ACL de red. |
admin_state_up |
Boolean |
Especifica el estado administrativo de la ACL de red. |
project_id |
String |
Especifica el ID del proyecto. Para obtener más información sobre cómo obtener un ID de proyecto, consulte Obtención de un ID de proyecto. |
created_at |
String |
Especifica la hora (UTC) en la que se crea el recurso. Formato: aaaa-MM-ddTHH:mm:ss |
updated_at |
String |
Especifica la hora (UTC) cuando se actualiza el recurso. Formato: aaaa-MM-ddTHH:mm:ss |
Ejemplo de la respuesta
{ "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" } ] }
Código de estado
Véase Códigos de estado.
Código de error
Véase Códigos de error.