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
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. |
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
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. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
https |
Sí |
HttpInfoRequestBody object |
Especifica la configuración HTTPS. |
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. |
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
Parámetro |
Tipo |
Descripción |
---|---|---|
https |
HttpInfoResponseBody object |
Especifica la configuración HTTPS. |
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. |
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.