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
- DynamicAppProvidersEnabled
-
Indicates whether dynamic app providers are enabled within an AppStream 2.0 image or not.
Type: String
Valid Values:
ENABLED | DISABLED
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
-
Indicates whether the image is shared with another account ID.
Type: String
Valid Values:
TRUE | FALSE
Required: No
- LatestAppstreamAgentVersion
-
Indicates whether the image is using the latest AppStream 2.0 agent version or not.
Type: String
Valid Values:
TRUE | FALSE
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 | RHEL8 | ROCKY_LINUX8
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 isAVAILABLE
. If image creation fails, the state isFAILED
.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
- SupportedInstanceFamilies
-
The supported instances families that determine which image a customer can use when the customer launches a fleet or image builder. The following instances families are supported:
-
General Purpose
-
Compute Optimized
-
Memory Optimized
-
Graphics
-
Graphics Design
-
Graphics Pro
-
Graphics G4
-
Graphics G5
Type: Array of strings
Length Constraints: Minimum length of 1.
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: