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.
ImportSshPublicKey
Añade una clave pública de Secure Shell (SSH) a un usuario de Transfer Family identificado por un valor UserName asignado al servidor habilitado para el protocolo de File Transfer específico, identificado por ServerId.
La respuesta devuelve el valor UserName, el valor ServerId y el nombre de SshPublicKeyId.
Sintaxis de la solicitud
{
"ServerId": "string",
"SshPublicKeyBody": "string",
"UserName": "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 formato JSON.
- ServerId
-
Identificador único asignado por el sistema para un servidor.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
s-([0-9a-f]{17})Obligatorio: sí
- SshPublicKeyBody
-
La parte de clave pública de un par de claves SSH.
AWS Transfer Family acepta claves RSA, ECDSA y ED25519.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0 caracteres. La longitud máxima es de 2048 caracteres.
Obligatorio: sí
- UserName
-
El nombre del usuario de Transfer Family que está asignado a uno o más servidores.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 100 caracteres.
Patrón:
[\w][\w@.-]{2,99}Obligatorio: sí
Sintaxis de la respuesta
{
"ServerId": "string",
"SshPublicKeyId": "string",
"UserName": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- ServerId
-
Identificador único asignado por el sistema para un servidor.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
s-([0-9a-f]{17}) - SshPublicKeyId
-
Nombre otorgado a una clave pública por el sistema que se importó.
Tipo: cadena
Limitaciones de longitud: longitud fija de 21.
Patrón:
key-[0-9a-f]{17} - UserName
-
Un nombre de usuario otorgado al
ServerIDvalor que especificó.Tipo: cadena
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 100 caracteres.
Patrón:
[\w][\w@.-]{2,99}
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 servicio. AWS Transfer Family
Código de estado HTTP: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.
Código de estado HTTP: 400
- ResourceExistsException
-
El recurso solicitado no existe o existe en una región distinta de la especificada para el comando.
Código de estado HTTP: 400
- ResourceNotFoundException
-
Esta excepción se produce cuando el servicio AWS Transfer Family no encuentra un recurso.
Código de estado HTTP: 400
- ServiceUnavailableException
-
La solicitud ha fallado porque el servicio AWS Transfer Family no está disponible.
Código de estado HTTP: 500
- ThrottlingException
-
La solicitud fue denegada debido a una limitación de la solicitud.
Código de estado HTTP: 400
Ejemplos
Ejemplo
Este comando importa una clave ECDSA almacenada en el archivo id_ecdsa.pub.
aws transfer import-ssh-public-key --server-id s-021345abcdef6789 --ssh-public-key-body file://id_ecdsa.pub --user-name jane-doe
Ejemplo
Si ejecuta el comando anterior, el sistema devuelve la siguiente información.
{ "ServerId": "s-021345abcdef6789", "SshPublicKeyId": "key-1234567890abcdef0", "UserName": "jane-doe" }
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
