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}
Parámetro |
Obligatorio |
Descripción |
---|---|---|
project_id |
Sí |
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 |
Sí |
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.
Parámetro |
Tipo |
Descripción |
---|---|---|
security_group |
Object |
Especifica el grupo de seguridad. Para más detalles, consulte Tabla 3. |
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. |
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. |
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" } }