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à. # CreateLocationFsxWindows Crea una *posizione* di trasferimento per un file system Amazon FSx for Windows File Server. AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati. Prima di iniziare, assicuratevi di conoscere DataSync [le modalità di accesso ai file system FSx di Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access). ## Sintassi della richiesta ``` { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "FsxFilesystemArn": "string", "Password": "string", "SecurityGroupArns": [ "string" ], "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "User": "string" } ``` ## Parametri della richiesta Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md). La richiesta accetta i seguenti dati in formato JSON. ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** Specifica le informazioni di configurazione per un segreto DataSync gestito, che include la password da DataSync utilizzare per accedere a una specifica posizione di archiviazione di FSx Windows, con una password gestita dal cliente. AWS KMS key Quando includi questo parametro come parte di una `CreateLocationFsxWindows` richiesta, fornisci solo l'ARN della chiave KMS. DataSync utilizza questa chiave KMS insieme a quella `Password` specificata per creare un segreto DataSync gestito per archiviare le credenziali di accesso alla posizione. Assicurati di disporre DataSync dell'autorizzazione per accedere alla chiave KMS specificata. Per ulteriori informazioni, consulta [Utilizzo di un segreto gestito dal servizio crittografato con](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) un codice personalizzato. AWS KMS key È possibile utilizzare `CmkSecretConfig` (con`Password`) o `CustomSecretConfig` (senza`Password`) per fornire le credenziali per una richiesta. `CreateLocationFsxWindows` Non fornite entrambi i parametri per la stessa richiesta. Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md) Obbligatorio: no ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** Specifica le informazioni di configurazione per un segreto di Secrets Manager gestito dal cliente in cui la password per una posizione di archiviazione FSx per Windows File Server è archiviata in testo semplice, in Secrets Manager. Questa configurazione include l'ARN segreto e l'ARN per un ruolo IAM che fornisce l'accesso al segreto. Per ulteriori informazioni, consulta [Usare un segreto che gestisci tu](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Puoi utilizzare `CmkSecretConfig` (con`Password`) o `CustomSecretConfig` (senza`Password`) per fornire le credenziali per una `CreateLocationFsxWindows` richiesta. Non fornite entrambi i parametri per la stessa richiesta. Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md) Obbligatorio: no ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) ** Speciifica il nome del dominio Windows a cui appartiene il file system FSx for Windows File Server. Se nell'ambiente sono presenti più domini Active Directory, la configurazione di questo parametro assicura la DataSync connessione al file system corretto. Tipo: String Vincoli di lunghezza: lunghezza massima di 253. Modello: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Obbligatorio: no ** [FsxFilesystemArn](#API_CreateLocationFsxWindows_RequestSyntax) ** Speciifica l'Amazon Resource Name (ARN) per FSx il file system per Windows File Server. Tipo: String Limitazioni di lunghezza: lunghezza massima di 128. Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$` Obbligatorio: sì ** [Password](#API_CreateLocationFsxWindows_RequestSyntax) ** Speciifica la password dell'utente con le autorizzazioni per montare e accedere a file, cartelle e metadati dei file nel file system FSx per Windows File Server. Tipo: String Vincoli di lunghezza: lunghezza massima di 104. Modello: `^.{0,104}$` Obbligatorio: no ** [SecurityGroupArns](#API_CreateLocationFsxWindows_RequestSyntax) ** Speciifica gli ARN dei gruppi di sicurezza Amazon EC2 che forniscono l'accesso alla sottorete preferita del file system. I gruppi di sicurezza specificati devono essere in grado di comunicare con i gruppi di sicurezza del file system. Per informazioni sulla configurazione dei gruppi di sicurezza per l'accesso al file system, consulta la [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html). Se scegli un gruppo di sicurezza che non consente connessioni dall'interno, esegui una delle seguenti operazioni: + Configura il gruppo di sicurezza per consentirgli di comunicare al suo interno. + Scegli un gruppo di sicurezza diverso in grado di comunicare con il gruppo di sicurezza del target di montaggio. 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ì ** [Subdirectory](#API_CreateLocationFsxWindows_RequestSyntax) ** Specifica un percorso di montaggio per il tuo file system utilizzando le barre. Qui è dove DataSync legge o scrive i dati (a seconda che si tratti di una posizione di origine o di destinazione). Tipo: String Vincoli di lunghezza: lunghezza massima di 4096. Modello: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$` Obbligatorio: no ** [Tags](#API_CreateLocationFsxWindows_RequestSyntax) ** 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 ** [User](#API_CreateLocationFsxWindows_RequestSyntax) ** Speciifica l'utente con le autorizzazioni per montare e accedere a file, cartelle e metadati dei file nel file system FSx per Windows File Server. Per informazioni sulla scelta di un utente con il giusto livello di accesso per il trasferimento, consulta le [autorizzazioni richieste FSx per le posizioni](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) dei file server di Windows. Tipo: String Vincoli di lunghezza: lunghezza massima di 104. Modello: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Obbligatorio: sì ## Sintassi della risposta ``` { "LocationArn": "string" } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [LocationArn](#API_CreateLocationFsxWindows_ResponseSyntax) ** L'ARN della posizione del file system FSx per Windows File Server che hai creato. 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 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 ## Vedi anche 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/CreateLocationFsxWindows) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows)