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
Compartir

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

OK

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

Códigos de estado

Código de estado

Descripción

200

OK

400

Error de solicitud

401

Permisos de token insuficientes.

500

Error de servidor interno.

Códigos de error

Consulte Códigos de error.

Tema principal:Certificate Management