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> Configuración de parámetros HTTPS

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

Ver PDF

Configuración de parámetros HTTPS

Función

Esta API se utiliza para configurar HTTPS para un nombre de dominio acelerado. Puede implementar la configuración HTTPS en todos los nodos de CDN para implementar la aceleración segura.

URI

PUT /v1.0/cdn/domains/{domain_id}/https-info

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
domain_id	Sí	String	Especifica el ID de nombre de dominio acelerado. Para obtener más información, consulte Consulta de detalles sobre un nombre de dominio.

**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. 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 4** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
https	Sí	HttpInfoRequestBody object	Especifica la configuración HTTPS.

**Tabla 5** HttpInfoRequestBody
Parámetro	Obligatorio	Tipo	Descripción
cert_name	Sí	String	Especifica el nombre del certificado. El valor contiene de 3 a 32 caracteres.
https_status	Sí	Integer	Especifica si se debe habilitar HTTPS. Valores posibles: 0: Desactivar HTTPS. El certificado y la clave privada no son necesarios. 1: Habilite HTTPS y seleccione Same as user para Origin Protocol. 2: Habilite HTTPS y seleccione HTTP para Origin Protocol. 3: Habilite HTTPS y seleccione HTTPS para Origin Protocol. El certificado y la clave privada son necesarios cuando se configura el certificado por primera vez. Deberá especificar el certificado y la clave privada cuando active HTTPS, excepto que ya haya configurado el certificado y la clave privada antes.
certificate	No	String	Especifica el cuerpo del certificado utilizado por el protocolo HTTPS. Este parámetro no es necesario si https_status se establece en 0. El valor está en formato PEM. Este parámetro es necesario si https_status se establece en 1 o 2 y se configura el certificado por primera vez.
private_key	No	String	Especifica la clave privada utilizada por el protocolo HTTPS. Este parámetro no es necesario si https_status se establece en 0. El valor está en formato PEM. Este parámetro es necesario si https_status se establece en 1 o 2 y se configura el certificado por primera vez.
http2	No	Integer	Especifica si se debe usar HTTP/2. Valores posibles: 1 (sí) y 0 (no).
certificate_type	No	Integer	Especifica el tipo de certificado. Valores posibles: 1 (certificado gestionado por Huawei) y 0 (su propio certificado). Valor predeterminado: 0.
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.

**Tabla 6** 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 7** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
https	HttpInfoResponseBody object	Especifica la configuración HTTPS.

**Tabla 8** HttpInfoResponseBody
Parámetro	Tipo	Descripción
https_status	Integer	Especifica si se debe habilitar HTTPS. Valores posibles: 0: Desactivar HTTPS. El certificado y la clave privada no son necesarios. 1: Habilite HTTPS y seleccione Igual que usuario para Origin Protocol en la consola de CDN. 2: Habilite HTTPS y seleccione HTTP para Origin Protocol en la consola de CDN. 3: Habilite HTTPS y seleccione HTTPS para Origin Protocol en la consola de CDN. El certificado y la clave privada son necesarios cuando HTTPS está habilitado.
cert_name	String	Especifica el nombre del certificado. El valor contiene de 3 a 32 caracteres.
certificate	String	Especifica el cuerpo del certificado.
private_key	String	Especifica la clave privada utilizada por el protocolo HTTPS. Este parámetro no es necesario si https_status se establece en 0. El valor está en formato de codificación PEM.
certificate_type	Integer	Especifica el tipo de certificado. Valores posibles: 1 (certificado gestionado por Huawei) y 0 (su propio certificado).
force_redirect_https	Integer	Especifica si está habilitada la redirección forzada. Valores posibles: 1 (sí) y 0 (no).
force_redirect_config	ForceRedirect object	Especifica la configuración de redirección forzada.
http2	Integer	Especifica si se debe usar HTTP/2. Valores posibles: 1 (sí) y 0 (no).
expiration_time	Long	Especifica la hora a la que caduca el certificado.

**Tabla 9** 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

PUT https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff8080**********************d71/https-info?enterprise_project_id=0

{
  "https" : {
    "http2" : 0,
    "certificate_type" : 0,
    "force_redirect_config" : {
      "redirect_type" : "http",
      "switch" : 1
    },
    "force_redirect_https" : 1,
    "https_status" : 2,
    "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" : {
    "http2" : 0,
    "certificate_type" : 0,
    "force_redirect_config" : {
      "redirect_type" : "http",
      "switch" : 1
    },
    "expiration_time" : 1636183290000,
    "force_redirect_https" : 2,
    "https_status" : 2,
    "cert_name" : "cdn_test_cert",
    "certificate" : "-----BEGIN CERTIFICATE----------END CERTIFICATE-----",
    "private_key" : ""
  }
}