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.
Die Amazon-EFS-API ist ein Netzwerk-Protokoll basierend auf HTTP (RFC 2616)
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.
Anmerkung
Operationsnamen, wie z. B.CreateFileSystem, erscheinen zwar nicht auf der Leitung, sind aber in AWS Identity and Access Management (IAM-) Richtlinien von Bedeutung. Weitere Informationen finden Sie unter Identitäts- und Zugriffsmanagement für Amazon EFS.
Der Operationsname wird auch zur Benennung von Befehlen in Befehlszeilentools und Elementen des SDK verwendet. AWS APIs Beispielsweise gibt es einen AWS CLI Befehl mit dem Namencreate-file-system, der der CreateFileSystem Operation zugeordnet ist.
Der Name des Vorgangs erscheint auch in den AWS CloudTrail Protokollen für Amazon EFS-API-Aufrufe.
API-Endpunkt
Der API-Endpunkt ist der DNS-Name, der in dem HTTP-URI für die API-Aufrufe als Host verwendet wird. Diese API-Endpunkte sind spezifisch für AWS-Regionen und haben die folgende Form.
elasticfilesystem.aws-region.amazonaws.com
Zum Beispiel ist der Amazon-EFS-API-Endpunkt für die Region USA West (Oregon) folgender.
elasticfilesystem---us-west-2.amazonaws.com.rproxy.goskope.comEine Liste der von Amazon AWS-Region EFS unterstützten Betriebssysteme (mit denen Sie Dateisysteme erstellen und verwalten können) finden Sie unter Amazon Elastic File System im Allgemeine AWS-Referenz.
Der regionsspezifische API-Endpunkt bestimmt den Umfang der Amazon-EFS-Ressourcen, auf die Sie bei einem API-Aufruf zugreifen können. Wenn Sie beispielsweise die DescribeFileSystems-Operation mit dem oben genannten Endpunkt aufrufen, erhalten Sie eine Liste mit den in Ihrem Konto erstellten Dateisystemen in der Region USA West (Oregon).
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 Beispiele für die Implementierung dieses Algorithmus finden Sie unter Wiederholversuche bei Fehlern und exponentielles Backoff in AWS in der Allgemeine Amazon Web Services-Referenz.
