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> Atualização de uma regra de mascaramento de dados
Atualizado em 2022-11-02 GMT+08:00

Atualização de uma regra de mascaramento de dados

Função

Essa API é usada para atualizar uma regra de mascaramento de dados.

URI

PUT /v1/{project_id}/waf/policy/{policy_id}/privacy/{rule_id}

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.

policy_id

Sim

String

ID da política. Ele pode ser obtido chamando a API ListPolicy.

rule_id

Sim

String

ID da regra de mascaramento de dados. Você pode obter o ID da regra chamando a API ListPrivacyRule, usada para consultar a lista de regras de mascaramento de dados.

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

url

Sim

String

URL protegido pela regra de mascaramento de dados. O valor deve estar no formato de URL padrão, por exemplo, /admin/xxx ou /admin/. The asterisk () indica o prefixo do caminho.

category

Sim

String

Campo mascarado.

  • Params: O campo params em solicitações
  • Cookie: Visitantes da Web distinguidos por cookies
  • Header: Cabeçalho HTTP personalizado
  • Form: Formulários

Valores de enumeração:

  • params
  • cookie
  • header
  • form

index

Sim

String

Nome do campo mascarado. Defina o nome do campo com base no campo mascarado. O campo mascarado não será exibido nos logs. O nome do campo mascarado não pode exceder bytes de 2 048. Apenas números, letras, sublinhados (_) e hifens (-) são permitidos.

description

Não

String

(Opcional) Uma descrição da regra.

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 regra

policyid

String

ID da política

timestamp

Long

Hora em que a regra foi criada. O valor é um carimbo de data/hora de 13 dígitos em ms.

status

Integer

Status da regra. O valor pode ser 0 ou 1.

  • 0: A regra está desativada.
  • 1: A regra está ativada.

url

String

URL protegido pela regra de mascaramento de dados. O valor deve estar no formato de URL padrão, por exemplo, /admin/xxx ou /admin/. The asterisk () indica o prefixo do caminho.

category

String

Campo mascarado.

  • Params: O campo params em solicitações
  • Cookie: Visitantes da Web distinguidos por cookies
  • Header: Cabeçalho HTTP personalizado
  • Form: Formulários

Valores de enumeração:

  • params
  • cookie
  • header
  • form

index

String

Nome do campo mascarado. Defina o nome do campo com base no campo mascarado. O campo mascarado não será exibido nos logs.

description

String

(Opcional) Uma descrição da regra.

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

PUT https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/privacy/{rule_id}?enterprise_project_id=0

{
  "url" : "/demo",
  "category" : "cookie",
  "index" : "demo1",
  "description" : "demo"
}

Exemplo de respostas

Código de estado: 200

Solicitação bem-sucedida.

{
  "id" : "97e4d35f375f4736a21cccfad77613eb",
  "policyid" : "38ff0cb9a10e4d5293c642bc0350fa6d",
  "description" : "demo",
  "url" : "/demo",
  "category" : "cookie",
  "index" : "demo1"
}

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.