Class ListContainerInstancesRequest
- 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.ListContainerInstancesRequest
-
- All Implemented Interfaces:
SdkPojo,ToCopyableBuilder<ListContainerInstancesRequest.Builder,ListContainerInstancesRequest>
@Generated("software.amazon.awssdk:codegen") public final class ListContainerInstancesRequest extends EcsRequest implements ToCopyableBuilder<ListContainerInstancesRequest.Builder,ListContainerInstancesRequest>
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceListContainerInstancesRequest.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static ListContainerInstancesRequest.Builderbuilder()Stringcluster()The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instances to list.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)Stringfilter()You can filter the results of aListContainerInstancesoperation with cluster query language statements.<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()IntegermaxResults()The maximum number of container instance results thatListContainerInstancesreturned in paginated output.StringnextToken()ThenextTokenvalue returned from aListContainerInstancesrequest indicating that more results are available to fulfill the request and further calls are needed.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends ListContainerInstancesRequest.Builder>serializableBuilderClass()ContainerInstanceStatusstatus()Filters the container instances by status.StringstatusAsString()Filters the container instances by status.ListContainerInstancesRequest.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 that hosts the container instances to list. 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 that hosts the container instances to list. If you do not specify a cluster, the default cluster is assumed.
-
filter
public final String filter()
You can filter the results of a
ListContainerInstancesoperation with cluster query language statements. For more information, see Cluster Query Language in the Amazon Elastic Container Service Developer Guide.- Returns:
- You can filter the results of a
ListContainerInstancesoperation with cluster query language statements. For more information, see Cluster Query Language in the Amazon Elastic Container Service Developer Guide.
-
nextToken
public final String nextToken()
The
nextTokenvalue returned from aListContainerInstancesrequest indicating that more results are available to fulfill the request and further calls are 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 aListContainerInstancesrequest indicating that more results are available to fulfill the request and further calls are 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 container instance results that
ListContainerInstancesreturned in paginated output. When this parameter is used,ListContainerInstancesonly returnsmaxResultsresults in a single page along with anextTokenresponse element. The remaining results of the initial request can be seen by sending anotherListContainerInstancesrequest with the returnednextTokenvalue. This value can be between 1 and 100. If this parameter isn't used, thenListContainerInstancesreturns up to 100 results and anextTokenvalue if applicable.- Returns:
- The maximum number of container instance results that
ListContainerInstancesreturned in paginated output. When this parameter is used,ListContainerInstancesonly returnsmaxResultsresults in a single page along with anextTokenresponse element. The remaining results of the initial request can be seen by sending anotherListContainerInstancesrequest with the returnednextTokenvalue. This value can be between 1 and 100. If this parameter isn't used, thenListContainerInstancesreturns up to 100 results and anextTokenvalue if applicable.
-
status
public final ContainerInstanceStatus status()
Filters the container instances by status. For example, if you specify the
DRAININGstatus, the results include only container instances that have been set toDRAININGusing UpdateContainerInstancesState. If you don't specify this parameter, the default is to include container instances set to all states other thanINACTIVE.If the service returns an enum value that is not available in the current SDK version,
statuswill returnContainerInstanceStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- Filters the container instances by status. For example, if you specify the
DRAININGstatus, the results include only container instances that have been set toDRAININGusing UpdateContainerInstancesState. If you don't specify this parameter, the default is to include container instances set to all states other thanINACTIVE. - See Also:
ContainerInstanceStatus
-
statusAsString
public final String statusAsString()
Filters the container instances by status. For example, if you specify the
DRAININGstatus, the results include only container instances that have been set toDRAININGusing UpdateContainerInstancesState. If you don't specify this parameter, the default is to include container instances set to all states other thanINACTIVE.If the service returns an enum value that is not available in the current SDK version,
statuswill returnContainerInstanceStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- Filters the container instances by status. For example, if you specify the
DRAININGstatus, the results include only container instances that have been set toDRAININGusing UpdateContainerInstancesState. If you don't specify this parameter, the default is to include container instances set to all states other thanINACTIVE. - See Also:
ContainerInstanceStatus
-
toBuilder
public ListContainerInstancesRequest.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<ListContainerInstancesRequest.Builder,ListContainerInstancesRequest>- Specified by:
toBuilderin classEcsRequest
-
builder
public static ListContainerInstancesRequest.Builder builder()
-
serializableBuilderClass
public static Class<? extends ListContainerInstancesRequest.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
-
-