ImportSshPublicKey - AWS Transfer Family

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: