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> Content Delivery Network> Referencia de la API> API> Configuración del nombre de dominio> Modificación de la configuración completa del dominio

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

Ver PDF

Modificación de la configuración completa del dominio

Función

Esta API se utiliza para modificar la configuración completa del nombre de dominio, incluyendo encabezado de solicitud de recuperación, encabezado HTTP, autenticación de URL, certificado, servidor de origen, protocolo de recuperación, redirección forzada, compresión inteligente, parámetro URL de caché, IPv6, edad de caché de código de estado, Recuperación basada en rango, lista negra o lista blanca de agente de usuario, reescritura de URL de solicitud de recuperación y configuración de página de error personalizada.

URI

PUT /v1.1/cdn/configuration/domains/{domain_name}/configs

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
domain_name	Sí	String	Especifica el nombre de dominio acelerado.

**Tabla 2** Parámetros de Query
Parámetro	Obligatorio	Tipo	Descripción
enterprise_project_id	No	String	Proyecto de empresa al que pertenece el nombre de dominio que se va a modificar. Este parámetro sólo es válido cuando la función de proyecto de empresa está habilitada. El valor all indica todos los proyectos. Este parámetro es obligatorio cuando se utiliza un usuario de IAM para llamar a esta API.

Parámetros de solicitud

**Tabla 3** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Especifica el token de usuario. The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

**Tabla 4** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
configs	No	Configs object	Elementos de configuración.

**Tabla 5** Configs
Parámetro	Obligatorio	Tipo	Descripción
origin_request_header	No	Array of OriginRequestHeader objects	Configuración de encabezado de solicitud de recuperación. La configuración original de todos los encabezados se sobrescribirá. Cuando utilice esta API, cargue información de todos los encabezados.
http_response_header	No	Array of HttpResponseHeader objects	Configuración de encabezado HTTP. La configuración original de todos los encabezados se sobrescribirá. Cuando utilice esta API, cargue información de todos los encabezados.
url_auth	No	UrlAuth object	Firma de URL.
https	No	HttpPutBody object	Configuración del certificado.
sources	No	Array of SourcesConfig objects	Configuración del servidor de origen.
origin_protocol	No	String	Protocolo de recuperación de contenido. Valores posibles: follow (igual que las peticiones del usuario), http (HTTP, valor predeterminado) y https (HTTPS).
force_redirect	No	ForceRedirectConfig object	Forzar redireccionamiento.
compress	No	Compress object	Compresión inteligente.
cache_url_parameter_filter	No	CacheUrlParameterFilter object	Configuración para almacenar en caché los parámetros de URL.
ipv6_accelerate	No	Integer	Configuración de IPv6 (1: habilitado; 0: deshabilitado).
error_code_cache	No	Array of ErrorCodeCache objects	Vigencia de la caché del código de estado.
origin_range_status	No	String	Recuperación basada en rango, es decir, recuperación de contenido basada en segmentos. Para habilitar la recuperación basada en rango, el servidor de origen debe admitir solicitudes de rango, es decir, solicitudes con el campo Rango en los encabezados. De lo contrario, la recuperación de contenido puede fallar. on: Habilitarlo. off: Desactivarlo.
user_agent_filter	No	UserAgentFilter object	Lista negra o lista blanca del agente de usuario.
origin_request_url_rewrite	No	Array of OriginRequestUrlRewrite objects	Reescritura de URL de solicitud de recuperación. Se pueden configurar hasta 20 URLs.
error_code_redirect_rules	No	Array of ErrorCodeRedirectRules objects	Página de error personalizada.

**Tabla 6** OriginRequestHeader
Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	Encabezado de solicitud de recuperación. Un encabezado contiene de 1 a 64 caracteres, incluyendo letras, dígitos y guiones (-).
value	No	String	Valor del encabezado de solicitud de recuperación. Este parámetro es opcional para la operación de eliminación. Un valor contiene de 1 a 512 caracteres. Las variables, por ejemplo, $client_ip y $remote_port, no son compatibles.
action	Sí	String	Tipo de operación del encabezado de solicitud de recuperación.El valor se puede eliminar o establecer. set: Si el encabezado no existe en la solicitud de recuperación original, agregue el encabezado antes de establecer su valor.

