翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# コンポーネントの詳細を一覧表示して表示する
このセクションでは、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. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/) で、EC2 Image Builder コンソールを開きます。
1. ナビゲーションペインから **コンポーネント** を選択します。デフォルトでは、Image Builder にはアカウントが所有するコンポーネントのリストが表示されます。
1. オプションでコンポーネントの所有権でフィルタリングできます。自分が所有していないがアクセスできるコンポーネントを表示するには、所有者タイプドロップダウンリストを展開し、いずれかの値を選択します。所有者タイプリストは、検索バーの検索テキストボックスの横にあります。次の値から選択できます。
+ **AWS Marketplace** – AWS Marketplace 製品サブスクリプションに直接関連付けられているコンポーネント。
+ **クイックスタート（Amazon マネージド）** - Amazon が作成管理する一般公開されているコンポーネント。
+ **Owned by me** - あなたが作成したコンポーネント。デフォルトではこれが選択されています。
+ **Shared with me** - 他人が作成し、自分のアカウントからあなたと共有したコンポーネント。
+ **サードパーティー管理** – ユーザーがサブスクライブしたサードパーティーが所有するコンポーネント 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
```
オプションでコンポーネントの所有権でフィルタリングできます。owner 属性は、一覧表示するコンポーネントの所有者を定義します。デフォルトでは、このリクエストはアカウントが所有するコンポーネントのリストを返します。`--owner` コンポーネント所有者別に結果をフィルタリングするには、**list-components** コマンドを実行するときにパラメータで次の値のいずれかを指定します。
**コンポーネントオーナーの値**
+ `AWSMarketplace`
+ `Amazon`
+ `Self`
+ `Shared`
+ `ThirdParty`
以下の例では、**list-components**コマンドに`--owner`パラメータを付けて結果をフィルタリングしている。
```
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
次の例は、コンポーネントの Amazon リソースネーム (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
```