Skip to content

/AWS1/CL_IMGCOMPONENTVERSION

The defining characteristics of a specific version of an Amazon Web Services TOE component.

CONSTRUCTOR

IMPORTING

Optional arguments:

iv_arn TYPE /AWS1/IMGIMAGEBUILDERARN /AWS1/IMGIMAGEBUILDERARN

The Amazon Resource Name (ARN) of the component.

Semantic versioning is included in each object's Amazon Resource Name (ARN), at the level that applies to that object as follows:

  1. Versionless ARNs and Name ARNs do not include specific values in any of the nodes. The nodes are either left off entirely, or they are specified as wildcards, for example: x.x.x.

  2. Version ARNs have only the first three nodes: ..

  3. Build version ARNs have all four nodes, and point to a specific build for a specific version of an object.

iv_name TYPE /AWS1/IMGRESOURCENAME /AWS1/IMGRESOURCENAME

The name of the component.

iv_version TYPE /AWS1/IMGVERSIONNUMBER /AWS1/IMGVERSIONNUMBER

The semantic version of the component.

The semantic version has four nodes: ../. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the base image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

iv_description TYPE /AWS1/IMGNONEMPTYSTRING /AWS1/IMGNONEMPTYSTRING

The description of the component.

iv_platform TYPE /AWS1/IMGPLATFORM /AWS1/IMGPLATFORM

The platform of the component.

it_supportedosversions TYPE /AWS1/CL_IMGOSVERSIONLIST_W=>TT_OSVERSIONLIST TT_OSVERSIONLIST

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

iv_type TYPE /AWS1/IMGCOMPONENTTYPE /AWS1/IMGCOMPONENTTYPE

The type of the component denotes whether the component is used to build the image or only to test it.

iv_owner TYPE /AWS1/IMGNONEMPTYSTRING /AWS1/IMGNONEMPTYSTRING

The owner of the component.

iv_datecreated TYPE /AWS1/IMGDATETIME /AWS1/IMGDATETIME

The date that the component was created.

iv_status TYPE /AWS1/IMGCOMPONENTSTATUS /AWS1/IMGCOMPONENTSTATUS

Describes the current status of the component version.

it_productcodes TYPE /AWS1/CL_IMGPRODUCTCODELSTITEM=>TT_PRODUCTCODELIST TT_PRODUCTCODELIST

Contains product codes that are used for billing purposes for Amazon Web Services Marketplace components.


Queryable Attributes

arn

The Amazon Resource Name (ARN) of the component.

Semantic versioning is included in each object's Amazon Resource Name (ARN), at the level that applies to that object as follows:

  1. Versionless ARNs and Name ARNs do not include specific values in any of the nodes. The nodes are either left off entirely, or they are specified as wildcards, for example: x.x.x.

  2. Version ARNs have only the first three nodes: ..

  3. Build version ARNs have all four nodes, and point to a specific build for a specific version of an object.

Accessible with the following methods

Method Description
GET_ARN() Getter for ARN, with configurable default
ASK_ARN() Getter for ARN w/ exceptions if field has no value
HAS_ARN() Determine if ARN has a value

name

The name of the component.

Accessible with the following methods

Method Description
GET_NAME() Getter for NAME, with configurable default
ASK_NAME() Getter for NAME w/ exceptions if field has no value
HAS_NAME() Determine if NAME has a value

version

The semantic version of the component.

The semantic version has four nodes: ../. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the base image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

Accessible with the following methods

Method Description
GET_VERSION() Getter for VERSION, with configurable default
ASK_VERSION() Getter for VERSION w/ exceptions if field has no value
HAS_VERSION() Determine if VERSION has a value

description

The description of the component.

Accessible with the following methods

Method Description
GET_DESCRIPTION() Getter for DESCRIPTION, with configurable default
ASK_DESCRIPTION() Getter for DESCRIPTION w/ exceptions if field has no value
HAS_DESCRIPTION() Determine if DESCRIPTION has a value

platform

The platform of the component.

Accessible with the following methods

Method Description
GET_PLATFORM() Getter for PLATFORM, with configurable default
ASK_PLATFORM() Getter for PLATFORM w/ exceptions if field has no value
HAS_PLATFORM() Determine if PLATFORM has a value

supportedOsVersions

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

Accessible with the following methods

Method Description
GET_SUPPORTEDOSVERSIONS() Getter for SUPPORTEDOSVERSIONS, with configurable default
ASK_SUPPORTEDOSVERSIONS() Getter for SUPPORTEDOSVERSIONS w/ exceptions if field has no
HAS_SUPPORTEDOSVERSIONS() Determine if SUPPORTEDOSVERSIONS has a value

type

The type of the component denotes whether the component is used to build the image or only to test it.

Accessible with the following methods

Method Description
GET_TYPE() Getter for TYPE, with configurable default
ASK_TYPE() Getter for TYPE w/ exceptions if field has no value
HAS_TYPE() Determine if TYPE has a value

owner

The owner of the component.

Accessible with the following methods

Method Description
GET_OWNER() Getter for OWNER, with configurable default
ASK_OWNER() Getter for OWNER w/ exceptions if field has no value
HAS_OWNER() Determine if OWNER has a value

dateCreated

The date that the component was created.

Accessible with the following methods

Method Description
GET_DATECREATED() Getter for DATECREATED, with configurable default
ASK_DATECREATED() Getter for DATECREATED w/ exceptions if field has no value
HAS_DATECREATED() Determine if DATECREATED has a value

status

Describes the current status of the component version.

Accessible with the following methods

Method Description
GET_STATUS() Getter for STATUS, with configurable default
ASK_STATUS() Getter for STATUS w/ exceptions if field has no value
HAS_STATUS() Determine if STATUS has a value

productCodes

Contains product codes that are used for billing purposes for Amazon Web Services Marketplace components.

Accessible with the following methods

Method Description
GET_PRODUCTCODES() Getter for PRODUCTCODES, with configurable default
ASK_PRODUCTCODES() Getter for PRODUCTCODES w/ exceptions if field has no value
HAS_PRODUCTCODES() Determine if PRODUCTCODES has a value

Public Local Types In This Class

Internal table types, representing arrays and maps of this class, are defined as local types:

TT_COMPONENTVERSIONLIST

TYPES TT_COMPONENTVERSIONLIST TYPE STANDARD TABLE OF REF TO /AWS1/CL_IMGCOMPONENTVERSION WITH DEFAULT KEY
.