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.
UpdateLocationSmb
Met à jour certains paramètres d'un emplacement créé pour accéder au système de fichiers SMB (Server Message Block). Pour plus d'informations sur la création d'un emplacement SMB, consultez la section Création d'un emplacement pour SMB.
Syntaxe de la requête
{
"AgentArns": [ "string" ],
"Domain": "string",
"LocationArn": "string",
"MountOptions": {
"Version": "string"
},
"Password": "string",
"Subdirectory": "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.
- AgentArns
-
Amazon Resource Name (ARN) des agents à utiliser pour un emplacement SMB (Simple Message Block).
Type : tableau de chaînes
Membres du tableau : Nombre minimum de 1 élément. Nombre Nombre Nombre Nombre Nombre Nombre Nombre Nombre Nombre Nombre Nombre Nombre Nombre
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}$Obligatoire : non
- Domain
-
Nom du domaine Windows auquel appartient le serveur SMB.
Type : String
Contraintes aintes aintes aintes.
Modèle :
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$Obligatoire : non
- LocationArn
-
L'Amazon Resource Name (ARN) de l'emplacement SMB à mettre à jour.
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
- MountOptions
-
Spécifie la version de protocole SMB (Server Message Block) utilisée par AWS DataSync pour accéder à un serveur de fichiers SMB.
Type : objet SmbMountOptions
Obligatoire : non
- Password
-
Mot de passe de l'utilisateur qui peut monter l'emplacement et dispose des autorisations pour accéder aux fichiers SMB.
Type : String
Contraintes aintes aintes aintes.
Modèle :
^.{0,104}$Obligatoire : non
- Subdirectory
-
Il s'agit du sous-répertoire du système de fichiers SMB qui est utilisé pour lire les données à partir de l'emplacement source SMB ou écrire des données vers la destination SMB. Le chemin SMB doit être un chemin qui est exporté par le serveur SMB, ou un sous-répertoire de ce chemin. Ce chemin doit pouvoir être monté par d'autres clients SMB sur votre réseau.
Note
Subdirectorydoit être spécifié avec des barres obliques. Par exemple,/path/to/folder.Pour transférer toutes les données du dossier que vous avez spécifié, vousDataSync devez disposer des autorisations pour monter le partage SMB et accéder à toutes les données de ce partage SMB. Pour ce faire, procédez de l'une des suivantes.
-
Assurez-vous que les informations utilisateur/mot de passe utilisées correspondent à l'utilisateur qui peut monter le partage et qui dispose des autorisations appropriées pour tous les fichiers et répertoires auxquels vousDataSync souhaitez accéder.
-
Utilisez les informations d'identification d'un membre du groupe Backup Operators pour monter le partage.
L'une ou l'autre méthode permet à l'agent d'accéder aux données. Pour que l'agent puisse accéder aux répertoires, vous devez également activer toutes les accès en exécution.
Type : String
Contraintes aintes aintes.
Modèle :
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$Obligatoire : non
-
- User
-
L'utilisateur qui peut monter l'emplacement SMB et dispose des autorisations pour accéder aux fichiers SMB.
Type : String
Contraintes aintes aintes aintes.
Modèle :
^[^\x5B\x5D\\/:;|=,+*?]{1,104}$Obligatoire : non
Éléments de réponse
Si l'action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
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
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 :
