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
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.
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
security_groups |
Sim |
Array of objects |
Especifica grupos de segurança. Para mais detalhes, consulte Tabela 3. |
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. |
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. |
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" } ] }