CreateAccessPoint - Amazon Elastic File System
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie auch 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.

CreateAccessPoint

Erstellt einen EFS-Zugangspunkt. Ein Zugangspunkt ist eine anwendungsspezifische Ansicht in ein EFS-Dateisystem, die einen Betriebssystembenutzer und eine Gruppe sowie einen Dateisystempfad auf jede über den Zugangspunkt erfolgte Dateisystemanforderung anwendet. Der Betriebssystembenutzer und die Gruppe überschreiben alle vom NFS-Client bereitgestellten Identitätsinformationen. Der Dateisystempfad wird als Stammverzeichnis des Zugangspunkts verfügbar gemacht. Anwendungen, die den Zugangspunkt verwenden, können nur auf Daten in einem eigenen Verzeichnis und die darunter liegende Ebene zugreifen. Weitere Informationen finden Sie unter Mounten eines Dateisystems mithilfe von EFS-Zugangspunkten.

Anmerkung

Wenn mehrere Anfragen zum Erstellen von Zugangspunkten auf demselben Dateisystem schnell hintereinander gesendet werden und sich das Dateisystem dem Grenzwert von 1.000 Zugangspunkten nähert, kann es bei diesen Anfragen zu einer Drosselung der Antwort kommen. Dadurch wird sichergestellt, dass das Dateisystem den angegebenen Grenzwert nicht überschreitet.

Diese Operation erfordert Berechtigungen für die Aktion elasticfilesystem:CreateAccessPoint.

Zugangspunkte können bei der Erstellung mit einem Tag versehen werden. Wenn Tags in der Aktion angegeben werden, mit der die Zugangspunkte erstellt werden, führt IAM eine zusätzliche Autorisierung für die Aktion elasticfilesystem:TagResource aus, um die Berechtigungen der Benutzer zum Erstellen von Tags zu überprüfen. Daher müssen Sie explizite Berechtigungen für die Verwendung der Aktion elasticfilesystem:TagResource gewähren. Weitere Informationen finden Sie unter Erteilen der Berechtigung zum Taggen von Ressourcen während der Erstellung.

Anforderungssyntax

POST /2015-02-01/access-points HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "FileSystemId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

ClientToken

Eine Zeichenfolge mit bis zu 64 ASCII-Zeichen, die Amazon EFS verwendet, um eine idempotente Erstellung sicherzustellen.

Typ: Zeichenfolge

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

Pattern: .+

Erforderlich: Ja

FileSystemId

Die ID des EFS-Dateisystems, für das der Zugangspunkt Zugang gewährt.

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

PosixUser

Der Betriebssystembenutzer und die Gruppe, die auf alle über den Zugangspunkt getätigten Dateisystemanfragen angewendet wurden.

Typ: PosixUser Objekt

Erforderlich: Nein

RootDirectory

Gibt das Verzeichnis auf dem EFS-Dateisystem an, das der Zugangspunkt als Stammverzeichnis des Dateisystems für NFS-Clients verfügbar macht, die den Zugangspunkt verwenden. Die Clients, die den Zugangspunkt verwenden, können nur auf das Stammverzeichnis und die darunter liegende Ebene zugreifen. Wenn das angegebene Verzeichnis RootDirectory > Path nicht vorhanden ist, wird es von EFS unter Anwendung der CreationInfo-Einstellungen erstellt, wenn ein Client eine Verbindung zu einem Zugangspunkt herstellt. Wenn Sie ein RootDirectory angeben, müssen Sie den Path und die CreationInfo bereitstellen.

Amazon EFS erstellt nur dann ein Stammverzeichnis, wenn Sie CreationInfo: OwnUid, ownGID und Berechtigungen für das Verzeichnis angegeben haben. Wenn Sie diese Informationen nicht angeben, erstellt Amazon EFS das Stammverzeichnis nicht. Wenn das Stammverzeichnis nicht existiert, schlagen Mount-Versuche beim Zugangspunkt fehl.

Typ: RootDirectory Objekt

Erforderlich: Nein

Tags

Erzeugt Tags, die dem Zugangspunkt zugeordnet sind. Jedes Tag ist ein Schlüssel-Wert-Paar, wobei jeder Schlüssel eineindeutig sein muss. Weitere Informationen finden Sie im AWS Allgemeinen Referenzhandbuch unter AWS Ressourcen kennzeichnen.

Typ: Array von Tag-Objekten

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "AccessPointArn": "string",
   "AccessPointId": "string",
   "ClientToken": "string",
   "FileSystemId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "OwnerId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "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.

AccessPointArn

Der eindeutige Amazon-Ressourcenname (ARN), der dem Zugangspunkt zugeordnet ist.

Typ: Zeichenfolge

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

Pattern: ^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$

AccessPointId

Die von Amazon EFS zugewiesene ID des Zugangspunkts.

Typ: Zeichenfolge

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

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

ClientToken

Die Opaque-Zeichenfolge, die in der Anforderung angegeben wird, um eine idempotente Erstellung zu gewährleisten.

Typ: Zeichenfolge

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

Pattern: .+

FileSystemId

Die ID des EFS-Dateisystems, auf das der Zugangspunkt angewendet wird.

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

LifeCycleState

Identifiziert die Lebenszyklusphase des Zugangspunkts.

Typ: Zeichenfolge

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

Name

Der Name dieses Zugangspunkts. Dies ist der Wert des Name-Tags.

Typ: Zeichenfolge

OwnerId

Identifiziert den AWS-Konto , dem die Access Point-Ressource gehört.

Typ: Zeichenfolge

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

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

PosixUser

Die vollständige POSIX-Identität, einschließlich Benutzer-ID, Gruppen-ID und sekundärer Gruppen-IDs auf dem Zugangspunkt, die für alle Dateioperationen von NFS-Clients verwendet wird, die den Zugangspunkt verwenden.

Typ: PosixUser Objekt

RootDirectory

Das Verzeichnis im EFS-Dateisystem, das der Zugangspunkt als Stammverzeichnis für NFS-Clients verfügbar macht, die den Zugangspunkts verwenden.

Typ: RootDirectory Objekt

Tags

Die mit dem Zugangspunkt verknüpften Tags, dargestellt als ein Array von Tag-Objekten.

Typ: Array von Tag-Objekten

Fehler

AccessPointAlreadyExists

Wird zurückgegeben, wenn der Zugangspunkt, den Sie erstellen möchten, bereits existiert, und zwar mit dem Erstellungstoken, das Sie in der Anfrage angegeben haben.

HTTP-Statuscode: 409

AccessPointLimitExceeded

Wird zurückgegeben, wenn der AWS-Konto bereits die maximal zulässige Anzahl von Zugriffspunkten pro Dateisystem erstellt hat. Weitere Informationen finden Sie unter https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region.

HTTP Status Code: 403

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

ThrottlingException

Wird zurückgegeben, wenn die API-Aktion CreateAccessPoint zu schnell aufgerufen wird und sich die Anzahl der Zugangspunkte im Dateisystem dem Grenzwert von 120 nähert.

HTTP-Statuscode: 429

Weitere Informationen finden Sie auch unter:

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