CreateLocationFsxOntap - AWS DataSync
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

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.

CreateLocationFsxOntap

Crée un point de terminaison pour un système de fichiers Amazon FSx forNetApp ONTAP auquel il estAWS DataSync possible d'accéder pour un transfert. Pour plus d'informations, veuillez consulter la rubrique Création d'un emplacement pour FSx pour ONTAP.

Syntaxe de la requête

{
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "Domain": "string",
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "StorageVirtualMachineArn": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Paramètres de demande

Pour plus d'informations sur les paramètres communs à toutes les actions, consultez la section Paramètres communs.

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

Protocol

Spécifie le protocole de transfert de données qu'utilise AWS DataSync pour accéder à votre système de fichiers Amazon FSx.

Type : objet FsxProtocol

Obligatoire : oui

SecurityGroupArns

Spécifie les groupes de sécurité Amazon EC2 qui fournissent un accès au sous-réseau préféré de votre système de fichiers.

Les groupes de sécurité doivent autoriser le trafic sortant sur les ports suivants (en fonction du protocole que vous utilisez) :

  • NFS (Network File System) : ports TCP 111, 635 et 2 049

  • SMB (Server Message Block) : port TCP 445

Les groupes de sécurité de votre système de fichiers doivent également autoriser le trafic entrant sur les mêmes ports.

Type : tableau de chaînes

Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments.

Contraintes de longueur : Longueur maximum de 128.

Modèle : ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$

Obligatoire : oui

StorageVirtualMachineArn

Spécifie l'ARN de la machine virtuelle de stockage (SVM) de votre système de fichiers vers ou depuis laquelle vous souhaitez copier des données.

Type : String

Contraintes de longueur : Longueur maximum de 162.

Modèle : ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$

Obligatoire : oui

Subdirectory

Spécifie le chemin d'accès au partage de fichiers de la SVM vers laquelle vous allez copier vos données.

Vous pouvez spécifier un chemin de jonction (également appelé point de montage), un chemin qtree (pour les partages de fichiers NFS) ou un nom de partage (pour les partages de fichiers SMB). Par exemple, votre chemin de montage peut être /vol1, /vol1/tree1 ou /share1.

Note

Ne spécifiez pas de chemin de jonction dans le volume racine de la SVM. Pour plus d'informations, veuillez consulter la rubrique Gestion de FSx pour les machines virtuelles de stockage ONTAP dans le Guide de l'utilisateur Amazon FSx pourNetApp ONTAP.

Type : String

Contraintes de longueur : longueur maximale de 255.

Modèle : ^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$

Obligatoire : non

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

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

Spécifie l'ARN de l'emplacement du système de fichiers FSx pour ONTAP que vous créez.

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

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 :