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 2022-11-08 GMT+08:00

Consulta de detalles acerca de un grupo de seguridad (descartada)

Función

Esta API se utiliza para consultar detalles sobre un grupo de seguridad.

Esta API solo puede consultar las reglas del grupo de seguridad entrante. Para consultar las reglas del grupo de seguridad saliente, consulte "Consulta de un grupo de seguridad" en "Grupo de seguridad (API nativa de OpenStack) " en la Referencia de la API de Virtual Private Cloud.

Esta API ha sido descartada. Utilice la API descrita en Consulta de un grupo de seguridad.

URI

GET /v2.1/{project_id}/os-security-groups/{security_group_id}

Tabla 1 describe los parámetros en el URI.
Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Descripción

project_id

Especifica el ID del proyecto.

Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.

security_group_id

Especifica el ID del grupo de seguridad, que se especifica en el URI.

Solicitud

No hay

Respuesta

Tabla 2 describe los parámetros de respuesta.

Tabla 2 Parámetros de respuesta

Parámetro

Tipo

Descripción

security_group

Object

Especifica el grupo de seguridad. Para más detalles, consulte Tabla 3.

Tabla 3 Objetos security_group

Parámetro

Tipo

Descripción

description

String

Especifica información acerca de un grupo de seguridad. Debe contener de 0 a 255 caracteres.

id

String

Especifica el ID del grupo de seguridad en formato UUID.

name

String

Especifica el nombre del grupo de seguridad. Debe contener de 0 a 255 caracteres.

rules

Array of objects

Especifica las reglas de grupo de seguridad. Para más detalles, consulte Tabla 4.

tenant_id

String

Especifica el ID del tenant o del proyecto.

Tabla 4 Objetos security_group_rule

Parámetro

Tipo

Descripción

parent_group_id

String

Especifica el ID de grupo de seguridad asociado en formato UUID.

ip_protocol

String

Especifica el tipo de protocolo o el número de protocolo IP. El valor puede ser icmp, tcp, udp o el número de protocolo IP.

from_port

Integer

Especifica el número de puerto inicial. El valor oscila entre 1 y 65,535 y no puede ser mayor que to_port.

Cuando ip_protocol es icmp, este parámetro indica el campo de tipo ICMP con una longitud de 0 a 255 caracteres.

NOTA:

El tipo de mensaje ICMP viene determinado por el campo de tipo y el campo de código en el paquete. Para obtener más información, consulte Apéndice > Tabla de relaciones de rango de puerto ICMP en Referencia de la API de Virtual Private Cloud. port_range_min indica el tipo ICMP y port_range_max indica el código ICMP.

to_port

Integer

Especifica el número de puerto de parada. El valor oscila entre 1 y 65,535 y no puede ser menor que from_port.

Cuando ip_protocol es icmp, este parámetro indica el campo de código ICMP con una longitud de 0 a 255 caracteres.

NOTA:

El tipo de mensaje ICMP viene determinado por el campo de tipo y el campo de código en el paquete. Para obtener más información, consulte Apéndice > Tabla de relaciones de rango de puerto ICMP en Referencia de la API de Virtual Private Cloud. port_range_min indica el tipo ICMP y port_range_max indica el código ICMP.

ip_range

Object

Especifica el segmento IP del mismo nivel en formato CIDR. Para más detalles, consulte Tabla 5.

Especifique ip_range o group.

group

Object

Especifica el nombre del grupo de seguridad del mismo nivel y el ID del inquilino en el grupo de seguridad del mismo nivel. Para más detalles, consulte Tabla 6.

Especifique ip_range o group.

id

String

Especifica el ID de regla del grupo de seguridad.

Tabla 5 Objetos ip_range

Parámetro

Tipo

Descripción

cidr

String

Especifica el segmento IP del mismo nivel en formato CIDR.

Tabla 6 Objetos group

Parámetro

Tipo

Descripción

tenant_id

String

Especifica el ID del tenant del grupo de seguridad del mismo nivel.

name

String

Especifica el nombre del grupo de seguridad del mismo nivel.

Ejemplo de la solicitud

GET https://{endpoint}/v2.1/bb1118612ba64af3a6ea63a1bdcaa5ae/os-security-groups/81f1d23b-b1e2-42cd-bdee-359b4a065a42

Ejemplo de la respuesta

{
    "security_group": {
        "rules": [],
        "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
        "id": "81f1d23b-b1e2-42cd-bdee-359b4a065a42",
        "name": "test-sg",
        "description": "desc-sg"
    }
}