本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

AWS Managed Services (AMS) API 与其他 AWS 服务类似。 APIs 您可以在 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、部署新实例、更新和删除实例、获取相关信息以及创建 AMIs。 CTsHTTP 终端节点是：

  `https://amscm.us-east-1.amazonaws.com`
+ SKMS：使用此 API 获取有关您的基础架构的信息，包括 VPCs堆栈、子网和。 AMIsHTTP 终端节点是：

  `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、mac [O](https://docs.aws.amazon.com/cli/latest/userguide/cli-install-macos.html) S](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html)、[虚拟](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-virtualenv.html)环境、[捆绑安装程序（Linux、macOS 或 Unix](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-bundle.html)）的说明。

   安装完成后，运行`aws help`以验证安装。

1. 安装 AWS CLI 后，要安装或升级 AMS CLI，请下载 AMS AMS C **LI 或 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。
   + 软件开发工具包压缩包：提供所有 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** 目录及其内容必须与.sh 文件位于同一个目录中。AWSManagedServices\$1InstallCLI**

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`