Verwenden der AMS-API und CLI - AMS-Benutzerhandbuch für Fortgeschrittene
AMS-API-HTTP-Endpunkte für REST-AufrufeInstallation oder Aktualisierung der AMS-CLI

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 AMS-API und CLI

Die AWS Managed Services (AMS) -API ähnelt der APIs für andere AWS Services. Weitere Informationen zur AMS-API finden Sie in der AMS-API-Referenz.

AMS-API-HTTP-Endpunkte für REST-Aufrufe

Neben den verschiedenen SDKs bietet AMS eine CLI; Sie können auch REST-API-Aufrufe für den AMS-Endpunkt aufrufen.

Es gibt zwei AMS APIs (der Endpunkt für beide befindet sich in us-east-1):

  • Change Management: Verwenden Sie diese API, um Zugriff auf oder Änderungen an Ihrer Infrastruktur anzufordern. Dazu gehören das Erstellen und Aktualisieren, Bereitstellen neuer Instances RFCs, das Aktualisieren und Löschen von Instances, das Abrufen von Informationen CTs und das Erstellen von Instances. AMIs Der HTTP-Endpunkt ist:

    https://amscm.us-east-1.amazonaws.com

  • SKMS: Verwenden Sie diese API, um Informationen über Ihre Infrastruktur abzurufen VPCs, einschließlich Stacks, Subnetze und. AMIs Der HTTP-Endpunkt ist:

    https://amsskms.us-east-1.amazonaws.com

Installation oder Aktualisierung der AMS-CLI

Die AMS-CLI ist eine einfache Möglichkeit, mit der AMS-API zu interagieren, und wird in den Beispielen in diesem Abschnitt verwendet. Die Verwendungskonventionen für die AWS CLI und AMS CLI finden Sie unter Verwenden der AWS Befehlszeilenschnittstelle.

Informationen zur Installation von SAML finden Sie unterAD FS-Anspruchsregel und SAML-Einstellungen.

Gehen Sie folgendermaßen vor, um die AMS-CLI zu installieren oder zu aktualisieren:

Anmerkung

Für dieses Verfahren benötigen Sie Administratoranmeldedaten.

Die AWS-CLI ist eine Voraussetzung für die Nutzung der AWS Managed Services (AMS) CLIs (Change Management und SKMS).

  1. Informationen zur Installation der AWS-CLI finden Sie unter Installation der AWS-Befehlszeilenschnittstelle und folgen Sie den entsprechenden Anweisungen. Beachten Sie, dass sich unten auf dieser Seite Anweisungen zur Verwendung verschiedener Installationsprogramme befinden: Linux, MS Windows, macOS, Virtual Environment, Bundled Installer (Linux, macOS oder Unix).

    Führen Sie nach der Installation den Befehl aus, aws help um die Installation zu überprüfen.

  2. Sobald die AWS-CLI installiert ist, laden Sie zur Installation oder zum Upgrade der AMS CLI entweder die AMS CLI- oder die AMS SDK-Distributionsdatei herunter und entpacken Sie sie. Sie können auf die AMS-CLI-Distributionsdateien über den Link Developer's Resources im linken Navigationsbereich der AMS-Konsole zugreifen.

  3. Die README-Datei enthält Anweisungen für jede Installation.

    Öffnen Sie entweder:

    • CLI zip: Stellt nur die AMS-CLI bereit.

    • SDK-Zip: Stellt das gesamte AMS APIs und die AMS-CLI bereit.

    Führen Sie für Windows das entsprechende Installationsprogramm aus (nur 32- oder 64-Bit-Systeme):

    • 32 Bit: ManagedCloudAPI_x86.msi

    • 64 Bit: ManagedCloudAPI_x64.msi

    Führen Sie für Mac/Linux die Datei mit dem Namen: AWSManagedServices_InstallCLI.sh aus, indem Sie diesen Befehl ausführen:. sh AWSManagedServices_InstallCLI.sh Beachten Sie, dass sich die Verzeichnisse amscm und amsskms und ihr Inhalt im selben Verzeichnis wie die .sh-Datei befinden müssen. AWSManagedServices_InstallCLI

  4. Wenn Ihre Unternehmensanmeldedaten über den Verbund mit AWS (die AMS-Standardkonfiguration) verwendet werden, müssen Sie ein Tool zur Verwaltung von Anmeldeinformationen installieren, das auf Ihren Verbundservice zugreifen kann. Sie können beispielsweise diesen AWS-Sicherheitsblog How to Implementation Federated API and CLI Access Using SAML 2.0 and AD FS verwenden, um Hilfe bei der Konfiguration Ihrer Tools zur Verwaltung Ihrer Anmeldeinformationen zu erhalten.

  5. Führen Sie nach der Installation die Befehle und Optionen aus aws amscm help und sehen Sie aws amsskms help sich diese an.

    Anmerkung

    Die AMS-CLI muss installiert sein, damit diese Befehle funktionieren. Um die AMS-API oder CLI zu installieren, rufen Sie die Seite Entwicklerressourcen der AMS-Konsole auf. Referenzmaterial zur AMS CM API oder AMS SKMS API finden Sie im Abschnitt AMS-Informationsressourcen im Benutzerhandbuch. Möglicherweise müssen Sie eine --profile Option für die Authentifizierung hinzufügen, aws amsskms ams-cli-command --profile SAML z. B. Möglicherweise müssen Sie die --region Option auch hinzufügen, da allen AMS-Befehlen beispielsweise us-east-1 ausgeht. aws amscm ams-cli-command --region=us-east-1