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
Définit un système de fichiers sur un serveur NFS (Network File System) à partir duquel lire ou sur lequel écrire.
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 communs à toutes les actions, voir Paramètres communs.
Cette demande accepte les données suivantes au format JSON.
- MountOptions
-
Les options de montage NFS queDataSync vous pouvez utiliser afin de monter votre partage NFS.
Type : objet NfsMountOptions
Obligatoire : non
- OnPremConfig
-
Contient une liste d'Amazon Resource Name (ARN) des agents utilisés pour se connecter à un serveur NFS.
Si vous copiez des données vers ou depuis votre périphérique AWS Snowcone, veuillez consulter la rubrique NFS Server sur AWS Snowcone pour plus d'informations.
Type : objet OnPremConfig
Obligatoire : oui
- ServerHostname
-
Nom du serveur NFS. Cette valeur est l'adresse IP ou le nom DNS (Domain Name Service) du serveur NFS. Un agent installé sur site utilise ce nom d'hôte pour monter le serveur NFS dans un réseau.
Si vous copiez des données vers ou depuis votre périphérique AWS Snowcone, veuillez consulter la rubrique NFS Server sur AWS Snowcone pour plus d'informations.
Note
Ce nom doit être conforme au DNS ou doit être une adresse IP version 4 (IPv4).
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
-
Sous-répertoire du système de fichiers NFS utilisé pour lire les données à partir de l'emplacement source NFS ou écrire des données dans la destination NFS. Le chemin doit être un chemin d'accès qui est exporté par le serveur NFS, ou un sous-répertoire. Ce chemin doit pouvoir être monté par d'autres clients NFS sur votre réseau.
Pour afficher tous les chemins d'accès exportés par votre serveur NFS, exécutez
showmount -e nfs-server-name
à partir d'un client NFS qui a accès à votre serveur. Vous pouvez spécifier n'importe quel répertoire qui apparaît dans les résultats et n'importe quel sous-répertoire de ce répertoire. Assurez-vous que l'exportation NFS est accessible sans authentification Kerberos.Pour transférer toutes les données du dossier que vous avez spécifié, DataSync doit disposer des autorisations permettant de lire toutes les données. Pour vous assurer que c'est le cas, configurez l'exportation NFS avec
no_root_squash,
ou assurez-vous que les autorisations pour tous les fichiers que vous souhaitez synchroniser avecDataSync un accès en lecture pour tous les utilisateurs. Ces actions permettent à l'agent de lire les fichiers. Pour que l'agent puisse accéder aux répertoires, vous devez également activer toutes les accès en exécution.Si vous copiez des données vers ou depuis votre périphérique AWS Snowcone, veuillez consulter la rubrique NFS Server sur AWS Snowcone pour plus d'informations.
Pour plus d'informations sur la configuration des exportations NFS, veuillez consulter la rubrique 18.7. Le fichier de configuration /etc/exports
dans la documentation Red Hat Enterprise Linux. Type : String
Contraintes de longueur : Longueur maximum de 4 096.
Modèle :
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$
Obligatoire : 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 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
-
Amazon Resource Name (ARN) de l'emplacement du système de fichiers NFS source qui est 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, 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
Exemples
Exemple
L'exemple suivant crée un point de terminaison pour un système de fichiers NFS en utilisant la version NFS spécifiée comme option de montage.
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": "ElasticFileSystem-1"
}
]
}
Exemple
La réponse renvoie l'Amazon Resource Name (ARN) de l'emplacement NFS.
Exemple de réponse
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}
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 :