本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 列出并查看组件详细信息
本节介绍如何查找您在 EC2 Image Builder 配方中使用的组件的信息并查看其详细信息。
**Topics**
+ [列出 Image Builder 组件](#list-components)
+ [列出来自的组件编译版本 AWS CLI](#cli-list-component-versions)
+ [从中获取组件详细信息 AWS CLI](#cli-get-component)
+ [从中获取组件策略的详细信息 AWS CLI](#cli-get-component-policy)
## 列出 Image Builder 组件
您可以使用以下方法之一列出和筛选 Image Builder 组件。
------
#### [ AWS 管理控制台 ]
要在中显示组件列表 AWS 管理控制台，请执行以下步骤：
1. 打开 EC2 Image Builder 控制台，网址为[https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。
1. 在导航窗格中选择**组件**。默认情况下，Image Builder 会显示您的账户拥有的组件列表。
1. 您可以选择根据组件所有权进行筛选。要查看您不拥有但可以访问的组件，请展开所有者类型下拉列表并选择其中一个值。所有者类型列表位于搜索栏中的搜索文本框旁边。可以选择以下值：
+ **AWS Marketplace**— 与 AWS Marketplace 产品订阅直接关联的组件。
+ **快速入门（Amazon 托管）**— Amazon 创建和维护的公开可用组件。
+ **我拥有的** — 您创建的组件。这是默认选择。
+ **与我共享** — 其他人通过其账户创建并与您共享的组件。
+ **第三方管理** — 您订阅的第三方拥有的组件。 AWS Marketplace
------
#### [ AWS CLI ]
以下示例说明如何使用 **[list-components](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-components.html)** 命令返回您的账户拥有的 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
```
------
## 列出来自的组件编译版本 AWS CLI
以下示例说明了如何使用 **[list-component-build-versions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-component-build-versions.html)** 命令列出具有特定语义版本的组件构建版本。要了解有关 Image Builder 资源的语义版本控制的更多信息，请参阅[Image Builder 中的语义版本控制](ibhow-semantic-versioning.md)。
```
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component.html)** 命令获取组件详细信息。
```
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component-policy.html)** 命令获取组件策略的详细信息。
```
aws imagebuilder get-component-policy --component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1
```