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. # CreateLocationEfs Crea una *ubicación* de transferencia para un sistema de archivos Amazon EFS. AWS DataSync puede usar esta ubicación como origen o destino para transferir datos. Antes de empezar, asegúrese de entender cómo DataSync [accede a los sistemas de archivos de Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access). ## Sintaxis de la solicitud ``` { "AccessPointArn": "string", "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "EfsFilesystemArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "Subdirectory": "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](CommonParameters.md). La solicitud acepta los siguientes datos en formato JSON. ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) ** Especifica el nombre de recurso de Amazon (ARN) del punto de acceso que se DataSync utiliza para montar el sistema de archivos Amazon EFS. Para obtener más información, consulte [Acceso a sistemas de archivos restringidos](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam). Tipo: cadena Limitaciones de longitud: longitud máxima de 128 caracteres. Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` Obligatorio: no ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) ** Especifica la subred y los grupos de seguridad que se DataSync utilizan para conectarse a uno de los [destinos de montaje](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) del sistema de archivos Amazon EFS. Tipo: objeto [Ec2Config](API_Ec2Config.md) Obligatorio: sí ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) ** Especifica el ARN del sistema de archivos de Amazon EFS. Tipo: cadena Limitaciones de longitud: longitud máxima de 128 caracteres. Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]{8,40}$` Obligatorio: sí ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) ** Especifica un rol AWS Identity and Access Management (IAM) que permite acceder DataSync al sistema de archivos Amazon EFS. Para obtener información sobre la creación de esta función, consulte [Creación de una función de DataSync IAM para el acceso al sistema de archivos](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role). Tipo: cadena Limitaciones de longitud: longitud máxima de 2048 caracteres. Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` Obligatorio: no ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) ** Especifica si desea DataSync utilizar el cifrado Transport Layer Security (TLS) 1.2 cuando transfiera datos hacia o desde su sistema de archivos Amazon EFS. Si especifica un punto de acceso mediante `AccessPointArn` o un rol de IAM con `FileSystemAccessRoleArn`, debe establecer este parámetro en `TLS1_2`. Tipo: cadena Valores válidos: `NONE | TLS1_2` Obligatorio: no ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) ** Especifica una ruta de montaje para el sistema de archivos de Amazon EFS. Aquí es donde DataSync lee o escribe los datos en su sistema de archivos (dependiendo de si se trata de una ubicación de origen o de destino). De forma predeterminada, DataSync utiliza el directorio raíz (o el [punto de acceso](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) si se proporciona uno mediante él`AccessPointArn`). También puede incluir subdirectorios usando barras diagonales (por ejemplo, `/path/to/folder`). Tipo: cadena Limitaciones de longitud: longitud máxima de 4096 caracteres. Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$` Obligatorio: no ** [Tags](#API_CreateLocationEfs_RequestSyntax) ** Especifica el par clave-valor que representa una etiqueta que desea agregar al recurso. El valor puede ser una cadena vacía. Este valor le ayuda a administrar, filtrar y buscar sus recursos. Le recomendamos que cree una etiqueta de nombre para su ubicación. Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md) Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos. Obligatorio: no ## Sintaxis de la respuesta ``` { "LocationArn": "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. ** [LocationArn](#API_CreateLocationEfs_ResponseSyntax) ** Nombre de recurso de Amazon (ARN) de la ubicación del sistema de archivos de Amazon EFS que cree. Tipo: cadena Limitaciones de longitud: longitud máxima de 128 caracteres. Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` ## Errores Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md). ** InternalException ** Esta excepción se produce cuando se genera un error en el servicio AWS DataSync . 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 ## Ejemplos ### Solicitud de ejemplo En el siguiente ejemplo, se crea una ubicación para un sistema de archivos de Amazon EFS. ``` { "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2" ] }, "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### Solicitud de muestra: creación de una ubicación para un sistema de archivos de Amazon EFS restringido En el siguiente ejemplo, se crea una ubicación para un sistema de archivos de Amazon EFS configurado para acceso restringido. En este tipo de escenario, es posible que deba especificar valores para `AccessPointArn`, `FileSystemAccessRoleArn` y `InTransitEncryption` en su solicitud. ``` { "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0", "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew", "InTransitEncryption": "TLS1_2", "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### Respuesta de ejemplo Una respuesta arroja el ARN de ubicación del sistema de archivos de Amazon EFS. ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" } ``` ## Véase también Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs)