Class EcsTaskProperties
- java.lang.Object
-
- software.amazon.awssdk.services.batch.model.EcsTaskProperties
-
- All Implemented Interfaces:
Serializable
,SdkPojo
,ToCopyableBuilder<EcsTaskProperties.Builder,EcsTaskProperties>
@Generated("software.amazon.awssdk:codegen") public final class EcsTaskProperties extends Object implements SdkPojo, Serializable, ToCopyableBuilder<EcsTaskProperties.Builder,EcsTaskProperties>
The properties for a task definition that describes the container and volume definitions of an Amazon ECS task. You can specify which Docker images to use, the required resources, and other configurations related to launching the task definition through an Amazon ECS service or task.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interface
EcsTaskProperties.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static EcsTaskProperties.Builder
builder()
List<TaskContainerProperties>
containers()
This object is a list of containers.EphemeralStorage
ephemeralStorage()
The amount of ephemeral storage to allocate for the task.boolean
equals(Object obj)
boolean
equalsBySdkFields(Object obj)
String
executionRoleArn()
The Amazon Resource Name (ARN) of the execution role that Batch can assume.<T> Optional<T>
getValueForField(String fieldName, Class<T> clazz)
boolean
hasContainers()
For responses, this returns true if the service returned a value for the Containers property.int
hashCode()
boolean
hasVolumes()
For responses, this returns true if the service returned a value for the Volumes property.String
ipcMode()
The IPC resource namespace to use for the containers in the task.NetworkConfiguration
networkConfiguration()
The network configuration for jobs that are running on Fargate resources.String
pidMode()
The process namespace to use for the containers in the task.String
platformVersion()
The Fargate platform version where the jobs are running.RuntimePlatform
runtimePlatform()
An object that represents the compute environment architecture for Batch jobs on Fargate.List<SdkField<?>>
sdkFields()
static Class<? extends EcsTaskProperties.Builder>
serializableBuilderClass()
String
taskRoleArn()
The Amazon Resource Name (ARN) that's associated with the Amazon ECS task.EcsTaskProperties.Builder
toBuilder()
String
toString()
Returns a string representation of this object.List<Volume>
volumes()
A list of volumes that are associated with the job.-
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
-
hasContainers
public final boolean hasContainers()
For responses, this returns true if the service returned a value for the Containers 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.
-
containers
public final List<TaskContainerProperties> containers()
This object is a list of 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
hasContainers()
method.- Returns:
- This object is a list of containers.
-
ephemeralStorage
public final EphemeralStorage ephemeralStorage()
The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on Fargate.
- Returns:
- The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on Fargate.
-
executionRoleArn
public final String executionRoleArn()
The Amazon Resource Name (ARN) of the execution role that Batch can assume. For jobs that run on Fargate resources, you must provide an execution role. For more information, see Batch execution IAM role in the Batch User Guide.
- Returns:
- The Amazon Resource Name (ARN) of the execution role that Batch can assume. For jobs that run on Fargate resources, you must provide an execution role. For more information, see Batch execution IAM role in the Batch User Guide.
-
platformVersion
public final String platformVersion()
The Fargate platform version where the jobs are running. A platform version is specified only for jobs that are running on Fargate resources. If one isn't specified, the
LATEST
platform version is used by default. This uses a recent, approved version of the Fargate platform for compute resources. For more information, see Fargate platform versions in the Amazon Elastic Container Service Developer Guide.- Returns:
- The Fargate platform version where the jobs are running. A platform version is specified only for jobs
that are running on Fargate resources. If one isn't specified, the
LATEST
platform version is used by default. This uses a recent, approved version of the Fargate platform for compute resources. For more information, see Fargate platform versions in the Amazon Elastic Container Service Developer Guide.
-
ipcMode
public final String ipcMode()
The IPC resource namespace to use for the containers in the task. The valid values are
host
,task
, ornone
.If
host
is specified, all containers within the tasks that specified thehost
IPC mode on the same container instance share the same IPC resources with the host Amazon EC2 instance.If
task
is specified, all containers within the specifiedtask
share the same IPC resources.If
none
is specified, the IPC resources within the containers of a task are private, and are not shared with other containers in a task or on the container instance.If no value is specified, then the IPC resource namespace sharing depends on the Docker daemon setting on the container instance. For more information, see IPC settings in the Docker run reference.
- Returns:
- The IPC resource namespace to use for the containers in the task. The valid values are
host
,task
, ornone
.If
host
is specified, all containers within the tasks that specified thehost
IPC mode on the same container instance share the same IPC resources with the host Amazon EC2 instance.If
task
is specified, all containers within the specifiedtask
share the same IPC resources.If
none
is specified, the IPC resources within the containers of a task are private, and are not shared with other containers in a task or on the container instance.If no value is specified, then the IPC resource namespace sharing depends on the Docker daemon setting on the container instance. For more information, see IPC settings in the Docker run reference.
-
taskRoleArn
public final String taskRoleArn()
The Amazon Resource Name (ARN) that's associated with the Amazon ECS task.
This is object is comparable to ContainerProperties:jobRoleArn.
- Returns:
- The Amazon Resource Name (ARN) that's associated with the Amazon ECS task.
This is object is comparable to ContainerProperties:jobRoleArn.
-
pidMode
public final String pidMode()
The process namespace to use for the containers in the task. The valid values are
host
ortask
. For example, monitoring sidecars might needpidMode
to access information about other containers running in the same task.If
host
is specified, all containers within the tasks that specified thehost
PID mode on the same container instance share the process namespace with the host Amazon EC2 instance.If
task
is specified, all containers within the specified task share the same process namespace.If no value is specified, the default is a private namespace for each container. For more information, see PID settings in the Docker run reference.
- Returns:
- The process namespace to use for the containers in the task. The valid values are
host
ortask
. For example, monitoring sidecars might needpidMode
to access information about other containers running in the same task.If
host
is specified, all containers within the tasks that specified thehost
PID mode on the same container instance share the process namespace with the host Amazon EC2 instance.If
task
is specified, all containers within the specified task share the same process namespace.If no value is specified, the default is a private namespace for each container. For more information, see PID settings in the Docker run reference.
-
networkConfiguration
public final NetworkConfiguration networkConfiguration()
The network configuration for jobs that are running on Fargate resources. Jobs that are running on Amazon EC2 resources must not specify this parameter.
- Returns:
- The network configuration for jobs that are running on Fargate resources. Jobs that are running on Amazon EC2 resources must not specify this parameter.
-
runtimePlatform
public final RuntimePlatform runtimePlatform()
An object that represents the compute environment architecture for Batch jobs on Fargate.
- Returns:
- An object that represents the compute environment architecture for Batch jobs on Fargate.
-
hasVolumes
public final boolean hasVolumes()
For responses, this returns true if the service returned a value for the Volumes 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.
-
volumes
public final List<Volume> volumes()
A list of volumes that are associated with the job.
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
hasVolumes()
method.- Returns:
- A list of volumes that are associated with the job.
-
toBuilder
public EcsTaskProperties.Builder toBuilder()
- Specified by:
toBuilder
in interfaceToCopyableBuilder<EcsTaskProperties.Builder,EcsTaskProperties>
-
builder
public static EcsTaskProperties.Builder builder()
-
serializableBuilderClass
public static Class<? extends EcsTaskProperties.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFields
in 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.
-
-