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' DataSyncaccès FSx aux systèmes de fichiers Windows File Server.
Syntaxe de la requête
{
"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.
Cette demande accepte les données suivantes au format JSON.
- Domain
-
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 : String
Contraintes de longueur : longueur maximale de 253.
Modèle :
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$Obligatoire : non
- FsxFilesystemArn
-
Spécifie le nom de ressource Amazon (ARN) FSx pour le système de fichiers Windows File Server.
Type : String
Contraintes de longueur : Longueur maximum de 128.
Modèle :
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):fsx:[a-z\-0-9]*:[0-9]{12}:file-system/fs-.*$Obligatoire : oui
- Password
-
Spécifie le mot de passe de l'utilisateur autorisé à monter et à accéder aux fichiers, dossiers et métadonnées de fichiers de votre système de fichiers FSx pour Windows File Server.
Type : String
Contraintes de longueur : longueur maximale de 104.
Modèle :
^.{0,104}$Obligatoire : oui
- SecurityGroupArns
-
Spécifie les groupes ARNs de EC2 sécurité Amazon 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 guide de l'utilisateur du serveur de fichiers Amazon FSx pour Windows.
Note
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-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$Obligatoire : oui
-
- Subdirectory
-
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 : String
Contraintes de longueur : longueur maximale de 4096.
Modèle :
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$Obligatoire : non
- Tags
-
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
Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments.
Obligatoire : non
- User
-
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 FSx pour les emplacements des serveurs de fichiers Windows.
Type : String
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
-
L'ARN de l'emplacement du système de fichiers FSx pour Windows File Server que vous avez créé.
Type : String
Contraintes de longueur : Longueur maximum de 128.
Modèle :
^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}$
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- 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
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
