Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # CreateLocationFsxWindows Crée un *emplacement* de transfert pour un système de fichiers Amazon FSx pour Windows File Server. AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. Avant de commencer, assurez-vous de bien comprendre le mode d' DataSync[accès FSx aux systèmes de fichiers Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access). ## Syntaxe de la requête ``` { "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" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, notamment le mot de passe DataSync utilisé pour accéder à un emplacement de stockage FSx Windows spécifique, avec un code géré par le client AWS KMS key. Lorsque vous incluez ce paramètre dans le cadre d'une `CreateLocationFsxWindows` demande, vous ne fournissez que l'ARN de la clé KMS. DataSync utilise cette clé KMS avec celle `Password` que vous spécifiez pour créer un secret DataSync géré afin de stocker les informations d'identification d'accès à la localisation. Assurez-vous qu'il DataSync est autorisé à accéder à la clé KMS que vous spécifiez. Pour plus d'informations, consultez la section [Utilisation d'un secret géré par un service chiffré avec un code personnalisé](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key Vous pouvez utiliser `CmkSecretConfig` (avec`Password`) ou `CustomSecretConfig` (sans`Password`) pour fournir des informations d'identification pour une `CreateLocationFsxWindows` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie les informations de configuration pour un secret du Gestionnaire de secrets géré par le client où le mot de passe d'un emplacement de stockage FSx pour le serveur de fichiers Windows est stocké en texte brut, dans Secrets Manager. Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret. Pour plus d'informations, consultez la section [Utilisation d'un secret que vous gérez](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Vous pouvez utiliser `CmkSecretConfig` (avec`Password`) ou `CustomSecretConfig` (sans`Password`) pour fournir des informations d'identification pour une `CreateLocationFsxWindows` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie le nom du domaine Windows auquel appartient le système FSx de fichiers du serveur de fichiers Windows. Si votre environnement comporte plusieurs domaines Active Directory, la configuration de ce paramètre garantit la DataSync connexion au bon système de fichiers. Type : Chaîne Contraintes de longueur : longueur maximale de 253. Modèle : `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Obligatoire : non ** [FsxFilesystemArn](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) FSx pour le système de fichiers Windows File Server. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : oui ** [Password](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie le mot de passe de l'utilisateur autorisé à monter et à accéder aux fichiers, dossiers et métadonnées de fichiers dans votre système de fichiers FSx pour Windows File Server. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^.{0,104}$` Obligatoire : non ** [SecurityGroupArns](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie les ARN des groupes de sécurité Amazon EC2 qui fournissent l'accès au sous-réseau préféré de votre système de fichiers. Les groupes de sécurité que vous spécifiez doivent pouvoir communiquer avec les groupes de sécurité de votre système de fichiers. Pour plus d'informations sur la configuration des groupes de sécurité pour l'accès au système de fichiers, consultez le [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). Si vous choisissez un groupe de sécurité qui n'autorise pas les connexions internes, effectuez l'une des opérations suivantes : + Configurez le groupe de sécurité pour lui permettre de communiquer au sein de lui-même. + Choisissez un autre groupe de sécurité capable de communiquer avec le groupe de sécurité de la cible de montage. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : oui ** [Subdirectory](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie un chemin de montage pour votre système de fichiers en utilisant des barres obliques. C'est là que les données sont DataSync lues ou écrites (selon qu'il s'agit d'un emplacement source ou de destination). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$` Obligatoire : non ** [Tags](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie des étiquettes qui vous aident à catégoriser, filtrer et rechercher vos ressources AWS . Nous vous recommandons de créer au moins une balise de nom pour votre emplacement. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ** [User](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie l'utilisateur autorisé à monter et à accéder aux fichiers, dossiers et métadonnées de fichiers dans votre système de fichiers FSx pour Windows File Server. Pour plus d'informations sur le choix d'un utilisateur disposant du niveau d'accès approprié pour votre transfert, consultez [les autorisations requises](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) FSx pour les emplacements des serveurs de fichiers Windows. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationFsxWindows_ResponseSyntax) ** L'ARN de l'emplacement du système de fichiers FSx pour Windows File Server que vous avez créé. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows)