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/ Web Application Firewall/ Referencia de la API/ API/ Certificate Management/ Aplicación de un certificado a un nombre de dominio

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

Ver PDF

Aplicación de un certificado a un nombre de dominio

Función

Esta API se utiliza para aplicar un certificado a un nombre de dominio.

URI

POST /v1/{project_id}/waf/certificate/{certificate_id}/apply-to-hosts

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto
certificate_id	Sí	String	ID de certificado HTTPS. Se puede obtener llamando a la API ListCertificates.

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
enterprise_project_id	No	String	ID del proyecto de empresa. Se puede obtener mediante el llamado API ListEnterpriseProject de EPS.

Parámetros de solicitud

**Tabla 3** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Se puede obtener llamando a la API IAM (valor de X-Subject-Token en el encabezado de respuesta).
Content-Type	Sí	String	Tipo de contenido Predeterminado: application/json;charset=utf8

**Tabla 4** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
cloud_host_ids	No	Array of strings	ID del nombre de dominio HTTPS en modo nube. Se puede obtener llamando a la API ListHost.
premium_host_ids	No	Array of strings	ID del nombre de dominio HTTPS en modo dedicado. Se puede obtener llamando a la API ListPremiumHost.

Parámetros de respuesta

Código de estado: 200

**Tabla 5** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
id	String	ID del certificado.
name	String	Nombre del certificado
timestamp	Long	Tiempo.
expire_time	Long	Fecha de expiración
bind_host	Array of CertificateBundingHostBody objects	Lista de nombres de dominios

**Tabla 6** CertificateBundingHostBody
Parámetro	Tipo	Descripción
id	String	ID de nombre de dominio
hostname	String	Nombre de dominio
waf_type	String	Modo WAF. El valor puede ser cloud para el modo cloud o premium para el modo dedicado. Valores de enumeración: cloud premium

Código de estado: 400

**Tabla 7** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Código de estad: 401

**Tabla 8** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Código de estado: 500

**Tabla 9** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Solicitudes de ejemplo

GET https://{Endpoint}/v1/{project_id}/waf/certificate/{certificate_id}/apply-to-hosts?enterprise_project_id=0

{
  "cloud_host_ids" : [ "85e554189d494c0f97789e93531c9f90" ],
  "premium_host_ids" : [ "4e9e97c425fc463c8f374b90124e8392" ]
}

Ejemplo de respuestas

Código de estado: 200

{
  "id" : "3ac1402300374a63a05be68c641e92c8",
  "name" : "www.abc.com",
  "timestamp" : 1636343349139,
  "expire_time" : 1650794100000,
  "bind_host" : [ {
    "id" : "e350cf556da34adab1f017523d1c05ed",
    "hostname" : "www.demo.com",
    "waf_type" : "cloud",
    "bandwidth" : 0,
    "qps" : 0
  } ]
}