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, copied, or updated by using Managed Image Updates, 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: