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 des métadonnées, telles que le chemin d'accès et des 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, voir Paramètres communs.
Cette demande accepte les données suivantes au format JSON.
- LocationArn
-
Amazon Resource Name (ARN) de l'emplacement SMB spécifié.
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}$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 spécifié.
Type : tableau de chaînes
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de éléments éléments éléments éléments éléments éléments éléments éléments éléments é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
-
Heure à laquelle l'emplacement SMB a été créé.
Type : Timestamp
- Domain
-
Nom du domaine Windows auquel appartient le serveur SMB.
Type : String
Contraintes de 1 éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments
Modèle :
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$ - LocationArn
-
Amazon Resource Name (ARN) de l'emplacement SMB spécifié.
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}$ - LocationUri
-
URL de l'emplacement SMB source qui est spécifié.
Type : String
Contraintes de 1 éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments
Modèle :
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - MountOptions
-
Les éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments élémentsDataSync éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments
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 : String
Contraintes de 1 éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments éléments
Modèle :
^[^\x5B\x5D\\/:;|=,+*?]{1,104}$
Erreurs
Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.
- InternalException
-
Cette exception est déclenchée lorsqu'une erreur se produit dans leAWS DataSync service.
Code d'état HTTP : 500
- InvalidRequestException
-
Cette exception est déclenchée lorsque le client soumet une demande mal formée.
Code d'état HTTP : 400
Exemples
Exemple
Cet exemple illustre une utilisation deDescribeLocationSmb.
Exemple de demande
{
"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}Exemple
Cet exemple illustre une utilisation deDescribeLocationSmb.
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 :
