ListCert - Certificate Management Service - Centro de documentación de Alibaba Cloud

Esta API consulta certificados en el almacén de certificados.

Descripción de la operación

El límite de QPS por usuario único para esta API es 10. Las llamadas que superen este límite se limitarán, lo cual puede afectar su negocio. Planifique sus llamadas a la API en consecuencia.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

yundun-cert:ListCert

get

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
KeyWord	string	No	La palabra clave para una búsqueda aproximada por nombre, nombre de dominio o nombre alternativo del asunto.	test_name
WarehouseId	integer	No	El ID del almacén. Puede obtener este ID mediante la llamada a la API ListCertWarehouse.	12
Status	string	No	El estado del certificado. Valores válidos: ISSUE: emitido REVOKE: revocado	ISSUE
SourceType	string	No	El origen del certificado. Valores válidos: upload: certificado cargado aliyun: certificado de Alibaba Cloud	aliyun
CertType	string	No	El tipo de certificado. Valores válidos: CA: certificado de CA CERT: certificado emitido	CERT
CurrentPage	integer	No	El número de página que se devolverá. El valor predeterminado es 1.	1
ShowSize	integer	No	El número de entradas por página. El valor predeterminado es 50.	50
Identifiers	string	No	Una lista de identificadores de certificados separados por comas.	aaa,bbb

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Un contenedor para los datos de respuesta.
ShowSize	integer	El tamaño de página. Valor predeterminado: 50.	50
CurrentPage	integer	El número de página actual. Valor predeterminado: 1.	1
TotalCount	integer	El número total de entradas.	10
CertList	array<object>	La lista de certificados.
	object	Los detalles de un certificado.
WhId	integer	El ID del almacén.	2
Identifier	string	El identificador único del certificado.	14dcc8afc7578e
WhInstanceId	string	El ID de la instancia del almacén.	test_whInstanceId
Status	string	El estado del certificado. Valores válidos: ISSUE: El certificado está emitido. REVOKE: El certificado está revocado.	ISSUE
SourceType	string	El origen del certificado. Valores válidos: upload: El certificado está cargado. aliyun: El certificado es de Alibaba Cloud.	aliyun
CertType	string	El tipo de certificado. Valores válidos: CA: un certificado de autoridad de certificación (CA) CERT: un certificado emitido	CERT
CommonName	string	El nombre común del certificado. Por lo general, es el nombre de dominio principal asociado con el certificado.	aliyun.alibaba.com
BeforeDate	integer	La fecha de inicio del periodo de validez del certificado. Este valor es una marca de tiempo UNIX en milisegundos.	1665819958000
Issuer	string	El emisor del certificado.	mySSL
AfterDate	integer	La fecha de caducidad del certificado. Este valor es una marca de tiempo UNIX en milisegundos.	1634283958000
ExistPrivateKey	boolean	Indica si hay una clave privada disponible para el certificado. Valores válidos: true false	false
Sans	string	Los nombres alternativos del asunto (SAN) asociados con el certificado. Los nombres de dominio múltiples están separados por comas (,).	*.alibaba.com,aliyun.alibaba.com
SerialNo	string	El número de serie del certificado. Este parámetro se devuelve solo si el parámetro de solicitud `OrderType` se establece en `CERT` o `UPLOAD`.
Algorithm	string	El algoritmo de cifrado del certificado. Valores válidos: RSA: el algoritmo RSA ECC: el algoritmo ECC SM2: el algoritmo SM2
SignAlgorithm	string	El algoritmo de firma del certificado.
RequestId	string	El ID de la solicitud.	15C66C7B-671A-4297-9187-2C4477247A74

Ejemplos

Respuesta exitosa

JSON Formato

{
  "ShowSize": 50,
  "CurrentPage": 1,
  "TotalCount": 10,
  "CertList": [
    {
      "WhId": 2,
      "Identifier": "14dcc8afc7578e",
      "WhInstanceId": "test_whInstanceId",
      "Status": "ISSUE",
      "SourceType": "aliyun",
      "CertType": "CERT",
      "CommonName": "aliyun.alibaba.com",
      "BeforeDate": 1665819958000,
      "Issuer": "mySSL",
      "AfterDate": 1634283958000,
      "ExistPrivateKey": false,
      "Sans": "*.alibaba.com,aliyun.alibaba.com",
      "SerialNo": "038abf4c27c33a7c11ad6658124135b52180",
      "Algorithm": "RSA",
      "SignAlgorithm": "SHA256WITHRSA"
    }
  ],
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.