Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Component - EC2 Image Builder

Component

A detailed view of a component.

Contents

arn

The Amazon Resource Name (ARN) of the component.

Type: String

Pattern: ^arn:aws[^:]*:imagebuilder:[^:]+:(?:[0-9]{12}|aws(?:-[a-z-]+)?):(?:image-recipe|container-recipe|infrastructure-configuration|distribution-configuration|component|image|image-pipeline|lifecycle-policy|workflow\/(?:build|test|distribution))/[a-z0-9-_]+(?:/(?:(?:x|[0-9]+)\.(?:x|[0-9]+)\.(?:x|[0-9]+))(?:/[0-9]+)?)?$

Required: No

changeDescription

Describes what change has been made in this version of the component, or what makes this version different from other versions of the component.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

data

Component data contains the YAML document content for the component.

Type: String

Required: No

dateCreated

The date that Image Builder created the component.

Type: String

Required: No

description

The description of the component.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

encrypted

The encryption status of the component.

Type: Boolean

Required: No

kmsKeyId

The KMS key identifier used to encrypt the component.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

name

The name of the component.

Type: String

Pattern: ^[-_A-Za-z-0-9][-_A-Za-z0-9 ]{1,126}[-_A-Za-z-0-9]$

Required: No

obfuscate

Indicates whether component source is hidden from view in the console, and from component detail results for API, CLI, or SDK operations.

Type: Boolean

Required: No

owner

The owner of the component.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

parameters

Contains parameter details for each of the parameters that the component document defined for the component.

Type: Array of ComponentParameterDetail objects

Required: No

platform

The operating system platform of the component.

Type: String

Valid Values: Windows | Linux | macOS

Required: No

productCodes

Contains product codes that are used for billing purposes for AWS Marketplace components.

Type: Array of ProductCodeListItem objects

Required: No

publisher

Contains the name of the publisher if this is a third-party component. Otherwise, this property is empty.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

state

Describes the current status of the component.

Type: ComponentState object

Required: No

supportedOsVersions

The operating system (OS) version supported by the component. If the OS information is available, Image Builder performs a prefix match against the base image OS version during image recipe creation.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 25 items.

Length Constraints: Minimum length of 1.

Required: No

tags

The tags that apply to the component.

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Key Pattern: ^(?!aws:)[a-zA-Z+-=._:/]+$

Value Length Constraints: Maximum length of 256.

Required: No

type

The component type specifies whether Image Builder uses the component to build the image or only to test it.

Type: String

Valid Values: BUILD | TEST

Required: No

version

The version of the component.

Type: String

Pattern: ^[0-9]+\.[0-9]+\.[0-9]+$

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.