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/ Web Application Firewall/ Referência de API/ API/ Gerenciamento de regras/ Criação de uma tabela de referência
Atualizado em 2022-11-02 GMT+08:00
Ver PDF
Compartilhar

Criação de uma tabela de referência

Função

Essa API é usada para adicionar uma tabela de referência. Uma tabela de referência pode ser usada por regras de proteção de ataque CC e regras de proteção precisas.

URI

POST /v1/{project_id}/waf/valuelist

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto. Para obtê-lo, vá para o console de gerenciamento do Huawei Cloud e passe o cursor sobre seu nome de usuário. Na janela exibida, escolha My Credentials.Em seguida, na área Projects, visualize Project ID correspondente.
Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

enterprise_project_id

Não

String

Você pode obter o ID chamando a API ListEnterpriseProject do EPS.

Parâmetros de solicitação

Tabela 3 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário. Ele pode ser obtido chamando a API do IAM (valor de X-Subject-Token no cabeçalho da resposta).

Content-Type

Sim

String

Tipo de conteúdo.

Padrão: application/json;charset=utf8
Tabela 4 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

name

Sim

String

Nome da tabela de referência. O valor pode conter no máximo 64 caracteres. Somente dígitos, letras, hífens, (_), de sublinhados e pontos (.) são permitidos.

Mínimo: 2

Máximo: 64

type

Sim

String

Tipo de tabela de referência. Para obter detalhes, consulte a lista de enumeração.

Mínimo: 2

Máximo: 32

Valores de enumeração:

  • url
  • params
  • ip
  • cookie
  • referer
  • user-agent
  • header
  • response_code
  • response_header
  • response_body

values

Sim

Array of strings

Valor da tabela de referência

description

Não

String

Descrição da tabela de referência. O valor contém no máximo 128 caracteres.

Mínimo: 0

Máximo: 128

Parâmetros de resposta

Código de estado: 200

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

id

String

ID da tabela de referência

name

String

Nome da tabela de referência.

type

String

Tipo de tabela de referência

description

String

Descrição da tabela de referência

timestamp

Long

Tabela de referência timestamp

values

Array of strings

Valor da tabela de referência

producer

Integer

Fonte da tabela de referência.

  • 1: A tabela de referência foi criada por você.
  • 2: A tabela de referência foi criada pela proteção inteligente de controle de acesso.

Código de estado: 400

Tabela 6 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro

error_msg

String

Mensagem de erro

Código de estado: 401

Tabela 7 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro

error_msg

String

Mensagem de erro

Código de estado: 500

Tabela 8 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro

error_msg

String

Mensagem de erro

Exemplos de solicitações

POST https://{Endpoint}/v1/{project_id}/waf/valuelist?enterprise_project_id=0

{
  "name" : "demo",
  "type" : "url",
  "values" : [ "/124" ],
  "description" : "demo"
}

Exemplo de respostas

Código de estado: 200

Solicitação bem-sucedida.

{
  "id" : "e5d9032d8da64d169269175c3e4c2849",
  "name" : "demo",
  "type" : "url",
  "values" : [ "/124" ],
  "timestamp" : 1650524684892,
  "description" : "demo",
  "producer" : 1
}

Códigos de status

Código de status

Descrição

200

Solicitação bem-sucedida.

400

Falha na solicitação.

401

O token não tem permissões necessárias.

500

Erro de servidor interno.

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Gerenciamento de regras