DescribeCertificates - Amazon DocumentDB

DescribeCertificates

Devuelve una lista de los certificados de la autoridad de certificación (CA) proporcionados por Amazon DocumentDB para esta Cuenta de AWS.

Parámetros de la solicitud

Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.

CertificateIdentifier

El identificador del certificado proporcionado por el usuario. Si se especifica este parámetro, se devuelve información solo del certificado especificado. Si se omite este parámetro, se devuelve una lista de hasta MaxRecords certificados. Este parámetro no distingue entre mayúsculas y minúsculas.

Restricciones

  • Debe coincidir con un CertificateIdentifier existente.

Tipo: cadena

Requerido: no

Filters.Filter.N

Este parámetro es incompatible en estos momentos.

Tipo: matriz de objetos Filter

Requerido: no

Marker

Un token de paginación opcional proporcionado por una solicitud DescribeCertificates anterior. Si se especifica este parámetro, la respuesta solo incluye registros más allá del marcador, hasta el valor especificado por MaxRecords.

Tipo: cadena

Requerido: no

MaxRecords

El número máximo de registros que se deben incluir en la respuesta. Si el número de registros es superior al valor MaxRecords especificado, se incluye en la respuesta un token de paginación que se conoce como marcador, de modo que se pueda recuperar el resto de resultados.

Predeterminado: 100

Restricciones:

  • Mínimo: 20

  • Máximo: 100

Tipo: entero

Requerido: no

Elementos de respuesta

El servicio devuelve los siguientes elementos.

Certificates.Certificate.N

Una lista de certificados para esta Cuenta de AWS.

Tipo: matriz de objetos Certificate

Marker

Se proporciona un token de paginación opcional si el número de registros recuperados es superior a MaxRecords. Si se especifica este parámetro, el marcador especifica el siguiente registro de la lista. Si se incluye el valor de Marker en la siguiente llamada a DescribeCertificates, aparecerá la siguiente página de certificados.

Tipo: cadena

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

CertificateNotFound

CertificateIdentifier no hace referencia a un certificado existente.

Código de estado HTTP: 404

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte: