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.
Atualizado em 2022-11-08 GMT+08:00

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

Valores retornados

Consulte Valores retornados para solicitações gerais.