Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2023-02-03 GMT+08:00

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.

Tabla 1 Descripción del parámetro

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.

  • Si no se pasan los parámetros marker y limit, se devolverán los registros de recursos de la primera página.
  • Si no se pasa el parámetro marker y el valor del parámetro limit se establece en 10 se devolverán los 10 primeros registros de recursos.
  • Si el valor del parámetro marker se establece en el ID de recurso del 10º registro y el valor del parámetro limit se establece en 10, se devolverán los registros de recursos del 11º al 20º.
  • Si el valor del parámetro marker se establece en el ID de recurso del 10º registro y no se pasa el parámetro limit, se devolverán los registros de recursos que comienzan desde el 11º registro (incluido el 11º).

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

Tabla 2 Parámetro de 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.

Tabla 3 Objetos de Firewall Group

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

Tabla 4 objeto de firewall_groups_link

Nombre

Tipo

Descripción

href

String

Especifica el enlace de API.

rel

String

Especifica la relación entre el enlace de API y la versión de API.

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.