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.
Actualización más reciente 2022-11-03 GMT+08:00

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

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

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

HttpInfoRequestBody object

Especifica la configuración HTTPS.

Tabla 5 HttpInfoRequestBody

Parámetro

Obligatorio

Tipo

Descripción

cert_name

String

Especifica el nombre del certificado. El valor contiene de 3 a 32 caracteres.

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

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

OK

{
  "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" : ""
  }
}

Códigos de estado

Código de estado

Descripción

200

OK

Códigos de error

Consulte Códigos de error.