Class ListTasksRequest
- java.lang.Object
-
- software.amazon.awssdk.core.SdkRequest
-
- software.amazon.awssdk.awscore.AwsRequest
-
- software.amazon.awssdk.services.ecs.model.EcsRequest
-
- software.amazon.awssdk.services.ecs.model.ListTasksRequest
-
- All Implemented Interfaces:
SdkPojo,ToCopyableBuilder<ListTasksRequest.Builder,ListTasksRequest>
@Generated("software.amazon.awssdk:codegen") public final class ListTasksRequest extends EcsRequest implements ToCopyableBuilder<ListTasksRequest.Builder,ListTasksRequest>
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceListTasksRequest.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static ListTasksRequest.Builderbuilder()Stringcluster()The short name or full Amazon Resource Name (ARN) of the cluster to use when filtering theListTasksresults.StringcontainerInstance()The container instance ID or full ARN of the container instance to use when filtering theListTasksresults.DesiredStatusdesiredStatus()The task desired status to use when filtering theListTasksresults.StringdesiredStatusAsString()The task desired status to use when filtering theListTasksresults.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)Stringfamily()The name of the task definition family to use when filtering theListTasksresults.<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()LaunchTypelaunchType()The launch type to use when filtering theListTasksresults.StringlaunchTypeAsString()The launch type to use when filtering theListTasksresults.IntegermaxResults()The maximum number of task results thatListTasksreturned in paginated output.StringnextToken()ThenextTokenvalue returned from aListTasksrequest indicating that more results are available to fulfill the request and further calls will be needed.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends ListTasksRequest.Builder>serializableBuilderClass()StringserviceName()The name of the service to use when filtering theListTasksresults.StringstartedBy()ThestartedByvalue to filter the task results with.ListTasksRequest.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class software.amazon.awssdk.awscore.AwsRequest
overrideConfiguration
-
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
-
cluster
public final String cluster()
The short name or full Amazon Resource Name (ARN) of the cluster to use when filtering the
ListTasksresults. 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
ListTasksresults. If you do not specify a cluster, the default cluster is assumed.
-
containerInstance
public final String containerInstance()
The container instance ID or full ARN of the container instance to use when filtering the
ListTasksresults. Specifying acontainerInstancelimits 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
ListTasksresults. Specifying acontainerInstancelimits the results to tasks that belong to that container instance.
-
family
public final String family()
The name of the task definition family to use when filtering the
ListTasksresults. Specifying afamilylimits the results to tasks that belong to that family.- Returns:
- The name of the task definition family to use when filtering the
ListTasksresults. Specifying afamilylimits the results to tasks that belong to that family.
-
nextToken
public final String nextToken()
The
nextTokenvalue returned from aListTasksrequest indicating that more results are available to fulfill the request and further calls will be needed. IfmaxResultswas 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
nextTokenvalue returned from aListTasksrequest indicating that more results are available to fulfill the request and further calls will be needed. IfmaxResultswas 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
public final Integer maxResults()
The maximum number of task results that
ListTasksreturned in paginated output. When this parameter is used,ListTasksonly returnsmaxResultsresults in a single page along with anextTokenresponse element. The remaining results of the initial request can be seen by sending anotherListTasksrequest with the returnednextTokenvalue. This value can be between 1 and 100. If this parameter isn't used, thenListTasksreturns up to 100 results and anextTokenvalue if applicable.- Returns:
- The maximum number of task results that
ListTasksreturned in paginated output. When this parameter is used,ListTasksonly returnsmaxResultsresults in a single page along with anextTokenresponse element. The remaining results of the initial request can be seen by sending anotherListTasksrequest with the returnednextTokenvalue. This value can be between 1 and 100. If this parameter isn't used, thenListTasksreturns up to 100 results and anextTokenvalue if applicable.
-
startedBy
public final String startedBy()
The
startedByvalue to filter the task results with. Specifying astartedByvalue limits the results to tasks that were started with that value.When you specify
startedByas the filter, it must be the only filter that you use.- Returns:
- The
startedByvalue to filter the task results with. Specifying astartedByvalue limits the results to tasks that were started with that value.When you specify
startedByas the filter, it must be the only filter that you use.
-
serviceName
public final String serviceName()
The name of the service to use when filtering the
ListTasksresults. Specifying aserviceNamelimits the results to tasks that belong to that service.- Returns:
- The name of the service to use when filtering the
ListTasksresults. Specifying aserviceNamelimits the results to tasks that belong to that service.
-
desiredStatus
public final DesiredStatus desiredStatus()
The task desired status to use when filtering the
ListTasksresults. Specifying adesiredStatusofSTOPPEDlimits 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'slastStatusmay have a value ofPENDING).If the service returns an enum value that is not available in the current SDK version,
desiredStatuswill 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
ListTasksresults. Specifying adesiredStatusofSTOPPEDlimits 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'slastStatusmay have a value ofPENDING). - See Also:
DesiredStatus
-
desiredStatusAsString
public final String desiredStatusAsString()
The task desired status to use when filtering the
ListTasksresults. Specifying adesiredStatusofSTOPPEDlimits 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'slastStatusmay have a value ofPENDING).If the service returns an enum value that is not available in the current SDK version,
desiredStatuswill 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
ListTasksresults. Specifying adesiredStatusofSTOPPEDlimits 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'slastStatusmay have a value ofPENDING). - See Also:
DesiredStatus
-
launchType
public final LaunchType launchType()
The launch type to use when filtering the
ListTasksresults.If the service returns an enum value that is not available in the current SDK version,
launchTypewill returnLaunchType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromlaunchTypeAsString().- Returns:
- The launch type to use when filtering the
ListTasksresults. - See Also:
LaunchType
-
launchTypeAsString
public final String launchTypeAsString()
The launch type to use when filtering the
ListTasksresults.If the service returns an enum value that is not available in the current SDK version,
launchTypewill returnLaunchType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromlaunchTypeAsString().- Returns:
- The launch type to use when filtering the
ListTasksresults. - See Also:
LaunchType
-
toBuilder
public ListTasksRequest.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<ListTasksRequest.Builder,ListTasksRequest>- Specified by:
toBuilderin classEcsRequest
-
builder
public static ListTasksRequest.Builder builder()
-
serializableBuilderClass
public static Class<? extends ListTasksRequest.Builder> serializableBuilderClass()
-
hashCode
public final int hashCode()
- Overrides:
hashCodein classAwsRequest
-
equals
public final boolean equals(Object obj)
- Overrides:
equalsin classAwsRequest
-
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.
-
getValueForField
public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
- Overrides:
getValueForFieldin classSdkRequest
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-