Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

列出并查看组件详细信息

本节介绍如何查找您在 EC2 Image Builder 配方中使用的 EC2 Task Orchestrator and Executor (EC2 TOE) 组件的信息和查看详细信息。

列出 EC2 TOE 组件

您可以使用以下方法之一列出和筛选 EC2 TOE 组件。

Amazon Web Services Management Console

要在中显示组件列表 Amazon Web Services Management Console，请执行以下步骤：

1. 打开位于 https://console.aws.amazon.com/imagebuilder/的 EC2 Image Builder 控制台。

2. 在导航窗格中选择组件。默认情况下，Image Builder 会显示您的账户拥有的组件列表。

3. 您可以选择根据组件所有权进行筛选。要查看您不拥有但可以访问的组件，请展开所有者类型下拉列表并选择其中一个值。所有者类型列表位于搜索栏中的搜索文本框旁边。可以选择以下值：

   • 快速入门（Amazon 托管）— Amazon 创建和维护的公开可用组件。

   • 我拥有的 — 您创建的组件。这是默认选择。

   • 与我共享 — 其他人通过其账户创建并与您共享的组件。

   • 第三方管理 — 您订阅的第三方拥有的组件。 Amazon Web Services Marketplace

Amazon CLI

以下示例说明如何使用list-components命令返回您的账户拥有的 EC2 TOE 组件列表。

aws imagebuilder list-components

您可以选择根据组件所有权进行筛选。所有者属性定义您要列出的组件的拥有人。默认情况下，此请求会返回您的账户拥有的组件列表。要按组件所有者筛选结果，请在运行 list-components 命令时使用 --owner 参数指定以下值之一。

组件所有者的值

• 自身

• Amazon

• ThirdParty

• 共享

以下示例显示带有 --owner 参数的 list-components 命令，用于筛选结果。

aws imagebuilder list-components --owner Self
{
    "requestId": "012a3456-b789-01cd-e234-fa5678b9012b",
    "componentVersionList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/sample-component01/1.0.0",
            "name": "sample-component01",
            "version": "1.0.0",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2020-09-24T16:58:24.444Z"
        },
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/sample-component01/1.0.1",
            "name": "sample-component01",
            "version": "1.0.1",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2021-07-10T03:38:46.091Z"
        }
    ]
}

aws imagebuilder list-components --owner Amazon

aws imagebuilder list-components --owner Shared

aws imagebuilder list-components --owner ThirdParty

列出组件生成版本 (Amazon CLI)

以下示例说明了如何使用 list-component-build-versions 命令列出具有特定语义版本的组件构建版本。要了解有关 Image Builder 资源的语义版本控制的更多信息，请参阅Semantic 版本控制。

aws imagebuilder list-component-build-versions --component-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1
{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "componentSummaryList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/1.0.1/1",
            "name": "examplecomponent",
            "version": "1.0.1",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "description": "An example component that builds, validates and tests an image",
            "changeDescription": "Updated version.",
            "dateCreated": "2020-02-19T18:53:45.940Z",
            "tags": {
                "KeyName": "KeyValue"
            }
        }
    ]
}
		

获取组件详细信息 (Amazon CLI)

以下示例说明在指定组件的 Amazon 资源名称（ARN）时如何使用 get-component 命令获取组件详细信息。

aws imagebuilder get-component --component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1/1
			{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11112",
    "component": {
        "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/1.0.1/1",
        "name": "examplecomponent",
        "version": "1.0.1",
        "type": "BUILD",
        "platform": "Linux",
        "owner": "123456789012",
        "data": "name: HelloWorldTestingDocument\ndescription: This is hello world testing document... etc.\"\n",
        "encrypted": true,
        "dateCreated": "2020-09-24T16:58:24.444Z",
        "tags": {}
    }
}
		

获取组件策略详细信息 (Amazon CLI)

以下示例说明了在指定组件的 ARN 时如何使用 get-component-policy 命令获取组件策略的详细信息。

aws imagebuilder get-component-policy --component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1