List Image Builder components List component build versions Get component details Get component policy details

List and view component details

This section describes how you can find information and view details for the components that you use in your EC2 Image Builder recipes.

Component details

List Image Builder components
List component build versions
Get component details
Get component policy details

List Image Builder components

You can use one of the following methods to list and filter Image Builder components.

Console

To display a list of components in the AWS Management Console, follow these steps:

Open the EC2 Image Builder console at https://console.aws.amazon.com/imagebuilder/.
Select Components from the navigation pane. By default, Image Builder shows a list of components that your account owns.
You can optionally filter on component ownership. To see components that you don't own, but have access to, expand the owner type dropdown list and select one of the values. The owner type list is located in the search bar, next to the search text box. You can select from the following values:
- AWS Marketplace – Components that are associated directly with an AWS Marketplace product subscription.
- Quick start (Amazon managed) – Publicly available components that Amazon creates and maintains.
- Owned by me – Components that you created. This is the default selection.
- Shared with me – Components that others created and shared with you from their account.
- Third party managed – Components that a third party owns that you subscribed to in AWS Marketplace.

AWS CLI

The following example shows how to use the list-components command to return a list of Image Builder components that your account owns.


aws imagebuilder list-components

You can optionally filter on component ownership. The owner attribute defines who owns the components that you want to list. By default, this request returns a list of components that your account owns. To filter the results by component owner, specify one of the following values with the --owner parameter when you run the list-components command.

Component owner values

AWSMarketplace
Amazon
Self
Shared
ThirdParty

The following examples show the list-components command with the --owner parameter to filter results.


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

When you list components with the --owner AWSMarketplace value, you can filter the results by product code. Specify the productCodes filter with a value in the format marketplace:productCodeId, as shown in the following example:


aws imagebuilder list-components --owner AWSMarketplace --filters name=productCodes,values=marketplace:examplecode123

Note

Image Builder returns AWS Marketplace component ARNs under the aws-marketplace namespace, with an owner of AWSMarketplace. When you call get-component for an AWS Marketplace component, the response includes the owner but omits the component data. The component data is available only when the calling build instance is entitled to the product.

PowerShell

The following example shows how to use the Get-EC2IBComponentList cmdlet to return a list of Image Builder components that your account owns:


Get-EC2IBComponentList

You can optionally filter on component ownership. By default, this request returns a list of components that your account owns. To filter the results by component owner, choose one of the following values for the -Owner parameter:

Component owner values

AWSMarketplace
Amazon
Self
Shared
ThirdParty

The following examples use the Get-EC2IBComponentList cmdlet with the -Owner parameter to filter the results by component owner:


Get-EC2IBComponentList -Owner Self


Get-EC2IBComponentList -Owner Amazon


Get-EC2IBComponentList -Owner Shared


Get-EC2IBComponentList -Owner ThirdParty

When you list components with the -Owner AWSMarketplace value, you can filter the results by product code. Specify the productCodes filter with a value in the format marketplace:productCodeId, as shown in the following example:


Get-EC2IBComponentList -Owner AWSMarketplace `
    -Filter @{Name="productCodes";Values="marketplace:examplecode123"}

Note

Image Builder returns AWS Marketplace component ARNs under the aws-marketplace namespace, with an owner of AWSMarketplace. When you get the details for an AWS Marketplace component, the response includes the owner but omits the component data. The component data is available only when the calling build instance is entitled to the product.

List component build versions

Get component details

Get component policy details

Warning Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Document Conventions

Components

Use AWS Marketplace components