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 controle de acesso de geolocalização
Atualizado em 2022-11-02 GMT+08:00

Atualização de uma regra de controle de acesso de geolocalização

Função

Atualização de uma regra de controle de acesso de geolocalização

URI

PUT /v1/{project_id}/waf/policy/{policy_id}/geoip/{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 (valor do campo id no corpo da resposta).

rule_id

Sim

String

ID da regra de controle de acesso de geolocalização. Você pode obter o ID da regra chamando a API ListGeoipRule, usada para consultar a lista de regras de controle de acesso de geolocalização. A ID da regra é incluída no campo id no corpo da resposta.

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

Não

String

Nome da rua de controle de acesso de geolocalização

description

Não

String

descrição

geoip

Sim

String

Locais que podem ser configurados na regra de controle de acesso de geolocalização: (CN: ChinaCA: Canadá, US: Estados Unidos, AU: Austrália, IN: Índia, JP: Japão, UK: Reino Unido, FR: França, DE: Alemanha, BR: Brasil, Ukraine: Ucrânia, North Korea: Coreia do Norte, The Republic of Korea: Coréia do Sul, Iran: Irã, Cuba: Cuba, Sultan: Sudão, Syria: Síria, Pakistan: Paquistão, Palestine Palestina, Israel Israel, Iraq: Iraque, Afghanistan: Afeganistão, Libya: Líbia, Turkey: Turquia, Thailand: Tailândia, Singapore: Singapura,South Africa: México, South Africa: México, Peru: Peru, Indonesia: Indonésia, GD Guangdong, FJ: Fujian, JL: Jilin, LN: Liaoning, TW: Taiwan, GZ: Guizhou, AH: Anhui, HL: Heilongjiang, HA: Henan, SC: Sichuan, HE: Em Hebei, YN: Yunnan, HB: Hubei, HI: Hainão, QH: Qinghai, HN: Hunan, JX: Jiangxi, SX: Shanxi, SN: Shaanxi, ZJ: Zhejiang, GS: Gansu, JS: Jiangsu, SD: Shandong, BJ: Pequim, SH: Xangai, TJ: Tianjin, CQ: Chongqing, MO: Macau (China), HK: Hong Kong (China), NX: Ningxia, GX: Guangxi, XJ: Xinjiang, XZ: Tibete, NM: Mongólia Interior

white

Sim

Integer

Ação Protetora

  • 0: O WAF bloqueia solicitações que atingem a regra.
  • 1: O WAF permite solicitações que batem na regra.
  • 2: O WAF registra apenas solicitações que atingem a 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

name

String

Nome da rua de controle de acesso de geolocalização

description

String

Descrição

policyid

String

ID da política

geoip

String

Locais que podem ser configurados na regra de controle de acesso de geolocalização: (CN: ChinaCA: Canadá, US: Estados Unidos, AU: Austrália, IN: Índia, JP: Japão, UK: Reino Unido, FR: França, DE: Alemanha, BR: Brasil, Ukraine: Ucrânia, North Korea: Coreia do Norte, The Republic of Korea: Coréia do Sul, Iran: Irã, Cuba: Cuba, Sultan: Sudão, Syria: Síria, Pakistan: Paquistão, Palestine Palestina, Israel Israel, Iraq: Iraque, Afghanistan: Afeganistão, Libya: Líbia, Turkey: Turquia, Thailand: Tailândia, Singapore: Singapura,South Africa: México, South Africa: México, Peru: Peru, Indonesia: Indonésia, GD Guangdong, FJ: Fujian, JL: Jilin, LN: Liaoning, TW: Taiwan, GZ: Guizhou, AH: Anhui, HL: Heilongjiang, HA: Henan, SC: Sichuan, HE: Em Hebei, YN: Yunnan, HB: Hubei, HI: Hainão, QH: Qinghai, HN: Hunan, JX: Jiangxi, SX: Shanxi, SN: Shaanxi, ZJ: Zhejiang, GS: Gansu, JS: Jiangsu, SD: Shandong, BJ: Pequim, SH: Xangai, TJ: Tianjin, CQ: Chongqing, MO: Macau (China), HK: Hong Kong (China), NX: Ningxia, GX: Guangxi, XJ: Xinjiang, XZ: Tibete, NM: Mongólia Interior

white

número inteiro

Ação protetora

  • 0: O WAF bloqueia solicitações que atingem a regra.
  • 1: O WAF permite solicitações que batem na regra.
  • 2: O WAF registra apenas solicitações que atingem a 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}/geoip/{rule_id}?enterprise_project_id=0

{
  "white" : 0,
  "name" : "demo",
  "geoip" : "BJ|Afghanistan"
}

Exemplo de respostas

Código de estado: 200

Solicitação bem-sucedida.

{
  "id" : "02dafa406c4941368a1037b020f15a53",
  "policyid" : "38ff0cb9a10e4d5293c642bc0350fa6d",
  "name" : "demo",
  "description" : "demo",
  "geoip" : "BJ|Afghanistan",
  "white" : 0,
  "geoTagList" : [ "BJ", "Afghanistan" ]
}

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.