CreateMountTarget

Crée une cible de montage pour un système de fichiers. Vous pouvez ensuite monter le système de fichiers sur des instances EC2 à l’aide de la cible de montage.

Vous pouvez créer une cible de montage dans chaque Zone de disponibilité de votre VPC. Toutes les instances EC2 d’un VPC dans une Zone de disponibilité donnée partagent une seule cible de montage pour un système de fichiers donné. Si vous disposez de plusieurs sous-réseaux dans une Zone de disponibilité, vous pouvez créer une cible de montage dans l’un de ces sous-réseaux. Pour accéder à leur système de fichiers, les instances EC2 n’ont pas besoin de partager le même sous-réseau que la cible de montage.

Vous ne pouvez créer qu’une seule cible de montage pour un système de fichiers Zone unique. Vous devez créer cette cible de montage dans la même Zone de disponibilité que celle où se trouve le système de fichiers. Utilisez AvailabilityZoneName propriétés AvailabiltyZoneId et de l’objet de réponse DescribeFileSystems pour obtenir ces informations. Utilisez la Zone de disponibilité subnetId associée au système de fichiers lors de la création de la cible de montage.

Pour plus d’informations, consultez Fonctionnement d’Amazon EFS.

Pour créer une cible de montage pour un système de fichiers, l’état du cycle de vie du système de fichiers doit être available. Pour plus d’informations, consultez DescribeFileSystems.

Dans la demande, fournissez les éléments suivants :

• L’ID du système de fichiers pour lequel vous créez la cible de montage.

• Un ID de sous-réseau, qui détermine les éléments suivants :

  • Le VPC dans lequel Amazon EFS crée la cible de montage

  • La Zone de disponibilité dans laquelle Amazon EFS crée la cible de montage

  • La plage d’adresses IP à partir de laquelle Amazon EFS sélectionne l’adresse IP de la cible de montage (si vous ne spécifiez pas d’adresse IP dans la demande)

Une fois la cible de montage créée, Amazon EFS retourne une réponse qui inclut un MountTargetId et une IpAddress. Vous utilisez cette adresse IP lors du montage du système de fichiers dans une instance EC2. Vous pouvez également utiliser le nom DNS de la cible de montage lors du montage du système de fichiers. L’instance EC2 sur laquelle vous montez le système de fichiers via la cible de montage peut convertir le nom DNS de la cible de montage en son adresse IP. Pour plus d’informations, consultez Fonctionnement de la présentation de la mise en place.

Notez que vous pouvez créer des cibles de montage pour un système de fichiers dans un seul VPC, et qu’il ne peut y avoir qu’une seule cible de montage par Zone de disponibilité. En d’autres termes, si le système de fichiers possède déjà une ou plusieurs cibles de montage créées pour ce dernier, le sous-réseau spécifié dans la demande d’ajout d’une autre cible de montage doit répondre aux exigences suivantes :

• Il doit appartenir au même VPC que les sous-réseaux des cibles de montage existantes

• Il ne doit pas se trouver dans la même Zone de disponibilité que les sous-réseaux des cibles de montage existantes

Si la demande répond aux exigences, Amazon EFS procède comme suit :

• Il crée une cible de montage dans le sous-réseau spécifié.

• Il crée également une interface réseau dans le sous-réseau comme suit :

  • Si la demande fournit une IpAddress, Amazon EFS attribue cette adresse IP à l’interface réseau. Sinon, Amazon EFS attribue une adresse gratuite au sous-réseau (de la même manière que l’appel CreateNetworkInterface Amazon EC2 lorsqu’une demande ne spécifie pas d’adresse IP privée principale).

  • Si la demande fournit des SecurityGroups, cette interface réseau est associée à ces groupes de sécurité. Sinon, elle appartient au groupe de sécurité par défaut pour le VPC du sous-réseau.

  • Attribue la description Mount target fsmt-id for file system fs-id dans laquelle fsmt-id est l’ID de la cible de montage et fs-id est le FileSystemId.

  • Définit la propriété requesterManaged de l’interface réseau sur true et la valeur requesterId sur EFS.

  Chaque cible de montage Amazon EFS dispose d’une interface réseau EC2 gérée par demandeur correspondante. Une fois l’interface réseau créée, Amazon EFS définit le champ NetworkInterfaceId dans la description de la cible de montage sur l’ID d’interface réseau et le champ IpAddress sur son adresse. En cas d’échec de la création de l’interface réseau, l’opération CreateMountTarget entière échoue.

Note

L’appel CreateMountTarget se termine seulement après la création de l’interface réseau, mais tant que l’état de la cible de montage est creating, vous pouvez vérifier le statut de création de la cible de montage en appelant l’opération DescribeMountTargets, ce qui retourne l’état de la cible de montage, entre autres.

