列出并查看组件详细信息 - EC2 Image Builder
列出 Image Builder 组件列出来自的组件编译版本 Amazon CLI从中获取组件详细信息 Amazon CLI从中获取组件策略的详细信息 Amazon CLI
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

列出并查看组件详细信息

本节介绍如何查找在 I EC2 mage Builder 配方中使用的组件的信息并查看其详细信息。

列出 Image Builder 组件

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

Amazon Web Services Management Console

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

  1. 打开 EC2 Image Builder 控制台，网址为https://console.aws.amazon.com/imagebuilder/。

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

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

    • Amazon Web Services Marketplace— 与 Amazon Web Services Marketplace 产品订阅直接关联的组件。

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

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

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

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

Amazon CLI

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

aws imagebuilder list-components

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

组件所有者的值

  • AWSMarketplace

  • Amazon

  • Self

  • Shared

  • 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 资源的语义版本控制的更多信息，请参阅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"
            }
        }
    ]
}

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