CreateMountTarget - Amazon Elastic File System
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerBeispieleWeitere Informationen finden Sie unter:

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. Weitere Informationen zu Mount-Zielen finden Sie unter Mount-Ziele verwalten.

Um ein Mount-Ziel für ein EFS-Dateisystem zu erstellen, muss der Lebenszyklusstatus des Dateisystems seinavailable. Weitere Informationen finden Sie unter DescribeFileSystems.

Nach der Erstellung des Mount-Ziels gibt Amazon EFS eine Antwort zurück, die eine MountTargetId und eine IP-Adresse (IpAddressoderIpv6Address) enthält. Sie verwenden diese IP-Adresse, wenn Sie das Dateisystem in einer EC2 Instance 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 So funktioniert Amazon EFS.

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. Weitere Informationen finden Sie unter Bereitstellungsziele erstellen.

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

  • Erstellt ein neues Mount-Ziel im angegebenen Subnetz.

  • Erstellt eine neue Netzwerkschnittstelle im Subnetz mit folgenden Eigenschaften:

    • Die BeschreibungMount target fsmt-id for file system fs-id , bei der fsmt-id es sich um die Mount-Ziel-ID fs-id handelt, und um die. FileSystemId

    • Die requesterManaged Eigenschaft der Netzwerkschnittstelle ist auf eingestellttrue, und der requesterId Wert, der auf gesetzt istEFS.

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

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

Wenn das IpAddressType Mount-Ziel IPv4 (IPV4_ONLYoderDUAL_STACK) lautet, geben Sie die zu IPv4 verwendende Adresse an. Wenn Sie keine angebenIpAddress, wählt Amazon EFS eine ungenutzte IP-Adresse aus dem Subnetz aus, für SubnetId das angegeben ist.

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

IpAddressType

Der IP-Adresstyp für das Mount-Ziel. Die möglichen Werte sind IPV4_ONLY (nur IPv4 Adressen), IPV6_ONLY (nur IPv6 Adressen) und DUAL_STACK (Dual-Stack, beide IPv6 Adressen IPv4 und Adressen). Wenn Sie keinen angebenIpAddressType, IPV4_ONLY wird verwendet.

Anmerkung

Das IPAddressType muss dem IP-Typ des Subnetzes entsprechen. Darüber hinaus überschreibt der IPAddressType Parameter den Wert, der als Standard-IP-Adresse für das Subnetz in der VPC festgelegt ist. Wenn beispielsweise IPAddressType is IPV4_ONLY und istrue, dann AssignIpv6AddressOnCreation IPv4 wird es für das Mount-Ziel verwendet. Weitere Informationen finden Sie unter Ändern des öffentlichen IP-Adressierungsattributs Ihres Subnetzes.

Typ: Zeichenfolge

Zulässige Werte: IPV4_ONLY | IPV6_ONLY | DUAL_STACK

Erforderlich: Nein

Ipv6Address

Wenn das IPAddressType für das Einhängeziel IPv6 (IPV6_ONLYoderDUAL_STACK) lautet, geben Sie die zu verwendende IPv6 Adresse an. Wenn Sie keine angebenIpv6Address, wählt Amazon EFS eine ungenutzte IP-Adresse aus dem Subnetz aus, für SubnetId das angegeben ist.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 3. Die maximale Länge beträgt 39.

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). Wenn Sie keine Sicherheitsgruppe angeben, verwendet Amazon EFS die Standardsicherheitsgruppe für die VPC des Subnetzes.

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. Der Subnetztyp muss derselbe Typ sein wie der. IpAddressType

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",
   "Ipv6Address": "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 IPv4 Adresse für das Mount-Ziel.

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

Ipv6Address

Die IPv6 Adresse für das Mount-Ziel.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 3. Die maximale Länge beträgt 39.

LifeCycleState

Der Lebenszyklusstatus des Mounting-Ziels.

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 das Mount-Ziel angegeben wurde, von der Availability Zone des Dateisystems unterscheidet. 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 Anfrage eine IP-Adresse (IpAddressoderIpv6Address) 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

Hat „Nein“ zurückgegeben IpAddress oder Ipv6Address wurde in der Anfrage angegeben und es gibt keine freien IP-Adressen im angegebenen Subnetz.

HTTP-Statuscode: 409

SecurityGroupLimitExceeded

Wird zurückgegeben, wenn die in der Anfrage SecurityGroups angegebene Anzahl von Daten den Grenzwert überschreitet, der auf dem Kontingent 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

Erstellen Sie ein Mount-Ziel an einer verfügbaren IPv4 Adresse in einem Subnetz

Die folgende Anfrage spezifiziert nur das Dateisystem und das Subnetz für das Mount-Ziel. Das Ziel wird an einer verfügbaren IPv4 Adresse im angegebenen Subnetz erstellt, wobei die Standardsicherheitsgruppe der VPC zugeordnet ist.

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

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

Erstellen Sie ein Mount-Ziel an einer bestimmten Adresse IPv4

Die folgende Anfrage spezifiziert das Dateisystem, das Subnetz, die Sicherheitsgruppe und die IPv4 Adresse, die für das Mount-Ziel verwendet werden sollen.

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"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

Erstellen Sie ein Mount-Ziel an einer bestimmten Adresse IPv6

Die folgende Anfrage spezifiziert das Dateisystem, das Subnetz, die Sicherheitsgruppe und die IPv6 Adresse, die für das Mount-Ziel verwendet werden sollen.

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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "IpAddressType": "IPV6_ONLY",
   "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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "NetworkInterfaceId":"eni-1bcb7772"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

Erstellen Sie ein Mount-Ziel an einer verfügbaren IPv4 Adresse im Dual-Stack-Subnetz

Die folgende Anfrage spezifiziert das Dateisystem, das Subnetz und den Adresstyp für das Mount-Ziel. Das Ziel wird an einer verfügbaren IPv4 Adresse im angegebenen Dual-Stack-Subnetz erstellt, wobei die Standardsicherheitsgruppe der VPC zugeordnet ist.

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

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

Erstellen Sie ein Mount-Ziel für ein bestimmtes IPv4 und IPv6 für Adressen im Dual-Stack-Subnetz

Die folgende Anfrage spezifiziert das Dateisystem, das Subnetz, die Sicherheitsgruppe, die Adresse und die IPv4 IPv6 Adresse für das Mount-Ziel. Das Ziel wird an den angegebenen IPv4 IPv6 Adressen in einem Dual-Stack-Subnetz erstellt.

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",
   "IpAddressType": "DUAL_STACK",
   "IpAddress": "10.0.1.25",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "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": "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"
}

Weitere Informationen finden Sie unter:

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