Syntaxe de la demande Paramètres de demande URI Corps de la demande Syntaxe de la réponse Eléments de réponse Erreurs Exemples consultez aussi

CreateMountTarget

Crée une cible de montage pour un système de fichiers. Vous pouvez ensuite monter le système de fichiers sur des EC2 instances à l'aide de la cible de montage. Pour plus d'informations sur les cibles de montage, consultez la section Gestion des cibles de montage.

Pour créer une cible de montage pour un système de fichiers EFS, l'état du cycle de vie du système de fichiers doit êtreavailable. Pour de plus amples informations, veuillez consulter DescribeFileSystems.

Après avoir créé la cible de montage, Amazon EFS renvoie une réponse qui inclut une MountTargetId et une adresse IP (IpAddressouIpv6Address). Vous utilisez cette adresse IP lors du montage du système de fichiers dans une EC2 instance. Vous pouvez également utiliser le nom DNS de la cible de montage lors du montage du système de fichiers. L' EC2 instance sur laquelle vous montez le système de fichiers à l'aide de la cible de montage peut convertir le nom DNS de la cible de montage en adresse IP. Pour plus d'informations, consultez Comment fonctionne Amazon EFS.

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é. Pour plus d'informations, consultez la section Création de cibles de montage.

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é.
Crée une nouvelle interface réseau dans le sous-réseau avec les éléments suivants :
- Description Mount target fsmt-id for file system fs-id où se fsmt-id trouve l'ID de la cible de montage, et où fs-id est leFileSystemId.
- requesterManagedPropriété de l'interface réseau définie sur true et requesterId valeur définie surEFS.
Chaque cible de montage possède une interface EC2 réseau gérée par le demandeur correspondante. Une fois l'interface réseau créée, Amazon EFS définit le NetworkInterfaceId champ de la description de la cible de montage sur l'ID de l'interface réseau et son adresse IP 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.

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

elasticfilesystem:CreateMountTarget

Cette opération nécessite également des autorisations pour les EC2 actions Amazon 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",
   "IpAddressType": "string",
   "Ipv6Address": "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 : String

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

Si la cible IpAddressType de montage est IPv4 (IPV4_ONLYouDUAL_STACK), spécifiez l' IPv4 adresse à utiliser. Si vous ne spécifiez pas deIpAddress, Amazon EFS sélectionne une adresse IP non utilisée dans le sous-réseau spécifié pourSubnetId.

Type : String

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

IpAddressType

Type d'adresse IP de la cible de montage. Les valeurs possibles sont IPV4_ONLY ( IPv4 adresses uniquement), IPV6_ONLY ( IPv6 adresses uniquement) et DUAL_STACK (double pile, à la fois IPv4 et IPv6 adresses). Si vous ne spécifiez pas deIpAddressType, alors IPV4_ONLY est utilisé.

Note

Le IPAddressType doit correspondre au type d'adresse IP du sous-réseau. En outre, le IPAddressType paramètre remplace la valeur définie comme adresse IP par défaut pour le sous-réseau du VPC. Par exemple, si le IPAddressType is IPV4_ONLY et le AssignIpv6AddressOnCreation is sonttrue, ils IPv4 sont utilisés pour la cible de montage. Pour plus d'informations, consultez Modifier les attributs d'adressage IP de votre sous-réseau.

Type : String

Valeurs valides : IPV4_ONLY | IPV6_ONLY | DUAL_STACK

Obligatoire : non

Ipv6Address

Si la cible IPAddressType de montage est IPv6 (IPV6_ONLYouDUAL_STACK), spécifiez l' IPv6 adresse à utiliser. Si vous ne spécifiez pas deIpv6Address, Amazon EFS sélectionne une adresse IP non utilisée dans le sous-réseau spécifié pourSubnetId.

Type : String

Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 39

Obligatoire : non

SecurityGroups

Groupe de sécurité VPC IDs, du format. sg-xxxxxxxx Ils doivent être destinés au même VPC que le sous-réseau spécifié. Le nombre maximum de groupes de sécurité dépend du quota du compte. Pour plus d'informations, consultez Amazon VPC Quotas dans le guide de l'utilisateur Amazon VPC (voir le tableau des groupes de sécurité). Si vous ne spécifiez aucun groupe de sécurité, Amazon EFS utilise le groupe de sécurité par défaut pour le VPC du sous-réseau.

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. Le type de sous-réseau doit être le même que leIpAddressType.

Type : String

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",
   "Ipv6Address": "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 : String

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 votre zone us-east-1a de disponibilité ne soit pas la même que celle us-east-1a d'une autre Compte AWS.

Type : String

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 : String

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

IPv4 Adresse de la cible de montage.

Type : String

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}$

Ipv6Address

IPv6 Adresse de la cible de montage.

Type : String

Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 39

LifeCycleState

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

Type : String

MountTargetId

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

Type : String

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 : String

OwnerId

Compte AWS ID propriétaire de la ressource.

Type : String

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 : String

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 : String

Erreurs

AvailabilityZonesMismatch

Renvoie si la zone de disponibilité spécifiée pour la cible de montage est différente de la zone de disponibilité du système de fichiers. 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 a spécifié une adresse IP (IpAddressouIpv6Address) déjà utilisée 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

Non renvoyé IpAddress ou Ipv6Address a été fourni dans la demande et il n'y a aucune adresse IP libre dans le sous-réseau spécifié.

Code d’état HTTP : 409

SecurityGroupLimitExceeded

Renvoyé si le nombre SecurityGroups spécifié dans la demande est supérieur à la limite, qui est basée sur le quota du compte. Supprimez certains groupes de sécurité ou demandez que le quota de comptes soit augmenté. Pour plus d'informations, consultez Amazon VPC Quotas dans le guide de l'utilisateur Amazon VPC (voir le tableau des groupes de sécurité).

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

Création d'une cible de montage à une IPv4 adresse disponible sur un sous-réseau

La demande suivante spécifie uniquement le système de fichiers et le sous-réseau de la cible de montage. La cible est créée à une IPv4 adresse disponible sur le sous-réseau spécifié, avec le groupe de sécurité par défaut associé au VPC.

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

{
    "OwnerId": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "NetworkInterfaceId":"eni-1bcb7772"
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

Création d'une cible de montage à une IPv4 adresse spécifique

La demande suivante indique le système de fichiers, le sous-réseau, le groupe de sécurité et l' IPv4adresse à utiliser pour la 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"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

Création d'une cible de montage à une IPv6 adresse spécifique

La demande suivante indique le système de fichiers, le sous-réseau, le groupe de sécurité et l' IPv6adresse à utiliser pour la 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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "IpAddressType": "IPV6_ONLY",
   "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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "NetworkInterfaceId":"eni-1bcb7772"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

Création d'une cible de montage à une IPv4 adresse disponible sur un sous-réseau à double pile

La demande suivante spécifie le système de fichiers, le sous-réseau et le type d'adresse de la cible de montage. La cible est créée à une IPv4 adresse disponible sur le sous-réseau à double pile spécifié, le groupe de sécurité par défaut étant associé au VPC.

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

{
    "OwnerId": "251839141158",
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId":"subnet-fd04ff94",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

Créez une cible de montage sur des adresses IPv4 et des IPv6 adresses spécifiques sur un sous-réseau à double pile

La demande suivante indique le système de fichiers, le sous-réseau, le groupe de sécurité, l' IPv4 adresse et l' IPv6 adresse de la cible de montage. La cible est créée aux IPv6 adresses IPv4 et adresses spécifiées sur un sous-réseau à double pile.

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",
   "IpAddressType": "DUAL_STACK",
   "IpAddress": "10.0.1.25",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "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": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "10.0.1.25",
    "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

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 :

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

CreateFileSystem

CreateReplicationConfiguration