Consulta da lista de políticas de controle de acesso
Função
Esta API é usada para consultar a lista de todas as políticas de controle de acesso.
URI
A tabela a seguir lista o método de solicitação HTTP/HTTPS e o URI da API.
|
Método de solicitação |
URI |
|---|---|
|
GET |
/v1.0/apigw/acls[?page_size, page_no, id, name, acl_type, entity_type] |
- Uma combinação de diferentes condições de consulta pode ser adicionada no final do URI usando pontos de interrogação (?) e E comercial (&).
- As condições de consulta incluem: id, name, acl_type, entity_type, page_size e page_no.
A tabela a seguir lista os parâmetros no URI.
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
id |
Não |
String |
ID da política de controle de acesso |
|
name |
Não |
String |
Nome da política de controle de acesso |
|
acl_type |
Não |
String |
Tipo de controle de acesso, que pode ser PERMIT ou DENY |
|
entity_type |
Não |
String |
Tipo de objeto, que pode ser IP ou DOMAIN |
|
page_size |
Não |
Integer |
Número de registros exibidos em cada página. O valor padrão é 20. |
|
page_no |
Não |
Integer |
Número da página. O valor padrão é 1. |
|
precise_search |
Não |
String |
Nome do parâmetro (name) para correspondência exata |
Solicitação
N/D
Resposta
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
size |
Integer |
Número de políticas de controle de acesso exibidas na página atual |
|
total |
Integer |
Número total de políticas de controle de acesso |
|
acls |
Dicionário |
Lista de políticas de controle de acesso |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
id |
String |
ID da política de controle de acesso |
|
acl_name |
String |
Nome da política de controle de acesso |
|
acl_type |
String |
Tipo de controle de acesso, que pode ser:
|
|
acl_value |
String |
Objetos de controle de acesso |
|
entity_type |
String |
Tipo de objeto, que pode ser:
|
|
update_time |
Timestamp |
Hora em que a política de controle de acesso foi atualizada pela última vez |
|
bind_num |
Integer |
Número de APIs às quais a política de controle de acesso foi vinculada |
Exemplo de resposta:
{
"total": 1,
"size": 1,
"acls": [{
"id": "d402b35e-1054-4280-b1c5-0d741a28c995",
"acl_name": "goodone",
"entity_type": "DOMAIN",
"acl_type": "PERMIT",
"acl_value": "19asdfaf-adfadf",
"update_time": "2017-11-18T14:27:36.918578+08:00",
"bind_num":1
}]
}
Códigos de status
|
Código de status |
Descrição |
|---|---|
|
200 |
OK |
|
400 |
Solicitação inválida |
|
500 |
Erro do servidor interno |