Class EksContainerDetail
- All Implemented Interfaces:
Serializable
,SdkPojo
,ToCopyableBuilder<EksContainerDetail.Builder,
EksContainerDetail>
The details for container properties that are returned by DescribeJobs
for jobs that use Amazon EKS.
- See Also:
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionargs()
An array of arguments to the entrypoint.static EksContainerDetail.Builder
builder()
command()
The entrypoint for the container.env()
The environment variables to pass to a container.final boolean
final boolean
equalsBySdkFields
(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.final Integer
exitCode()
The exit code returned for the job attempt.final <T> Optional
<T> getValueForField
(String fieldName, Class<T> clazz) final boolean
hasArgs()
For responses, this returns true if the service returned a value for the Args property.final boolean
For responses, this returns true if the service returned a value for the Command property.final boolean
hasEnv()
For responses, this returns true if the service returned a value for the Env property.final int
hashCode()
final boolean
For responses, this returns true if the service returned a value for the VolumeMounts property.final String
image()
The Docker image used to start the container.final String
The image pull policy for the container.final String
name()
The name of the container.final String
reason()
A short human-readable string to provide additional details for a running or stopped container.The type and amount of resources to assign to a container.The security context for a job.static Class
<? extends EksContainerDetail.Builder> Take this object and create a builder that contains all of the current property values of this object.final String
toString()
Returns a string representation of this object.final List
<EksContainerVolumeMount> The volume mounts for the container.Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
name
The name of the container. If the name isn't specified, the default name "
Default
" is used. Each container in a pod must have a unique name.- Returns:
- The name of the container. If the name isn't specified, the default name "
Default
" is used. Each container in a pod must have a unique name.
-
image
The Docker image used to start the container.
- Returns:
- The Docker image used to start the container.
-
imagePullPolicy
The image pull policy for the container. Supported values are
Always
,IfNotPresent
, andNever
. This parameter defaults toAlways
if the:latest
tag is specified,IfNotPresent
otherwise. For more information, see Updating images in the Kubernetes documentation.- Returns:
- The image pull policy for the container. Supported values are
Always
,IfNotPresent
, andNever
. This parameter defaults toAlways
if the:latest
tag is specified,IfNotPresent
otherwise. For more information, see Updating images in the Kubernetes documentation.
-
hasCommand
public final boolean hasCommand()For responses, this returns true if the service returned a value for the Command 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. -
command
The entrypoint for the container. For more information, see Entrypoint in the Kubernetes documentation.
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
hasCommand()
method.- Returns:
- The entrypoint for the container. For more information, see Entrypoint in the Kubernetes documentation.
-
hasArgs
public final boolean hasArgs()For responses, this returns true if the service returned a value for the Args 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. -
args
An array of arguments to the entrypoint. If this isn't specified, the
CMD
of the container image is used. This corresponds to theargs
member in the Entrypoint portion of the Pod in Kubernetes. Environment variable references are expanded using the container's environment.If the referenced environment variable doesn't exist, the reference in the command isn't changed. For example, if the reference is to "
$(NAME1)
" and theNAME1
environment variable doesn't exist, the command string will remain "$(NAME1)
".$$
is replaced with$
and the resulting string isn't expanded. For example,$$(VAR_NAME)
is passed as$(VAR_NAME)
whether or not theVAR_NAME
environment variable exists. For more information, see Dockerfile reference: CMD and Define a command and arguments for a pod in the Kubernetes documentation.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
hasArgs()
method.- Returns:
- An array of arguments to the entrypoint. If this isn't specified, the
CMD
of the container image is used. This corresponds to theargs
member in the Entrypoint portion of the Pod in Kubernetes. Environment variable references are expanded using the container's environment.If the referenced environment variable doesn't exist, the reference in the command isn't changed. For example, if the reference is to "
$(NAME1)
" and theNAME1
environment variable doesn't exist, the command string will remain "$(NAME1)
".$$
is replaced with$
and the resulting string isn't expanded. For example,$$(VAR_NAME)
is passed as$(VAR_NAME)
whether or not theVAR_NAME
environment variable exists. For more information, see Dockerfile reference: CMD and Define a command and arguments for a pod in the Kubernetes documentation.
-
hasEnv
public final boolean hasEnv()For responses, this returns true if the service returned a value for the Env 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. -
env
The environment variables to pass to a container.
Environment variables cannot start with "
AWS_BATCH
". This naming convention is reserved for variables that Batch sets.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
hasEnv()
method.- Returns:
- The environment variables to pass to a container.
Environment variables cannot start with "
AWS_BATCH
". This naming convention is reserved for variables that Batch sets.
-
resources
The type and amount of resources to assign to a container. The supported resources include
memory
,cpu
, andnvidia.com/gpu
. For more information, see Resource management for pods and containers in the Kubernetes documentation.- Returns:
- The type and amount of resources to assign to a container. The supported resources include
memory
,cpu
, andnvidia.com/gpu
. For more information, see Resource management for pods and containers in the Kubernetes documentation.
-
exitCode
The exit code returned for the job attempt. A non-zero exit code is considered failed.
- Returns:
- The exit code returned for the job attempt. A non-zero exit code is considered failed.
-
reason
A short human-readable string to provide additional details for a running or stopped container. It can be up to 255 characters long.
- Returns:
- A short human-readable string to provide additional details for a running or stopped container. It can be up to 255 characters long.
-
hasVolumeMounts
public final boolean hasVolumeMounts()For responses, this returns true if the service returned a value for the VolumeMounts 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. -
volumeMounts
The volume mounts for the container. Batch supports
emptyDir
,hostPath
, andsecret
volume types. For more information about volumes and volume mounts in Kubernetes, see Volumes in the Kubernetes documentation.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
hasVolumeMounts()
method.- Returns:
- The volume mounts for the container. Batch supports
emptyDir
,hostPath
, andsecret
volume types. For more information about volumes and volume mounts in Kubernetes, see Volumes in the Kubernetes documentation.
-
securityContext
The security context for a job. For more information, see Configure a security context for a pod or container in the Kubernetes documentation.
- Returns:
- The security context for a job. For more information, see Configure a security context for a pod or container in the Kubernetes documentation.
-
toBuilder
Description copied from interface:ToCopyableBuilder
Take this object and create a builder that contains all of the current property values of this object.- Specified by:
toBuilder
in interfaceToCopyableBuilder<EksContainerDetail.Builder,
EksContainerDetail> - Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
-
equals
-
equalsBySdkFields
Description copied from interface:SdkPojo
Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in anSdkPojo
class, and is generated based on a service model.If an
SdkPojo
class does not have any inherited fields,equalsBySdkFields
andequals
are essentially the same.- Specified by:
equalsBySdkFields
in interfaceSdkPojo
- Parameters:
obj
- the object to be compared with- Returns:
- true if the other object equals to this object by sdk fields, false otherwise.
-
toString
-
getValueForField
-
sdkFields
-
sdkFieldNameToField
- Specified by:
sdkFieldNameToField
in interfaceSdkPojo
- Returns:
- The mapping between the field name and its corresponding field.
-