使用 AMS API 和 CLI - AMS 高级用户指南
用于 REST 调用的 AMS API HTTP安装或升级 AMS CLI

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

使用 AMS API 和 CLI

AWS Managed Services (AMS) API 与其他 AWS 服务类似。 APIs 您可以在 AMS API 参考中阅读有关 AMS API 的信息。

用于 REST 调用的 AMS API HTTP

除此之外 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

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、mac O S、虚拟环境、捆绑安装程序（Linux、macOS 或 Unix）的说明。

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

  2. 安装 AWS CLI 后，要安装或升级 AMS CLI，请下载 AMS AMS C LI 或 AMS SDK 可分发文件 zip 文件并解压缩。您可以通过 AMS 控制台左侧导航栏中的开发者资源链接访问 AMS CLI 发行版。

  3. README 文件提供了任何安装的说明。

    打开任一选项：

    • CLI zip：仅提供 AMS CLI。

    • 软件开发工具包压缩包：提供所有 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 目录及其内容必须与.sh 文件位于同一个目录中。AWSManagedServices_InstallCLI

  4. 如果您的公司证书是通过与 AWS 的联合身份验证（AMS 默认配置）使用的，则必须安装可以访问您的联合身份验证服务的凭证管理工具。例如，您可以使用此 AWS 安全博客如何使用 SAML 2.0 和 AD FS 实现联合 API 和 CLI 访问来帮助配置您的凭证管理工具。

  5. 安装完成后，运行aws amscm helpaws 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