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.
Verwenden der API für Amazon EC2
Wichtig
Seit dem 14. Oktober 2022 enthalten HTTP-Antworten von den Amazon EC2 EC2-APIs kein Begründungselement mehr. Wie in RFC7230
Wir bieten die Query API für Amazon EC2 sowie Software Development Kits (SDK), mit AWS denen Sie von Ihrer bevorzugten Programmiersprache aus auf Amazon EC2 zugreifen können. Weitere Informationen finden Sie im Amazon EC2 Developer Guide.
Inhalt
Erforderliche Kenntnisse
Wenn Sie über eine API auf Amazon EC2 zugreifen möchten, sollten Sie mit den folgenden Informationen vertraut sein:
-
XML
-
Web-Services
-
HTTP-Anforderungen
-
Eine oder mehrere Programmiersprachen wie Java, PHP, Perl, Python, Ruby, C# oder C++.
Verfügbare APIs für Amazon EC2
Die Amazon EC2 Query API stellt HTTP- oder HTTPS-Anfragen bereit, die das HTTP-Verb GET oder POST und einen Query-Parameter mit dem Namen Action verwenden.
AWS bietet Bibliotheken, Beispielcode, Tutorials und andere Ressourcen für Softwareentwickler, die es vorziehen, Anwendungen mithilfe sprachspezifischer APIs zu erstellen, anstatt eine Anfrage über HTTP oder HTTPS einzureichen. Diese Bibliotheken bieten grundlegende Funktionen, die sich automatisch um Aufgaben wie das kryptografische Signieren Ihrer Anfragen, das Wiederholen von Anfragen und das Verarbeiten von Fehlerantworten kümmern, sodass Ihnen der Einstieg erleichtert wird.
Weitere Informationen finden Sie unter Erstellen von Amazon EC2-Ressourcen mithilfe eines AWS SDK im Amazon EC2 Developer Guide.
Allgemeine Abfrageparameter
Die meisten Amazon EC2 EC2-API-Aktionen unterstützen die in den folgenden Tabellen beschriebenen Parameter. Die allgemeinen Parameter variieren je nachdem, ob Sie Signature Version 2 oder Signature Version 4 zum Signieren Ihrer Anfragen verwenden. Weitere Informationen finden Sie im IAM-Benutzerhandbuch unter AWS API-Anfragen signieren.
Parameter für Signature Version 4
| Name | Description | Erforderlich |
|---|---|---|
|
|
Die auszuführende Aktion. Beispiel: |
Ja |
|
|
Die zu verwendende -API-Version. |
Ja |
|
|
Der Hash-Algorithmus, den Sie verwenden, um die Anforderungssignatur zu erstellen. Beispiel: |
Ja |
|
|
Der Gültigkeitsbereich der Anmeldeinformationen für die Anfrage im Format Beispiel: |
Ja |
|
|
Das Datum und die Uhrzeit, zu der die Anforderung signiert wurde, im Format yyyymmddThhmmssz. Das Datum muss mit dem Datum übereinstimmen, das im Bereich der Anmeldeinformationen für den Beispiel: |
Ja |
X-Amz-SignedHeaders |
Die Header, die Sie als Teil der Anfrage angeben. Sie müssen mindestens den Beispiel: |
Ja |
|
|
Eine Signatur, die von Ihrem geheimen Zugriffsschlüssel abgeleitet ist. Beispiel: |
Ja |
|
|
Das temporäre Sicherheitstoken, das durch einen Aufruf von abgerufen wurde AWS -Security-Token-Service. Beispiel: |
Nein |
|
|
Überprüft, ob Sie über die erforderlichen Berechtigungen für die Aktion verfügen, ohne die Anfrage tatsächlich zu stellen. Wenn Sie über die erforderlichen Berechtigungen verfügen, wird die Anfrage zurückgegeben. |
Nein |
Die Parameter X-Amz-AlgorithmX-Amz-Credential,X-Amz-SignedHeaders, und können entweder als separate X-Amz-Signature Parameter in der Abfragezeichenfolge angegeben werden, oder ihre Werte können in einem einzigen Authorization Header enthalten sein. Weitere Informationen finden Sie im IAM-Benutzerhandbuch unter AWS API-Anfragen signieren.
Parameter für Signature Version 2
| Name | Description | Erforderlich |
|---|---|---|
|
|
Die auszuführende Aktion. Beispiel: |
Ja |
|
|
Die zu verwendende -API-Version. |
Ja |
|
|
Die Zugriffsschlüssel-ID für den Absender der Anfrage. Dadurch wird das Konto identifiziert, dem die Nutzung des Dienstes in Rechnung gestellt wird. Das Konto, das mit der Zugriffsschlüssel-ID verknüpft ist, muss für Amazon EC2 registriert sein, andernfalls wird die Anfrage nicht akzeptiert. Beispiel: |
Ja |
|
|
Das Datum und die Uhrzeit, an dem die in der Anfrage enthaltene Signatur abläuft, im Format YYYY-MM-DDThh:mm:ssZ. Weitere Informationen finden Sie unter ISO 8601 Beispiel: |
Bedingt. Anfragen müssen entweder Timestamp oder enthaltenExpires, dürfen aber nicht beide enthalten. |
|
|
Das Datum und die Uhrzeit, zu der die Anfrage signiert wurde, im Format YYYY-MM-DDThh:mm:ssZ. Weitere Informationen finden Sie unter ISO 8601 Beispiel: |
Bedingt. Anfragen müssen entweder Timestamp oder enthaltenExpires, dürfen aber nicht beide enthalten. |
|
|
Die Signatur der Anfrage. Beispiel: |
Ja |
|
|
Der Hash-Algorithmus, den Sie verwenden, um die Anforderungssignatur zu erstellen. Zulässige Werte: Beispiel: |
Ja |
|
|
Die Signaturversion, die Sie zum Signieren der Anfrage verwenden. Legen Sie diesen Wert auf Beispiel: |
Ja |
|
|
Überprüft, ob Sie über die erforderlichen Berechtigungen für die Aktion verfügen, ohne die Anfrage tatsächlich zu stellen. Wenn Sie über die erforderlichen Berechtigungen verfügen, wird die Anfrage zurückgegeben. |
Nein |
|
|
Das temporäre Sicherheitstoken, das durch einen Aufruf von abgerufen wurde AWS -Security-Token-Service. Beispiel: |
Nein |
Die Parameterwerte müssen sein URL-encoded. Dies gilt für jeden Query-Parameter, der an Amazon EC2 übergeben wird, und ist in der Regel im Signature Parameter erforderlich. Einige Kunden tun dies automatisch, aber das ist nicht die Norm.