Criação de uma política de controle de acesso
Função
Esta API é usada para criar uma política de controle de acesso para permitir ou negar acesso à API de determinados endereços IP ou domínios. O valor acl_value de um domínio é um nome de locatário em vez de um nome de domínio (como www.exampleDomain.com).
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 |
|---|---|
|
POST |
/v1.0/apigw/acls |
Solicitação
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
acl_name |
String |
Nome da política de controle de acesso O nome de uma política de controle de acesso consiste de 3 a 64 caracteres, começando com uma letra. Apenas letras, dígitos e sublinhados (_) são permitidos. |
|
acl_type |
String |
Tipo de controle de acesso, que pode ser:
|
|
acl_value |
String |
Um ou mais objetos a partir dos quais o acesso será controlado. Separe vários objetos com vírgulas. |
|
entity_type |
String |
Tipo de objeto, que pode ser:
|
Exemplo de solicitação:
{
"acl_name": "test001",
"acl_type": "PERMIT",
"acl_value": "192.168.1.5,192.168.10.0/24,192.168.12.12-192.168.12.19",
"entity_type": "IP"
}
Resposta
|
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 |
Exemplo de resposta:
{
"id": "d402b35e-1054-4280-b1c5-0d741a28c995",
"acl_name": "test",
"entity_type": "IP",
"acl_type": "PERMIT",
"acl_value": "192.168.1.5,192.168.10.0/24,192.168.12.12-192.168.12.19",
"update_time": "2017-11-18T14:27:36.918578+08:00"
}
Códigos de status
|
Código de status |
Descrição |
|---|---|
|
201 |
Criado |
|
400 |
Solicitação inválida |
|
500 |
Erro do servidor interno |