使用 AMS API 和 CLI - AMS 進階使用者指南
REST 呼叫的 AMS API HTTP 端點安裝或升級 AMS CLI

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 AMS API 和 CLI

AWS Managed Services (AMS) API 與其他 APIs 類似。 AWS 您可以在 AMS API 參考中閱讀 AMS API。

REST 呼叫的 AMS API HTTP 端點

除了各種 SDKs，AMS 還提供 CLI；您也可以針對 AMS 端點叫用 REST API 呼叫。

有兩個 AMS APIs （兩者的端點都位於 us-east-1)：

  • 變更管理：使用此 API 請求存取或變更您的基礎設施，包括建立和更新 RFCs、部署新執行個體、更新和刪除執行個體、取得 CTs的相關資訊，以及建立 AMIs。HTTP 端點為：

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

  • SKMS：使用此 API 取得基礎設施的相關資訊，包括 VPCs、堆疊、子網路和 AMIs。HTTP 端點為：

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

安裝或升級 AMS CLI

AMS CLI 是與 AMS API 互動的簡單方法，用於本節的範例。如需 AWS CLI 和 AMS CLI 的使用慣例，請參閱使用 AWS 命令列界面。

如需安裝 SAML 的資訊，請參閱 AD FS 宣告規則和 SAML 設定。

若要安裝或升級 AMS CLI，請遵循下列指示：

注意

您必須擁有此程序的管理員登入資料。

AWS CLI 是使用 AWS Managed Services (AMS) CLIs（變更管理和 SKMS) 的先決條件。

  1. 若要安裝 AWS CLI，請參閱安裝 AWS 命令列界面，並遵循適當的指示。請注意，在該頁面底部有使用不同安裝程式、Linux、MS Windows、macOS、虛擬環境、 Bundled Installer (Linux、macOS 或 Unix) 的說明。

    安裝之後，請執行 aws help來驗證安裝。

  2. 安裝 AWS CLI 後，若要安裝或升級 AMS CLI，請下載 AMS AMS CLI 或 AMS SDK 可分發 zip 檔案並解壓縮。您可以透過 AMS 主控台左側導覽中的開發人員資源連結來存取 AMS CLI 可分發項目。

  3. README 檔案提供任何安裝的指示。

    開啟：

    • CLI zip：僅提供 AMS CLI。

    • SDK zip：提供所有 AMS APIs和 AMS CLI。

    對於 Windows，請執行適當的安裝程式 （僅限 32 或 64 位元系統）：

    • 32 位元：ManagedCloudAPI_x86.msi

    • 64 位元：ManagedCloudAPI_x64.msi

    對於 Mac/Linux，執行此命令以執行名為 AWSManagedServices_InstallCLI.sh 的檔案：sh AWSManagedServices_InstallCLI.sh。請注意，amscm 和 amsskms 目錄及其內容必須與 AWSManagedServices_InstallCLI.sh 檔案位於相同的目錄中。

  4. 如果您的公司登入資料是透過 AWS (AMS 預設組態） 聯合使用，您必須安裝登入資料管理工具，以存取您的聯合服務。例如，您可以使用此 AWS 安全部落格 如何使用 SAML 2.0 和 AD FS 實作聯合 API 和 CLI 存取，以協助設定憑證管理工具。

  5. 安裝之後，請執行 aws amscm help和 aws amsskms help 以查看命令和選項。

    注意

    必須安裝 AMS CLI，這些命令才能運作。若要安裝 AMS API 或 CLI，請前往 AMS 主控台開發人員資源頁面。如需 AMS CM API 或 AMS SKMS API 的參考資料，請參閱《 使用者指南》中的 AMS 資訊資源一節。您可能需要新增身分驗證--profile選項，例如 aws amsskms ams-cli-command --profile SAML。您可能還需要新增 --region選項，因為所有 AMS 命令都用盡 us-east-1；例如 aws amscm ams-cli-command --region=us-east-1。