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 point de terminaison pour un système de fichiers Amazon FSx for 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 communs à toutes les actions, voir Paramètres communs.
Cette demande accepte les données suivantes au format JSON.
- Domain
-
Spécifie le nom du domaine Windows auquel appartient le système de fichiers FSx for Windows File Server.
Type : String
Contraintes de longueur : longueur maximum de 253.
Modèle :
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$
Obligatoire : non
- FsxFilesystemArn
-
Spécifie l'Amazon Resource Name (ARN) pour le système de fichiers FSx for 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 qui a l'autorisation d'accéder aux fichiers et dossiers du système de fichiers.
Type : String
Contraintes de longueur : Longueur maximum de 104.
Modèle :
^.{0,104}$
Obligatoire : oui
- SecurityGroupArns
-
Spécifie les ARN des groupes de sécurité qui donnent accès au sous-réseau que vous choisissez pour votre système de fichiers.
Note
Si vous choisissez un groupe de sécurité qui n'autorise pas les connexions internes, procédez comme suit :
-
Configurez le groupe de sécurité pour qu'il puisse communiquer au sein de lui-même.
-
Choisissez un autre groupe de sécurité qui peut 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 maximum de 4 096.
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 qui dispose des autorisations pour accéder aux fichiers, aux dossiers et aux métadonnées de votre système de fichiers.
Pour plus d'informations sur le choix d'un utilisateur disposant d'autorisations suffisantes, consultez la section Autorisations requises.
Type : String
Contraintes de longueur : Longueur maximum de 104.
Modèle :
^[^\x5B\x5D\\/:;|=,+*?]{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 for Windows File Server que vous procédez comme suit :
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 communes à toutes les actions, reportez-vous à la sectionErreurs 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
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :