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 detalhes sobre um grupo de segurança (Descartado)

Atualizado em 2022-11-08 GMT+08:00

Consulta de detalhes sobre um grupo de segurança (Descartado)

Função

Essa API é usada para consultar detalhes sobre um grupo de segurança.

Essa API só pode consultar as regras do grupo de segurança de entrada. Para consultar as regras de grupo de segurança de saída, consulte "Consulta de um grupo de segurança" em "Grupo de segurança (API OpenStack nativo)" na Referência de API de Virtual Private Cloud.

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

URI

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

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.
security_group_id	Sim	Especifica o ID do grupo de segurança, que é especificado no URI.

Solicitação

Nenhum

Resposta

Tabela 2 descreve os parâmetros de resposta.

**Tabela 2** Parâmetros de resposta
Parâmetro	Tipo	Descrição
security_group	Object	Especifica o grupo 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 tipo ICMP e port_range_max indica o 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.

**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/81f1d23b-b1e2-42cd-bdee-359b4a065a42

Exemplo de resposta

{
    "security_group": {
        "rules": [],
        "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
        "id": "81f1d23b-b1e2-42cd-bdee-359b4a065a42",
        "name": "test-sg",
        "description": "desc-sg"
    }
}