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 desatualizadas/ Gerenciamento de grupo de segurança (as API de Nova do OpenStack)/ Consulta de grupos de segurança (Descartado)

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

Ver PDF

Consulta de grupos de segurança (Descartado)

Função

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

Esta API foi descartada. Use a API descrita em Consulta de grupos de segurança.

URI

GET /v2.1/{project_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.

A consulta de paginação não é suportada.

Solicitação

N/D

Resposta

Tabela 2 descreve os parâmetros de resposta.

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

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

**Tabela 4** objetos **security_group_rule**
Parâmetro	Tipo	Descrição
parent_group_id	String	Especifica o ID do grupo de segurança associado no formato UUID.
ip_protocol	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	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 indica o tipo ICMP campo com um comprimento de 0 a 255 caracteres. NOTA: O tipo de mensagem ICMP é determinado pelo campo de tipo e código no pacote. Para obter detalhes, consulte Appendix > ICMP-Port Range Relationship Table na Referência de API de Virtual Private Cloud. port_range_min indica o campo de tipo ICMP e port_range_max indica o campo de código ICMP.
to_port	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, este parâmetro indica o campo de código ICMP com um comprimento de 0 a 255 caracteres. NOTA: O tipo de mensagem ICMP é determinado pelo campo de tipo e código no pacote. Para obter detalhes, consulte Appendix > ICMP-Port Range Relationship Table na Referência de API de Virtual Private Cloud. port_range_min indica o tipo ICMP e port_range_max indica o código ICMP.
ip_range	Object	Especifica o segmento IP de peer no formato CIDR. Para mais detalhes, consulte Tabela 5. Especifique ip_range ou group.
group	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. Especifique ip_range ou group.
id	String	Especifica a ID da regra do grupo de segurança no formato UUID.

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

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

Exemplo de solicitação

GET https://{endpoint}/v2.1/bb1118612ba64af3a6ea63a1bdcaa5ae/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"
        }
    ]
}