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

# 使用 AMS API 和 CLI
<a name="understand-sent-api"></a>

AWS Managed Services (AMS) API 與其他 APIs 類似。 AWS 您可以在 AMS API [參考中閱讀 AMS API](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/index.html)。

## REST 呼叫的 AMS API HTTP 端點
<a name="sent-api-endpoints"></a>

除了各種 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
<a name="install-sent-cli"></a>

AMS CLI 是與 AMS API 互動的簡單方法，用於本節的範例。如需 AWS CLI 和 AMS CLI 的使用慣例，請參閱[使用 AWS 命令列界面](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-using.html)。

如需安裝 SAML 的資訊，請參閱 [AD FS 宣告規則和 SAML 設定](adfs-claim-rule-saml.md)。

若要安裝或升級 AMS CLI，請遵循下列指示：
**注意**  
您必須擁有此程序的管理員登入資料。

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

1. 若要安裝 AWS CLI，請參閱[安裝 AWS 命令列界面](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)，並遵循適當的指示。請注意，在該頁面底部有使用不同安裝程式、[Linux](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-linux.html)、[MS Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html)、[macOS](https://docs.aws.amazon.com/cli/latest/userguide/cli-install-macos.html)、[虛擬環境](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-virtualenv.html)、 [Bundled Installer (Linux、macOS 或 Unix) ](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-bundle.html)的說明。

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

1. 安裝 AWS CLI 後，若要安裝或升級 AMS CLI，請下載 AMS **AMS CLI** 或 **AMS SDK** 可分發 zip 檔案並解壓縮。您可以透過 AMS 主控台左側導覽中的[https://console.aws.amazon.com/managedservices/developerResources](https://console.aws.amazon.com/managedservices/developerResources)連結來存取 AMS CLI 可分發項目。

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

   開啟：
   + CLI zip：僅提供 AMS CLI。
   + SDK zip：提供所有 AMS APIs和 AMS CLI。

   對於 **Windows**，請執行適當的安裝程式 （僅限 32 或 64 位元系統）：
   + 32 位元：**ManagedCloudAPI\$1x86.msi**
   + 64 位元：**ManagedCloudAPI\$1x64.msi**

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

1. 如果您的公司登入資料是透過 AWS (AMS 預設組態） 聯合使用，您必須安裝登入資料管理工具，以存取您的聯合服務。例如，您可以使用此 AWS 安全部落格 [ 如何使用 SAML 2.0 和 AD FS 實作聯合 API 和 CLI 存取](https://blogs.aws.amazon.com/security/post/Tx1LDN0UBGJJ26Q/How-to-Implement-Federated-API-and-CLI-Access-Using-SAML-2-0-and-AD-FS)，以協助設定憑證管理工具。

1. 安裝之後，請執行 `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`。