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.
CreateLocationNfs
Crée un emplacement de transfert pour un serveur de fichiers NFS (Network File System). AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données.
Avant de commencer, assurez-vous de bien comprendre comment DataSync accéder aux serveurs de fichiers NFS.
Syntaxe de la requête
{
"MountOptions": {
"Version": "string"
},
"OnPremConfig": {
"AgentArns": [ "string" ]
},
"ServerHostname": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- MountOptions
-
Spécifie les options qui DataSync peuvent être utilisées pour monter votre serveur de fichiers NFS.
Type : objet NfsMountOptions
Obligatoire : non
- OnPremConfig
-
Spécifie le nom de ressource Amazon (ARN) de l' DataSync agent qui peut se connecter à votre serveur de fichiers NFS.
Vous pouvez spécifier plusieurs agents. Pour plus d'informations, consultez la section Utilisation de plusieurs DataSync agents.
Type : objet OnPremConfig
Obligatoire : oui
- ServerHostname
-
Spécifie le nom DNS (Domain Name System) ou l'adresse IP version 4 du serveur de fichiers NFS auquel votre DataSync agent se connecte.
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 chemin d'exportation sur le serveur de fichiers NFS que vous DataSync souhaitez monter.
Ce chemin (ou un sous-répertoire du chemin) est l'endroit où les données sont DataSync transférées depuis ou vers. Pour plus d'informations sur la configuration d'une exportation pour DataSync, consultez la section Accès aux serveurs de fichiers NFS.
Type : String
Contraintes de longueur : longueur maximale de 4096.
Modèle :
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$Obligatoire : oui
- Tags
-
Spécifie des étiquettes qui vous aident à classer, filtrer et rechercher vos AWS ressources. 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
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 de l'emplacement de transfert que vous avez créé pour votre serveur de fichiers NFS.
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 courantes pour toutes les actions, consultez Erreurs 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
L'exemple suivant crée un emplacement DataSync de transfert pour un serveur de fichiers NFS.
Exemple de demande
{
"MountOptions": {
"Version": : "NFS4_0"
},
"OnPremConfig": {
"AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
},
"ServerHostname": "MyServer@amazon.com",
"Subdirectory": "/MyFolder",
"Tags": [
{
"Key": "Name",
"Value": "FileSystem-1"
}
]
}exemple
La réponse renvoie l'ARN de l'emplacement NFS.
Exemple de réponse
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
