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.
ListHostKeys
Agregue una lista de claves de host al servidor especificada por el ServerId parámetro.
Sintaxis de la solicitud
{
"MaxResults": number,
"NextToken": "string",
"ServerId": "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
-
Número máximo de claves de host que se devolverán.
Tipo: entero
Rango válido: valor mínimo de 1. Valor máximo de 1000.
Obligatorio: no
- NextToken
-
Cuando hay resultados adicionales que no se devolvieron, se devuelve un parámetro
NextToken. Puede usar ese valor en una llamada posterior aListHostKeyspara seguir publicando los resultados.Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 6144 caracteres.
Obligatorio: no
- ServerId
-
El identificador del servidor que contiene las claves del host que desea visualizar.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
s-([0-9a-f]{17})Obligatorio: sí
Sintaxis de la respuesta
{
"HostKeys": [
{
"Arn": "string",
"DateImported": number,
"Description": "string",
"Fingerprint": "string",
"HostKeyId": "string",
"Type": "string"
}
],
"NextToken": "string",
"ServerId": "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.
- HostKeys
-
Devuelve una matriz en la que cada elemento contiene los detalles de una clave del host.
Tipo: matriz de objetos ListedHostKey
- NextToken
-
Devuelve un token que puede usar para volver a llamar a
ListHostKeysy recibir resultados adicionales, si los hay.Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 6144 caracteres.
- ServerId
-
Devuelve el identificador del servidor que contiene las claves del host enumeradas.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
s-([0-9a-f]{17})
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:
