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/ Consulta de la lista de certificados

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

Ver PDF

Consulta de la lista de certificados

Función

Esta API se utiliza para consultar la lista de certificados.

URI

GET /v1/{project_id}/waf/certificate

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto

**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.
page	No	Integer	Número de página de los datos a devolver durante la consulta de paginación. El valor varía de 0 a 100000. El valor predeterminado es 1, que indica que se devuelven los datos de la primera página. Predeterminado: 1
pagesize	No	Integer	Número de resultados en cada página durante la consulta de paginación. El valor varía de 1 a 100. El valor predeterminado es 10, lo que indica que cada página contiene 10 resultados. Predeterminado: 10
name	No	String	Nombre del certificado
host	No	Boolean	Si se desea obtener el nombre de dominio para el que se utiliza el certificado. El valor predeterminado es false. \n -true: Obtener los certificados que se han utilizado para los nombres de dominio. \n -false: obtenga los certificados que no se utilizan para ningún nombre de dominio. Predeterminado: false
exp_status	No	Integer	Estado del certificado. Las opciones son 0, 1 y 2. 0: El certificado es válido. 1: El certificado ha caducado; 2: El certificado caducará en el plazo de un mes.

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

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
items	Array of CertificateBody objects	Certificados
total	Integer	Número total de certificados

**Tabla 5** CertificateBody
Parámetro	Tipo	Descripción
id	String	ID de certificado
name	String	Nombre del certificado
content	String	Archivo de certificado, que está en formato PEM.
key	String	Clave privada del certificado, que está en formato PEM.
expire_time	Long	Marca de tiempo de caducidad del certificado.
exp_status	Integer	Estado del certificado. Las opciones son 0, 1 y 2. 0: El certificado es válido. 1: El certificado ha caducado; 2: El certificado caducará en el plazo de un mes.
timestamp	Long	Marca de tiempo de carga de certificado.
bind_host	Array of BindHost objects	Nombre de dominio asociado al certificado

**Tabla 6** BindHost
Parámetro	Tipo	Descripción
id	String	ID de nombre de dominio
hostname	String	Nombre de dominio
waf_type	String	Modo de nombre de dominio: cloud (modo de cloud) / premium (modo dedicado)
mode	String	Este parámetro es requerido solamente por el modo dedicado.

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 estado: 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?enterprise_project_id=0

Ejemplo de respuestas

Código de estado: 200

{
  "total" : 1,
  "items" : [ {
    "id" : "dc443ca4f29c4f7e8d4adaf485be317b",
    "name" : "demo",
    "timestamp" : 1643181401751,
    "expire_time" : 1650794100000,
    "bind_host" : [ ],
    "exp_status" : 2
  } ]
}