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 UserName
valor asignado al servidor específico habilitado para el protocolo de transferencia de archivos, 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 SSH claves.
AWS Transfer Family acepta RSAECDSA, y ED25519 claves.
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 de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- 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
ServerID
valor 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 AWS Transfer Family servicio.
HTTPCódigo de estado: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.
HTTPCódigo de estado: 400
- ResourceExistsException
-
El recurso solicitado no existe o existe en una región distinta de la especificada para el comando.
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
- ThrottlingException
-
La solicitud fue denegada debido a una limitación de la solicitud.
HTTPCódigo de estado: 400
Ejemplos
Ejemplo
Este comando importa una ECDSA clave almacenada en el id_ecdsa.pub
archivo.
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 cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: