Class ListTasksRequest
- All Implemented Interfaces:
SdkPojo
,ToCopyableBuilder<ListTasksRequest.Builder,
ListTasksRequest>
-
Nested Class Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic ListTasksRequest.Builder
builder()
final String
cluster()
The short name or full Amazon Resource Name (ARN) of the cluster to use when filtering theListTasks
results.final String
The container instance ID or full ARN of the container instance to use when filtering theListTasks
results.final DesiredStatus
The task desired status to use when filtering theListTasks
results.final String
The task desired status to use when filtering theListTasks
results.final boolean
final boolean
equalsBySdkFields
(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.final String
family()
The name of the task definition family to use when filtering theListTasks
results.final <T> Optional
<T> getValueForField
(String fieldName, Class<T> clazz) Used to retrieve the value of a field from any class that extendsSdkRequest
.final int
hashCode()
final LaunchType
The launch type to use when filtering theListTasks
results.final String
The launch type to use when filtering theListTasks
results.final Integer
The maximum number of task results thatListTasks
returned in paginated output.final String
ThenextToken
value returned from aListTasks
request indicating that more results are available to fulfill the request and further calls will be needed.static Class
<? extends ListTasksRequest.Builder> final String
The name of the service to use when filtering theListTasks
results.final String
ThestartedBy
value to filter the task results with.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.Methods inherited from class software.amazon.awssdk.awscore.AwsRequest
overrideConfiguration
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
cluster
The short name or full Amazon Resource Name (ARN) of the cluster to use when filtering the
ListTasks
results. If you do not specify a cluster, the default cluster is assumed.- Returns:
- The short name or full Amazon Resource Name (ARN) of the cluster to use when filtering the
ListTasks
results. If you do not specify a cluster, the default cluster is assumed.
-
containerInstance
The container instance ID or full ARN of the container instance to use when filtering the
ListTasks
results. Specifying acontainerInstance
limits the results to tasks that belong to that container instance.- Returns:
- The container instance ID or full ARN of the container instance to use when filtering the
ListTasks
results. Specifying acontainerInstance
limits the results to tasks that belong to that container instance.
-
family
The name of the task definition family to use when filtering the
ListTasks
results. Specifying afamily
limits the results to tasks that belong to that family.- Returns:
- The name of the task definition family to use when filtering the
ListTasks
results. Specifying afamily
limits the results to tasks that belong to that family.
-
nextToken
The
nextToken
value returned from aListTasks
request indicating that more results are available to fulfill the request and further calls will be needed. IfmaxResults
was provided, it's possible the number of results to be fewer thanmaxResults
.This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.
- Returns:
- The
nextToken
value returned from aListTasks
request indicating that more results are available to fulfill the request and further calls will be needed. IfmaxResults
was provided, it's possible the number of results to be fewer thanmaxResults
.This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.
-
maxResults
The maximum number of task results that
ListTasks
returned in paginated output. When this parameter is used,ListTasks
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListTasks
request with the returnednextToken
value. This value can be between 1 and 100. If this parameter isn't used, thenListTasks
returns up to 100 results and anextToken
value if applicable.- Returns:
- The maximum number of task results that
ListTasks
returned in paginated output. When this parameter is used,ListTasks
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListTasks
request with the returnednextToken
value. This value can be between 1 and 100. If this parameter isn't used, thenListTasks
returns up to 100 results and anextToken
value if applicable.
-
startedBy
The
startedBy
value to filter the task results with. Specifying astartedBy
value limits the results to tasks that were started with that value.When you specify
startedBy
as the filter, it must be the only filter that you use.- Returns:
- The
startedBy
value to filter the task results with. Specifying astartedBy
value limits the results to tasks that were started with that value.When you specify
startedBy
as the filter, it must be the only filter that you use.
-
serviceName
The name of the service to use when filtering the
ListTasks
results. Specifying aserviceName
limits the results to tasks that belong to that service.- Returns:
- The name of the service to use when filtering the
ListTasks
results. Specifying aserviceName
limits the results to tasks that belong to that service.
-
desiredStatus
The task desired status to use when filtering the
ListTasks
results. Specifying adesiredStatus
ofSTOPPED
limits the results to tasks that Amazon ECS has set the desired status toSTOPPED
. This can be useful for debugging tasks that aren't starting properly or have died or finished. The default status filter isRUNNING
, which shows tasks that Amazon ECS has set the desired status toRUNNING
.Although you can filter results based on a desired status of
PENDING
, this doesn't return any results. Amazon ECS never sets the desired status of a task to that value (only a task'slastStatus
may have a value ofPENDING
).If the service returns an enum value that is not available in the current SDK version,
desiredStatus
will returnDesiredStatus.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromdesiredStatusAsString()
.- Returns:
- The task desired status to use when filtering the
ListTasks
results. Specifying adesiredStatus
ofSTOPPED
limits the results to tasks that Amazon ECS has set the desired status toSTOPPED
. This can be useful for debugging tasks that aren't starting properly or have died or finished. The default status filter isRUNNING
, which shows tasks that Amazon ECS has set the desired status toRUNNING
.Although you can filter results based on a desired status of
PENDING
, this doesn't return any results. Amazon ECS never sets the desired status of a task to that value (only a task'slastStatus
may have a value ofPENDING
). - See Also:
-
desiredStatusAsString
The task desired status to use when filtering the
ListTasks
results. Specifying adesiredStatus
ofSTOPPED
limits the results to tasks that Amazon ECS has set the desired status toSTOPPED
. This can be useful for debugging tasks that aren't starting properly or have died or finished. The default status filter isRUNNING
, which shows tasks that Amazon ECS has set the desired status toRUNNING
.Although you can filter results based on a desired status of
PENDING
, this doesn't return any results. Amazon ECS never sets the desired status of a task to that value (only a task'slastStatus
may have a value ofPENDING
).If the service returns an enum value that is not available in the current SDK version,
desiredStatus
will returnDesiredStatus.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromdesiredStatusAsString()
.- Returns:
- The task desired status to use when filtering the
ListTasks
results. Specifying adesiredStatus
ofSTOPPED
limits the results to tasks that Amazon ECS has set the desired status toSTOPPED
. This can be useful for debugging tasks that aren't starting properly or have died or finished. The default status filter isRUNNING
, which shows tasks that Amazon ECS has set the desired status toRUNNING
.Although you can filter results based on a desired status of
PENDING
, this doesn't return any results. Amazon ECS never sets the desired status of a task to that value (only a task'slastStatus
may have a value ofPENDING
). - See Also:
-
launchType
The launch type to use when filtering the
ListTasks
results.If the service returns an enum value that is not available in the current SDK version,
launchType
will returnLaunchType.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromlaunchTypeAsString()
.- Returns:
- The launch type to use when filtering the
ListTasks
results. - See Also:
-
launchTypeAsString
The launch type to use when filtering the
ListTasks
results.If the service returns an enum value that is not available in the current SDK version,
launchType
will returnLaunchType.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromlaunchTypeAsString()
.- Returns:
- The launch type to use when filtering the
ListTasks
results. - See Also:
-
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<ListTasksRequest.Builder,
ListTasksRequest> - Specified by:
toBuilder
in classEcsRequest
- Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
public final int hashCode()- Overrides:
hashCode
in classAwsRequest
-
equals
- Overrides:
equals
in classAwsRequest
-
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
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. -
getValueForField
Description copied from class:SdkRequest
Used to retrieve the value of a field from any class that extendsSdkRequest
. The field name specified should match the member name from the corresponding service-2.json model specified in the codegen-resources folder for a given service. The class specifies what class to cast the returned value to. If the returned value is also a modeled class, theSdkRequest.getValueForField(String, Class)
method will again be available.- Overrides:
getValueForField
in classSdkRequest
- Parameters:
fieldName
- The name of the member to be retrieved.clazz
- The class to cast the returned object to.- Returns:
- Optional containing the casted return value
-
sdkFields
-