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: