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

UpdateLocationSmb

Mise à jour de certains paramètres d'un emplacement précédemment créé pour l'accès au système de fichiers SMB (Server Message Block). Pour plus d'informations sur la création d'un emplacement SMB, consultezCré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, consultezParamètres courants.

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

Obligatoire : Non

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

Obligatoire : Non

LocationArn

Amazon Resource Name (ARN) de l'emplacement SMB à mettre à jour.

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

MountOptions

Spécifie comment DataSync peut accéder à un emplacement à l'aide du protocole 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 et dossiers de l'emplacement SMB.

Type : Chaîne

Contraintes de longueur Longueur maximum de 104.

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

Subdirectory doit ê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é, DataSync doit disposer des autorisations nécessaires pour monter le partage SMB et pour accéder à toutes les données de ce partage. Pour ce faire, effectuez l'une des actions 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 que vous souhaitez DataSync pour accéder à.

  • Utilisez les informations d'identification d'un membre du groupe Backup Operators pour monter le partage.

L'une ou l'autre de ces options 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 : Chaîne

Contraintes de longueur Longueur maximum de 4096.

Modèle : ^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$

Obligatoire : Non

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 maximum de 104.

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 renvoyée lorsqu'une erreur se produit dansAWS DataSyncservice.

Code d'état HTTP : 500

InvalidRequestException

Cette exception est renvoyée lorsque le client envoie 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 :