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

CreateLocationNfs

Définit un système de fichiers sur un serveur NFS (Network File System) sur lequel lire ou sur lequel écrire.

Syntaxe de la demande

{ "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, voirParamètres courants.

Cette demande accepte les données suivantes au format JSON.

MountOptions

Les options de montage NFS qui DataSync permet 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 votreAWS Snowconeappareil, voirServeur NFS surAWS Snowconepour plus d'informations, consultez.

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 votreAWS Snowconeappareil, voirServeur NFS surAWS Snowconepour plus d'informations, consultez.

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])$

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 avecno_root_squash,ou assurez-vous que les autorisations pour tous les fichiers que vous souhaitez DataSync autoriser l'accès en lecture à 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 votreAWS Snowconeappareil, voirServeur NFS surAWS Snowconepour plus d'informations, consultez.

Pour plus d'informations sur la configuration des exportations NFS, consultez.18.7. Fichier de configuration /etc/exportsdans la documentation Red Hat Enterprise Linux.

Type : Chaîne

Contraintes de longueur : Longueur maximum de 4096.

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 deTagListEntryobjets

Membres de tableau : Nombre minimal de 0 éléments. 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 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 laAWS DataSyncservice.

HTTP Status Code : 500

InvalidRequestException

Cette exception est renvoyée lorsque le client envoie une demande mal formée.

HTTP Status Code : 400

Exemples

Example (Exemple)

L'exemple suivant montre comment créer 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" } ] }

Example (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 :