Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# CreateLocationEfs
<a name="API_CreateLocationEfs"></a>

Crea una *posizione* di trasferimento per un file system Amazon EFS. AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati.

Prima di iniziare, assicurati di aver compreso come DataSync [accede ai file system Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access).

## Sintassi della richiesta
<a name="API_CreateLocationEfs_RequestSyntax"></a>

```
{
   "AccessPointArn": "string",
   "Ec2Config": { 
      "SecurityGroupArns": [ "string" ],
      "SubnetArn": "string"
   },
   "EfsFilesystemArn": "string",
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateLocationEfs_RequestParameters"></a>

Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

La richiesta accetta i seguenti dati in formato JSON.

 ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-AccessPointArn"></a>
Speciifica l'Amazon Resource Name (ARN) del punto di accesso utilizzato per DataSync montare il file system Amazon EFS.  
Per ulteriori informazioni, consulta [Accesso ai file system con restrizioni](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^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}$`   
Obbligatorio: no

 ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Ec2Config"></a>
Speciifica la sottorete e i gruppi di sicurezza DataSync utilizzati per connettersi a uno degli obiettivi di [montaggio](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) del file system Amazon EFS.  
Tipo: oggetto [Ec2Config](API_Ec2Config.md)  
Obbligatorio: sì

 ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-EfsFilesystemArn"></a>
Speciifica l'ARN per il tuo file system Amazon EFS.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^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}$`   
Obbligatorio: sì

 ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-FileSystemAccessRoleArn"></a>
Specifica un ruolo AWS Identity and Access Management (IAM) che consente di accedere DataSync al file system Amazon EFS.  
Per informazioni sulla creazione di questo ruolo, consulta [Creazione di un ruolo DataSync IAM per l'accesso al file system](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Obbligatorio: no

 ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-InTransitEncryption"></a>
Specifica se desideri DataSync utilizzare la crittografia Transport Layer Security (TLS) 1.2 quando trasferisce dati da o verso il tuo file system Amazon EFS.  
Se specifichi un punto di accesso utilizzando `AccessPointArn` o un ruolo IAM utilizzando `FileSystemAccessRoleArn`, è necessario impostare questo parametro su `TLS1_2`.  
Tipo: String  
Valori validi: `NONE | TLS1_2`   
Campo obbligatorio: no

 ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Subdirectory"></a>
Specifica un percorso di montaggio per il tuo file system Amazon EFS. È qui che DataSync legge o scrive i dati sul tuo file system (a seconda che si tratti di una posizione di origine o di destinazione).  
Per impostazione predefinita, DataSync utilizza la directory principale (o il [punto di accesso](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html), se fornito utilizzando`AccessPointArn`). È inoltre possibile includere sottodirectory utilizzando barre (ad esempio,). `/path/to/folder`  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obbligatorio: no

 ** [Tags](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Tags"></a>
Specifica la coppia chiave-valore che rappresenta un tag che si desidera aggiungere alla risorsa. Il valore può essere una stringa vuota. Questo valore consente di gestire, filtrare e cercare le risorse. È consigliabile creare un tag di nome per la posizione.  
Tipo: matrice di oggetti [TagListEntry](API_TagListEntry.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.  
Obbligatorio: no

## Sintassi della risposta
<a name="API_CreateLocationEfs_ResponseSyntax"></a>

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

## Elementi di risposta
<a name="API_CreateLocationEfs_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [LocationArn](#API_CreateLocationEfs_ResponseSyntax) **   <a name="DataSync-CreateLocationEfs-response-LocationArn"></a>
L'Amazon Resource Name (ARN) della posizione del file system Amazon EFS che crei.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^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}$` 

## Errori
<a name="API_CreateLocationEfs_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InternalException **   
Questa eccezione viene generata quando si verifica un errore nel AWS DataSync servizio.  
Codice di stato HTTP: 500

 ** InvalidRequestException **   
Questa eccezione viene generata quando il client invia una richiesta non valida.  
Codice di stato HTTP: 400

## Esempi
<a name="API_CreateLocationEfs_Examples"></a>

### Richiesta di esempio
<a name="API_CreateLocationEfs_Example_1"></a>

L'esempio seguente crea una posizione per un file system 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"
    }]
}
```

### Richiesta di esempio: creazione di una posizione per un file system Amazon EFS con restrizioni
<a name="API_CreateLocationEfs_Example_2"></a>

L'esempio seguente crea una posizione per un file system Amazon EFS con accesso limitato. In questo tipo di scenario, potrebbe essere necessario specificare i valori per `AccessPointArn` e `InTransitEncryption` nella richiesta. `FileSystemAccessRoleArn`

```
{
    "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"
    }]
}
```

### Risposta di esempio
<a name="API_CreateLocationEfs_Example_3"></a>

Una risposta restituisce l'ARN della posizione del file system Amazon EFS.

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

## Vedi anche
<a name="API_CreateLocationEfs_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs)