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.

# DescribeLocationEfs
<a name="API_DescribeLocationEfs"></a>

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un sistema de archivos Amazon EFS.

## Sintaxis de la solicitud
<a name="API_DescribeLocationEfs_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeLocationEfs_RequestParameters"></a>

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.

 ** [LocationArn](#API_DescribeLocationEfs_RequestSyntax) **   <a name="DataSync-DescribeLocationEfs-request-LocationArn"></a>
El nombre de recurso de Amazon (ARN) de la ubicación del sistema de archivos de Amazon EFS sobre el que desea obtener información.  
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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeLocationEfs_ResponseSyntax"></a>

```
{
   "AccessPointArn": "string",
   "CreationTime": number,
   "Ec2Config": { 
      "SecurityGroupArns": [ "string" ],
      "SubnetArn": "string"
   },
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "LocationArn": "string",
   "LocationUri": "string"
}
```

## Elementos de respuesta
<a name="API_DescribeLocationEfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AccessPointArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-AccessPointArn"></a>
El ARN del punto de acceso que se DataSync utiliza para acceder al 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}$` 

 ** [CreationTime](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-CreationTime"></a>
La hora en que se creó el registro.  
Tipo: marca temporal

 ** [Ec2Config](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-Ec2Config"></a>
La subred y los grupos de seguridad que se AWS 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)

 ** [FileSystemAccessRoleArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-FileSystemAccessRoleArn"></a>
El rol AWS Identity and Access Management (IAM) que permite acceder DataSync al sistema de archivos Amazon EFS.  
Para obtener más información, consulte [Crear un rol 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/.*$` 

 ** [InTransitEncryption](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-InTransitEncryption"></a>
Indica si DataSync utiliza el cifrado Transport Layer Security (TLS) al transferir datos hacia o desde el sistema de archivos Amazon EFS.  
Tipo: cadena  
Valores válidos: `NONE | TLS1_2` 

 ** [LocationArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-LocationArn"></a>
El ARN de la ubicación 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):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-LocationUri"></a>
La URL de la ubicación del sistema de archivos de Amazon EFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

## Errores
<a name="API_DescribeLocationEfs_Errors"></a>

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
<a name="API_DescribeLocationEfs_Examples"></a>

### Solicitud de ejemplo
<a name="API_DescribeLocationEfs_Example_1"></a>

El siguiente ejemplo muestra cómo obtener información sobre una ubicación específica del sistema de archivos de Amazon EFS.

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678"
}
```

### Respuesta de ejemplo
<a name="API_DescribeLocationEfs_Example_2"></a>

El siguiente ejemplo devuelve detalles de ubicación sobre un sistema de archivos de Amazon EFS.

```
{
    "CreationTime": 1653319021.353,
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2"
        ]
    },
    "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890",
    "LocationUri": "efs://us-east-2.fs-021345abcdef6789/"
}
```

### Respuesta de ejemplo: descripción de una ubicación para un sistema de archivos de Amazon EFS restringido
<a name="API_DescribeLocationEfs_Example_3"></a>

El siguiente ejemplo devuelve los detalles de ubicación de un sistema de archivos de Amazon EFS con acceso restringido, incluidos los elementos `AccessPointArn`, `FileSystemAccessRoleArn` y `InTransitEncryption`.

```
{
    "CreationTime": 1653319021.353,
    "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"
    }]
}
```

## Véase también
<a name="API_DescribeLocationEfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationEfs)