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 un punto de enlace para un sistema de archivos de Amazon EFS al que AWS DataSync puede acceder para una transferencia. Para obtener más información, consulte Crear una ubicación para Amazon EFS.
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 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.
- AccessPointArn
-
Especifica el nombre de recurso de Amazon (ARN) del punto de acceso que DataSync utiliza para acceder al sistema de archivos de Amazon EFS.
Tipo: String
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$
Obligatorio: no
- Ec2Config
-
Especifica los grupos de seguridad y la subred que DataSync utiliza para acceder al sistema de archivos de Amazon EFS.
Tipo: objeto Ec2Config
Obligatorio: sí
- EfsFilesystemArn
-
Especifica el ARN del sistema de archivos de Amazon EFS.
Tipo: String
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]*:[0-9]{12}:file-system/fs-.*$
Obligatorio: sí
- FileSystemAccessRoleArn
-
Especifica un rol AWS Identity and Access Management (IAM) que se DataSync asume al montar el sistema de archivos de Amazon EFS.
Tipo: String
Limitaciones de longitud: longitud máxima de 2048 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$
Obligatorio: no
- InTransitEncryption
-
Especifica si desea DataSync usar el cifrado de seguridad de la capa de transporte (TLS) 1.2 cuando copia datos en o desde el sistema de archivos de Amazon EFS.
Si especifica un punto de acceso mediante
AccessPointArn
o un rol de IAM conFileSystemAccessRoleArn
, debe establecer este parámetro enTLS1_2
.Tipo: String
Valores válidos:
NONE | TLS1_2
Obligatorio: no
- Subdirectory
-
Especifica una ruta de montaje para el sistema de archivos de Amazon EFS. Aquí es donde DataSync lee o escribe datos (en función de si se trata de una ubicación de origen o de destino). De forma predeterminada, DataSync utiliza el directorio raíz, pero también puede incluir subdirectorios.
nota
Debe especificar un valor con barras inclinadas (por ejemplo,
/path/to/folder
).Tipo: String
Limitaciones de longitud: longitud máxima de 4096 caracteres.
Patrón:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$
Obligatorio: no
- Tags
-
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
Miembros de la matriz: número mínimo de 0 elementos. Número máximo de 50 elementos.
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
-
Nombre de recurso de Amazon (ARN) de la ubicación del sistema de archivos de Amazon EFS que crea.
Tipo: String
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$
Errores
Para obtener información sobre los errores comunes a todas las acciones, consulteErrores comunes.
- InternalException
-
Esta excepción se produce cuando se produce un error en el AWS DataSync servicio.
Código de estado HTTP: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con formato incorrecto.
Código de estado HTTP: 400
Ejemplos
Solicitud de muestra
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 ejemplo: creación de una ubicación para un sistema de archivos Amazon EFS restringido
En el siguiente ejemplo, se crea una ubicación para un sistema de archivos de Amazon EFS con acceso restringido. En este tipo de situaciones, puede que tengas que especificar valores para AccessPointArn
FileSystemAccessRoleArn
, y InTransitEncryption
en tu 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 devuelve 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 un SDK de AWS de un lenguaje específico, consulte: