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 :
