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.

Amazon-EFS-API

Die Amazon-EFS-API ist ein Netzwerk-Protokoll basierend auf HTTP (RFC 2616). Für jeden API-Aufruf stellen Sie eine HTTP-Anfrage an den regionsspezifischen Amazon EFS-API-Endpunkt für den AWS-Region Ort, an dem Sie Dateisysteme verwalten möchten. Die API nutzt JSON-Dokumente (RFC 4627) für die HTTP-Anforderungs-/Antworttexte.

Die Amazon-EFS-API ist ein RPC-Modell. In diesem Modell gibt es einen festen Satz von Operationen, deren jeweilige Syntax den Clients ohne jede vorhergehende Interaktion bekannt ist. Im folgenden Abschnitt finden Sie eine Beschreibung für alle API-Operationen, die eine abstrakte RPC-Notation verwenden. Jeder verfügt über einen Operationsnamen, der nicht in den Wire-Daten zu sehen ist. Die jeweiligen Operationen werden den HTTP-Anforderungselementen zugeordnet.

Die genaue Amazon-EFS-Operation, der eine bestimmte Anforderung zugewiesen wird, hängt von der Kombination zweier Faktoren ab: der Anforderungsmethode (GET, PUT, POST oder DELETE) und dem Muster, das dem Anforderungs-URI entspricht. Bei einer PUT- oder POST-Operation extrahiert Amazon EFS die Aufrufargumente aus dem Anforderungs-URI-Pfadsegment, Abfrageparametern und dem JSON-Objekt im Anforderungstext.

API-Endpunkte

Ein Endpunkt ist eine URL, die als Einstiegspunkt für einen AWS Webservice dient. Amazon EFS unterstützt die folgenden Endpunkttypen:

Wenn Sie eine Anfrage stellen, können Sie den zu verwendenden Endpunkt angeben. Wenn Sie keinen Endpunkt angeben, wird der IPv4 Endpunkt standardmäßig verwendet. Um einen anderen Endpunkttyp zu verwenden, müssen Sie ihn in Ihrer Anforderung angeben. Beispiele für diese Vorgehensweise finden Sie unter Angeben von Endpunkten. Eine Tabelle der verfügbaren Endpunkte finden Sie unter Amazon EFS-Endpunkte und Kontingente.

IPv4 Endpunkte

IPv4 Endpunkte unterstützen nur IPv4 Datenverkehr. IPv4 Endpunkte sind für alle Regionen verfügbar. Das Format des IPv4 Endpunkts hängt von der Region ab.

Dual-Stack-Endpunkte (IPv4 und IPv6)

Dual-Stack-Endpunkte unterstützen sowohl den als auch den Datenverkehr. IPv4 IPv6 Wenn Sie eine Anfrage an einen Dual-Stack-Endpunkt stellen, wird die Endpunkt-URL je nach dem von Ihrem Netzwerk und Client verwendeten Protokoll in eine IPv6 oder eine IPv4 Adresse aufgelöst. Das Format des Dual-Stack-Endpunkts hängt von der Region ab.

Angeben von Endpunkten

Die folgenden Beispiele zeigen, wie Sie mithilfe von für Amazon EFS einen Endpunkt für die Region USA West (Nordkalifornien) (us-west-1) angeben. AWS CLI

IPv4

aws efs get-rest-apis --region us-west-1 --endpoint-url https://elasticfilesystem.us-west-1.amazonaws.com

Dual-Stack

aws efs get-rest-apis --region us-west-1 --endpoint-url https://efs.us-west-1.api.aws

API-Version

Die für einen Aufruf verwendete API-Version wird vom ersten Pfadsegment des Anforderungs-URIs bestimmt und weist ein Datumsformat nach ISO 8601 auf. Ein Beispiel finden Sie unter CreateFileSystem.

Die Beschreibung in der Dokumentation bezieht sich auf die API-Version 2015-02-01.

Verwandte Themen

In den folgenden Abschnitten erhalten Sie Beschreibungen der API-Operationen. Sie erfahren, wie Sie Signaturen zur Authentifizierung von Anforderungen erstellen und wie Sie mithilfe der IAM-Richtlinien Berechtigungen für die API-Operationen erteilen.

Arbeiten mit der Abfrage-API-Anforderungsrate für Amazon EFS

Amazon EFS-API-Anfragen werden für jede AWS-Konto Anfrage pro Region gedrosselt, um die Serviceleistung zu verbessern. Alle Amazon EFS-API-Aufrufe zusammen, unabhängig davon, ob sie von einer Anwendung AWS CLI, der oder der Amazon EFS-Konsole stammen, dürfen die maximal zulässige API-Anforderungsrate nicht überschreiten. Die maximale API-Anforderungsrate kann von Land zu Land variieren AWS-Regionen. Die gestellten API-Anfragen werden dem zugrunde liegenden Objekt zugeordnet AWS-Konto.

Wenn eine API-Anforderung die API-Anforderungsrate für ihre Kategorie überschreitet, gibt die Anforderung den Fehlercode ThrottlingException zurück. Um diesen Fehler zu vermeiden, stellen Sie sicher, dass Ihre Anwendung API-Anfragen nicht in schneller Folge erneut versucht. Sie können dies tun, indem Sie beim Abrufen vorsichtig sind und Wiederholungen mit exponentiellem Backoff verwenden.

Abrufen

Möglicherweise muss Ihre Anwendung wiederholt eine API-Operation aufrufen, um auf ein Aktualisierung des Status zu prüfen. Bevor Sie mit dem Abrufen beginnen, geben Sie die Anforderungszeit für den potenziellen Abschluss ein. Wenn Sie mit dem Abrufen beginnen, verwenden Sie ein geeignetes Energiesparintervall zwischen aufeinanderfolgenden Anforderungen. Um die besten Ergebnisse zu erzielen, verwenden Sie ein zunehmendes Energiesparintervall.

Wiederholversuche oder Stapelverarbeitung

Möglicherweise muss Ihre Anwendung nach dem Auftreten eines Fehlers eine API-Anforderung wiederholen oder mehrere Ressourcen verarbeiten (z. B. all Ihre Amazon-EFS-Dateisysteme). Um die Rate von API-Anforderungen zu senken, verwenden Sie ein geeignetes Energiesparintervall zwischen aufeinanderfolgenden Anforderungen. Um die besten Ergebnisse zu erzielen, verwenden Sie ein zunehmendes oder variables Energiesparintervall.

Berechnen des Energiesparintervalls

Wenn Sie eine API-Anforderung abrufen oder wiederholen müssen, empfehlen wir die Verwendung eines exponentiellen Backoff-Algorithmus zum Berechnen des Energiesparintervalls zwischen API-Aufrufen. Die Idee hinter dem exponentiellen Backoff ist, bei aufeinander folgenden Fehlermeldungen progressiv längere Wartezeiten zwischen den Wiederholversuchen zu verwenden. Weitere Informationen und Implementierungsbeispiele für diesen Algorithmus finden Sie unter Verhalten bei Wiederholungsversuchen in der Allgemeine Amazon Web Services-Referenz.