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.
ImportHostKey
Agregue una clave de host al servidor especificada por el parámetro ServerId
.
Sintaxis de la solicitud
{
"Description": "string
",
"HostKeyBody": "string
",
"ServerId": "string
",
"Tags": [
{
"Key": "string
",
"Value": "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.
- Description
-
La descripción textual que identifica esta clave de host.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.
Patrón:
[\p{Print}]*
Obligatorio: no
- HostKeyBody
-
La parte de clave privada 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. La longitud máxima es de 4096 caracteres.
Obligatorio: sí
- ServerId
-
El identificador del servidor que contiene la clave de host que se va a importar.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
s-([0-9a-f]{17})
Obligatorio: sí
- Tags
-
Pares clave-valor que se pueden utilizar para agrupar y buscar claves de host.
Tipo: Matriz de Tag objetos
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 50 artículos.
Obligatorio: no
Sintaxis de la respuesta
{
"HostKeyId": "string",
"ServerId": "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.
- HostKeyId
-
Devuelve el identificador de clave de host de la clave importada.
Tipo: cadena
Limitaciones de longitud: longitud fija de 25.
Patrón:
hostkey-[0-9a-f]{17}
- ServerId
-
Devuelve el identificador del servidor que contiene la clave importada.
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 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
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: