Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Elastic Cloud Server/ Referência de API/ As API da Nova do OpenStack/ Gerenciamento de grupo de segurança/ Consulta de grupos de segurança para um ECS especificado

Atualizado em 2025-08-25 GMT+08:00

Ver PDF

Consulta de grupos de segurança para um ECS especificado

Função

Essa API é usada para consultar grupos de segurança para um ECS determinado.

URI

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

Tabela 1 descreve os parâmetros no URI.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Descrição
project_id	Sim	Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.
server_id	Sim	Especifica a ID de ECS.

Solicitação

Nenhum

Resposta

Tabela 2 descreve os parâmetros de resposta.

**Tabela 2** Parâmetros de resposta
Parâmetro	Obrigatório	Tipo	Descrição
security_groups	Sim	Array of objects	Especifica grupos de segurança. Para mais detalhes, consulte Tabela 3.

**Tabela 3** objetos **security_group**
Parâmetro	Obrigatório	Tipo	Descrição
description	Sim	String	Especifica informações sobre um grupo de segurança. Deve conter de 0 a 255 caracteres.
id	Sim	String	Especifica o ID do grupo de segurança no formato UUID.
name	Sim	String	Especifica o nome do grupo de segurança. Deve conter de 0 a 255 caracteres.
rules	Sim	Array of objects	Especifica regras de grupo de segurança. Para mais detalhes, consulte Tabela 4.
tenant_id	Sim	String	Especifica o inquilino ou ID do projeto.

**Tabela 4** objetos **security_group_rule**
Parâmetro	Obrigatório	Tipo	Descrição
parent_group_id	Sim	String	Especifica o ID do grupo de segurança associado no formato UUID.
ip_protocol	Sim	String	Especifica o tipo de protocolo ou o número do protocolo IP. O valor pode ser icmp, tcp, udp ou o número do protocolo IP.
from_port	Sim	Integer	Especifica o número da porta inicial. O valor varia de 1 a 65 535 e não pode ser maior que to_port. Quando ip_protocol é icmp, este parâmetro especifica um tipo de porta com um comprimento de 0 a 255 caracteres.
to_port	Sim	Integer	Especifica o número da porta de parada. O valor varia de 1 a 65 535 e não pode ser menor que from_port. Quando ip_protocol é icmp, ele especifica o código. O valor varia de 0 a 255. Se ambos from_port e to_port são -1, qualquer pacote ICMP pode ser transmitido.
ip_range	Sim	Object	Especifica o segmento IP de peer no formato CIDR. Para mais detalhes, consulte Tabela 5. O valor de ip_range ou group deve estar vazio.
group	Sim	Object	Especifica o nome do grupo de segurança de pares e o ID do locatário no grupo de segurança de pares. Para mais detalhes, consulte Tabela 6. O valor de ip_range ou group deve estar vazio.
id	Sim	String	Especifica a ID da regra do grupo de segurança no formato UUID.

**Tabela 5** Objetos **ip_range**
Parâmetro	Obrigatório	Tipo	Descrição
cidr	Não	String	Especifica o segmento IP de peer no formato CIDR.

**Tabela 6** objetos de **group**
Parâmetro	Obrigatório	Tipo	Descrição
tenant_id	Não	String	Especifica a ID do locatário do grupo de segurança de pares.
name	Não	String	Especifica o nome do grupo de segurança peer.

Exemplo de solicitação

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

Exemplo de resposta

{
    "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"
        }
    ]
}