

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à.

# CreateLocationFsxOntap
<a name="API_CreateLocationFsxOntap"></a>

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

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

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

```
{
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "StorageVirtualMachineArn": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateLocationFsxOntap_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.

 ** [Protocol](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Protocol"></a>
Speciifica il protocollo di trasferimento dati AWS DataSync utilizzato per accedere al tuo FSx file system Amazon.  
Tipo: oggetto [FsxProtocol](API_FsxProtocol.md)  
Obbligatorio: sì

 ** [SecurityGroupArns](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-SecurityGroupArns"></a>
Speciifica i gruppi di sicurezza di Amazon EC2 che forniscono l'accesso alla sottorete preferita del file system.  
I gruppi di sicurezza devono consentire il traffico in uscita sulle seguenti porte (a seconda del protocollo utilizzato):  
+  **NFS (Network File System)**: porte TCP 111, 635 e 2049
+  **SMB (Server Message Block)**: porta TCP 445
I gruppi di sicurezza del file system devono inoltre consentire il traffico in entrata sulle stesse porte.  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
Obbligatorio: sì

 ** [StorageVirtualMachineArn](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-StorageVirtualMachineArn"></a>
Specifica l'ARN della macchina virtuale di archiviazione (SVM) nel file system in cui o da cui copiare i dati.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 162.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$`   
Obbligatorio: sì

 ** [Subdirectory](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Subdirectory"></a>
Specificate il percorso della condivisione di file nella SVM da cui desiderate trasferire i dati o da cui desiderate trasferire i dati.  
Puoi specificare un percorso di giunzione (detto anche punto di montaggio), un percorso qtree (per condivisioni di file NFS) o un nome condivisione (per condivisioni di file SMB). Ad esempio, il percorso di montaggio potrebbe essere `/vol1`, `/vol1/tree1`, o `/share1`.  
Non specificare un percorso di giunzione nel volume radice dell'SVM. Per ulteriori informazioni, consulta [Managing FSx for ONTAP Storage Virtual Machines](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) nella *Amazon FSx for NetApp ONTAP User Guide*.
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 255.  
Modello: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$`   
Obbligatorio: no

 ** [Tags](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Tags"></a>
Specifica le etichette che consentono di classificare, filtrare e cercare le risorse AWS . È consigliabile creare almeno 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_CreateLocationFsxOntap_ResponseSyntax"></a>

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

## Elementi di risposta
<a name="API_CreateLocationFsxOntap_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_CreateLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxOntap-response-LocationArn"></a>
Specificate l'ARN della posizione FSx del file system for ONTAP che create.  
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_CreateLocationFsxOntap_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 servizio. AWS DataSync   
Codice di stato HTTP: 500

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

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

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