CreateMountTarget

Erstellt ein Mountingziel für ein Dateisystem Anschließend können Sie das Dateisystem mithilfe des Mount-Ziels auf EC2 Instanzen mounten.

Sie können in jeder Availability Zone in Ihrer VPC ein Mount-Ziel erstellen. Alle EC2 Instances in einer VPC innerhalb einer bestimmten Availability Zone teilen sich ein einzelnes Mount-Ziel für ein bestimmtes Dateisystem. Wenn Sie mehrere Subnetze in einer Availability Zone haben, erstellen Sie ein Mount-Ziel in einem der Subnetze. EC2 Instanzen müssen sich nicht im selben Subnetz wie das Mount-Ziel befinden, um auf ihr Dateisystem zugreifen zu können.

Sie können nur ein Mountingziel pro One-Zone-Dateisystem erstellen. Sie müssen dieses Mountingziel in derselben Availability Zone erstellen, in der sich das Dateisystem befindet. Verwenden Sie die Eigenschaften AvailabilityZoneName und AvailabiltyZoneId im Antwortobjekt DescribeFileSystems, um diese Informationen abzurufen. Verwenden Sie bei der Erstellung des Mountingziels die Availability Zone, die der Availability Zone des Dateisystems subnetId zugeordnet ist.

Weitere Informationen finden Sie unter Funktionsweise von Amazon EFS.

Um ein Bereitstellungsziel für ein Dateisystem zu erstellen, muss der Lebenszyklusstatus des Dateisystems available lauten. Weitere Informationen finden Sie unter DescribeFileSystems.

Machen Sie in der Anforderung die folgenden Angaben:

• ID des Dateisystems, für das Sie das Mountingziel erstellen.

• Eine Subnetz-ID, die Folgendes bestimmt:

  • VPC, in dem Amazon EFS das Mountingziel erstellt.

  • Availability Zone, in der Amazon EFS das Mountingziel erstellt.

  • IP-Adressbereich, aus dem Amazon EFS die IP-Adresse des Mountingziels auswählt (wenn Sie in der Anforderung keine IP-Adresse angeben).

Nachdem das Mount-Ziel erstellt wurde, gibt Amazon EFS eine Antwort zurück, die eine MountTargetId und eine IpAddress beinhaltet. Sie verwenden diese IP-Adresse, wenn Sie das Dateisystem in einer EC2 Instanz mounten. Sie können außerdem den DNS-Namen des Mount-Ziels beim Mounten des Dateisystems verwenden. Die EC2 Instanz, auf der Sie das Dateisystem mithilfe des Mount-Ziels mounten, kann den DNS-Namen des Mount-Ziels in seine IP-Adresse auflösen. Weitere Informationen finden Sie unter Funktionsweise: Überblick über die Implementierung.

Beachten Sie, dass Sie Mount-Ziele für ein Dateisystem nur in einer VPC erstellen können. Es kann nur ein Mount-Ziel pro Availability Zone geben. Das heißt, wenn das Dateisystem bereits ein oder mehrere Mount-Ziele hat, muss das in der Anfrage zum Hinzufügen eines weiteren Mount-Ziels angegebene Subnetz die folgenden Anforderungen erfüllen:

• Muss zur selben VPC gehören wie die Subnetze der vorhandenen Mount-Ziele.

• Darf nicht in derselben Availability Zone wie eines der Subnetze der vorhandenen Mount-Ziele liegen.

Wenn die Anfrage die Anforderungen erfüllt, geht Amazon EFS wie folgt vor:

• Erstellt ein neues Mount-Ziel im angegebenen Subnetz.

• Erstellt außerdem wie folgt eine neue Netzwerkschnittstelle im Subnetz:

  • Wenn die Anfrage eine IpAddress enthält, weist Amazon EFS diese IP-Adresse der Netzwerkschnittstelle zu. Andernfalls weist Amazon EFS eine freie Adresse im Subnetz zu (genauso wie der EC2 CreateNetworkInterface Amazon-Anruf, wenn eine Anfrage keine primäre private IP-Adresse angibt).

  • Wenn die Anforderung SecurityGroups liefert, ist diese Netzwerkschnittstelle diesen Sicherheitsgruppen zugeordnet. Andernfalls gehört sie zur Standard-Sicherheitsgruppe für die VPC des Subnetzes.

  • Weist die Beschreibung Mount target fsmt-id for file system fs-id zu, wobei fsmt-id die Mount-Ziel-ID und fs-id die FileSystemId ist.

  • Setzt die Eigenschaft requesterManaged der Netzwerkschnittstelle auf true und den Wert requesterId auf EFS.

  Jedes Amazon EFS-Mount-Ziel hat eine entsprechende, vom Anforderer verwaltete EC2 Netzwerkschnittstelle. Nachdem die Netzwerkschnittstelle erstellt wurde, setzt Amazon EFS das Feld NetworkInterfaceId in der Beschreibung des Mount-Ziels auf die Netzwerkschnittstellen-ID und das Feld IpAddress auf seine Adresse. Wenn die Erstellung der Netzwerkschnittstelle fehlschlägt, schlägt die gesamte CreateMountTarget-Operation fehl.

Anmerkung

Der Aufruf von CreateMountTarget gibt erst nach der Erstellung der Netzwerkschnittstelle einen Wert zurück. Da aber der Status des Mountingziel weiterhin creating lautet, können Sie ihn durch Aufruf der Operation DescribeMountTargets überprüfen, die unter anderem den Status des Mountingziels zurückgibt.

Wir empfehlen Ihnen, in jeder Availability Zone ein Mountingziel zu erstellen. Es gibt Kostenüberlegungen für die Verwendung eines Dateisystems in einer Availability Zone durch ein Mount-Ziel, das in einer anderen Availability Zone erstellt wurde. Weitere Informationen finden Sie unter Amazon EFS – Preise. Wenn Sie immer ein für die Availability Zone der Instance lokales Mountingziel verwenden, vermeiden Sie darüber hinaus ein Teilausfallszenario. Wenn die Availability Zone, in der Ihr Mount-Ziel erstellt wird, herunterfällt, können Sie nicht über dieses Mount-Ziel auf Ihr Dateisystem zugreifen.

Diese Operation erfordert Berechtigungen für die folgende Dateisystemaktion:

• elasticfilesystem:CreateMountTarget

Für diesen Vorgang sind auch Berechtigungen für die folgenden EC2 Amazon-Aktionen erforderlich:

• ec2:DescribeSubnets

• ec2:DescribeNetworkInterfaces

• ec2:CreateNetworkInterface

Anforderungssyntax

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

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

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

FileSystemId

Die ID des Dateisystems, für das das Bereitstellungsziel erstellt werden soll.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.

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

Erforderlich: Ja

IpAddress

Gültige IPv4 Adresse innerhalb des Adressbereichs des angegebenen Subnetzes.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 7 Zeichen. Maximale Länge beträgt 15 Zeichen.

Pattern: ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

Erforderlich: Nein

SecurityGroups

VPC-Sicherheitsgruppe IDs in der Formsg-xxxxxxxx. Diese müssen für dieselbe VPC wie das angegebene Subnetz gelten. Die maximale Anzahl von Sicherheitsgruppen hängt vom Kontingent ab. Weitere Informationen finden Sie unter Amazon VPC-Kontingente im Amazon VPC-Benutzerhandbuch (siehe Tabelle mit Sicherheitsgruppen).

Typ: Zeichenfolgen-Array

Array-Mitglieder: Maximale Anzahl von 100 Elementen.

Längenbeschränkungen: Mindestlänge von 11. Maximale Länge von 43.

Pattern: ^sg-[0-9a-f]{8,40}

Erforderlich: Nein

SubnetId

Die ID des Subnetzes, in dem das Bereitstellungsziel hinzugefügt werden soll. Verwenden Sie für One-Zone-Dateisysteme, das Subnetz, das der Availability Zone des Dateisystems zugeordnet ist.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 15 Zeichen. Maximale Länge beträgt 47 Zeichen.

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

Erforderlich: Ja

Antwortsyntax

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

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

AvailabilityZoneId

Die eindeutige und konsistente Kennung der Availability Zone, in der sich das Mountingziel befindet. use1-az1Ist beispielsweise eine AZ-ID für die Region us-east-1 und sie hat in jeder Region den gleichen Standort. AWS-Konto

Typ: Zeichenfolge

AvailabilityZoneName

Der Name der Availability Zone, in der sich das Mountingziel befindet. Availability Zones werden den jeweiligen Namen unabhängig voneinander zugeordnet. AWS-Konto Beispielsweise ist die Availability Zone us-east-1a für Sie AWS-Konto möglicherweise nicht derselbe Standort wie us-east-1a für eine andere AWS-Konto.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.

Pattern: .+

FileSystemId

Die ID des Dateisystems, für das das Mountingziel erstellt werden soll.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.

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

IpAddress

Die Adresse, unter der das Dateisystem mithilfe des Mountziels gemountet werden kann.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 7 Zeichen. Maximale Länge beträgt 15 Zeichen.

Pattern: ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

LifeCycleState

Der Lebenszyklusstatus des Mountingziels.

Typ: Zeichenfolge

Zulässige Werte: creating | available | updating | deleting | deleted | error

MountTargetId

Vom System zugewiesene ID für das Mountingziel.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 13 Zeichen. Maximale Länge beträgt 45 Zeichen.

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

NetworkInterfaceId

Die ID der Netzwerkschnittstelle, die Amazon EFS bei der Erstellung des Mountingziels erstellt hat.

Typ: Zeichenfolge

OwnerId

AWS-Konto ID, der die Ressource gehört.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 14 Zeichen.

Pattern: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

SubnetId

Die ID des Subnetzes des Mountingziels.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 15 Zeichen. Maximale Länge beträgt 47 Zeichen.

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

VpcId

Die ID der Virtual Private Cloud (VPC), in der das Mountingziel konfiguriert ist.

Typ: Zeichenfolge

Fehler

AvailabilityZonesMismatch

Wird zurückgegeben, wenn sich die Availability Zone, die für ein Mountingziel angegeben wurde, von der Availability Zone unterscheidet, die für One-Zone-Speicher angegeben wurde. Weitere Informationen finden Sie unter Redundanz von regionalem und One-Zone-Speicher.

HTTP Status Code: 400

BadRequest

Wird zurückgegeben, wenn die Anforderung falsch formatiert ist oder einen Fehler enthält, z. B. einen ungültigen Parameterwert oder einen fehlenden erforderlichen Parameter.

HTTP Status Code: 400

FileSystemNotFound

Wird zurückgegeben, wenn der angegebene FileSystemId Wert im Wert des Anforderers nicht vorhanden ist AWS-Konto.

HTTP Status Code: 404

IncorrectFileSystemLifeCycleState

Wird zurückgegeben, wenn der Lebenszyklusstatus des Dateisystems nicht „verfügbar“ ist.

HTTP-Statuscode: 409

InternalServerError

Wird zurückgegeben, wenn auf der Serverseite ein Fehler aufgetreten ist.

HTTP Status Code: 500

IpAddressInUse

Wird zurückgegeben, wenn in der Anforderung eine IpAddress angegeben wurde, die bereits im Subnetz verwendet wird.

HTTP-Statuscode: 409

MountTargetConflict

Wird zurückgegeben, wenn das Mountingziel eine der auf der Grundlage der vorhandenen Mountingziele des Dateisystems angegebenen Einschränkungen verletzen würde.

HTTP-Statuscode: 409

NetworkInterfaceLimitExceeded

Das aufrufende Konto hat den Grenzwert für elastische Netzwerkschnittstellen für die spezifische AWS-Region erreicht. Löschen Sie entweder einige Netzwerkschnittstellen oder fordern Sie eine Erhöhung des Kontingents an. Weitere Informationen finden Sie unter Amazon VPC-Kontingente im Amazon VPC-Benutzerhandbuch (siehe den Eintrag Netzwerkschnittstellen pro Region in der Tabelle Netzwerkschnittstellen).

HTTP-Statuscode: 409

NoFreeAddressesInSubnet

Wird zurückgegeben, wenn IpAddress in der Anforderung nicht angegeben wurde und es keine freien IP-Adressen im Subnetz gibt.

HTTP-Statuscode: 409

SecurityGroupLimitExceeded

Wird zurückgegeben, wenn die in der Anfrage SecurityGroups angegebene Anzahl von Objekten das Limit überschreitet, das auf dem Kontingent des Kontos basiert. Löschen Sie entweder einige Sicherheitsgruppen oder fordern Sie eine Erhöhung des Kontokontingents an. Weitere Informationen finden Sie unter Amazon VPC-Kontingente im Amazon VPC-Benutzerhandbuch (siehe Tabelle mit Sicherheitsgruppen).

HTTP Status Code: 400

SecurityGroupNotFound

Wird zurückgegeben, wenn eine der angegebenen Sicherheitsgruppen nicht in der Virtual Private Cloud (VPC) des Subnetzes vorhanden ist.

HTTP Status Code: 400

SubnetNotFound

Wird zurückgegeben, wenn in der Anforderung kein Subnetz mit der ID SubnetId angegeben wurde.

HTTP Status Code: 400

UnsupportedAvailabilityZone

Wird zurückgegeben, wenn die angeforderte Amazon-EFS-Funktion in der angegebenen Availability Zone nicht verfügbar ist.

HTTP Status Code: 400

Beispiele

Fügt einem Dateisystem ein Mountingziel hinzu

Die folgende Anfrage erstellt ein Bereitstellungsziel für ein Dateisystem. In der Anforderung werden nur Werte für die erforderlichen Parameter FileSystemId und SubnetId angegeben. Die Anforderung stellt nicht die optionalen Parameter IpAddress und SecurityGroups bereit. Als IpAddress verwendet der Vorgang eine der verfügbaren IP-Adressen im angegebenen Subnetz. Des Weiteren wird die der VPC zugeordnete Standard-Sicherheitsgruppe für die SecurityGroups verwendet.

Beispielanforderung

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

Beispielantwort

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

Hinzufügen eines Mountingziels zu einem Dateisystem

In der folgenden Anforderung sind alle Anforderungsparameter für die Erstellung eines Mountingziels angegeben.

Beispielanforderung

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"
   ]
}

Beispielantwort

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

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs:

• AWS -Befehlszeilenschnittstelle

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK für JavaScript V3

• AWS SDK for PHP V3

• AWS SDK für Python

• AWS SDK for Ruby V3