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/ Actualización de una regla de control de acceso de geolocalización

Actualización más reciente 2022-11-02 GMT+08:00

Ver PDF

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

Función

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

URI

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

**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 (valor del campo id en el cuerpo de la respuesta).
rule_id	Sí	String	ID de la regla. Se puede obtener llamando a la API ListGeoipRule. (el valor del campo id en el cuerpo de la respuesta)

**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	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 continental, 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, Ucrania: 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, Israel Israel, Iraq: Irak, Afganistan: Afganistán, Libya: Libia, Turkey: Turquía, Tailandia: Tailandia, Singapore: Singapur, South Africa: Sudáfrica, Mexico: México, Peru: Perú, Indonesia: Indonesia, GD Guangdong, FJ: Fujian, JL: Jilin, LN: Liaoning, TW: Taiwán (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: Pekín, SH: Shanghai, TJ: Tianjin, CQ: Chongqing, MO: Macao (China) HK: Hong Kong (China), NX: Ningxia, GX: Guangxi, XJ: Xinjiang, XZ: Tibet, NM: Mongolia Interior
white	Sí	Integer	Acción protectora: \n - 0: Block \n - 1: Allow \n - 2: Log only

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 continental, 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: Corea del Sur, Iran: Irán, Cuba: Cuba, Sultan: Sudán, Syria: Siria, Pakistan: Pakistán, Palestine, Israel Israel, Iraq: Irak, Afganistan: Afganistán, Libya: Libia, Turkey: Turquía, Tailandia: Tailandia, Singapore: Singapur, South Africa: Sudáfrica, Mexico: México, Peru: Perú, Indonesia: Indonesia, GD Guangdong, FJ: Fujian, JL: Jilin, LN: Liaoning, TW: Taiwán (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: Pekín, SH: Shanghai, TJ: Tianjin, CQ: Chongqing, MO: Macao (China) HK: Hong Kong (China), NX: Ningxia, GX: Guangxi, XJ: Xinjiang, XZ: Tibet, NM: Mongolia Interior
white	Integer	Acción protectora: \n - 0: Block \n - 1: Allow \n - 2: Log only

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 estad: 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

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

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

Ejemplo de respuestas

Código de estado: 200

La solicitud se ha realizado correctamente.

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