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

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

La richiesta accetta i seguenti dati in formato JSON.

CmkSecretConfig

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 un codice personalizzato. AWS KMS key

Nota

È possibile utilizzare CmkSecretConfig (conPassword) o CustomSecretConfig (senzaPassword) per fornire le credenziali per una richiesta. CreateLocationFsxWindows Non fornite entrambi i parametri per la stessa richiesta.

Tipo: oggetto CmkSecretConfig

Obbligatorio: no

CustomSecretConfig

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.

Nota

Puoi utilizzare CmkSecretConfig (conPassword) o CustomSecretConfig (senzaPassword) per fornire le credenziali per una CreateLocationFsxWindows richiesta. Non fornite entrambi i parametri per la stessa richiesta.

Tipo: oggetto CustomSecretConfig

Obbligatorio: no

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

Vincoli di lunghezza: lunghezza massima di 253.

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

Obbligatorio: no

FsxFilesystemArn

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

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

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

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

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.

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

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.

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: