CreateMountTarget - Amazon Elastic File System

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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 Ihrem ein Mount-Ziel erstellenVPC. Alle EC2 Instances VPC in einer bestimmten Availability Zone teilen sich ein einzelnes Mount-Ziel für ein bestimmtes Dateisystem. Wenn Sie mehrere Subnetze in einer Availability Zone haben, legen Sie in einem der Subnetze ein Mount-Ziel an. EC2Instanzen 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 AmazonEFS: So funktioniert's.

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:

    • Das, VPC in dem Amazon das Mount-Ziel EFS erstellt

    • Die Availability Zone, in der Amazon das Mount-Ziel EFS erstellt

    • Der IP-Adressbereich, aus dem Amazon die IP-Adresse des Mount-Ziels EFS auswählt (wenn Sie in der Anfrage keine IP-Adresse angeben)

Nach der Erstellung des Mount-Ziels EFS gibt Amazon eine Antwort zurück, die a MountTargetId und an enthältIpAddress. Sie verwenden diese IP-Adresse, wenn Sie das Dateisystem in einer EC2 Instance mounten. Sie können auch den DNS Namen des Mount-Ziels verwenden, wenn Sie das Dateisystem mounten. 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 einem VPC erstellen können und dass es pro Availability Zone nur ein Mount-Ziel geben kann. 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 zu denselben Subnetzen gehören VPC 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, EFS geht Amazon 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 enthältIpAddress, EFS weist Amazon diese IP-Adresse der Netzwerkschnittstelle zu. Andernfalls EFS weist Amazon 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 Standardsicherheitsgruppe für die Subnetze. VPC

    • 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 EFS Amazon-Mount-Ziel hat eine entsprechende, vom Anforderer verwaltete EC2 Netzwerkschnittstelle. Nachdem die Netzwerkschnittstelle erstellt wurde, EFS setzt Amazon das NetworkInterfaceId Feld in der Beschreibung des Mount-Ziels auf die Netzwerkschnittstellen-ID und das IpAddress Feld auf dessen 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 auf Amazon EFS. 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" }

URIParameter anfordern

Die Anfrage verwendet keine URI Parameter.

Anforderungstext

Die Anfrage 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

Bis zu fünf VPC Sicherheitsgruppen IDs der Formsg-xxxxxxxx. Diese müssen für dasselbe Subnetz VPC wie das angegebene Subnetz gelten.

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 Dienst eine HTTP 200-Antwort zurück.

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

AvailabilityZoneId

Die eindeutige und konsistente Kennung der Availability Zone, in der sich das Mounting-Ziel 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 bei der EFS Erstellung des Mount-Ziels 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 virtuellen privaten Cloud (VPC), in der das Mount-Ziel 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.

HTTPStatuscode: 400

BadRequest

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

HTTPStatuscode: 400

FileSystemNotFound

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

HTTPStatuscode: 404

IncorrectFileSystemLifeCycleState

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

HTTPStatuscode: 409

InternalServerError

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

HTTPStatuscode: 500

IpAddressInUse

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

HTTPStatuscode: 409

MountTargetConflict

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

HTTPStatuscode: 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 VPCAmazon-Kontingente im VPCAmazon-Benutzerhandbuch (siehe den Eintrag Netzwerkschnittstellen pro Region in der Tabelle Netzwerkschnittstellen).

HTTPStatuscode: 409

NoFreeAddressesInSubnet

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

HTTPStatuscode: 409

SecurityGroupLimitExceeded

Wird zurückgegeben, wenn die in der Anforderung SecurityGroups angegebene Größe den Wert fünf überschreitet.

HTTPStatuscode: 400

SecurityGroupNotFound

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

HTTPStatuscode: 400

SubnetNotFound

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

HTTPStatuscode: 400

UnsupportedAvailabilityZone

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

HTTPStatuscode: 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. Und der Vorgang verwendet die Standardsicherheitsgruppe, die mit der VPC für verknüpft istSecurityGroups.

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 Option API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: