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

CreateLocationSmb

Définit un système de fichiers sur un serveur SMB (Server Message Block) qui peut être lu ou écrit.

Syntaxe de la demande

{ "AgentArns": [ "string" ], "Domain": "string", "MountOptions": { "Version": "string" }, "Password": "string", "ServerHostname": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "User": "string" }

Paramètres de demande

Pour plus d'informations sur les paramètres communs à toutes les actions, voirParamè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}$

Prérequis : Oui

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-.]*)*[A-Za-z0-9-]*[A-Za-z0-9]$

Prérequis : Non

MountOptions

Les options de montage utilisées par DataSync pour accéder au serveur SMB.

Type : objet SmbMountOptions

Prérequis : Non

Password

Mot de passe de l'utilisateur qui peut monter l'emplacement et dispose des autorisations nécessaires pour accéder aux fichiers et dossiers du partage de fichiers SMB.

Type : Chaîne

Contraintes de longueur : Longueur maximale de 104.

Modèle : ^.{0,104}$

Prérequis : Oui

ServerHostname

Nom du serveur SMB. Cette valeur est l'adresse IP ou le nom DNS (Domain Name Service) du serveur SMB. Un agent installé sur site utilise ce nom pour monter le serveur SMB dans un réseau.

Note

Ce nom doit être conforme au DNS ou doit être une adresse IP version 4 (IPv4).

Type : Chaîne

Contraintes de longueur : Longueur maximale de 255.

Modèle : ^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$

Prérequis : Oui

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, ainsi que pour accéder à toutes les données de ce partage. Pour ce faire, 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 de votre choix. DataSync pour accéder ou utiliser les informations d'identification d'un membre du groupe Opérateurs de Backup 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 : Chaîne

Contraintes de longueur : Longueur maximum de 4096.

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

Prérequis : Oui

Tags

Paire clé-valeur qui représente la balise que vous souhaitez ajouter à l'emplacement. La valeur peut être une chaîne vide. Nous vous recommandons d'utiliser des balises pour nommer vos ressources.

Type : Tableau deTagListEntryobjets

Membres du tableau : Nombre minimal de 0 éléments. Nombre maximal de 50 éléments.

Prérequis : Non

User

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

Pour plus d'informations sur le choix d'un nom d'utilisateur qui garantit des autorisations suffisantes pour les fichiers, les dossiers et les métadonnées, consultez leParamètre utilisateurpour les sites PME.

Type : Chaîne

Contraintes de longueur : Longueur maximale de 104.

Modèle : ^[^\x5B\x5D\\/:;|=,+*?]{1,104}$

Prérequis : Oui

Syntaxe de la réponse

{ "LocationArn": "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.

LocationArn

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

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

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, voirErreurs courantes.

InternalException

Cette exception est renvoyée lorsqu'une erreur se produit dans leAWS 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

Exemples

Exemple

Cet exemple illustre une utilisation de CreateLocationSmb.

Exemple de demande

{ "AgentArns":[ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs", "arn:aws:datasync:us-east-2:111222333444:agent/agent-2345noo35nnee1123ovo3" ], "Domain":"AMAZON", "MountOptions":{ "Version":"SMB3" }, "Password":"string", "ServerHostname":"MyServer.amazon.com", "Subdirectory":"share", "Tags":[ { "Key":"department", "Value":"finance" } ], "User":"user-1" }

Exemple

Cet exemple illustre une utilisation de CreateLocationSmb.

Exemple de réponse

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

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 :