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/ Consulta de lista de regras de controle de acesso de geolocalização

Atualizado em 2022-11-02 GMT+08:00

Ver PDF

Consulta de lista de regras de controle de acesso de geolocalização

Função

URI

GET /v1/{project_id}/waf/policy/{policy_id}/geoip

**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.

**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.
page	Não	Integer	Número de página dos dados a serem retornados durante a consulta de paginação. O valor padrão é 1, indicando que os dados na primeira página são retornados. Padrão: 1
pagesize	Não	Integer	Número de resultados em cada página durante a consulta de paginação. Faixa de valor: 1 a 100. O valor padrão é 10, indicando que cada página contém 10 resultados. Padrão: 10

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

Parâmetros de resposta

Código de estado: 200

**Tabela 4** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
total	Integer	Número de regras de controle de acesso de geolocalização na política
items	Array of GeOIpItem objects	Matriz de geolocalização controle de acesso rues

**Tabela 5** GeOIpItem
Parâmetro	Tipo	Descrição
id	String	ID da regra
policyid	String	ID da política
name	String	Nome da rua de controle de acesso de geolocalização
geoip	String	Locais que podem ser configurados na regra de controle de acesso de geolocalização: (CN: China, CA: 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	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.
status	Integer	Status da regra. true: ativado. false: desativado.
timestamp	Long	Hora em que a regra é criada.

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

GET https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/geoip?enterprise_project_id=0

Exemplo de respostas

Código de estado: 200

{
  "total" : 1,
  "items" : [ {
    "id" : "06f07f6c229141b9a4a78614751bb687",
    "policyid" : "2abeeecefb9840e6bf05efbd80d0fcd7",
    "timestamp" : 1636340038062,
    "status" : 1,
    "geoip" : "GD",
    "white" : 1,
    "name" : "demo"
  } ]
}