View a markdown version of this page

Aufrufen der IAM-API mithilfe von HTTP-Abfrageanforderungen - AWS Identitäts- und Zugriffsverwaltung
EndpunkteHTTPS erforderlichSignieren von IAM-API-Anforderungen

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.

Aufrufen der IAM-API mithilfe von HTTP-Abfrageanforderungen

Mithilfe der Query-API können Sie programmgesteuert auf das IAM und die AWS STS Dienste zugreifen. Abfrage-API-Anforderungen sind HTTPS-Anforderungen, in denen eine auszuführende Aktion mittels eines Action-Parameters angegeben wird. IAM und AWS STS unterstützt GET- und POST-Anfragen für alle Aktionen. Das heißt, die API verlangt nicht, dass Sie für einige Aktionen GET und für andere POST verwenden. GET-Anforderungen unterliegen jedoch den Längenbeschränkungen für URLs. Diese Beschränkung ist abhängig vom verwendeten Browser, beträgt in der Regel jedoch 2.048 Bytes. Für größere Abfrage-API-Anforderungen muss daher eine POST-Anforderung verwendet werden.

Die Antwort erfolgt in Form eines XML-Dokuments. Weitere Informationen über die Antwort finden Sie auf den Seiten zu den einzelnen Aktionen in der IAM API-Referenz oder die AWS -Security-Token-Service -API-Referenz.

Tipp

Anstatt die IAM- oder AWS STS API-Operationen direkt aufzurufen, können Sie eines der AWS SDKs verwenden. Die AWS SDKs bestehen aus Bibliotheken und Beispielcode für verschiedene Programmiersprachen und Plattformen (Java, Ruby, .NET, iOS, Android usw.). Die SDKs bieten eine bequeme Möglichkeit, programmatischen Zugriff auf IAM und zu erstellen. AWS Mithilfe der SDKs lassen sich unter anderem Anforderungen kryptografisch signieren (siehe unten), Fehler verwalten und Anforderungen automatisch wiederholen. Informationen zu den AWS SDKs, einschließlich deren Herunterladen und Installieren, finden Sie auf der Seite Tools für Amazon Web Services.

Weitere Informationen über die API-Vorgänge und Fehler finden Sie in der IAM API-Referenz oder die AWS -Security-Token-Service -API-Referenz.

Endpunkte

IAM und AWS STS jedes hat einen einzigen globalen Endpunkt:

Wichtig

AWS STS unterstützt zusätzlich zum globalen Endpunkt auch das Senden von Anfragen an regionale Endpunkte. AWS empfiehlt, regionale Endpunkte anstelle von globalen Endpunkten zu verwenden, um die Latenz zu reduzieren, Redundanz aufzubauen und die Gültigkeit der Sitzungstoken zu erhöhen. Bevor Sie AWS STS in einer bestimmten Region verwenden können, müssen Sie STS für Ihr AWS-Konto zunächst in dieser Region aktivieren. Weitere Informationen zur Aktivierung zusätzlicher Regionen für AWS STS finden Sie unter. Verwalten AWS STS in einem AWS-Region

Weitere Informationen zu AWS Endpunkten und Regionen für alle Dienste finden Sie unter Dienstendpunkte und Kontingente im. Allgemeine AWS-Referenz

HTTPS erforderlich

Die Abfrage-API gibt vertrauliche Informationen wie Sicherheitsanmeldeinformationen zurück; daher müssen für alle API-Anforderungen HTTPS verwenden.

Signieren von IAM-API-Anforderungen

Anforderungen müssen über eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel signiert werden. Wir empfehlen dringend, dass Sie Ihre Root-Benutzer des AWS-Kontos Anmeldeinformationen nicht für die tägliche Arbeit mit IAM verwenden. Sie können die Anmeldeinformationen für einen IAM-Benutzer verwenden oder Sie können sie verwenden, um temporäre Sicherheitsanmeldeinformationen AWS STS zu generieren.

Zum Signieren Ihrer API-Anfragen empfehlen wir die Verwendung von AWS Signature Version 4. Weitere Informationen zu Signature Version 4 finden Sie im Signaturprozess mit Signaturversion 4 in der Allgemeinen Referenz zu AWS .

Wenn Sie Signaturversion 2 verwenden müssen, finden Sie dazu ebenfalls Informationen in der Allgemeinen Referenz zu AWS.

Weitere Informationen finden Sie hier: