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.
Central de ajuda/ API Gateway/ Referência de API/ APIs compartilhadas de gateway (para usuários existentes)/ Gerenciamento de política de controle de acesso/ Criação de uma política de controle de acesso
Atualizado em 2023-05-29 GMT+08:00
Ver PDF
Compartilhar

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.

Tabela 1 Método de solicitação HTTP/HTTPS e URI

Método de solicitação

URI

POST

/v1.0/apigw/acls

Solicitação

Tabela 2 Descrição do parâmetro

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:

  • PERMIT (lista branca)
  • DENY (lista negra)

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:

  • IP
  • DOMAIN

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

Tabela 3 Descrição do parâmetro

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:

  • PERMIT (lista branca)
  • DENY (lista negra)

acl_value

String

Objetos de controle de acesso

entity_type

String

Tipo de objeto, que pode ser:

  • IP
  • DOMAIN

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

Tabela 4 Códigos de status

Código de status

Descrição

201

Criado

400

Solicitação inválida

500

Erro do servidor interno