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ält
IpAddress
, EFS weist Amazon diese IP-Adresse der Netzwerkschnittstelle zu. Andernfalls EFS weist Amazon eine freie Adresse im Subnetz zu (genauso wie der EC2CreateNetworkInterface
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, wobeifsmt-id
die Mount-Ziel-ID undfs-id
dieFileSystemId
ist. -
Setzt die Eigenschaft
requesterManaged
der Netzwerkschnittstelle auftrue
und den WertrequesterId
aufEFS
.
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 dasIpAddress
Feld auf dessen Adresse. Wenn die Erstellung der Netzwerkschnittstelle fehlschlägt, schlägt die gesamteCreateMountTarget
-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
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 Form
sg-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-az1
Ist beispielsweise eine AZ-ID für die Region us-east-1 und sie hat in jeder Region den gleichen Standort. AWS-KontoTyp: 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 wieus-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: