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.
CreateServer
Crea una instancia de servidor virtual de escalado automático en función del protocolo de transferencia de archivos seleccionado en AWS. Cuando actualice su servidor habilitado por protocoles de transferencia de archivos o cuando trabaje con usuarios, use la propiedad ServerId
generada por el servicio, la cual se asigna al servidor creado recientemente.
Sintaxis de la solicitud
{
"Certificate": "string
",
"Domain": "string
",
"EndpointDetails": {
"AddressAllocationIds": [ "string
" ],
"SecurityGroupIds": [ "string
" ],
"SubnetIds": [ "string
" ],
"VpcEndpointId": "string
",
"VpcId": "string
"
},
"EndpointType": "string
",
"HostKey": "string
",
"IdentityProviderDetails": {
"DirectoryId": "string
",
"Function": "string
",
"InvocationRole": "string
",
"SftpAuthenticationMethods": "string
",
"Url": "string
"
},
"IdentityProviderType": "string
",
"LoggingRole": "string
",
"PostAuthenticationLoginBanner": "string
",
"PreAuthenticationLoginBanner": "string
",
"ProtocolDetails": {
"As2Transports": [ "string
" ],
"PassiveIp": "string
",
"SetStatOption": "string
",
"TlsSessionResumptionMode": "string
"
},
"Protocols": [ "string
" ],
"S3StorageOptions": {
"DirectoryListingOptimization": "string
"
},
"SecurityPolicyName": "string
",
"StructuredLogDestinations": [ "string
" ],
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
],
"WorkflowDetails": {
"OnPartialUpload": [
{
"ExecutionRole": "string
",
"WorkflowId": "string
"
}
],
"OnUpload": [
{
"ExecutionRole": "string
",
"WorkflowId": "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.
- Certificate
-
El nombre de recurso de Amazon (ARN) del certificado AWS Certificate Manager (ACM). Necesario cuando
Protocols
se establece enFTPS
.Para solicitar un certificado público nuevo, consulte Solicitar un certificado público en la Guía del AWS Certificate Manager usuario.
Para importar un certificado existente a ACM, consulte Importación de certificados a ACM en la Guía del AWS Certificate Manager usuario.
Para solicitar un certificado privado para usar FTPS a través de direcciones IP privadas, consulte Solicitar un certificado privado en la Guía del AWS Certificate Manager usuario.
Se admiten certificados con los siguientes algoritmos criptográficos y tamaños de clave:
-
RSA de 2048 bits (RSA_2048)
-
RSA de 4096 bits (RSA_4096)
-
Curva elíptica principal de 256 bits (EC_prime256v1)
-
Curva elíptica principal de 384 bits (EC_secp384r1)
-
Curva elíptica principal de 521 bits (EC_secp521r1)
nota
El certificado debe ser un certificado SSL/TLS X.509 versión 3 válido con FQDN o dirección IP especificada e información sobre el emisor.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1600 caracteres.
Obligatorio: no
-
- Domain
-
El dominio del sistema de almacenamiento que se utiliza para las transferencias de archivos. Hay dos dominios disponibles: Amazon Simple Storage Service (Amazon S3) y Amazon Elastic File System (Amazon EFS). El valor predeterminado es S3.
nota
Después de crear el servidor, el dominio no se puede cambiar.
Tipo: cadena
Valores válidos:
S3 | EFS
Obligatorio: no
- EndpointDetails
-
Los ajustes del punto de conexión de la nube privada virtual (VPC) que está configurado para su servidor. Cuando aloja el punto de conexión dentro de la VPC, puede hacer que sea accesible solo para los recursos de la VPC, o puede adjuntar direcciones IP elásticas y hacer que sea accesible para los clientes a través de Internet. Los grupos de seguridad predeterminados de su VPC se asignan automáticamente a su punto de conexión.
Tipo: objeto EndpointDetails
Obligatorio: no
- EndpointType
-
El tipo de punto de conexión que desea que use el servidor. Puede optar por hacer que el punto de conexión de su servidor sea de acceso público (PUBLIC) o alojarlo dentro de su VPC. Con un punto de conexión alojado en una VPC, puede restringir el acceso al servidor y a los recursos solo dentro de su VPC o elegir que esté orientado a Internet al adjuntarle direcciones IP elásticas directamente.
nota
Después del 19 de mayo de 2021, no podrás crear un servidor con
EndpointType=VPC_ENDPOINT
tu cuenta Cuenta de AWS si no lo ha hecho antes del 19 de mayo de 2021. Si ya has creado servidoresEndpointType=VPC_ENDPOINT
en tu cuenta Cuenta de AWS el 19 de mayo de 2021 o antes, no te afectará. Después de esta fecha, useEndpointType
=VPC
.Para obtener más información, consulte Suspender el uso de VPC_ENDPOINT.
Se recomienda que utilice
VPC
comoEndpointType
. Con este tipo de punto de conexión, tiene la opción de asociar directamente hasta tres direcciones IPv4 Elastic (IP BYO incluida) con el punto de conexión del servidor y utilizar grupos de seguridad de VPC para restringir el tráfico de la dirección IP pública del cliente. Esto no es posible si se estableceEndpointType
enVPC_ENDPOINT
.Tipo: cadena
Valores válidos:
PUBLIC | VPC | VPC_ENDPOINT
Obligatorio: no
- HostKey
-
La clave privada RSA, ECDSA o ED25519 que se utilizará en el servidor habilitado para SFTP. Puede agregar varias claves de host, en caso de que desee rotar las claves, o tener un conjunto de claves activas que utilicen algoritmos diferentes.
Use el siguiente comando para generar una clave RSA de 2048 bits sin contraseña:
ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key
.Utilice un valor mínimo de 2048 para la opción
-b
. Puede crear una clave más fuerte utilizando 3072 o 4096.Utilice el siguiente comando para generar una clave ECDSA de 256 bits sin contraseña:
ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key
.Los valores válidos para la opción
-b
de ECDSA son 256, 384 y 521.Utilice el siguiente comando para generar una clave ED25519 sin contraseña:
ssh-keygen -t ed25519 -N "" -f my-new-server-key
.Puedes reemplazar todos estos comandos por my-new-server-keyla cadena que prefieras.
importante
Si no planea migrar los usuarios existentes de un servidor compatible con SFTP a un servidor nuevo, no actualice la clave de host. El cambio accidental de la clave de host de un servidor puede ser disruptivo.
Para obtener más información, consulte Actualizar las claves de host de un servidor con SFTP en la AWS Transfer Family Guía del usuario.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 4096 caracteres.
Obligatorio: no
- IdentityProviderDetails
-
Obligatorio cuando
IdentityProviderType
se establece enAWS_DIRECTORY_SERVICE
,AWS_LAMBDA
oAPI_GATEWAY
. Acepta una matriz que contiene toda la información necesaria para usar un directorio enAWS_DIRECTORY_SERVICE
o invocar a una API de autenticación proporcionada por el cliente, incluida la URL de API Gateway. No es necesario cuandoIdentityProviderType
se establece enSERVICE_MANAGED
.Tipo: objeto IdentityProviderDetails
Obligatorio: no
- IdentityProviderType
-
El modo de autenticación de un servidor. El valor predeterminado es
SERVICE_MANAGED
, que le permite almacenar las credenciales de usuario y acceder a ellas dentro del servicio. AWS Transfer FamilyÚselo
AWS_DIRECTORY_SERVICE
para proporcionar acceso a los grupos de Active Directory AWS Directory Service for Microsoft Active Directory o a Microsoft Active Directory en su entorno local o AWS mediante AD Connector. Esta opción también requiere que se especifique el ID del directorio mediante el parámetroIdentityProviderDetails
.Utilice el valor
API_GATEWAY
para la integración con un proveedor de identidades de su elección. La configuración deAPI_GATEWAY
requiere que proporcione un punto de conexión de Amazon API Gateway para solicitar la autenticación mediante el parámetroIdentityProviderDetails
.Usa el
AWS_LAMBDA
valor para usar directamente una AWS Lambda función como proveedor de identidades. Si elige este valor, debe especificar el ARN de la función de Lambda en el parámetroFunction
para el tipo de datos deIdentityProviderDetails
.Tipo: cadena
Valores válidos:
SERVICE_MANAGED | API_GATEWAY | AWS_DIRECTORY_SERVICE | AWS_LAMBDA
Obligatorio: no
- LoggingRole
-
El nombre de recurso de Amazon (ARN) de la función AWS Identity and Access Management (IAM) que permite a un servidor activar el CloudWatch registro de Amazon para Amazon S3 o Amazon EFSEvents. Cuando esté configurado, podrá ver la actividad de los usuarios en sus registros. CloudWatch
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0 caracteres. La longitud máxima es de 2048 caracteres.
Patrón:
(|arn:.*role/\S+)
Obligatorio: no
- PostAuthenticationLoginBanner
-
Especifica una cadena para que se muestre cuando los usuarios se conecten a un servidor. Esta cadena se muestra después de que el usuario se autentique.
nota
El protocolo SFTP no admite banners de visualización posteriores a la autenticación.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 4 096 caracteres.
Patrón:
[\x09-\x0D\x20-\x7E]*
Obligatorio: no
- PreAuthenticationLoginBanner
-
Especifica una cadena para que se muestre cuando los usuarios se conecten a un servidor. Esta cadena se muestra antes de que el usuario se autentique. Por ejemplo, el siguiente banner muestra detalles sobre el uso del sistema:
This system is for the use of authorized users only. Individuals using this computer system without authority, or in excess of their authority, are subject to having all of their activities on this system monitored and recorded by system personnel.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 4 096 caracteres.
Patrón:
[\x09-\x0D\x20-\x7E]*
Obligatorio: no
- ProtocolDetails
-
La configuración de protocolo configurados para su servidor.
-
Use el parámetro
PassiveIp
para indicar el modo pasivo (para los protocolos FTP y FTPS). Ingrese una sola dirección IPv4 de cuatro puntos, como la dirección IP externa de un firewall, un enrutador o un equilibrador de carga. -
Utilice el parámetro
SetStatOption
para ignorar el error que se genera cuando el cliente intenta usar el comandoSETSTAT
en un archivo que esté cargando en un bucket de Amazon S3. Para que el AWS Transfer Family servidor ignore elSETSTAT
comando y cargue archivos sin necesidad de realizar ningún cambio en el cliente SFTP, definaENABLE_NO_OP
el valor en. Si estableces elSetStatOption
parámetro enENABLE_NO_OP
, Transfer Family generará una entrada de registro en Amazon CloudWatch Logs para que puedas determinar cuándo el cliente está realizando unaSETSTAT
llamada. -
Para determinar si su AWS Transfer Family servidor reanuda las sesiones negociadas recientes mediante un identificador de sesión único, utilice el
TlsSessionResumptionMode
parámetro. -
As2Transports
indica el método de transporte de los mensajes de AS2. Actualmente, solo se admite HTTP.
Tipo: objeto ProtocolDetails
Obligatorio: no
-
- Protocols
-
Especifica el protocolo o los protocolos de File Transfer a través de los cuales el cliente de protocolo de File Transfer puede conectarse al punto de enlace del servidor. Los protocolos disponibles son:
-
SFTP
(Protocolo de File Transfer Secure Shell (SSH)): transferencia de archivos a través de SSH -
FTPS
(Protocolo de File Transfer seguro): transferencia de archivos con cifrado TLS -
FTP
(Protocolo de File Transfer): transferencia de archivos sin cifrar -
AS2
(Declaración de aplicabilidad 2): se utiliza para transportar datos estructurados business-to-business
nota
-
Si lo selecciona
FTPS
, debe elegir un certificado almacenado en AWS Certificate Manager (ACM) que se utilice para identificar el servidor cuando los clientes se conecten a él a través de FTPS. -
Si el
Protocol
incluyeFTP
oFTPS
, elEndpointType
debe serVPC
y elIdentityProviderType
debe serAWS_DIRECTORY_SERVICE
,AWS_LAMBDA
oAPI_GATEWAY
. -
Si
Protocol
incluyeFTP
, entoncesAddressAllocationIds
no se puede asociar. -
Si el
Protocol
se establece solo enSFTP
, se puede establecer elEndpointType
comoPUBLIC
y elIdentityProviderType
se puede configurar como cualquiera de los tipos de identidad admitidos:SERVICE_MANAGED
,AWS_DIRECTORY_SERVICE
,AWS_LAMBDA
oAPI_GATEWAY
. -
Si
Protocol
incluyeAS2
,EndpointType
debe serVPC
y el dominio debe ser Amazon S3.
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 4 elementos.
Valores válidos:
SFTP | FTP | FTPS | AS2
Obligatorio: no
-
- S3StorageOptions
-
Especifica si el rendimiento de los directorios de Amazon S3 está optimizado o no. Esta opción está deshabilitada de forma predeterminada.
De forma predeterminada, las asignaciones de los directorios principales tienen un
TYPE
valor de.DIRECTORY
Si habilita esta opción, tendrá que establecerla de forma explícitaFILE
siHomeDirectoryMapEntry
Type
desea que la asignación tenga un destino de archivo.Tipo: objeto S3StorageOptions
Obligatorio: no
- SecurityPolicyName
-
Especifica el nombre de la política de seguridad del servidor.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 100 caracteres.
Patrón:
Transfer[A-Za-z0-9]*SecurityPolicy-[A-Za-z0-9-]+
Obligatorio: no
- StructuredLogDestinations
-
Especifica los grupos de registro a los que se envían los registros de su servidor.
Para especificar un grupo de registros, debe proporcionar el ARN de un grupo de registros existente. En este caso, el formato del grupo de registros es el siguiente:
arn:aws:logs:region-name:amazon-account-id:log-group:log-group-name:*
Por ejemplo,
arn:aws:logs:us-east-1:111122223333:log-group:mytestgroup:*
Si ha especificado previamente un grupo de registros para un servidor, puede borrarlo y desactivar el registro estructurado proporcionando un valor vacío para este parámetro en una llamada
update-server
. Por ejemplo:update-server --server-id s-1234567890abcdef0 --structured-log-destinations
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.
Limitaciones de longitud: longitud mínima de 20. La longitud máxima es de 1600 caracteres.
Patrón:
arn:\S+
Obligatorio: no
- Tags
-
Pares clave-valor que se puede utilizar para agrupar y buscar servidores.
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
- WorkflowDetails
-
Especifica el ID del flujo de trabajo que se va a asignar y el rol de ejecución que se utiliza para ejecutar el flujo de trabajo.
Además de un flujo de trabajo que se ejecuta cuando un archivo se carga por completo,
WorkflowDetails
también puede contener un ID de flujo de trabajo (y un rol de ejecución) para que un flujo de trabajo se ejecute en una carga parcial. Se produce una carga parcial si la sesión de servidor se desconecta mientras se está cargando el archivo.Tipo: objeto WorkflowDetails
Obligatorio: no
Sintaxis de la respuesta
{
"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.
- ServerId
-
El identificador asignado al servicio del servidor que se crea.
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.
- AccessDeniedException
-
No tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 400
- InternalServiceError
-
Esta excepción se produce cuando se produce un error en el AWS Transfer Family servicio.
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
En el siguiente ejemplo se crea un nuevo usuario usando un VPC_ENDPOINT
.
Solicitud de muestra
{
"EndpointType": "VPC",
"EndpointDetails":...,
"HostKey": "Your RSA private key",
"IdentityProviderDetails": "IdentityProvider",
"IdentityProviderType": "SERVICE_MANAGED",
"LoggingRole": "CloudWatchLoggingRole",
"Tags": [
{
"Key": "Name",
"Value": "MyServer"
}
]
}
Ejemplo
Este es un ejemplo de respuesta para esta llamada a la API.
Respuesta de ejemplo
{
"ServerId": "s-01234567890abcdef"
}
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: