Image - Amazon AppStream 2.0

Image

Describes an image.

Contents

Name

The name of the image.

Type: String

Length Constraints: Minimum length of 1.

Required: Yes

Applications

The applications associated with the image.

Type: Array of Application objects

Required: No

AppstreamAgentVersion

The version of the AppStream 2.0 agent to use for instances that are launched from this image.

Type: String

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

Required: No

Arn

The ARN of the image.

Type: String

Pattern: ^arn:aws(?:\-cn|\-iso\-b|\-iso|\-us\-gov)?:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.\\-]{0,1023}$

Required: No

BaseImageArn

The ARN of the image from which this image was created.

Type: String

Pattern: ^arn:aws(?:\-cn|\-iso\-b|\-iso|\-us\-gov)?:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.\\-]{0,1023}$

Required: No

CreatedTime

The time the image was created.

Type: Timestamp

Required: No

Description

The description to display.

Type: String

Length Constraints: Minimum length of 1.

Required: No

DisplayName

The image name to display.

Type: String

Length Constraints: Minimum length of 1.

Required: No

ImageBuilderName

The name of the image builder that was used to create the private image. If the image is shared, this value is null.

Type: String

Length Constraints: Minimum length of 1.

Required: No

ImageBuilderSupported

Indicates whether an image builder can be launched from this image.

Type: Boolean

Required: No

ImageErrors

Describes the errors that are returned when a new image can't be created.

Type: Array of ResourceError objects

Required: No

ImagePermissions

The permissions to provide to the destination AWS account for the specified image.

Type: ImagePermissions object

Required: No

Platform

The operating system platform of the image.

Type: String

Valid Values: WINDOWS | WINDOWS_SERVER_2016 | WINDOWS_SERVER_2019 | WINDOWS_SERVER_2022 | AMAZON_LINUX2

Required: No

PublicBaseImageReleasedDate

The release date of the public base image. For private images, this date is the release date of the base image from which the image was created.

Type: Timestamp

Required: No

State

The image starts in the PENDING state. If image creation succeeds, the state is AVAILABLE. If image creation fails, the state is FAILED.

Type: String

Valid Values: PENDING | AVAILABLE | FAILED | COPYING | DELETING | CREATING | IMPORTING

Required: No

StateChangeReason

The reason why the last state change occurred.

Type: ImageStateChangeReason object

Required: No

Visibility

Indicates whether the image is public or private.

Type: String

Valid Values: PUBLIC | PRIVATE | SHARED

Required: No

See Also

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