列出并查看组件详细信息

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

列出 AWSTOE 组件

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

AWS Management Console

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

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

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

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

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

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

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

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

AWS CLI

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

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

列出来自的组件编译版本 AWS CLI

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

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"
            }
        }
    ]
}
		

从中获取组件详细信息 AWS 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": {}
    }
}
		

从中获取组件策略的详细信息 AWS 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