Class GameServerContainerDefinition
- java.lang.Object
-
- software.amazon.awssdk.services.gamelift.model.GameServerContainerDefinition
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<GameServerContainerDefinition.Builder,GameServerContainerDefinition>
@Generated("software.amazon.awssdk:codegen") public final class GameServerContainerDefinition extends Object implements SdkPojo, Serializable, ToCopyableBuilder<GameServerContainerDefinition.Builder,GameServerContainerDefinition>
Describes the game server container in an existing game server container group. A game server container identifies a container image with your game server build. A game server container is automatically considered essential; if an essential container fails, the entire container group restarts.
You can update a container definition and deploy the updates to an existing fleet. When creating or updating a game server container group definition, use the property https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameServerContainerDefinitionInput.
Part of: ContainerGroupDefinition
Returned by: DescribeContainerGroupDefinition, ListContainerGroupDefinitions, UpdateContainerGroupDefinition
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceGameServerContainerDefinition.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static GameServerContainerDefinition.Builderbuilder()StringcontainerName()The container definition identifier.List<ContainerDependency>dependsOn()Indicates that the container relies on the status of other containers in the same container group during startup and shutdown sequences.List<ContainerEnvironment>environmentOverride()A set of environment variables that's passed to the container on startup.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasDependsOn()For responses, this returns true if the service returned a value for the DependsOn property.booleanhasEnvironmentOverride()For responses, this returns true if the service returned a value for the EnvironmentOverride property.inthashCode()booleanhasMountPoints()For responses, this returns true if the service returned a value for the MountPoints property.StringimageUri()The URI to the image that Amazon GameLift uses when deploying this container to a container fleet.List<ContainerMountPoint>mountPoints()A mount point that binds a path inside the container to a file or directory on the host system and lets it access the file or directory.ContainerPortConfigurationportConfiguration()The set of ports that are available to bind to processes in the container.StringresolvedImageDigest()A unique and immutable identifier for the container image.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends GameServerContainerDefinition.Builder>serializableBuilderClass()StringserverSdkVersion()The Amazon GameLift server SDK version that the game server is integrated with.GameServerContainerDefinition.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
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
-
containerName
public final String containerName()
The container definition identifier. Container names are unique within a container group definition.
- Returns:
- The container definition identifier. Container names are unique within a container group definition.
-
hasDependsOn
public final boolean hasDependsOn()
For responses, this returns true if the service returned a value for the DependsOn 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.
-
dependsOn
public final List<ContainerDependency> dependsOn()
Indicates that the container relies on the status of other containers in the same container group during startup and shutdown sequences. A container might have dependencies on multiple containers.
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
hasDependsOn()method.- Returns:
- Indicates that the container relies on the status of other containers in the same container group during startup and shutdown sequences. A container might have dependencies on multiple containers.
-
hasMountPoints
public final boolean hasMountPoints()
For responses, this returns true if the service returned a value for the MountPoints 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.
-
mountPoints
public final List<ContainerMountPoint> mountPoints()
A mount point that binds a path inside the container to a file or directory on the host system and lets it access the file or directory.
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
hasMountPoints()method.- Returns:
- A mount point that binds a path inside the container to a file or directory on the host system and lets it access the file or directory.
-
hasEnvironmentOverride
public final boolean hasEnvironmentOverride()
For responses, this returns true if the service returned a value for the EnvironmentOverride 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.
-
environmentOverride
public final List<ContainerEnvironment> environmentOverride()
A set of environment variables that's passed to the container on startup. See the ContainerDefinition::environment parameter in the Amazon Elastic Container Service API Reference.
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
hasEnvironmentOverride()method.- Returns:
- A set of environment variables that's passed to the container on startup. See the ContainerDefinition::environment parameter in the Amazon Elastic Container Service API Reference.
-
imageUri
public final String imageUri()
The URI to the image that Amazon GameLift uses when deploying this container to a container fleet. For a more specific identifier, see
ResolvedImageDigest.- Returns:
- The URI to the image that Amazon GameLift uses when deploying this container to a container fleet. For a
more specific identifier, see
ResolvedImageDigest.
-
portConfiguration
public final ContainerPortConfiguration portConfiguration()
The set of ports that are available to bind to processes in the container. For example, a game server process requires a container port to allow game clients to connect to it. Container ports aren't directly accessed by inbound traffic. Amazon GameLift maps these container ports to externally accessible connection ports, which are assigned as needed from the container fleet's
ConnectionPortRange.- Returns:
- The set of ports that are available to bind to processes in the container. For example, a game server
process requires a container port to allow game clients to connect to it. Container ports aren't directly
accessed by inbound traffic. Amazon GameLift maps these container ports to externally accessible
connection ports, which are assigned as needed from the container fleet's
ConnectionPortRange.
-
resolvedImageDigest
public final String resolvedImageDigest()
A unique and immutable identifier for the container image. The digest is a SHA 256 hash of the container image manifest.
- Returns:
- A unique and immutable identifier for the container image. The digest is a SHA 256 hash of the container image manifest.
-
serverSdkVersion
public final String serverSdkVersion()
The Amazon GameLift server SDK version that the game server is integrated with. Only game servers using 5.2.0 or higher are compatible with container fleets.
- Returns:
- The Amazon GameLift server SDK version that the game server is integrated with. Only game servers using 5.2.0 or higher are compatible with container fleets.
-
toBuilder
public GameServerContainerDefinition.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<GameServerContainerDefinition.Builder,GameServerContainerDefinition>
-
builder
public static GameServerContainerDefinition.Builder builder()
-
serializableBuilderClass
public static Class<? extends GameServerContainerDefinition.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
-
-