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 API mittels HTTP-Abfrageanforderungen
Dieser Abschnitt enthält allgemeine Informationen über die Verwendung der Abfrage-API für AWS Organizations. Weitere Informationen über die API-Vorgänge und Fehler finden Sie in der AWS Organizations-API-Referenz.
Anmerkung
Anstatt die AWS Organizations-Query-API direkt aufzurufen, können Sie auch eine der AWS-SDKs verwenden. Die AWS-SDKs bestehen aus Bibliotheken und Beispiel-Code für verschiedene Programmiersprachen und Plattformen (darunter Java, Ruby, .NET, iOS und Android). Die SDKs sind gut zur Einrichtung des programmgesteuerten Zugriffs auf AWS Organizations und AWS geeignet. Mithilfe der SDKs lassen sich unter anderem Anforderungen kryptografisch signieren, Fehler verwalten und Anforderungen automatisch wiederholen. Weitere Informationen über die AWS-SDKs, das Herunterladen und die Installation finden Sie unter Tools für Amazon Web Services
Die Abfrage-API für AWS Organizations dient zum Aufrufen von Serviceaktionen. Abfrage-API-Anforderungen sind HTTPS-Anforderungen, in denen eine auszuführende Operation mittels eines Action-Parameters angegeben wird. AWS Organizations unterstützt GET- und POST-Anforderungen für alle Operationen. Dies bedeutet, es ist für API nicht erforderlich, je nach Aktion zwischen GET- und POST-Anforderungen zu unterscheiden. Allerdings unterliegen GET-Anforderungen der Größenbeschränkung von URLs. Diese sind abhängig vom Browser; die übliche Beschränkung liegt bei 2.048 Byte. 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 AWS Organizations-API-Referenz.
Endpunkte
AWS Organizations verfügt über einen einzelnen globalen API-Endpunkt, der in der Region USA Ost (Nord-Virginia) gehostet wird.
Weitere Informationen zu AWS Endpunkten und Regionen für alle Services finden Sie unter Regionale Endpunkte im Allgemeine AWS-Referenz.
HTTPS erforderlich
Die Abfrage-API gibt vertrauliche Informationen wie Sicherheitsanmeldeinformationen zurück; daher müssen Sie zum Verschlüsseln aller API-Anforderungen HTTPS verwenden.
Signieren von AWS Organizations-API-Anforderungen
Anforderungen müssen über eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel signiert werden. Wir raten nachdrücklich davon ab, Ihre Root-Benutzer des AWS-Kontos-Anmeldeinformationen für die tägliche Arbeit mit AWS Organizations zu verwenden. Sie können die Anmeldeinformationen für einen Benutzer oder eine Rolle nutzen.
Zum Signieren von API-Anforderungen müssen Sie Signature Version 4 für AWS verwenden. Weitere Informationen zur Verwendung von Signature Version 4 finden Sie unter Signieren von AWS-API-Anforderungen im IAM-Benutzerhandbuch.
AWS Organizations unterstützt keine älteren Versionen, wie z. B. Signature Version 2.
Weitere Informationen finden Sie hier:
-
AWS-Sicherheitsanmeldeinformationen – Bietet allgemeine Informationen zu den Arten der Anmeldeinformationen, mit denen Sie auf AWS zugreifen können.
-
Bewährte Sicherheitsmethoden in IAM – Bietet Vorschläge für die Verwendung des IAM-Service zum Backup von AWS-Ressourcen, einschließlich der in AWS Organizations.
-
Temporäre Sicherheitsanmeldeinformationen in IAM – Beschreibt die Erstellung und Verwendung von temporären Sicherheitsanmeldeinformationen.
