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
Crée un point de terminaison pour un serveur de fichiers SMB (Server Message Block) et crée un point de terminaison. AWS DataSync Pour plus d'informations, consultez Création maximum maximum.
Syntaxe de la requête
{
"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, voir Paramètres communs.
Cette demande accepte les données suivantes au format JSON.
- AgentArns
-
Spécifie l'DataSyncagent (ou les agents) que vous souhaitez connecter à votre serveur de fichiers SMB. Spécifiez un agent en utilisant son Amazon Resource Name (Amazon Resource Name).
Type : tableau de chaînes
Membres du tableau : Nombre minimum de 1 élément. maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum
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 : oui
- Domain
-
Spécifie le nom de domaine Windows auquel appartient votre serveur de fichiers SMB.
Pour plus d'informations, consultez les autorisations requises pour les emplacements SMB.
Type : String
Contraintes de longueur : Longueur maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum
Modèle :
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$Obligatoire : non
- MountOptions
-
Spécifie la version du protocole SMB qui a l'DataSyncutilisation pour accéder à votre serveur de fichiers SMB.
Type : objet SmbMountOptions
Obligatoire : non
- Password
-
Spécifie le mot de passe de l'utilisateur qui peut monter votre serveur de fichiers SMB et dispose des autorisations nécessaires pour accéder aux fichiers et dossiers concernés par votre transfert.
Pour plus d'informations, consultez les autorisations requises pour les emplacements SMB.
Type : String
Contraintes de longueur : Longueur maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum
Modèle :
^.{0,104}$Obligatoire : oui
- ServerHostname
-
Spécifie le nom DNS (Domain Name Service) ou l'adresse IP du serveur de fichiers SMB que votre DataSync agent va monter.
Note
Vous ne pouvez pas spécifier d'adresse IP version 6 (IPv6).
Type : String
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])$Obligatoire : oui
- Subdirectory
-
Spécifie le nom du partage exporté par votre serveur de fichiers SMB sur lequel les données DataSync seront lues ou écrites. Vous pouvez inclure un sous-répertoire dans le chemin de partage (par exemple,
/path/to/subdirectory). Assurez-vous que les autres clients SMB peuvent également monter ce chemin.Pour copier toutes les données du sous-répertoire spécifié, vous DataSync devez être capable de monter le partage SMB et d'accéder à toutes ses données. Pour plus d'informations, consultez les autorisations requises pour les emplacements SMB.
Type : String
Contraintes de longueur : Longueur maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum
Modèle :
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$Obligatoire : oui
- Tags
-
Spécifie des étiquettes qui vous aident à catégoriser, filtrer et rechercher vos ressources AWS. Nous vous recommandons de créer au moins une balise de nom pour votre emplacement.
Type : tableau d’objets TagListEntry
Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments.
Obligatoire : non
- User
-
Spécifie le nom d'utilisateur qui peut monter votre serveur de fichiers SMB et qui est autorisé à accéder aux fichiers et aux dossiers concernés par votre transfert.
Pour plus d'informations sur le choix d'un utilisateur disposant du niveau d'accès approprié pour votre transfert, consultez la section Autorisations requises pour les sites des PME.
Type : String
Contraintes de longueur : Longueur maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum maximum
Modèle :
^[^\x5B\x5D\\/:;|=,+*?]{1,104}$Obligatoire : 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
-
L'ARN ARN de l'emplacement SMB que vous avez créé.
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}$
Erreurs
Pour plus d'informations sur les erreurs communes à toutes les actions, reportez-vous à la sectionErreurs courantes.
- InternalException
-
Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service.
Code d'état HTTP : 500
- InvalidRequestException
-
Cette exception est levée lorsque le client soumet une demande mal formée.
Code d'état HTTP : 400
Exemples
Exemple de demande
L'exemple suivant crée un emplacement pour un serveur de fichiers SMB.
{ "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 de réponse
Une réponse renvoie l'ARN de localisation de votre serveur de fichiers SMB.
{ "LocationArn": "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 :
