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 porMaxRecords
.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 deMarker
en la siguiente llamada aDescribeCertificates
, 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: