Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Web Application Firewall/ Referencia de la API/ API/ Gestión de reglas/ Creación de una regla de control de acceso de geolocalización

Actualización más reciente 2025-08-20 GMT+08:00

Ver PDF

Creación de una regla de control de acceso de geolocalización

Función

Esta API se utiliza para crear una regla de control de acceso de geolocalización.

URI

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

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto
policy_id	Sí	String	ID de política. Se puede obtener llamando a la API ListPolicy.

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
enterprise_project_id	No	String	ID del proyecto de empresa. Se puede obtener mediante el llamado API ListEnterpriseProject de EPS.

Parámetros de solicitud

**Tabla 3** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Se puede obtener llamando a la API IAM (valor de X-Subject-Token en el encabezado de respuesta).
Content-Type	Sí	String	Tipo de contenido Predeterminado: application/json;charset=utf8

**Tabla 4** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
geoip	Sí	String	Ubicaciones geográficas que se pueden utilizar para el control de acceso. Códigos de ubicación: \n (CN: China, AB2: Fuera de China, AB: Fuera de China continental, CA: Canadá, US: Estados Unidos, AU: Australia, IN: India, JP: Japón, UK: Reino Unido, FR: Francia, DE: Alemania, BR: Brasil, Ukraine: Ucrania, North Korea: Corea del Norte, The Republic of Korea: Corea del Sur, Iran: Irán, Cuba: Cuba, Sultan: Sudán, Syria: Siria, Pakistan: Pakistán, Palestine Palestina, Israel Israel, Iraq: Irak, Afghanistan: Afganistán, Libya: Libia, Turkey: Turquía, Thailand: Tailandia, Singapore: Singapur,South Africa: Sudáfrica, Mexico: México, Peru: Perú, Indonesia: Indonesia, GD Guangdong, FJ: Fujian, JL: Jilin, LN: Liaoning, TW: Taiwan (China), GZ: Guizhou, AH: Anhui, HL: Heilongjiang, HA: Henan, SC: Sichuan, HE: Hebei, YN: Yunnan, HB: Hubei, HI: Hainan, QH: Qinghai, HN: Hunan, JX: Jiangxi, SX: Shanxi, SN: Shaanxi, ZJ: Zhejiang, GS: Gansu, JS: Jiangsu, SD: Shandong, BJ: Beijing, SH: Shanghai, TJ: Tianjin, CQ: Chongqing, MO: Macao (China), HK: Hong Kong (China), NX: Ningxia, GX: Guangxi, XJ: Xinjiang, XZ: Xizang, NM: Mongolia Interior
white	Sí	Integer	Acción protectora: \n - 0: Block \n - 1: Allow \n - 2: Log only
description	No	String	Descripción de la regla

Parámetros de respuesta

Código de estado: 200

**Tabla 5** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
id	String	ID de la regla.
policyid	String	ID de política
geoip	String	Códigos para regiones que se pueden utilizar en una regla de control de acceso de geolocalización. \n CN: China, AB2: Fuera de China, AB: Fuera de China continental, Hong Kong, Macao y Taiwán, CA: Canadá, US: Estados Unidos, AU: Australia, IN: India, JP: Japón, UK: Reino Unido, FR: Francia, DE: Alemania, BR: Brasil, Ukraine: Ucrania, North Korea: Corea del Norte, The Republic of Korea: La República de Corea, Iran: Irán, Cuba: Cuba, Sultan: Sudán, Syria: Siria, Pakistan: Pakistán, Palestine Palestina, Israel Israel, Iraq: Irak, Afghanistan: Afganistán, Libya: Libia, Turkey: Turquía, Thailand: Tailandia, Singapore: Singapur,South Africa: Sudáfrica, Mexico: México, Peru: Perú, Indonesia: Indonesia, GD Guangdong, FJ: Fujian, JL: Jilin, LN: Liaoning, TW: Taiwan (China), GZ: Guizhou, AH: Anhui, HL: Heilongjiang, HA: Henan, SC: Sichuan, HE: Hebei, YN: Yunnan, HB: Hubei, HI: Hainan, QH: Qinghai, HN: Hunan, JX: Jiangxi, SX: Shanxi, SN: Shaanxi, ZJ: Zhejiang, GS: Gansu, JS: Jiangsu, SD: Shandong, BJ: Beijing, SH: Shanghai, TJ: Tianjin, CQ: Chongqing, MO: Macao (China), HK: Hong Kong (China), NX: Ningxia, GX: Guangxi, XJ: Xinjiang, XZ: Xizang, NM: Mongolia Interior
white	Integer	Acción protectora: \n - 0: Block \n - 1: Allow \n - 2: Log only
timestamp	Long	Marca de tiempo de creación de reglas

Código de estado: 400

**Tabla 6** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Código de estado: 401

**Tabla 7** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Código de estado: 500

**Tabla 8** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Solicitudes de ejemplo

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

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

Ejemplo de respuestas

Código de estado: 200

{
  "id" : "02dafa406c4941368a1037b020f15a53",
  "policyid" : "38ff0cb9a10e4d5293c642bc0350fa6d",
  "name" : "demo",
  "timestamp" : 1650534513775,
  "description" : "demo",
  "status" : 1,
  "geoip" : "SH|Afghanistan",
  "white" : 0,
  "geoTagList" : [ "SH", "Afghanistan" ]
}