**Tabla 7** HttpResponseHeader
Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	Encabezado de respuesta HTTP. Valores posibles: Content-Disposition, Content-Language, Access-Control-Allow-Origin, Access-Control-Allow-Methods, Access-Control-Max-Age, Access-Control-Expose-Headers, o custom headers. Un encabezado contiene de 1 a 100 caracteres, incluyendo letras, dígitos y guiones (-) y comienza con una letra.
value	No	String	Valor del encabezado de respuesta HTTP. Un valor contiene de 1 a 256 caracteres, incluidas letras, dígitos y caracteres especiales (.-_*#!%&+\|^~'/:;,=@?).
action	Sí	String	Tipo de operación del encabezado de respuesta HTTP. El valor se puede establecer o eliminar. Algunos encabezados solo se pueden establecer. Algunos encabezados personalizados no se pueden eliminar ni establecer.

**Tabla 8** UrlAuth
Parámetro	Obligatorio	Tipo	Descripción
status	Sí	String	Estado del método de firma de URL A/B/C. El valor puede estar off o on.
type	No	String	Método de firma type_a:Método A type_b:Método B type_c1:Método C1 type_c2:Método C2
key	No	String	Una clave de autenticación contiene de 6 a 32 caracteres, incluyendo letras y dígitos.
time_format	No	String	Formato de tiempo. dec:Decimal hex:Hexadecimal Método A:Solo se admite el formato decimal. Método B: Solo se admite el formato decimal. Método C1: Solo se admite el formato hexadecimal. Método C2: Los formatos decimal y hexadecimal son compatibles.
expire_time	No	Integer	Tiempo de caducidad. El valor varía de 0 a 31536000, en segundos.

**Tabla 9** HttpPutBody
Parámetro	Obligatorio	Tipo	Descripción
https_status	No	String	Si se debe habilitar HTTPS. on: activado; off: desactivado.
certificate_name	No	String	Nombre del certificado. El valor contiene de 3 a 32 caracteres. Este parámetro es obligatorio cuando se configura un certificado.
certificate_value	No	String	Contenido del certificado utilizado por el protocolo HTTPS. Este parámetro es obligatorio cuando se configura un certificado. El valor está en formato PEM.
private_key	No	String	Clave privada utilizada por el protocolo HTTPS. Este parámetro es obligatorio cuando se configura un certificado. El valor está en formato PEM.
certificate_source	No	Integer	Tipo de certificado. 1: certificado gestionado por Huawei; 0: su propio certificado. Valor predeterminado: 0. Este parámetro es obligatorio cuando se configura un certificado.
http2_status	No	String	Si se utiliza HTTP/2. on: sí; off: no. Valor predeterminado: off. Cuando https_status se establece en off, este parámetro no tiene efecto.
tls_version	No	String	Seguridad de la capa de transporte (TLS). Actualmente, TLSv1.0, TLSv1.1, TLSv1.2, y TLSv1.3 son compatibles. De forma predeterminada, todas las versiones están habilitadas. Puede habilitar una sola versión o versiones consecutivas. Para habilitar varias versiones, utilice comas (,) para separar versiones, por ejemplo, TLSv1.1,TLSv1.2.

**Tabla 10** SourcesConfig
Parámetro	Obligatorio	Tipo	Descripción
origin_addr	Sí	String	Dirección IP o nombre de dominio del servidor de origen.
origin_type	Sí	String	Tipo de servidor de origen. Valores posibles: ipaddr (dirección IP del servidor de origen), domain (nombre de dominio del servidor de origen), andobs_bucket (nombre de dominio de un bucket OBS).
priority	Sí	Integer	Prioridad de servidor de origen. Valores posibles: 70 (primario) y 30 (en espera).
obs_web_hosting_status	No	String	Si desea habilitar el alojamiento de sitios web estático para el bucket OBS. Este parámetro es obligatorio cuando el tipo de servidor de origen es obs_bucket. Valores posibles: off (deshabilitado) y on (habilitado).
http_port	No	Integer	Puerto HTTP. Valor predeterminado: 80.
https_port	No	Integer	Puerto HTTPS. Valor predeterminado: 443.
host_name	No	String	Host de recuperación. El valor predeterminado es el nombre de dominio de aceleración.

**Tabla 11** ForceRedirectConfig
Parámetro	Obligatorio	Tipo	Descripción
status	Sí	String	Si se debe activar la redirección forzada. Valores posibles: on (activado) y off (desactivado).
type	No	String	Forzar el tipo de redirección. Valores posibles: http (forzar la redirección a HTTP) y https (forzar la redirección a HTTPS).

**Tabla 12** Compress
Parámetro	Obligatorio	Tipo	Descripción
status	Sí	String	Ya sea para habilitar la compresión inteligente. Valores posibles: on (activado) y off (desactivado).
type	No	String	Tipo de compresión inteligente. Valores posibles: gzip (gzip) y br (Brotli).

**Tabla 13** CacheUrlParameterFilter
Parámetro	Obligatorio	Tipo	Descripción
type	No	String	Tipo de operación para almacenar en caché los parámetros de URL. full_url: cache todos los parámetros; ignore_url_params: ignore todos los parámetros; del_args: ignore parámetros de URL específicos; reserve_args: parámetros de URL especificados de reserva.
value	No	String	Valores de parámetros. Múltiples valores están separados por punto y coma (;).

**Tabla 14** ErrorCodeCache
Parámetro	Obligatorio	Tipo	Descripción
code	No	Integer	Los códigos de error 400, 403, 404, 405, 414, 500, 501, 502, 503 y 504 están disponibles.
ttl	No	Integer	Vigencia de la caché del código de error, en segundos. The value ranges from 0 to 31,536,000 (365 days each year by default).

**Tabla 15** UserAgentFilter
Parámetro	Obligatorio	Tipo	Descripción
type	Sí	String	Tipo de lista negra o blanca de agente de usuario. off: La lista negra y la lista blanca del agente de usuario están deshabilitadas. black: Lista negra del agente de usuario. white: Lista blanca del agente de usuario.
value	No	String	Lista negra o lista blanca del agente de usuario. Este parámetro es opcional cuando type se establece en off. Se pueden configurar hasta 10 reglas. Una sola regla contiene hasta 100 caracteres. Las reglas están separadas por comas (,).

**Tabla 16** OriginRequestUrlRewrite
Parámetro	Obligatorio	Tipo	Descripción
priority	Sí	Integer	Prioridad de una regla de reescritura de URL. La prioridad de una regla es obligatoria y debe ser única. La regla con la prioridad más alta se usará primero para hacer coincidir. La prioridad es un entero que oscila entre 1 y 100. Un número mayor indica una prioridad más alta.
match_type	Sí	String	Tipo de coincidencia. all: todos los archivos. file_path: ruta URL. wildcard
source_url	No	String	URL que se va a reescribir. Una URL comienza con una barra (/) y no contiene http://, https://, ni el nombre de dominio. Una URL contiene hasta 512 caracteres. Se admiten comodines (), por ejemplo, /test//*.mp4. Cuando el modo de coincidencia es Path, las cadenas de consulta de la URL original se eliminarán después de reescribir.
target_url	Sí	String	Una URL comienza con una barra (/) y no contiene http://, https://, ni el nombre de dominio. Una URL contiene hasta 256 caracteres. El campo n-ésimo comodín (*) se puede sustituir por $n, donde n = 1, 2, 3..., por ejemplo, /newtest/$1/$2.jpg.

**Tabla 17** ErrorCodeRedirectRules
Parámetro	Obligatorio	Tipo	Descripción
error_code	Sí	String	Código de error de redirección. Actualmente, se admiten los siguientes códigos de estado: 4xx: 400, 403, 404, 405, 414, 416, 451 5xx: 500, 501, 502, 503, 504
target_code	Sí	String	Código de estado de redirección. El valor puede ser 301 o 302.
target_link	Sí	String	URL de destino para redireccionamiento.

Parámetros de respuesta

Ninguno

Solicitudes de ejemplo

{
  "configs" : {
    "origin_request_header" : [ {
      "name" : "test_name",
      "value" : "test_value",
      "action" : "set"
    } ],
    "http_response_header" : [ {
      "name" : "test_name",
      "value" : "test_value",
      "action" : "set"
    } ],
    "url_auth" : {
      "status" : "off"
    },
    "compress" : {
      "status" : "off"
    },
    "force_redirect" : {
      "status" : "on",
      "type" : "http"
    },
    "origin_protocol" : "follow",
    "sources" : [ {
      "origin_addr" : "192.168.1.1",
      "origin_type" : "ipaddr",
      "priority" : 70,
      "http_port" : 80,
      "https_port" : 443
    } ]
  }
}