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/ Asociación de un certificado con varios nombres de dominio

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

Ver PDF

Asociación de un certificado con varios nombres de dominio

Función

Si asocia un certificado con varios nombres de dominio, debe habilitar la configuración de forzar HTTP para los nombres de dominio.

URI

PUT /v1.0/cdn/domains/config-https-info

**Tabla 1** 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 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Especifica el token de usuario. El token se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

**Tabla 3** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
https	No	UpdateDomainMultiCertificatesRequestBodyContent object	Especifica la configuración HTTPS.

**Tabla 4** UpdateDomainMultiCertificatesRequestBodyContent
Parámetro	Obligatorio	Tipo	Descripción
domain_name	Sí	String	Especifica la lista de nombres de dominio. Los nombres de dominio están separados por comas (,). Se admiten hasta 50 nombres de dominio.
https_switch	Sí	Integer	Especifica si se debe habilitar HTTPS. Valores posibles: 0 (deshabilitado) y 1 (habilitado). Si https_switch se establece en 1, se deben especificar los parámetros del certificado.
access_origin_way	No	Integer	Especifica el protocolo de origen. Valores posibles: 1 (igual que las peticiones del usuario), 2 (HTTP, valor predeterminado) y 3 (HTTPS). Si el valor está vacío, HTTP se utiliza de forma predeterminada.
force_redirect_https	No	Integer	Especifica si se deben redirigir a la fuerza las solicitudes a HTTPS. Valores posibles: 0 (no) y 1 (sí). Se recomienda utilizar force_redirect_config para configurar los ajustes.
force_redirect_config	No	ForceRedirect object	Especifica la configuración de redirección forzada.
http2	No	Integer	Especifica si se debe usar HTTP/2. Valores posibles: 0 (no) y 1 (sí). Si este parámetro está vacío, HTTP/2 no se utiliza por defecto.
cert_name	No	String	Especifica el nombre del certificado. Este parámetro es obligatorio cuando https_switch se establece en 1. El valor contiene de 3 a 32 caracteres.
certificate	No	String	Especifica el cuerpo del certificado. Este parámetro es obligatorio cuando https_switch se establece en 1.
private_key	No	String	Especifica la clave privada. Este parámetro es obligatorio cuando https_switch se establece en 1.
certificate_type	No	Integer	Especifica el tipo de certificado. Valores posibles: 0 (su propio certificado) y 1 (certificado gestionado por Huawei). Si establece este parámetro en 1, no es necesario introducir el cuerpo del certificado y la clave privada. El sistema hace coincidir automáticamente el certificado según el nombre del certificado. Si no establece este parámetro, el valor 0 se utiliza de forma predeterminada.

**Tabla 5** ForceRedirect
Parámetro	Obligatorio	Tipo	Descripción
switch	Sí	Integer	Especifica si se debe habilitar la redirección forzada. Valores posibles: 1 (habilitado) y 0 (habilitado).
redirect_type	No	String	Especifica el protocolo al que se redirigen a la fuerza las solicitudes. Valores posibles: http y https.

Parámetros de respuesta

Código de estado: 200

**Tabla 6** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
https	UpdateDomainMultiCertificatesResponseBodyContent object	Especifica la configuración HTTPS.

**Tabla 7** UpdateDomainMultiCertificatesResponseBodyContent
Parámetro	Tipo	Descripción
domain_name	String	Especifica la lista de nombres de dominio.
https_switch	Integer	Especifica si se debe habilitar HTTPS. Valores posibles: 0 (deshabilitado) y 1 (habilitado). Si establece este parámetro en 1, se debe configurar un certificado.
access_origin_way	Integer	Especifica el protocolo de origen. Valores posibles: 1 (igual que las peticiones del usuario), 2 (HTTP, valor predeterminado) y 3 (HTTPS).
force_redirect_https	Integer	Especifica si se deben redirigir a la fuerza las solicitudes a HTTPS. Valores posibles: 0 (no) y 1 (sí). Se recomienda utilizar force_redirect_config para configurar los ajustes.
force_redirect_config	ForceRedirect object	Especifica la configuración de redirección forzada.
http2	Integer	Especifica si se debe usar HTTP/2. Valores posibles: 0 (no) y 1 (sí).
cert_name	String	Especifica el nombre del certificado. El valor contiene de 3 a 32 caracteres.
certificate	String	Especifica el cuerpo del certificado.
certificate_type	Integer	Especifica el tipo de certificado. Valores posibles: 0 (su propio certificado) y 1 (certificado gestionado por Huawei).
expiration_time	Long	Especifica la hora a la que caduca el certificado.

**Tabla 8** ForceRedirect
Parámetro	Tipo	Descripción
switch	Integer	Especifica si se debe habilitar la redirección forzada. Valores posibles: 1 (habilitado) y 0 (habilitado).
redirect_type	String	Especifica el protocolo al que se redirigen a la fuerza las solicitudes. Valores posibles: http y https.

Solicitudes de ejemplo

{
  "https" : {
    "domain_name" : "example1.com",
    "access_origin_way" : 2,
    "http2" : 0,
    "certificate_type" : 0,
    "force_redirect_config" : {
      "redirect_type" : "https",
      "switch" : 1
    },
    "https_switch" : 1,
    "cert_name" : "cdn_test_cert",
    "certificate" : "-----BEGIN CERTIFICATE----------END CERTIFICATE-----",
    "private_key" : "-----BEGIN RSA PRIVATE KEY---------END RSA PRIVATE KEY-----"
  }
}

Ejemplo de respuestas

Código de estado: 200

{
  "https" : {
    "domain_name" : "example1.com",
    "https_switch" : 1,
    "access_origin_way" : 2,
    "force_redirect_https" : 1,
    "force_redirect_config" : {
      "redirect_type" : "https",
      "switch" : 1
    },
    "http2" : 0,
    "expiration_time" : 1925791912000,
    "cert_name" : "cdn_test_cert",
    "certificate" : "-----BEGIN CERTIFICATE----------END CERTIFICATE-----",
    "certificate_type" : 0
  }
}