Consulta de un grupo de seguridad
Función
Esta API se utiliza para consultar detalles sobre un grupo de seguridad específico.
URI
GET /v2.0/security-groups/{security_group_id}
Mensaje de solicitud
No hay
Ejemplo de la solicitud
GET https://{Endpoint}/v2.0/security-groups/0431c9c5-1660-42e0-8a00-134bec7f03e2
Mensaje de la respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
security_group |
security_group object |
Especifica el grupo de seguridad. Para obtener más información, véase Tabla 2. |
Atributo |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el ID del grupo de seguridad. Este parámetro no es obligatorio cuando consulta los grupos de seguridad. |
tenant_id |
String |
Especifica el ID del proyecto. |
name |
String |
Especifica el nombre del grupo de seguridad. |
description |
String |
Proporciona la información complementaria sobre el grupo de seguridad. |
security_group_rules |
Array of Security Group Rule objects |
Especifica la lista de reglas del grupo de seguridad. Para obtener más información, véase Tabla 3. |
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 grupo de seguridad. Formato: aaaa-MM-ddTHH:mm:ss |
updated_at |
String |
Especifica la hora (UTC) cuando se actualiza el grupo de seguridad. Formato: aaaa-MM-ddTHH:mm:ss |
Atributo |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el identificador de la regla del grupo de seguridad. Este parámetro no es obligatorio cuando consulta las reglas del grupo de seguridad. |
description |
String |
Proporciona la información adicional acerca de la regla del grupo de seguridad. |
security_group_id |
String |
Especifica el ID del grupo de seguridad perteneciente. |
remote_group_id |
String |
Especifica el identificador del par del grupo de seguridad perteneciente. |
direction |
String |
Especifica la dirección del tráfico para el que tiene efecto la regla de grupo de seguridad. |
remote_ip_prefix |
String |
Especifica el segmento de dirección IP del mismo nivel. |
protocol |
String |
Especifica el tipo de protocolo o el número de protocolo IP. |
port_range_max |
Integer |
Especifica el número máximo de puerto. Cuando se utiliza ICMP, el valor es el código de ICMP. |
port_range_min |
Integer |
Especifica el número de puerto mínimo. Si se utiliza el protocolo ICMP, este parámetro indica el tipo de ICMP. Cuando se utiliza el protocolo TCP o UDP, deben especificarse tanto port_range_max como port_range_min, y el valor port_range_max debe ser mayor que el valor port_range_min. Cuando se utiliza el protocolo ICMP, si especifica el código ICMP (port_range_max), también debe especificar el tipo de ICMP (port_range_min). |
ethertype |
String |
Especifica el tipo de red. Se admiten IPv4 e IPv6. |
tenant_id |
String |
Especifica el ID del proyecto. |
remote_address_group_id |
String |
|
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 la regla de grupo de seguridad. Formato: aaaa-MM-ddTHH:mm:ss |
updated_at |
String |
Especifica la hora (UTC) en la que se actualiza la regla del grupo de seguridad. Formato: aaaa-MM-ddTHH:mm:ss |
Ejemplo de la respuesta
{ "security_group": { "id": "0431c9c5-1660-42e0-8a00-134bec7f03e2", "name": "sg-ad3f", "description": "", "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "security_group_rules": [ { "id": "d90e55ba-23bd-4d97-b722-8cb6fb485d69", "direction": "ingress", "protocol": null, "ethertype": "IPv4", "description": null, "remote_group_id": "0431c9c5-1660-42e0-8a00-134bec7f03e2", "remote_ip_prefix": null, "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "port_range_max": null, "port_range_min": null, "security_group_id": "0431c9c5-1660-42e0-8a00-134bec7f03e2", "remote_address_group_id": "0150a3a7-82ca-4569-865c-04e46e5e9249" }, { "id": "aecff4d4-9ce9-489c-86a3-803aedec65f7", "direction": "egress", "protocol": null, "ethertype": "IPv4", "description": null, "remote_group_id": null, "remote_ip_prefix": null, "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "port_range_max": null, "port_range_min": null, "security_group_id": "0431c9c5-1660-42e0-8a00-134bec7f03e2", "remote_address_group_id": null } ], "created_at": "2018-09-12T08:24:14", "updated_at": "2018-09-12T08:24:14" } }
Código de estado
Véase Códigos de estado.
Código de error
Véase Códigos de error.