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