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.

Centro de ayuda/ Elastic Cloud Server/ Referencia de la API/ API de OpenStack Nova/ Gestión de grupos de seguridad/ Consulta de grupos de seguridad para un ECS especificado

Actualización más reciente 2025-08-25 GMT+08:00

Ver PDF

Consulta de grupos de seguridad para un ECS especificado

Función

Esta API se utiliza para consultar grupos de seguridad para un ECS especificado.

URI

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

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Descripción del parámetro
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.
server_id	Sí	Especifica el ID de ECS.

Solicitud

No hay

Respuesta

Tabla 2 describe los parámetros de respuesta.

**Tabla 2** Parámetros de respuesta
Parámetro	Obligatorio	Tipo	Descripción
security_groups	Sí	Array of objects	Especifica los grupos de seguridad. Para más detalles, consulte Tabla 3.

**Tabla 3** Objetos **security_group**
Parámetro	Obligatorio	Tipo	Descripción
description	Sí	String	Especifica información acerca de un grupo de seguridad. Debe contener de 0 a 255 caracteres.
id	Sí	String	Especifica el ID del grupo de seguridad en formato UUID.
name	Sí	String	Especifica el nombre del grupo de seguridad. Debe contener de 0 a 255 caracteres.
rules	Sí	Array of objects	Especifica las reglas de grupo de seguridad. Para más detalles, consulte Tabla 4.
tenant_id	Sí	String	Especifica el ID del tenant o del proyecto.

**Tabla 4** Objetos **security_group_rule**
Parámetro	Obligatorio	Tipo	Descripción
parent_group_id	Sí	String	Especifica el ID de grupo de seguridad asociado en formato UUID.
ip_protocol	Sí	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	Sí	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 especifica un tipo de puerto con una longitud de 0 a 255 caracteres.
to_port	Sí	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, especifica el código. El valor varía de 0 a 255. Si ambos from_port y to_port son -1, se puede transmitir cualquier paquete ICMP.
ip_range	Sí	Object	Especifica el segmento IP del mismo nivel en formato CIDR. Para más detalles, consulte Tabla 5. El valor de ip_range o group debe estar vacío.
group	Sí	Object	Specifies the name of the peer security group and the ID of the tenant in the peer security group. For details, see Tabla 6. The value of ip_range or group must be empty.
id	Sí	String	Especifica el ID de regla del grupo de seguridad en formato UUID.

**Tabla 5** Objetos ip_range
Parámetro	Obligatorio	Tipo	Descripción
cidr	No	String	Especifica el segmento IP del mismo nivel en formato CIDR.

**Tabla 6** Objetos **group**
Parámetro	Obligatorio	Tipo	Descripción
tenant_id	No	String	Especifica el ID del tenant del grupo de seguridad del mismo nivel.
name	No	String	Especifica el nombre del grupo de seguridad del mismo nivel.

Ejemplo de la solicitud

GET https://{endpoint}/v2.1/e73621affb8f44e1bc01898747ca09d4/servers/65fae4c2-3a09-46c6-af12-3b04f1fdba1e/os-security-groups

Ejemplo de la respuesta

{
    "security_groups": [
        {
            "rules": [
                {
                    "from_port": null,
                    "group": {
                        "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
                        "name": "default"
                    },
                    "ip_protocol": null,
                    "to_port": null,
                    "parent_group_id": "bc4ac1d1-dc77-4b7d-a97d-af86eb0dc450",
                    "ip_range": {},
                    "id": "bb3cc988-e06a-49f6-b668-600e8bf193ee"
                },
                {
                    "from_port": null,
                    "group": {
                        "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
                        "name": "default"
                    },
                    "ip_protocol": null,
                    "to_port": null,
                    "parent_group_id": "bc4ac1d1-dc77-4b7d-a97d-af86eb0dc450",
                    "ip_range": {},
                    "id": "f9371051-d7e1-4be4-8748-77b1e0913730"
                }
            ],
            "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
            "description": "default",
            "id": "bc4ac1d1-dc77-4b7d-a97d-af86eb0dc450",
            "name": "default"
        },
        {
            "rules": [
                {
                    "from_port": 200,
                    "group": {},
                    "ip_protocol": "tcp",
                    "to_port": 400,
                    "parent_group_id": "b3e4b615-a40f-4e1c-92af-2e0d382141d5",
                    "ip_range": {
                        "cidr": "0.0.0.0/0"
                    },
                    "id": "3330120d-bbd1-4a73-bda9-0196a84d5670"
                },
                {
                    "from_port": 201,
                    "group": {},
                    "ip_protocol": "tcp",
                    "to_port": 400,
                    "parent_group_id": "b3e4b615-a40f-4e1c-92af-2e0d382141d5",
                    "ip_range": {
                        "cidr": "0.0.0.0/0"
                    },
                    "id": "b550c9a6-970a-462d-984e-265e88020818"
                }
            ],
            "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
            "description": "desc-sg",
            "id": "b3e4b615-a40f-4e1c-92af-2e0d382141d5",
            "name": "test-sg"
        }
    ]
}