CreateLocationFsxWindows - AWS DataSync

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.

Sintassi della richiesta

{ "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.

La richiesta accetta i seguenti dati in formato JSON.

Domain

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: stringa

Vincoli di lunghezza: lunghezza massima di 253.

Modello: ^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$

Campo obbligatorio: no

FsxFilesystemArn

Speciifica l'Amazon Resource Name (ARN) per FSx il file system per Windows File Server.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 128.

Modello: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):fsx:[a-z\-0-9]*:[0-9]{12}:file-system/fs-.*$

Campo obbligatorio: sì

Password

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: stringa

Vincoli di lunghezza: lunghezza massima di 104.

Modello: ^.{0,104}$

Campo obbligatorio: sì

SecurityGroupArns

Speciifica i gruppi ARNs di EC2 sicurezza Amazon che forniscono l'accesso alla sottorete preferita del tuo file system.

I gruppi di sicurezza specificati devono essere in grado di comunicare con i gruppi di sicurezza del tuo file system. Per informazioni sulla configurazione dei gruppi di sicurezza per l'accesso al file system, consulta la Amazon FSx for Windows File Server User Guide.

Nota

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: matrice 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-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$

Campo obbligatorio: sì

Subdirectory

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: stringa

Vincoli di lunghezza: lunghezza massima di 4096.

Modello: ^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$

Campo obbligatorio: no

Tags

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

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.

Campo obbligatorio: no

User

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 dei file server di Windows.

Tipo: stringa

Vincoli di lunghezza: lunghezza massima di 104.

Modello: ^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$

Campo 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

L'ARN della posizione del file system FSx per Windows File Server che hai creato.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 128.

Modello: ^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}$

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

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: