Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
ListCertificates
Devuelve una lista de los certificados actuales que se han importado AWS Transfer Family. Si desea limitar los resultados a un número determinado, introduzca un valor para el parámetro MaxResults. Si ejecutó el comando anteriormente y recibió un valor para el parámetro NextToken, puede proporcionarlo para seguir enumerando los certificados desde donde los dejó.
Sintaxis de la solicitud
{
"MaxResults": number,
"NextToken": "string"
}Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en JSON formato.
- MaxResults
-
El número máximo de certificados para devolver.
Tipo: entero
Rango válido: valor mínimo de 1. Valor máximo de 1000.
Obligatorio: no
- NextToken
-
Cuando pueda obtener resultados adicionales de la llamada
ListCertificates, se devolverá un parámetroNextTokenen la salida. A continuación, puede pasar un comando posterior al parámetroNextTokenpara seguir enumerando los certificados adicionales.Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 6144 caracteres.
Obligatorio: no
Sintaxis de la respuesta
{
"Certificates": [
{
"ActiveDate": number,
"Arn": "string",
"CertificateId": "string",
"Description": "string",
"InactiveDate": number,
"Status": "string",
"Type": "string",
"Usage": "string"
}
],
"NextToken": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- Certificates
-
Devuelve una matriz de los certificados que se especifican en la llamada
ListCertificates.Tipo: matriz de objetos ListedCertificate
- NextToken
-
Devuelve el siguiente token, que puede usar para enumerar el siguiente certificado.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 6144 caracteres.
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InternalServiceError
-
Esta excepción se produce cuando se produce un error en el AWS Transfer Family servicio.
HTTPCódigo de estado: 500
- InvalidNextTokenException
-
El parámetro
NextTokenque se pasó no es válido.HTTPCódigo de estado: 400
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.
HTTPCódigo de estado: 400
- ResourceNotFoundException
-
Esta excepción se produce cuando el servicio AWS Transfer Family no encuentra un recurso.
HTTPCódigo de estado: 400
- ServiceUnavailableException
-
La solicitud ha fallado porque el servicio AWS Transfer Family no está disponible.
HTTPCódigo de estado: 500
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
