DescribeLocationFsxWindows - AWS DataSync

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.

DescribeLocationFsxWindows

Renvoie les métadonnées relatives à l'emplacement d'un serveur de fichiers Amazon FSx for Windows File Server, telles que des informations sur son chemin d'accès.

Syntaxe de la requête

{ "LocationArn": "string" }

Paramètres de demande

Pour plus d'informations sur les paramètres communs à toutes les actions, consultezParamètres courants.

Cette demande accepte les données suivantes au format JSON.

LocationArn

Amazon Resource Name (ARN) de l'emplacement du serveur de fichiers FSx for Windows File Server à décrire.

Type : Chaîne

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}$

Obligatoire : Oui

Syntaxe de la réponse

{ "CreationTime": number, "Domain": "string", "LocationArn": "string", "LocationUri": "string", "SecurityGroupArns": [ "string" ], "User": "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.

CreationTime

Heure à laquelle l'emplacement du serveur de fichiers FSx for Windows File Server a été créé.

Type : Horodatage

Domain

Nom du domaine Windows auquel appartient le serveur de fichier FSx for Windows File Server.

Type : Chaîne

Contraintes de longueur Longueur maximum de 253.

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

LocationArn

Amazon Resource Name (ARN) de l'emplacement du serveur de fichiers FSx for Windows File Server qui a été décrit.

Type : Chaîne

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}$

LocationUri

URL de l'emplacement du serveur de fichiers FSx for Windows File Server qui a été décrit.

Type : Chaîne

Contraintes de longueur Longueur maximum de 4 360.

Modèle : ^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$

SecurityGroupArns

Amazon Resource Name (ARN) des groupes de sécurité configurés pour le système de fichiers FSx for Windows File Server.

Type : Tableau de chaînes

Membres du tableau : Nombre minimum de 1 élément. Nombre maximal 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/.*$

User

Utilisateur disposant des autorisations pour accéder aux fichiers et aux dossiers dans le système de fichiers FSx for Windows File Server.

Type : Chaîne

Contraintes de longueur Longueur maximum de 104.

Modèle : ^[^\x5B\x5D\\/:;|=,+*?]{1,104}$

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.

InternalException

Cette exception est renvoyée lorsqu'une erreur se produit dans leAWS DataSyncservice.

HTTP : 500

InvalidRequestException

Cette exception est renvoyée lorsque le client soumet une demande mal formée.

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 :