使用查询选项查找更改类型 - AMS 高级用户指南

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

使用查询选项查找更改类型

此示例演示如何使用 AMS 控制台查找要提交的 RFC 的相应更改类型。

您可以使用控制台或 API/CLI 来查找更改类型 ID (CT) 或版本。有两种方法，要么是搜索，要么是选择分类。对于这两种选择类型，您可以通过选择 “最常用”、“最近使用” 或 “按字母顺序” 对搜索进行排序。

YouTube 视频：如何使用 AWS Managed Services CLI 创建 RFC，在哪里可以找到 CT 架构？

在 AMS 控制台中，在 RFCs-> 创建 RFC 页面上：

  • 选择 “按更改类型浏览”（默认）后，可以：

    • 使用快速创建区域从 AMS 最受欢迎的 AMS 中进行选择 CTs。点击标签，将打开 “运行 RFC” 页面，并自动为您填充主题选项。根据需要完成其余选项，然后单击 “运行” 提交 RFC。

    • 或者，向下滚动到 “所有变更类型” 区域并开始在选项框中键入 CT 名称，您不必输入确切或完整的更改类型名称。您还可以通过输入相关词语按更改类型 ID、分类或执行模式（自动或手动）搜索 CT。

      选择默认卡片视图后，匹配的 CT 卡片会在您键入时出现，选择一张卡片并单击 “创建 RFC”。选择表格视图后，选择相关的 CT，然后单击 “创建 RFC”。两种方法都会打开 “运行 RFC” 页面。

  • 或者，要浏览更改类型选择，请单击页面顶部的按类别选择以打开一系列下拉选项框。

  • 选择 “类别”、“子类别”、“物料” 和 “工序”。该更改类型的信息框显示在页面底部显示一个面板。

  • 准备就绪后，按 Enter，将显示匹配的更改类型列表。

  • 从列表中选择更改类型。该更改类型的信息框出现在页面底部。

  • 选择正确的更改类型后，选择 “创建 RFC”。

注意

必须安装 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

注意

AMS API/CLI （amscm 和 amsskms）终端节点位于 AWS 弗吉尼亚北部区域。us-east-1根据您的身份验证设置方式以及您的账户和资源所在的 AWS 区域，您可能需要在发出命令--region us-east-1时进行添加。如果这是您的身份验证方法--profile saml，则可能还需要添加。

要使用 AMS CM API（参见 ListChangeTypeClassificationSummaries）或 CLI 搜索更改类型，请执行以下操作：

您可以使用筛选器或查询进行搜索。该 ListChangeTypeClassificationSummaries 操作具有Category、SubcategoryItem、和的 “筛选器” 选项Operation，但这些值必须与现有值完全匹配。要在使用 CLI 时获得更灵活的结果，可以使用--query选项。

使用 AMS CM API/CLI 更改类型筛选
属性 有效值 有效/默认条件 备注

ChangeTypeId

任何表示 a 的字符串 ChangeTypeId （例如：ct-abc123xyz7890）

Equals

有关更改类型 IDs，请参阅更改类型参考。

有关变更类型 IDs，请参阅查找变更类型或 CSIO。

类别

任何自由格式的文本

包含

不支持每个字段中的正则表达式。不区分大小写的搜索

子类别

Item

操作

  1. 以下是一些商品变更类型分类的示例：

    以下命令列出了所有更改类型类别。

    aws amscm list-change-type-categories

    以下命令列出了属于指定类别的子类别。

    aws amscm list-change-type-subcategories --category CATEGORY

    以下命令列出了属于指定类别和子类别的项目。

    aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY

  2. 以下是一些使用 CLI 查询搜索变更类型的示例：

    以下命令在 CT 分类摘要中搜索项目名称中包含 “S3” 的摘要，并以表格形式创建类别、子类别、项目、操作和更改类型 ID 的输出。

    aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
    +---------------------------------------------------------------+
|               ListChangeTypeClassificationSummaries           |
+----------+-------------------------+--+------+----------------+
|Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r|
+----------+-------------------------+--+------+----------------+

  3. 然后，您可以使用更改类型 ID 获取 CT 架构并检查参数。以下命令将架构输出到名为 creates3Params.schema.json 的 JSON 文件中。

    aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json

    有关使用 CLI 查询的信息，请参阅如何使用--query 选项过滤输出和查询语言参考JMESPath 规范。

  4. 获得变更类型 ID 后，我们建议您验证变更类型的版本，以确保它是最新版本。使用以下命令查找指定更改类型的版本：

    aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CHANGE_TYPE_ID

    要查找AutomationStatus特定更改类型的，请运行以下命令：

    aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"

    要查找ExpectedExecutionDurationInMinutes特定更改类型的，请运行以下命令：

    aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"