Class Image
- java.lang.Object
-
- software.amazon.awssdk.services.appstream.model.Image
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<Image.Builder,Image>
@Generated("software.amazon.awssdk:codegen") public final class Image extends Object implements SdkPojo, Serializable, ToCopyableBuilder<Image.Builder,Image>
Describes an image.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceImage.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description List<Application>applications()The applications associated with the image.StringappstreamAgentVersion()The version of the AppStream 2.0 agent to use for instances that are launched from this image.Stringarn()The ARN of the image.StringbaseImageArn()The ARN of the image from which this image was created.static Image.Builderbuilder()InstantcreatedTime()The time the image was created.Stringdescription()The description to display.StringdisplayName()The image name to display.DynamicAppProvidersEnableddynamicAppProvidersEnabled()Indicates whether dynamic app providers are enabled within an AppStream 2.0 image or not.StringdynamicAppProvidersEnabledAsString()Indicates whether dynamic app providers are enabled within an AppStream 2.0 image or not.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasApplications()For responses, this returns true if the service returned a value for the Applications property.inthashCode()booleanhasImageErrors()For responses, this returns true if the service returned a value for the ImageErrors property.booleanhasSupportedInstanceFamilies()For responses, this returns true if the service returned a value for the SupportedInstanceFamilies property.StringimageBuilderName()The name of the image builder that was used to create the private image.BooleanimageBuilderSupported()Indicates whether an image builder can be launched from this image.List<ResourceError>imageErrors()Describes the errors that are returned when a new image can't be created.ImagePermissionsimagePermissions()The permissions to provide to the destination AWS account for the specified image.ImageSharedWithOthersimageSharedWithOthers()Indicates whether the image is shared with another account ID.StringimageSharedWithOthersAsString()Indicates whether the image is shared with another account ID.LatestAppstreamAgentVersionlatestAppstreamAgentVersion()Indicates whether the image is using the latest AppStream 2.0 agent version or not.StringlatestAppstreamAgentVersionAsString()Indicates whether the image is using the latest AppStream 2.0 agent version or not.Stringname()The name of the image.PlatformTypeplatform()The operating system platform of the image.StringplatformAsString()The operating system platform of the image.InstantpublicBaseImageReleasedDate()The release date of the public base image.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends Image.Builder>serializableBuilderClass()ImageStatestate()The image starts in thePENDINGstate.StringstateAsString()The image starts in thePENDINGstate.ImageStateChangeReasonstateChangeReason()The reason why the last state change occurred.List<String>supportedInstanceFamilies()The supported instances families that determine which image a customer can use when the customer launches a fleet or image builder.Image.BuildertoBuilder()StringtoString()Returns a string representation of this object.VisibilityTypevisibility()Indicates whether the image is public or private.StringvisibilityAsString()Indicates whether the image is public or private.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
name
public final String name()
The name of the image.
- Returns:
- The name of the image.
-
arn
public final String arn()
The ARN of the image.
- Returns:
- The ARN of the image.
-
baseImageArn
public final String baseImageArn()
The ARN of the image from which this image was created.
- Returns:
- The ARN of the image from which this image was created.
-
displayName
public final String displayName()
The image name to display.
- Returns:
- The image name to display.
-
state
public final ImageState state()
The image starts in the
PENDINGstate. If image creation succeeds, the state isAVAILABLE. If image creation fails, the state isFAILED.If the service returns an enum value that is not available in the current SDK version,
statewill returnImageState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstateAsString().- Returns:
- The image starts in the
PENDINGstate. If image creation succeeds, the state isAVAILABLE. If image creation fails, the state isFAILED. - See Also:
ImageState
-
stateAsString
public final String stateAsString()
The image starts in the
PENDINGstate. If image creation succeeds, the state isAVAILABLE. If image creation fails, the state isFAILED.If the service returns an enum value that is not available in the current SDK version,
statewill returnImageState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstateAsString().- Returns:
- The image starts in the
PENDINGstate. If image creation succeeds, the state isAVAILABLE. If image creation fails, the state isFAILED. - See Also:
ImageState
-
visibility
public final VisibilityType visibility()
Indicates whether the image is public or private.
If the service returns an enum value that is not available in the current SDK version,
visibilitywill returnVisibilityType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromvisibilityAsString().- Returns:
- Indicates whether the image is public or private.
- See Also:
VisibilityType
-
visibilityAsString
public final String visibilityAsString()
Indicates whether the image is public or private.
If the service returns an enum value that is not available in the current SDK version,
visibilitywill returnVisibilityType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromvisibilityAsString().- Returns:
- Indicates whether the image is public or private.
- See Also:
VisibilityType
-
imageBuilderSupported
public final Boolean imageBuilderSupported()
Indicates whether an image builder can be launched from this image.
- Returns:
- Indicates whether an image builder can be launched from this image.
-
imageBuilderName
public final String imageBuilderName()
The name of the image builder that was used to create the private image. If the image is shared, this value is null.
- Returns:
- The name of the image builder that was used to create the private image. If the image is shared, this value is null.
-
platform
public final PlatformType platform()
The operating system platform of the image.
If the service returns an enum value that is not available in the current SDK version,
platformwill returnPlatformType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromplatformAsString().- Returns:
- The operating system platform of the image.
- See Also:
PlatformType
-
platformAsString
public final String platformAsString()
The operating system platform of the image.
If the service returns an enum value that is not available in the current SDK version,
platformwill returnPlatformType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromplatformAsString().- Returns:
- The operating system platform of the image.
- See Also:
PlatformType
-
description
public final String description()
The description to display.
- Returns:
- The description to display.
-
stateChangeReason
public final ImageStateChangeReason stateChangeReason()
The reason why the last state change occurred.
- Returns:
- The reason why the last state change occurred.
-
hasApplications
public final boolean hasApplications()
For responses, this returns true if the service returned a value for the Applications property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
applications
public final List<Application> applications()
The applications associated with the image.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasApplications()method.- Returns:
- The applications associated with the image.
-
createdTime
public final Instant createdTime()
The time the image was created.
- Returns:
- The time the image was created.
-
publicBaseImageReleasedDate
public final Instant 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.
- Returns:
- 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.
-
appstreamAgentVersion
public final String appstreamAgentVersion()
The version of the AppStream 2.0 agent to use for instances that are launched from this image.
- Returns:
- The version of the AppStream 2.0 agent to use for instances that are launched from this image.
-
imagePermissions
public final ImagePermissions imagePermissions()
The permissions to provide to the destination AWS account for the specified image.
- Returns:
- The permissions to provide to the destination AWS account for the specified image.
-
hasImageErrors
public final boolean hasImageErrors()
For responses, this returns true if the service returned a value for the ImageErrors property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
imageErrors
public final List<ResourceError> imageErrors()
Describes the errors that are returned when a new image can't be created.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasImageErrors()method.- Returns:
- Describes the errors that are returned when a new image can't be created.
-
latestAppstreamAgentVersion
public final LatestAppstreamAgentVersion latestAppstreamAgentVersion()
Indicates whether the image is using the latest AppStream 2.0 agent version or not.
If the service returns an enum value that is not available in the current SDK version,
latestAppstreamAgentVersionwill returnLatestAppstreamAgentVersion.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromlatestAppstreamAgentVersionAsString().- Returns:
- Indicates whether the image is using the latest AppStream 2.0 agent version or not.
- See Also:
LatestAppstreamAgentVersion
-
latestAppstreamAgentVersionAsString
public final String latestAppstreamAgentVersionAsString()
Indicates whether the image is using the latest AppStream 2.0 agent version or not.
If the service returns an enum value that is not available in the current SDK version,
latestAppstreamAgentVersionwill returnLatestAppstreamAgentVersion.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromlatestAppstreamAgentVersionAsString().- Returns:
- Indicates whether the image is using the latest AppStream 2.0 agent version or not.
- See Also:
LatestAppstreamAgentVersion
-
hasSupportedInstanceFamilies
public final boolean hasSupportedInstanceFamilies()
For responses, this returns true if the service returned a value for the SupportedInstanceFamilies property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
supportedInstanceFamilies
public final List<String> 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
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSupportedInstanceFamilies()method.- Returns:
- 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
-
-
-
dynamicAppProvidersEnabled
public final DynamicAppProvidersEnabled dynamicAppProvidersEnabled()
Indicates whether dynamic app providers are enabled within an AppStream 2.0 image or not.
If the service returns an enum value that is not available in the current SDK version,
dynamicAppProvidersEnabledwill returnDynamicAppProvidersEnabled.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromdynamicAppProvidersEnabledAsString().- Returns:
- Indicates whether dynamic app providers are enabled within an AppStream 2.0 image or not.
- See Also:
DynamicAppProvidersEnabled
-
dynamicAppProvidersEnabledAsString
public final String dynamicAppProvidersEnabledAsString()
Indicates whether dynamic app providers are enabled within an AppStream 2.0 image or not.
If the service returns an enum value that is not available in the current SDK version,
dynamicAppProvidersEnabledwill returnDynamicAppProvidersEnabled.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromdynamicAppProvidersEnabledAsString().- Returns:
- Indicates whether dynamic app providers are enabled within an AppStream 2.0 image or not.
- See Also:
DynamicAppProvidersEnabled
-
imageSharedWithOthers
public final ImageSharedWithOthers imageSharedWithOthers()
Indicates whether the image is shared with another account ID.
If the service returns an enum value that is not available in the current SDK version,
imageSharedWithOtherswill returnImageSharedWithOthers.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromimageSharedWithOthersAsString().- Returns:
- Indicates whether the image is shared with another account ID.
- See Also:
ImageSharedWithOthers
-
imageSharedWithOthersAsString
public final String imageSharedWithOthersAsString()
Indicates whether the image is shared with another account ID.
If the service returns an enum value that is not available in the current SDK version,
imageSharedWithOtherswill returnImageSharedWithOthers.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromimageSharedWithOthersAsString().- Returns:
- Indicates whether the image is shared with another account ID.
- See Also:
ImageSharedWithOthers
-
toBuilder
public Image.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<Image.Builder,Image>
-
builder
public static Image.Builder builder()
-
serializableBuilderClass
public static Class<? extends Image.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-