Nous vous recommandons de créer une cible de Montage dans chacune des Zones de disponibilité. L’utilisation d’un système de fichiers dans une Zone de disponibilité via une cible de montage créée dans une autre Zone de disponibilité implique un certain coût. Pour plus d’informations, consultez Amazon EFS. En outre, en utilisant systématiquement un système local de montage cible dans la Zone de disponibilité de l’instance, vous éliminez un scénario d’échec partiel. En cas de défaillance de la Zone de disponibilité dans laquelle la cible de montage est créée, vous ne pouvez pas accéder à votre système de fichiers via cette cible de montage.

Cette opération exige des autorisations pour l’action suivante sur le système de fichiers :

• elasticfilesystem:CreateMountTarget

Cette opération exige également des autorisations pour les actions Amazon EC2 suivantes :

• ec2:DescribeSubnets

• ec2:DescribeNetworkInterfaces

• ec2:CreateNetworkInterface

Syntaxe de la demande

POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json

{
   "FileSystemId": "string",
   "IpAddress": "string",
   "SecurityGroups": [ "string" ],
   "SubnetId": "string"
}

Paramètres de demande URI

La demande n’utilise pas de paramètres URI.

Corps de la demande

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

FileSystemId

ID du système de fichiers pour lequel créer la cible de montage.

Type : chaîne

Contraintes de longueur : Longueur maximum de 128.

Modèle : ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Obligatoire : oui

IpAddress

Adresse IPv4 valide dans la plage d’adresses du sous-réseau spécifié.

Type : chaîne

Contraintes de longueur : longueur minimale de 7. Longueur maximale de 15.

Modèle : ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

Obligatoire : non

SecurityGroups

Cinq ID de groupe de sécurité VPC maximum au format sg-xxxxxxxx. Ils sont destinés au même VPC que le sous-réseau spécifié.

Type : tableau de chaînes

Membres du tableau : nombre maximum de 100 éléments.

Contraintes de longueur : longueur minimale de 11. Longueur maximale de 43.

Modèle : ^sg-[0-9a-f]{8,40}

Obligatoire : non

SubnetId

ID du sous-réseau dans lequel ajouter la cible de montage. Pour les systèmes de fichiers Zone unique, utilisez le sous-réseau associé à la Zone de disponibilité du système de fichiers.

Type : chaîne

Contraintes de longueur : longueur minimale de 15. Longueur maximale de 47.

Modèle : ^subnet-[0-9a-f]{8,40}$

Obligatoire : oui

Syntaxe de la réponse

HTTP/1.1 200
Content-type: application/json

{
   "AvailabilityZoneId": "string",
   "AvailabilityZoneName": "string",
   "FileSystemId": "string",
   "IpAddress": "string",
   "LifeCycleState": "string",
   "MountTargetId": "string",
   "NetworkInterfaceId": "string",
   "OwnerId": "string",
   "SubnetId": "string",
   "VpcId": "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.

AvailabilityZoneId

Identifiant unique et cohérent de la Zone de disponibilité dans laquelle réside la cible de montage. Par exemple, use1-az1 il s'agit d'un ID AZ pour la région us-east-1 et il a le même emplacement dans chaque région. Compte AWS

Type : chaîne

AvailabilityZoneName

Nom de la Zone de disponibilité dans laquelle se trouve la cible de montage. Les zones de disponibilité sont associées indépendamment aux noms de chacune d'entre elles Compte AWS. Par exemple, il se Compte AWS peut que la zone us-east-1a de disponibilité de votre région ne soit pas la même que celle us-east-1a d'une autre Compte AWS.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.

Modèle : .+

FileSystemId

L’ID du système de fichiers pour lequel la cible de montage est destinée.

Type : chaîne

Contraintes de longueur : Longueur maximum de 128.

Modèle : ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

IpAddress

Adresse à laquelle le système de fichiers peut être monté à l’aide de la cible de montage.

Type : chaîne

Contraintes de longueur : longueur minimale de 7. Longueur maximale de 15.

Modèle : ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

LifeCycleState

État du cycle de vie de la cible de montage.

Type : chaîne

Valeurs valides : creating | available | updating | deleting | deleted | error

MountTargetId

ID de cible de montage attribué par le système.

Type : chaîne

Contraintes de longueur : longueur minimale de 13. Longueur maximale de 45.

Modèle : ^fsmt-[0-9a-f]{8,40}$

NetworkInterfaceId

ID de l’interface réseau créée par Amazon EFS lors de la création de la cible de montage.

Type : chaîne

OwnerId

Compte AWS ID propriétaire de la ressource.

Type : chaîne

Contraintes de longueur : longueur maximale de 14.

Modèle : ^(\d{12})|(\d{4}-\d{4}-\d{4})$

SubnetId

ID du sous-réseau de la cible de montage.

Type : chaîne

Contraintes de longueur : longueur minimale de 15. Longueur maximale de 47.

Modèle : ^subnet-[0-9a-f]{8,40}$

VpcId

ID du cloud privé virtuel (VPC) dans lequel la cible de montage est configurée.

Type : chaîne

Erreurs

AvailabilityZonesMismatch

Renvoie si la Zone de disponibilité spécifiée pour une cible de montage est différente de la Zone de disponibilité spécifiée pour le stockage Zone unique. Pour plus d’informations, reportez-vous à la section Redondance du stockage régional et à une zone.

Code d’état HTTP : 400

BadRequest

Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.

Code d’état HTTP : 400

FileSystemNotFound

Renvoyé si la FileSystemId valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.

Code d’état HTTP : 404

IncorrectFileSystemLifeCycleState

Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».

Code d’état HTTP : 409

InternalServerError

Renvoyé si une erreur s’est produite côté serveur.

Code d’état HTTP : 500

IpAddressInUse

Renvoyé si la demande en spécifie un IpAddress qui est déjà utilisé dans le sous-réseau.

Code d’état HTTP : 409

MountTargetConflict

Renvoie si la cible de montage enfreint l’une des restrictions spécifiées en fonction des cibles de montage existantes du système de fichiers.

Code d’état HTTP : 409

NetworkInterfaceLimitExceeded

Le compte appelant a atteint la limite d’interfaces réseau élastiques pour le compte en question Région AWS. Supprimez certaines interfaces réseau ou demandez que le quota de comptes soit augmenté. Pour plus d’informations, consultez les Quotas Amazon VPC dans le Guide de l’utilisateur Amazon VPC (consultez l’entrée Interfaces réseau par région dans le tableau des interfaces réseau).

Code d’état HTTP : 409

NoFreeAddressesInSubnet

Renvoie si ce IpAddress n’est pas spécifié dans la demande et s’il n’y a aucune adresse IP libre dans le sous-réseau.

Code d’état HTTP : 409

SecurityGroupLimitExceeded

Renvoyé si la taille de SecurityGroups spécifiée dans la demande est supérieure à cinq.

Code d’état HTTP : 400

SecurityGroupNotFound

Renvoyé si l’un des groupes de sécurité spécifiés n’existe pas dans le cloud privé virtuel (VPC) du sous-réseau.

Code d’état HTTP : 400

SubnetNotFound

Renvoyé s’il n’y a aucun sous-réseau dont l’ID est SubnetId fourni dans la demande.

Code d’état HTTP : 400

UnsupportedAvailabilityZone

Renvoyé si la fonctionnalité Amazon EFS demandée n’est pas disponible dans la Zone de disponibilité spécifiée.

Code d’état HTTP : 400

Exemples

Ajouter une cible de montage à un système de fichiers

La demande suivante crée une cible de montage pour un système de fichiers. La demande spécifie des valeurs uniquement pour les FileSystemId paramètres et les paramètres SubnetId requis. La demande ne fournit pas les options IpAddress et les paramètres SecurityGroups. Pour IpAddress, l’opération utilise l’une des adresses IP disponibles dans le sous-réseau spécifié. De plus, l’opération utilise le groupe de sécurité par défaut associé au VPC pour SecurityGroups.

Exemple de demande

POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}

Exemple de réponse

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
    "MountTargetId": "fsmt-55a4413c",
    "NetworkInterfaceId": "eni-01234567",
    "FileSystemId": "fs-01234567",
    "LifeCycleState": "available",
    "SubnetId": "subnet-01234567",
    "OwnerId": "231243201240",
    "IpAddress": "172.31.22.183"
}

Ajouter une cible de montage à un système de fichiers

La demande suivante spécifie tous les paramètres de demande pour créer une cible de montage.

Exemple de demande

POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-01234567",
   "IpAddress":"10.0.2.42",
   "SecurityGroups":[
      "sg-01234567"
   ]
}

Exemple de réponse

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
   "OwnerId":"251839141158",
   "MountTargetId":"fsmt-9a13661e",
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-fd04ff94",
   "LifeCycleState":"available",
   "IpAddress":"10.0.2.42",
   "NetworkInterfaceId":"eni-1bcb7772"
}

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :

• Interface de ligne de commande AWS

• AWS SDK pour .NET

• AWS SDK pour C++

• AWS SDK pour Go v2

• AWS SDK pour Java V2

• AWS SDK pour V3 JavaScript

• AWS SDK pour PHP V3

• AWS SDK pour Python

• AWS SDK pour Ruby V3