DescribeLocationSmb - 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.

DescribeLocationSmb

Renvoie les métadonnées, telles que le chemin d'accès et les informations utilisateur sur un emplacement SMB.

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 SMB à 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

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

AgentArns

Amazon Resource Name (ARN) de l'emplacement du système de fichiers SMB source qui est créé.

Type : Tableau de chaînes

Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 4 éléments.

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}:agent/agent-[0-9a-z]{17}$

CreationTime

L'heure à laquelle l'emplacement SMB a été créé.

Type : Horodatage

Domain

Nom du domaine Windows auquel appartient le serveur SMB.

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 SMB 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 SMB source qui a été décrit.

Type : Chaîne

Contraintes de longueur Longueur maximale de 4360.

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

MountOptions

Les options de montage disponibles pour DataSync à utiliser pour accéder à un emplacement SMB.

Type : objet SmbMountOptions

User

Utilisateur qui peut monter l'emplacement et dispose des autorisations pour accéder aux fichiers et dossiers de l'emplacement SMB.

Type : Chaîne

Contraintes de longueur Longueur maximale 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 dansAWS DataSyncservice.

Code d'état HTTP : 500

InvalidRequestException

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

Code d'état HTTP : 400

Exemples

Exemple

Cet exemple illustre une utilisation de DescribeLocationSmb.

Exemple de demande

{ "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" }

Exemple

Cet exemple illustre une utilisation de DescribeLocationSmb.

Exemple de réponse

{ "AgentArns":[ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0bc3b3dc9bbc15145", "arn:aws:datasync:us-east-2:111222333444:agent/agent-04b3fe3d261a18c8f" ], "CreationTime":"1532660733.39", "Domain":"AMAZON", "LocationArn":"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49", "LocationUri":"smb://hostname.amazon.com/share", "MountOptions":{ "Version":"SMB3" }, "User":"user-1" }

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 :