CreateAccessPoint - Amazon Elastic File System
AnforderungssyntaxURIParameter anfordernAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere 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.

CreateAccessPoint

Erzeugt einen EFS Access Point. Ein Access Point ist eine anwendungsspezifische Ansicht eines EFS Dateisystems, die einen Betriebssystembenutzer und eine Betriebssystemgruppe sowie einen Dateisystempfad auf jede Dateisystemanfrage anwendet, die über den Access Point gestellt wird. Der Betriebssystembenutzer und die Gruppe haben Vorrang vor allen vom Client bereitgestellten Identitätsinformationen. NFS 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 Access Points.

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 bei der Erstellungsaktion Tags angegeben wurden, IAM führt eine zusätzliche Autorisierung für die elasticfilesystem:TagResource Aktion durch, um zu überprüfen, ob Benutzer berechtigt sind, Tags zu erstellen. 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"
      }
   ]
}

URIParameter anfordern

Die Anfrage verwendet keine URI Parameter.

Anforderungstext

Die Anfrage 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, auf das der Access Point Zugriff 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 im EFS Dateisystem an, das der Access Point den NFS Clients, die den Access Point verwenden, als Stammverzeichnis Ihres Dateisystems zur Verfügung stellt. Die Clients, die den Zugangspunkt verwenden, können nur auf das Stammverzeichnis und die darunter liegende Ebene zugreifen. Wenn das Path angegebene RootDirectory > nicht existiert, EFS erstellt Amazon es und wendet die CreationInfo Einstellungen an, wenn ein Client eine Verbindung zu einem Access Point 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, Own GID und die 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 Dienst eine HTTP 200-Antwort zurück.

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

AccessPointArn

Der eindeutige Amazon-Ressourcenname (ARN), der dem Access Point 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 zugewiesene ID des Access PointsEFS.

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, für das der Access Point gilt.

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 Gruppe IDs auf dem Access Point, die für alle Dateioperationen von NFS Clients verwendet wird, die den Access Point verwenden.

Typ: PosixUser Objekt

RootDirectory

Das Verzeichnis im EFS Dateisystem, das der Access Point den NFS Clients, die den Access Point verwenden, als Stammverzeichnis zur Verfügung stellt.

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.

HTTPStatuscode: 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.

HTTPStatuscode: 403

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

ThrottlingException

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

HTTPStatuscode: 429

Weitere Informationen finden Sie unter:

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