Interface BatchAsyncClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder()
method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient
supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in
some cases such as credentials retrieval and endpoint discovery as part of the async API call.
Using Batch, you can run batch computing workloads on the Amazon Web Services Cloud. Batch computing is a common means for developers, scientists, and engineers to access large amounts of compute resources. Batch uses the advantages of the batch computing to remove the undifferentiated heavy lifting of configuring and managing required infrastructure. At the same time, it also adopts a familiar batch computing software approach. You can use Batch to efficiently provision resources, and work toward eliminating capacity constraints, reducing your overall compute costs, and delivering results more quickly.
As a fully managed service, Batch can run batch computing workloads of any scale. Batch automatically provisions compute resources and optimizes workload distribution based on the quantity and scale of your specific workloads. With Batch, there's no need to install or manage batch computing software. This means that you can focus on analyzing results and solving your specific problems instead.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptionstatic BatchAsyncClientBuilderbuilder()Create a builder that can be used to configure and create aBatchAsyncClient.default CompletableFuture<CancelJobResponse> cancelJob(Consumer<CancelJobRequest.Builder> cancelJobRequest) Cancels a job in an Batch job queue.default CompletableFuture<CancelJobResponse> cancelJob(CancelJobRequest cancelJobRequest) Cancels a job in an Batch job queue.static BatchAsyncClientcreate()Create aBatchAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.createComputeEnvironment(Consumer<CreateComputeEnvironmentRequest.Builder> createComputeEnvironmentRequest) Creates an Batch compute environment.createComputeEnvironment(CreateComputeEnvironmentRequest createComputeEnvironmentRequest) Creates an Batch compute environment.createConsumableResource(Consumer<CreateConsumableResourceRequest.Builder> createConsumableResourceRequest) Creates an Batch consumable resource.createConsumableResource(CreateConsumableResourceRequest createConsumableResourceRequest) Creates an Batch consumable resource.default CompletableFuture<CreateJobQueueResponse> createJobQueue(Consumer<CreateJobQueueRequest.Builder> createJobQueueRequest) Creates an Batch job queue.default CompletableFuture<CreateJobQueueResponse> createJobQueue(CreateJobQueueRequest createJobQueueRequest) Creates an Batch job queue.createSchedulingPolicy(Consumer<CreateSchedulingPolicyRequest.Builder> createSchedulingPolicyRequest) Creates an Batch scheduling policy.createSchedulingPolicy(CreateSchedulingPolicyRequest createSchedulingPolicyRequest) Creates an Batch scheduling policy.createServiceEnvironment(Consumer<CreateServiceEnvironmentRequest.Builder> createServiceEnvironmentRequest) Creates a service environment for running service jobs.createServiceEnvironment(CreateServiceEnvironmentRequest createServiceEnvironmentRequest) Creates a service environment for running service jobs.deleteComputeEnvironment(Consumer<DeleteComputeEnvironmentRequest.Builder> deleteComputeEnvironmentRequest) Deletes an Batch compute environment.deleteComputeEnvironment(DeleteComputeEnvironmentRequest deleteComputeEnvironmentRequest) Deletes an Batch compute environment.deleteConsumableResource(Consumer<DeleteConsumableResourceRequest.Builder> deleteConsumableResourceRequest) Deletes the specified consumable resource.deleteConsumableResource(DeleteConsumableResourceRequest deleteConsumableResourceRequest) Deletes the specified consumable resource.default CompletableFuture<DeleteJobQueueResponse> deleteJobQueue(Consumer<DeleteJobQueueRequest.Builder> deleteJobQueueRequest) Deletes the specified job queue.default CompletableFuture<DeleteJobQueueResponse> deleteJobQueue(DeleteJobQueueRequest deleteJobQueueRequest) Deletes the specified job queue.deleteSchedulingPolicy(Consumer<DeleteSchedulingPolicyRequest.Builder> deleteSchedulingPolicyRequest) Deletes the specified scheduling policy.deleteSchedulingPolicy(DeleteSchedulingPolicyRequest deleteSchedulingPolicyRequest) Deletes the specified scheduling policy.deleteServiceEnvironment(Consumer<DeleteServiceEnvironmentRequest.Builder> deleteServiceEnvironmentRequest) Deletes a Service environment.deleteServiceEnvironment(DeleteServiceEnvironmentRequest deleteServiceEnvironmentRequest) Deletes a Service environment.deregisterJobDefinition(Consumer<DeregisterJobDefinitionRequest.Builder> deregisterJobDefinitionRequest) Deregisters an Batch job definition.deregisterJobDefinition(DeregisterJobDefinitionRequest deregisterJobDefinitionRequest) Deregisters an Batch job definition.Describes one or more of your compute environments.describeComputeEnvironments(Consumer<DescribeComputeEnvironmentsRequest.Builder> describeComputeEnvironmentsRequest) Describes one or more of your compute environments.describeComputeEnvironments(DescribeComputeEnvironmentsRequest describeComputeEnvironmentsRequest) Describes one or more of your compute environments.This is a variant ofdescribeComputeEnvironments(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsRequest)operation.describeComputeEnvironmentsPaginator(Consumer<DescribeComputeEnvironmentsRequest.Builder> describeComputeEnvironmentsRequest) This is a variant ofdescribeComputeEnvironments(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsRequest)operation.describeComputeEnvironmentsPaginator(DescribeComputeEnvironmentsRequest describeComputeEnvironmentsRequest) This is a variant ofdescribeComputeEnvironments(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsRequest)operation.describeConsumableResource(Consumer<DescribeConsumableResourceRequest.Builder> describeConsumableResourceRequest) Returns a description of the specified consumable resource.describeConsumableResource(DescribeConsumableResourceRequest describeConsumableResourceRequest) Returns a description of the specified consumable resource.Describes a list of job definitions.describeJobDefinitions(Consumer<DescribeJobDefinitionsRequest.Builder> describeJobDefinitionsRequest) Describes a list of job definitions.describeJobDefinitions(DescribeJobDefinitionsRequest describeJobDefinitionsRequest) Describes a list of job definitions.default DescribeJobDefinitionsPublisherThis is a variant ofdescribeJobDefinitions(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsRequest)operation.default DescribeJobDefinitionsPublisherdescribeJobDefinitionsPaginator(Consumer<DescribeJobDefinitionsRequest.Builder> describeJobDefinitionsRequest) This is a variant ofdescribeJobDefinitions(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsRequest)operation.default DescribeJobDefinitionsPublisherdescribeJobDefinitionsPaginator(DescribeJobDefinitionsRequest describeJobDefinitionsRequest) This is a variant ofdescribeJobDefinitions(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsRequest)operation.Describes one or more of your job queues.describeJobQueues(Consumer<DescribeJobQueuesRequest.Builder> describeJobQueuesRequest) Describes one or more of your job queues.describeJobQueues(DescribeJobQueuesRequest describeJobQueuesRequest) Describes one or more of your job queues.default DescribeJobQueuesPublisherThis is a variant ofdescribeJobQueues(software.amazon.awssdk.services.batch.model.DescribeJobQueuesRequest)operation.default DescribeJobQueuesPublisherdescribeJobQueuesPaginator(Consumer<DescribeJobQueuesRequest.Builder> describeJobQueuesRequest) This is a variant ofdescribeJobQueues(software.amazon.awssdk.services.batch.model.DescribeJobQueuesRequest)operation.default DescribeJobQueuesPublisherdescribeJobQueuesPaginator(DescribeJobQueuesRequest describeJobQueuesRequest) This is a variant ofdescribeJobQueues(software.amazon.awssdk.services.batch.model.DescribeJobQueuesRequest)operation.default CompletableFuture<DescribeJobsResponse> describeJobs(Consumer<DescribeJobsRequest.Builder> describeJobsRequest) Describes a list of Batch jobs.default CompletableFuture<DescribeJobsResponse> describeJobs(DescribeJobsRequest describeJobsRequest) Describes a list of Batch jobs.describeSchedulingPolicies(Consumer<DescribeSchedulingPoliciesRequest.Builder> describeSchedulingPoliciesRequest) Describes one or more of your scheduling policies.describeSchedulingPolicies(DescribeSchedulingPoliciesRequest describeSchedulingPoliciesRequest) Describes one or more of your scheduling policies.describeServiceEnvironments(Consumer<DescribeServiceEnvironmentsRequest.Builder> describeServiceEnvironmentsRequest) Describes one or more of your service environments.describeServiceEnvironments(DescribeServiceEnvironmentsRequest describeServiceEnvironmentsRequest) Describes one or more of your service environments.describeServiceEnvironmentsPaginator(Consumer<DescribeServiceEnvironmentsRequest.Builder> describeServiceEnvironmentsRequest) This is a variant ofdescribeServiceEnvironments(software.amazon.awssdk.services.batch.model.DescribeServiceEnvironmentsRequest)operation.describeServiceEnvironmentsPaginator(DescribeServiceEnvironmentsRequest describeServiceEnvironmentsRequest) This is a variant ofdescribeServiceEnvironments(software.amazon.awssdk.services.batch.model.DescribeServiceEnvironmentsRequest)operation.describeServiceJob(Consumer<DescribeServiceJobRequest.Builder> describeServiceJobRequest) The details of a service job.describeServiceJob(DescribeServiceJobRequest describeServiceJobRequest) The details of a service job.getJobQueueSnapshot(Consumer<GetJobQueueSnapshotRequest.Builder> getJobQueueSnapshotRequest) Provides a list of the first 100RUNNABLEjobs associated to a single job queue.getJobQueueSnapshot(GetJobQueueSnapshotRequest getJobQueueSnapshotRequest) Provides a list of the first 100RUNNABLEjobs associated to a single job queue.listConsumableResources(Consumer<ListConsumableResourcesRequest.Builder> listConsumableResourcesRequest) Returns a list of Batch consumable resources.listConsumableResources(ListConsumableResourcesRequest listConsumableResourcesRequest) Returns a list of Batch consumable resources.default ListConsumableResourcesPublisherlistConsumableResourcesPaginator(Consumer<ListConsumableResourcesRequest.Builder> listConsumableResourcesRequest) This is a variant oflistConsumableResources(software.amazon.awssdk.services.batch.model.ListConsumableResourcesRequest)operation.default ListConsumableResourcesPublisherlistConsumableResourcesPaginator(ListConsumableResourcesRequest listConsumableResourcesRequest) This is a variant oflistConsumableResources(software.amazon.awssdk.services.batch.model.ListConsumableResourcesRequest)operation.default CompletableFuture<ListJobsResponse> listJobs(Consumer<ListJobsRequest.Builder> listJobsRequest) Returns a list of Batch jobs.default CompletableFuture<ListJobsResponse> listJobs(ListJobsRequest listJobsRequest) Returns a list of Batch jobs.listJobsByConsumableResource(Consumer<ListJobsByConsumableResourceRequest.Builder> listJobsByConsumableResourceRequest) Returns a list of Batch jobs that require a specific consumable resource.listJobsByConsumableResource(ListJobsByConsumableResourceRequest listJobsByConsumableResourceRequest) Returns a list of Batch jobs that require a specific consumable resource.listJobsByConsumableResourcePaginator(Consumer<ListJobsByConsumableResourceRequest.Builder> listJobsByConsumableResourceRequest) This is a variant oflistJobsByConsumableResource(software.amazon.awssdk.services.batch.model.ListJobsByConsumableResourceRequest)operation.listJobsByConsumableResourcePaginator(ListJobsByConsumableResourceRequest listJobsByConsumableResourceRequest) This is a variant oflistJobsByConsumableResource(software.amazon.awssdk.services.batch.model.ListJobsByConsumableResourceRequest)operation.default ListJobsPublisherlistJobsPaginator(Consumer<ListJobsRequest.Builder> listJobsRequest) This is a variant oflistJobs(software.amazon.awssdk.services.batch.model.ListJobsRequest)operation.default ListJobsPublisherlistJobsPaginator(ListJobsRequest listJobsRequest) This is a variant oflistJobs(software.amazon.awssdk.services.batch.model.ListJobsRequest)operation.listSchedulingPolicies(Consumer<ListSchedulingPoliciesRequest.Builder> listSchedulingPoliciesRequest) Returns a list of Batch scheduling policies.listSchedulingPolicies(ListSchedulingPoliciesRequest listSchedulingPoliciesRequest) Returns a list of Batch scheduling policies.default ListSchedulingPoliciesPublisherlistSchedulingPoliciesPaginator(Consumer<ListSchedulingPoliciesRequest.Builder> listSchedulingPoliciesRequest) This is a variant oflistSchedulingPolicies(software.amazon.awssdk.services.batch.model.ListSchedulingPoliciesRequest)operation.default ListSchedulingPoliciesPublisherlistSchedulingPoliciesPaginator(ListSchedulingPoliciesRequest listSchedulingPoliciesRequest) This is a variant oflistSchedulingPolicies(software.amazon.awssdk.services.batch.model.ListSchedulingPoliciesRequest)operation.default CompletableFuture<ListServiceJobsResponse> listServiceJobs(Consumer<ListServiceJobsRequest.Builder> listServiceJobsRequest) Returns a list of service jobs for a specified job queue.default CompletableFuture<ListServiceJobsResponse> listServiceJobs(ListServiceJobsRequest listServiceJobsRequest) Returns a list of service jobs for a specified job queue.default ListServiceJobsPublisherlistServiceJobsPaginator(Consumer<ListServiceJobsRequest.Builder> listServiceJobsRequest) This is a variant oflistServiceJobs(software.amazon.awssdk.services.batch.model.ListServiceJobsRequest)operation.default ListServiceJobsPublisherlistServiceJobsPaginator(ListServiceJobsRequest listServiceJobsRequest) This is a variant oflistServiceJobs(software.amazon.awssdk.services.batch.model.ListServiceJobsRequest)operation.listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists the tags for an Batch resource.listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists the tags for an Batch resource.registerJobDefinition(Consumer<RegisterJobDefinitionRequest.Builder> registerJobDefinitionRequest) Registers an Batch job definition.registerJobDefinition(RegisterJobDefinitionRequest registerJobDefinitionRequest) Registers an Batch job definition.default BatchServiceClientConfigurationThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationdefault CompletableFuture<SubmitJobResponse> submitJob(Consumer<SubmitJobRequest.Builder> submitJobRequest) Submits an Batch job from a job definition.default CompletableFuture<SubmitJobResponse> submitJob(SubmitJobRequest submitJobRequest) Submits an Batch job from a job definition.submitServiceJob(Consumer<SubmitServiceJobRequest.Builder> submitServiceJobRequest) Submits a service job to a specified job queue to run on SageMaker AI.submitServiceJob(SubmitServiceJobRequest submitServiceJobRequest) Submits a service job to a specified job queue to run on SageMaker AI.default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Associates the specified tags to a resource with the specifiedresourceArn.default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest) Associates the specified tags to a resource with the specifiedresourceArn.default CompletableFuture<TerminateJobResponse> terminateJob(Consumer<TerminateJobRequest.Builder> terminateJobRequest) Terminates a job in a job queue.default CompletableFuture<TerminateJobResponse> terminateJob(TerminateJobRequest terminateJobRequest) Terminates a job in a job queue.terminateServiceJob(Consumer<TerminateServiceJobRequest.Builder> terminateServiceJobRequest) Terminates a service job in a job queue.terminateServiceJob(TerminateServiceJobRequest terminateServiceJobRequest) Terminates a service job in a job queue.default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Deletes specified tags from an Batch resource.default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Deletes specified tags from an Batch resource.updateComputeEnvironment(Consumer<UpdateComputeEnvironmentRequest.Builder> updateComputeEnvironmentRequest) Updates an Batch compute environment.updateComputeEnvironment(UpdateComputeEnvironmentRequest updateComputeEnvironmentRequest) Updates an Batch compute environment.updateConsumableResource(Consumer<UpdateConsumableResourceRequest.Builder> updateConsumableResourceRequest) Updates a consumable resource.updateConsumableResource(UpdateConsumableResourceRequest updateConsumableResourceRequest) Updates a consumable resource.default CompletableFuture<UpdateJobQueueResponse> updateJobQueue(Consumer<UpdateJobQueueRequest.Builder> updateJobQueueRequest) Updates a job queue.default CompletableFuture<UpdateJobQueueResponse> updateJobQueue(UpdateJobQueueRequest updateJobQueueRequest) Updates a job queue.updateSchedulingPolicy(Consumer<UpdateSchedulingPolicyRequest.Builder> updateSchedulingPolicyRequest) Updates a scheduling policy.updateSchedulingPolicy(UpdateSchedulingPolicyRequest updateSchedulingPolicyRequest) Updates a scheduling policy.updateServiceEnvironment(Consumer<UpdateServiceEnvironmentRequest.Builder> updateServiceEnvironmentRequest) Updates a service environment.updateServiceEnvironment(UpdateServiceEnvironmentRequest updateServiceEnvironmentRequest) Updates a service environment.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
cancelJob
Cancels a job in an Batch job queue. Jobs that are in a
SUBMITTED,PENDING, orRUNNABLEstate are cancelled and the job status is updated toFAILED.A
PENDINGjob is canceled after all dependency jobs are completed. Therefore, it may take longer than expected to cancel a job inPENDINGstatus.When you try to cancel an array parent job in
PENDING, Batch attempts to cancel all child jobs. The array parent job is canceled when all child jobs are completed.Jobs that progressed to the
STARTINGorRUNNINGstate aren't canceled. However, the API operation still succeeds, even if no job is canceled. These jobs must be terminated with the TerminateJob operation.- Parameters:
cancelJobRequest- Contains the parameters forCancelJob.- Returns:
- A Java Future containing the result of the CancelJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
cancelJob
default CompletableFuture<CancelJobResponse> cancelJob(Consumer<CancelJobRequest.Builder> cancelJobRequest) Cancels a job in an Batch job queue. Jobs that are in a
SUBMITTED,PENDING, orRUNNABLEstate are cancelled and the job status is updated toFAILED.A
PENDINGjob is canceled after all dependency jobs are completed. Therefore, it may take longer than expected to cancel a job inPENDINGstatus.When you try to cancel an array parent job in
PENDING, Batch attempts to cancel all child jobs. The array parent job is canceled when all child jobs are completed.Jobs that progressed to the
STARTINGorRUNNINGstate aren't canceled. However, the API operation still succeeds, even if no job is canceled. These jobs must be terminated with the TerminateJob operation.
This is a convenience which creates an instance of the
CancelJobRequest.Builderavoiding the need to create one manually viaCancelJobRequest.builder()- Parameters:
cancelJobRequest- AConsumerthat will call methods onCancelJobRequest.Builderto create a request. Contains the parameters forCancelJob.- Returns:
- A Java Future containing the result of the CancelJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createComputeEnvironment
default CompletableFuture<CreateComputeEnvironmentResponse> createComputeEnvironment(CreateComputeEnvironmentRequest createComputeEnvironmentRequest) Creates an Batch compute environment. You can create
MANAGEDorUNMANAGEDcompute environments.MANAGEDcompute environments can use Amazon EC2 or Fargate resources.UNMANAGEDcompute environments can only use EC2 resources.In a managed compute environment, Batch manages the capacity and instance types of the compute resources within the environment. This is based on the compute resource specification that you define or the launch template that you specify when you create the compute environment. Either, you can choose to use EC2 On-Demand Instances and EC2 Spot Instances. Or, you can use Fargate and Fargate Spot capacity in your managed compute environment. You can optionally set a maximum price so that Spot Instances only launch when the Spot Instance price is less than a specified percentage of the On-Demand price.
In an unmanaged compute environment, you can manage your own EC2 compute resources and have flexibility with how you configure your compute resources. For example, you can use custom AMIs. However, you must verify that each of your AMIs meet the Amazon ECS container instance AMI specification. For more information, see container instance AMIs in the Amazon Elastic Container Service Developer Guide. After you created your unmanaged compute environment, you can use the DescribeComputeEnvironments operation to find the Amazon ECS cluster that's associated with it. Then, launch your container instances into that Amazon ECS cluster. For more information, see Launching an Amazon ECS container instance in the Amazon Elastic Container Service Developer Guide.
Batch doesn't automatically upgrade the AMIs in a compute environment after it's created. For more information on how to update a compute environment's AMI, see Updating compute environments in the Batch User Guide.
- Parameters:
createComputeEnvironmentRequest- Contains the parameters forCreateComputeEnvironment.- Returns:
- A Java Future containing the result of the CreateComputeEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createComputeEnvironment
default CompletableFuture<CreateComputeEnvironmentResponse> createComputeEnvironment(Consumer<CreateComputeEnvironmentRequest.Builder> createComputeEnvironmentRequest) Creates an Batch compute environment. You can create
MANAGEDorUNMANAGEDcompute environments.MANAGEDcompute environments can use Amazon EC2 or Fargate resources.UNMANAGEDcompute environments can only use EC2 resources.In a managed compute environment, Batch manages the capacity and instance types of the compute resources within the environment. This is based on the compute resource specification that you define or the launch template that you specify when you create the compute environment. Either, you can choose to use EC2 On-Demand Instances and EC2 Spot Instances. Or, you can use Fargate and Fargate Spot capacity in your managed compute environment. You can optionally set a maximum price so that Spot Instances only launch when the Spot Instance price is less than a specified percentage of the On-Demand price.
In an unmanaged compute environment, you can manage your own EC2 compute resources and have flexibility with how you configure your compute resources. For example, you can use custom AMIs. However, you must verify that each of your AMIs meet the Amazon ECS container instance AMI specification. For more information, see container instance AMIs in the Amazon Elastic Container Service Developer Guide. After you created your unmanaged compute environment, you can use the DescribeComputeEnvironments operation to find the Amazon ECS cluster that's associated with it. Then, launch your container instances into that Amazon ECS cluster. For more information, see Launching an Amazon ECS container instance in the Amazon Elastic Container Service Developer Guide.
Batch doesn't automatically upgrade the AMIs in a compute environment after it's created. For more information on how to update a compute environment's AMI, see Updating compute environments in the Batch User Guide.
This is a convenience which creates an instance of the
CreateComputeEnvironmentRequest.Builderavoiding the need to create one manually viaCreateComputeEnvironmentRequest.builder()- Parameters:
createComputeEnvironmentRequest- AConsumerthat will call methods onCreateComputeEnvironmentRequest.Builderto create a request. Contains the parameters forCreateComputeEnvironment.- Returns:
- A Java Future containing the result of the CreateComputeEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createConsumableResource
default CompletableFuture<CreateConsumableResourceResponse> createConsumableResource(CreateConsumableResourceRequest createConsumableResourceRequest) Creates an Batch consumable resource.
- Parameters:
createConsumableResourceRequest-- Returns:
- A Java Future containing the result of the CreateConsumableResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createConsumableResource
default CompletableFuture<CreateConsumableResourceResponse> createConsumableResource(Consumer<CreateConsumableResourceRequest.Builder> createConsumableResourceRequest) Creates an Batch consumable resource.
This is a convenience which creates an instance of the
CreateConsumableResourceRequest.Builderavoiding the need to create one manually viaCreateConsumableResourceRequest.builder()- Parameters:
createConsumableResourceRequest- AConsumerthat will call methods onCreateConsumableResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateConsumableResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createJobQueue
default CompletableFuture<CreateJobQueueResponse> createJobQueue(CreateJobQueueRequest createJobQueueRequest) Creates an Batch job queue. When you create a job queue, you associate one or more compute environments to the queue and assign an order of preference for the compute environments.
You also set a priority to the job queue that determines the order that the Batch scheduler places jobs onto its associated compute environments. For example, if a compute environment is associated with more than one job queue, the job queue with a higher priority is given preference for scheduling jobs to that compute environment.
- Parameters:
createJobQueueRequest- Contains the parameters forCreateJobQueue.- Returns:
- A Java Future containing the result of the CreateJobQueue operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createJobQueue
default CompletableFuture<CreateJobQueueResponse> createJobQueue(Consumer<CreateJobQueueRequest.Builder> createJobQueueRequest) Creates an Batch job queue. When you create a job queue, you associate one or more compute environments to the queue and assign an order of preference for the compute environments.
You also set a priority to the job queue that determines the order that the Batch scheduler places jobs onto its associated compute environments. For example, if a compute environment is associated with more than one job queue, the job queue with a higher priority is given preference for scheduling jobs to that compute environment.
This is a convenience which creates an instance of the
CreateJobQueueRequest.Builderavoiding the need to create one manually viaCreateJobQueueRequest.builder()- Parameters:
createJobQueueRequest- AConsumerthat will call methods onCreateJobQueueRequest.Builderto create a request. Contains the parameters forCreateJobQueue.- Returns:
- A Java Future containing the result of the CreateJobQueue operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createSchedulingPolicy
default CompletableFuture<CreateSchedulingPolicyResponse> createSchedulingPolicy(CreateSchedulingPolicyRequest createSchedulingPolicyRequest) Creates an Batch scheduling policy.
- Parameters:
createSchedulingPolicyRequest- Contains the parameters forCreateSchedulingPolicy.- Returns:
- A Java Future containing the result of the CreateSchedulingPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createSchedulingPolicy
default CompletableFuture<CreateSchedulingPolicyResponse> createSchedulingPolicy(Consumer<CreateSchedulingPolicyRequest.Builder> createSchedulingPolicyRequest) Creates an Batch scheduling policy.
This is a convenience which creates an instance of the
CreateSchedulingPolicyRequest.Builderavoiding the need to create one manually viaCreateSchedulingPolicyRequest.builder()- Parameters:
createSchedulingPolicyRequest- AConsumerthat will call methods onCreateSchedulingPolicyRequest.Builderto create a request. Contains the parameters forCreateSchedulingPolicy.- Returns:
- A Java Future containing the result of the CreateSchedulingPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createServiceEnvironment
default CompletableFuture<CreateServiceEnvironmentResponse> createServiceEnvironment(CreateServiceEnvironmentRequest createServiceEnvironmentRequest) Creates a service environment for running service jobs. Service environments define capacity limits for specific service types such as SageMaker Training jobs.
- Parameters:
createServiceEnvironmentRequest-- Returns:
- A Java Future containing the result of the CreateServiceEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createServiceEnvironment
default CompletableFuture<CreateServiceEnvironmentResponse> createServiceEnvironment(Consumer<CreateServiceEnvironmentRequest.Builder> createServiceEnvironmentRequest) Creates a service environment for running service jobs. Service environments define capacity limits for specific service types such as SageMaker Training jobs.
This is a convenience which creates an instance of the
CreateServiceEnvironmentRequest.Builderavoiding the need to create one manually viaCreateServiceEnvironmentRequest.builder()- Parameters:
createServiceEnvironmentRequest- AConsumerthat will call methods onCreateServiceEnvironmentRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateServiceEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteComputeEnvironment
default CompletableFuture<DeleteComputeEnvironmentResponse> deleteComputeEnvironment(DeleteComputeEnvironmentRequest deleteComputeEnvironmentRequest) Deletes an Batch compute environment.
Before you can delete a compute environment, you must set its state to
DISABLEDwith the UpdateComputeEnvironment API operation and disassociate it from any job queues with the UpdateJobQueue API operation. Compute environments that use Fargate resources must terminate all active jobs on that compute environment before deleting the compute environment. If this isn't done, the compute environment enters an invalid state.- Parameters:
deleteComputeEnvironmentRequest- Contains the parameters forDeleteComputeEnvironment.- Returns:
- A Java Future containing the result of the DeleteComputeEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteComputeEnvironment
default CompletableFuture<DeleteComputeEnvironmentResponse> deleteComputeEnvironment(Consumer<DeleteComputeEnvironmentRequest.Builder> deleteComputeEnvironmentRequest) Deletes an Batch compute environment.
Before you can delete a compute environment, you must set its state to
DISABLEDwith the UpdateComputeEnvironment API operation and disassociate it from any job queues with the UpdateJobQueue API operation. Compute environments that use Fargate resources must terminate all active jobs on that compute environment before deleting the compute environment. If this isn't done, the compute environment enters an invalid state.
This is a convenience which creates an instance of the
DeleteComputeEnvironmentRequest.Builderavoiding the need to create one manually viaDeleteComputeEnvironmentRequest.builder()- Parameters:
deleteComputeEnvironmentRequest- AConsumerthat will call methods onDeleteComputeEnvironmentRequest.Builderto create a request. Contains the parameters forDeleteComputeEnvironment.- Returns:
- A Java Future containing the result of the DeleteComputeEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteConsumableResource
default CompletableFuture<DeleteConsumableResourceResponse> deleteConsumableResource(DeleteConsumableResourceRequest deleteConsumableResourceRequest) Deletes the specified consumable resource.
- Parameters:
deleteConsumableResourceRequest-- Returns:
- A Java Future containing the result of the DeleteConsumableResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteConsumableResource
default CompletableFuture<DeleteConsumableResourceResponse> deleteConsumableResource(Consumer<DeleteConsumableResourceRequest.Builder> deleteConsumableResourceRequest) Deletes the specified consumable resource.
This is a convenience which creates an instance of the
DeleteConsumableResourceRequest.Builderavoiding the need to create one manually viaDeleteConsumableResourceRequest.builder()- Parameters:
deleteConsumableResourceRequest- AConsumerthat will call methods onDeleteConsumableResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteConsumableResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteJobQueue
default CompletableFuture<DeleteJobQueueResponse> deleteJobQueue(DeleteJobQueueRequest deleteJobQueueRequest) Deletes the specified job queue. You must first disable submissions for a queue with the UpdateJobQueue operation. All jobs in the queue are eventually terminated when you delete a job queue. The jobs are terminated at a rate of about 16 jobs each second.
It's not necessary to disassociate compute environments from a queue before submitting a
DeleteJobQueuerequest.- Parameters:
deleteJobQueueRequest- Contains the parameters forDeleteJobQueue.- Returns:
- A Java Future containing the result of the DeleteJobQueue operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteJobQueue
default CompletableFuture<DeleteJobQueueResponse> deleteJobQueue(Consumer<DeleteJobQueueRequest.Builder> deleteJobQueueRequest) Deletes the specified job queue. You must first disable submissions for a queue with the UpdateJobQueue operation. All jobs in the queue are eventually terminated when you delete a job queue. The jobs are terminated at a rate of about 16 jobs each second.
It's not necessary to disassociate compute environments from a queue before submitting a
DeleteJobQueuerequest.
This is a convenience which creates an instance of the
DeleteJobQueueRequest.Builderavoiding the need to create one manually viaDeleteJobQueueRequest.builder()- Parameters:
deleteJobQueueRequest- AConsumerthat will call methods onDeleteJobQueueRequest.Builderto create a request. Contains the parameters forDeleteJobQueue.- Returns:
- A Java Future containing the result of the DeleteJobQueue operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteSchedulingPolicy
default CompletableFuture<DeleteSchedulingPolicyResponse> deleteSchedulingPolicy(DeleteSchedulingPolicyRequest deleteSchedulingPolicyRequest) Deletes the specified scheduling policy.
You can't delete a scheduling policy that's used in any job queues.
- Parameters:
deleteSchedulingPolicyRequest- Contains the parameters forDeleteSchedulingPolicy.- Returns:
- A Java Future containing the result of the DeleteSchedulingPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteSchedulingPolicy
default CompletableFuture<DeleteSchedulingPolicyResponse> deleteSchedulingPolicy(Consumer<DeleteSchedulingPolicyRequest.Builder> deleteSchedulingPolicyRequest) Deletes the specified scheduling policy.
You can't delete a scheduling policy that's used in any job queues.
This is a convenience which creates an instance of the
DeleteSchedulingPolicyRequest.Builderavoiding the need to create one manually viaDeleteSchedulingPolicyRequest.builder()- Parameters:
deleteSchedulingPolicyRequest- AConsumerthat will call methods onDeleteSchedulingPolicyRequest.Builderto create a request. Contains the parameters forDeleteSchedulingPolicy.- Returns:
- A Java Future containing the result of the DeleteSchedulingPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteServiceEnvironment
default CompletableFuture<DeleteServiceEnvironmentResponse> deleteServiceEnvironment(DeleteServiceEnvironmentRequest deleteServiceEnvironmentRequest) Deletes a Service environment. Before you can delete a service environment, you must first set its state to
DISABLEDwith theUpdateServiceEnvironmentAPI operation and disassociate it from any job queues with theUpdateJobQueueAPI operation.- Parameters:
deleteServiceEnvironmentRequest-- Returns:
- A Java Future containing the result of the DeleteServiceEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteServiceEnvironment
default CompletableFuture<DeleteServiceEnvironmentResponse> deleteServiceEnvironment(Consumer<DeleteServiceEnvironmentRequest.Builder> deleteServiceEnvironmentRequest) Deletes a Service environment. Before you can delete a service environment, you must first set its state to
DISABLEDwith theUpdateServiceEnvironmentAPI operation and disassociate it from any job queues with theUpdateJobQueueAPI operation.
This is a convenience which creates an instance of the
DeleteServiceEnvironmentRequest.Builderavoiding the need to create one manually viaDeleteServiceEnvironmentRequest.builder()- Parameters:
deleteServiceEnvironmentRequest- AConsumerthat will call methods onDeleteServiceEnvironmentRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteServiceEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deregisterJobDefinition
default CompletableFuture<DeregisterJobDefinitionResponse> deregisterJobDefinition(DeregisterJobDefinitionRequest deregisterJobDefinitionRequest) Deregisters an Batch job definition. Job definitions are permanently deleted after 180 days.
- Parameters:
deregisterJobDefinitionRequest-- Returns:
- A Java Future containing the result of the DeregisterJobDefinition operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deregisterJobDefinition
default CompletableFuture<DeregisterJobDefinitionResponse> deregisterJobDefinition(Consumer<DeregisterJobDefinitionRequest.Builder> deregisterJobDefinitionRequest) Deregisters an Batch job definition. Job definitions are permanently deleted after 180 days.
This is a convenience which creates an instance of the
DeregisterJobDefinitionRequest.Builderavoiding the need to create one manually viaDeregisterJobDefinitionRequest.builder()- Parameters:
deregisterJobDefinitionRequest- AConsumerthat will call methods onDeregisterJobDefinitionRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeregisterJobDefinition operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeComputeEnvironments
default CompletableFuture<DescribeComputeEnvironmentsResponse> describeComputeEnvironments(DescribeComputeEnvironmentsRequest describeComputeEnvironmentsRequest) Describes one or more of your compute environments.
If you're using an unmanaged compute environment, you can use the
DescribeComputeEnvironmentoperation to determine theecsClusterArnthat you launch your Amazon ECS container instances into.- Parameters:
describeComputeEnvironmentsRequest- Contains the parameters forDescribeComputeEnvironments.- Returns:
- A Java Future containing the result of the DescribeComputeEnvironments operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeComputeEnvironments
default CompletableFuture<DescribeComputeEnvironmentsResponse> describeComputeEnvironments(Consumer<DescribeComputeEnvironmentsRequest.Builder> describeComputeEnvironmentsRequest) Describes one or more of your compute environments.
If you're using an unmanaged compute environment, you can use the
DescribeComputeEnvironmentoperation to determine theecsClusterArnthat you launch your Amazon ECS container instances into.
This is a convenience which creates an instance of the
DescribeComputeEnvironmentsRequest.Builderavoiding the need to create one manually viaDescribeComputeEnvironmentsRequest.builder()- Parameters:
describeComputeEnvironmentsRequest- AConsumerthat will call methods onDescribeComputeEnvironmentsRequest.Builderto create a request. Contains the parameters forDescribeComputeEnvironments.- Returns:
- A Java Future containing the result of the DescribeComputeEnvironments operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeComputeEnvironments
Describes one or more of your compute environments.
If you're using an unmanaged compute environment, you can use the
DescribeComputeEnvironmentoperation to determine theecsClusterArnthat you launch your Amazon ECS container instances into.- Returns:
- A Java Future containing the result of the DescribeComputeEnvironments operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeComputeEnvironmentsPaginator
This is a variant of
describeComputeEnvironments(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.DescribeComputeEnvironmentsPublisher publisher = client.describeComputeEnvironmentsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.DescribeComputeEnvironmentsPublisher publisher = client.describeComputeEnvironmentsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeComputeEnvironments(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsRequest)operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeComputeEnvironmentsPaginator
default DescribeComputeEnvironmentsPublisher describeComputeEnvironmentsPaginator(DescribeComputeEnvironmentsRequest describeComputeEnvironmentsRequest) This is a variant of
describeComputeEnvironments(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.DescribeComputeEnvironmentsPublisher publisher = client.describeComputeEnvironmentsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.DescribeComputeEnvironmentsPublisher publisher = client.describeComputeEnvironmentsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeComputeEnvironments(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsRequest)operation.- Parameters:
describeComputeEnvironmentsRequest- Contains the parameters forDescribeComputeEnvironments.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeComputeEnvironmentsPaginator
default DescribeComputeEnvironmentsPublisher describeComputeEnvironmentsPaginator(Consumer<DescribeComputeEnvironmentsRequest.Builder> describeComputeEnvironmentsRequest) This is a variant of
describeComputeEnvironments(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.DescribeComputeEnvironmentsPublisher publisher = client.describeComputeEnvironmentsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.DescribeComputeEnvironmentsPublisher publisher = client.describeComputeEnvironmentsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeComputeEnvironments(software.amazon.awssdk.services.batch.model.DescribeComputeEnvironmentsRequest)operation.
This is a convenience which creates an instance of the
DescribeComputeEnvironmentsRequest.Builderavoiding the need to create one manually viaDescribeComputeEnvironmentsRequest.builder()- Parameters:
describeComputeEnvironmentsRequest- AConsumerthat will call methods onDescribeComputeEnvironmentsRequest.Builderto create a request. Contains the parameters forDescribeComputeEnvironments.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeConsumableResource
default CompletableFuture<DescribeConsumableResourceResponse> describeConsumableResource(DescribeConsumableResourceRequest describeConsumableResourceRequest) Returns a description of the specified consumable resource.
- Parameters:
describeConsumableResourceRequest-- Returns:
- A Java Future containing the result of the DescribeConsumableResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeConsumableResource
default CompletableFuture<DescribeConsumableResourceResponse> describeConsumableResource(Consumer<DescribeConsumableResourceRequest.Builder> describeConsumableResourceRequest) Returns a description of the specified consumable resource.
This is a convenience which creates an instance of the
DescribeConsumableResourceRequest.Builderavoiding the need to create one manually viaDescribeConsumableResourceRequest.builder()- Parameters:
describeConsumableResourceRequest- AConsumerthat will call methods onDescribeConsumableResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DescribeConsumableResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobDefinitions
default CompletableFuture<DescribeJobDefinitionsResponse> describeJobDefinitions(DescribeJobDefinitionsRequest describeJobDefinitionsRequest) Describes a list of job definitions. You can specify a
status(such asACTIVE) to only return job definitions that match that status.- Parameters:
describeJobDefinitionsRequest- Contains the parameters forDescribeJobDefinitions.- Returns:
- A Java Future containing the result of the DescribeJobDefinitions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobDefinitions
default CompletableFuture<DescribeJobDefinitionsResponse> describeJobDefinitions(Consumer<DescribeJobDefinitionsRequest.Builder> describeJobDefinitionsRequest) Describes a list of job definitions. You can specify a
status(such asACTIVE) to only return job definitions that match that status.
This is a convenience which creates an instance of the
DescribeJobDefinitionsRequest.Builderavoiding the need to create one manually viaDescribeJobDefinitionsRequest.builder()- Parameters:
describeJobDefinitionsRequest- AConsumerthat will call methods onDescribeJobDefinitionsRequest.Builderto create a request. Contains the parameters forDescribeJobDefinitions.- Returns:
- A Java Future containing the result of the DescribeJobDefinitions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobDefinitions
Describes a list of job definitions. You can specify a
status(such asACTIVE) to only return job definitions that match that status.- Returns:
- A Java Future containing the result of the DescribeJobDefinitions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobDefinitionsPaginator
This is a variant of
describeJobDefinitions(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.DescribeJobDefinitionsPublisher publisher = client.describeJobDefinitionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.DescribeJobDefinitionsPublisher publisher = client.describeJobDefinitionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeJobDefinitions(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsRequest)operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobDefinitionsPaginator
default DescribeJobDefinitionsPublisher describeJobDefinitionsPaginator(DescribeJobDefinitionsRequest describeJobDefinitionsRequest) This is a variant of
describeJobDefinitions(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.DescribeJobDefinitionsPublisher publisher = client.describeJobDefinitionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.DescribeJobDefinitionsPublisher publisher = client.describeJobDefinitionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeJobDefinitions(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsRequest)operation.- Parameters:
describeJobDefinitionsRequest- Contains the parameters forDescribeJobDefinitions.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobDefinitionsPaginator
default DescribeJobDefinitionsPublisher describeJobDefinitionsPaginator(Consumer<DescribeJobDefinitionsRequest.Builder> describeJobDefinitionsRequest) This is a variant of
describeJobDefinitions(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.DescribeJobDefinitionsPublisher publisher = client.describeJobDefinitionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.DescribeJobDefinitionsPublisher publisher = client.describeJobDefinitionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeJobDefinitions(software.amazon.awssdk.services.batch.model.DescribeJobDefinitionsRequest)operation.
This is a convenience which creates an instance of the
DescribeJobDefinitionsRequest.Builderavoiding the need to create one manually viaDescribeJobDefinitionsRequest.builder()- Parameters:
describeJobDefinitionsRequest- AConsumerthat will call methods onDescribeJobDefinitionsRequest.Builderto create a request. Contains the parameters forDescribeJobDefinitions.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobQueues
default CompletableFuture<DescribeJobQueuesResponse> describeJobQueues(DescribeJobQueuesRequest describeJobQueuesRequest) Describes one or more of your job queues.
- Parameters:
describeJobQueuesRequest- Contains the parameters forDescribeJobQueues.- Returns:
- A Java Future containing the result of the DescribeJobQueues operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobQueues
default CompletableFuture<DescribeJobQueuesResponse> describeJobQueues(Consumer<DescribeJobQueuesRequest.Builder> describeJobQueuesRequest) Describes one or more of your job queues.
This is a convenience which creates an instance of the
DescribeJobQueuesRequest.Builderavoiding the need to create one manually viaDescribeJobQueuesRequest.builder()- Parameters:
describeJobQueuesRequest- AConsumerthat will call methods onDescribeJobQueuesRequest.Builderto create a request. Contains the parameters forDescribeJobQueues.- Returns:
- A Java Future containing the result of the DescribeJobQueues operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobQueues
Describes one or more of your job queues.
- Returns:
- A Java Future containing the result of the DescribeJobQueues operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobQueuesPaginator
This is a variant of
describeJobQueues(software.amazon.awssdk.services.batch.model.DescribeJobQueuesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.DescribeJobQueuesPublisher publisher = client.describeJobQueuesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.DescribeJobQueuesPublisher publisher = client.describeJobQueuesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.DescribeJobQueuesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.DescribeJobQueuesResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeJobQueues(software.amazon.awssdk.services.batch.model.DescribeJobQueuesRequest)operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobQueuesPaginator
default DescribeJobQueuesPublisher describeJobQueuesPaginator(DescribeJobQueuesRequest describeJobQueuesRequest) This is a variant of
describeJobQueues(software.amazon.awssdk.services.batch.model.DescribeJobQueuesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.DescribeJobQueuesPublisher publisher = client.describeJobQueuesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.DescribeJobQueuesPublisher publisher = client.describeJobQueuesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.DescribeJobQueuesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.DescribeJobQueuesResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeJobQueues(software.amazon.awssdk.services.batch.model.DescribeJobQueuesRequest)operation.- Parameters:
describeJobQueuesRequest- Contains the parameters forDescribeJobQueues.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobQueuesPaginator
default DescribeJobQueuesPublisher describeJobQueuesPaginator(Consumer<DescribeJobQueuesRequest.Builder> describeJobQueuesRequest) This is a variant of
describeJobQueues(software.amazon.awssdk.services.batch.model.DescribeJobQueuesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.DescribeJobQueuesPublisher publisher = client.describeJobQueuesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.DescribeJobQueuesPublisher publisher = client.describeJobQueuesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.DescribeJobQueuesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.DescribeJobQueuesResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeJobQueues(software.amazon.awssdk.services.batch.model.DescribeJobQueuesRequest)operation.
This is a convenience which creates an instance of the
DescribeJobQueuesRequest.Builderavoiding the need to create one manually viaDescribeJobQueuesRequest.builder()- Parameters:
describeJobQueuesRequest- AConsumerthat will call methods onDescribeJobQueuesRequest.Builderto create a request. Contains the parameters forDescribeJobQueues.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobs
default CompletableFuture<DescribeJobsResponse> describeJobs(DescribeJobsRequest describeJobsRequest) Describes a list of Batch jobs.
- Parameters:
describeJobsRequest- Contains the parameters forDescribeJobs.- Returns:
- A Java Future containing the result of the DescribeJobs operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeJobs
default CompletableFuture<DescribeJobsResponse> describeJobs(Consumer<DescribeJobsRequest.Builder> describeJobsRequest) Describes a list of Batch jobs.
This is a convenience which creates an instance of the
DescribeJobsRequest.Builderavoiding the need to create one manually viaDescribeJobsRequest.builder()- Parameters:
describeJobsRequest- AConsumerthat will call methods onDescribeJobsRequest.Builderto create a request. Contains the parameters forDescribeJobs.- Returns:
- A Java Future containing the result of the DescribeJobs operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeSchedulingPolicies
default CompletableFuture<DescribeSchedulingPoliciesResponse> describeSchedulingPolicies(DescribeSchedulingPoliciesRequest describeSchedulingPoliciesRequest) Describes one or more of your scheduling policies.
- Parameters:
describeSchedulingPoliciesRequest- Contains the parameters forDescribeSchedulingPolicies.- Returns:
- A Java Future containing the result of the DescribeSchedulingPolicies operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeSchedulingPolicies
default CompletableFuture<DescribeSchedulingPoliciesResponse> describeSchedulingPolicies(Consumer<DescribeSchedulingPoliciesRequest.Builder> describeSchedulingPoliciesRequest) Describes one or more of your scheduling policies.
This is a convenience which creates an instance of the
DescribeSchedulingPoliciesRequest.Builderavoiding the need to create one manually viaDescribeSchedulingPoliciesRequest.builder()- Parameters:
describeSchedulingPoliciesRequest- AConsumerthat will call methods onDescribeSchedulingPoliciesRequest.Builderto create a request. Contains the parameters forDescribeSchedulingPolicies.- Returns:
- A Java Future containing the result of the DescribeSchedulingPolicies operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeServiceEnvironments
default CompletableFuture<DescribeServiceEnvironmentsResponse> describeServiceEnvironments(DescribeServiceEnvironmentsRequest describeServiceEnvironmentsRequest) Describes one or more of your service environments.
- Parameters:
describeServiceEnvironmentsRequest-- Returns:
- A Java Future containing the result of the DescribeServiceEnvironments operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeServiceEnvironments
default CompletableFuture<DescribeServiceEnvironmentsResponse> describeServiceEnvironments(Consumer<DescribeServiceEnvironmentsRequest.Builder> describeServiceEnvironmentsRequest) Describes one or more of your service environments.
This is a convenience which creates an instance of the
DescribeServiceEnvironmentsRequest.Builderavoiding the need to create one manually viaDescribeServiceEnvironmentsRequest.builder()- Parameters:
describeServiceEnvironmentsRequest- AConsumerthat will call methods onDescribeServiceEnvironmentsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DescribeServiceEnvironments operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeServiceEnvironmentsPaginator
default DescribeServiceEnvironmentsPublisher describeServiceEnvironmentsPaginator(DescribeServiceEnvironmentsRequest describeServiceEnvironmentsRequest) This is a variant of
describeServiceEnvironments(software.amazon.awssdk.services.batch.model.DescribeServiceEnvironmentsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.DescribeServiceEnvironmentsPublisher publisher = client.describeServiceEnvironmentsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.DescribeServiceEnvironmentsPublisher publisher = client.describeServiceEnvironmentsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.DescribeServiceEnvironmentsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.DescribeServiceEnvironmentsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeServiceEnvironments(software.amazon.awssdk.services.batch.model.DescribeServiceEnvironmentsRequest)operation.- Parameters:
describeServiceEnvironmentsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeServiceEnvironmentsPaginator
default DescribeServiceEnvironmentsPublisher describeServiceEnvironmentsPaginator(Consumer<DescribeServiceEnvironmentsRequest.Builder> describeServiceEnvironmentsRequest) This is a variant of
describeServiceEnvironments(software.amazon.awssdk.services.batch.model.DescribeServiceEnvironmentsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.DescribeServiceEnvironmentsPublisher publisher = client.describeServiceEnvironmentsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.DescribeServiceEnvironmentsPublisher publisher = client.describeServiceEnvironmentsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.DescribeServiceEnvironmentsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.DescribeServiceEnvironmentsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeServiceEnvironments(software.amazon.awssdk.services.batch.model.DescribeServiceEnvironmentsRequest)operation.
This is a convenience which creates an instance of the
DescribeServiceEnvironmentsRequest.Builderavoiding the need to create one manually viaDescribeServiceEnvironmentsRequest.builder()- Parameters:
describeServiceEnvironmentsRequest- AConsumerthat will call methods onDescribeServiceEnvironmentsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeServiceJob
default CompletableFuture<DescribeServiceJobResponse> describeServiceJob(DescribeServiceJobRequest describeServiceJobRequest) The details of a service job.
- Parameters:
describeServiceJobRequest-- Returns:
- A Java Future containing the result of the DescribeServiceJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeServiceJob
default CompletableFuture<DescribeServiceJobResponse> describeServiceJob(Consumer<DescribeServiceJobRequest.Builder> describeServiceJobRequest) The details of a service job.
This is a convenience which creates an instance of the
DescribeServiceJobRequest.Builderavoiding the need to create one manually viaDescribeServiceJobRequest.builder()- Parameters:
describeServiceJobRequest- AConsumerthat will call methods onDescribeServiceJobRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DescribeServiceJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getJobQueueSnapshot
default CompletableFuture<GetJobQueueSnapshotResponse> getJobQueueSnapshot(GetJobQueueSnapshotRequest getJobQueueSnapshotRequest) Provides a list of the first 100
RUNNABLEjobs associated to a single job queue.- Parameters:
getJobQueueSnapshotRequest-- Returns:
- A Java Future containing the result of the GetJobQueueSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getJobQueueSnapshot
default CompletableFuture<GetJobQueueSnapshotResponse> getJobQueueSnapshot(Consumer<GetJobQueueSnapshotRequest.Builder> getJobQueueSnapshotRequest) Provides a list of the first 100
RUNNABLEjobs associated to a single job queue.
This is a convenience which creates an instance of the
GetJobQueueSnapshotRequest.Builderavoiding the need to create one manually viaGetJobQueueSnapshotRequest.builder()- Parameters:
getJobQueueSnapshotRequest- AConsumerthat will call methods onGetJobQueueSnapshotRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the GetJobQueueSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listConsumableResources
default CompletableFuture<ListConsumableResourcesResponse> listConsumableResources(ListConsumableResourcesRequest listConsumableResourcesRequest) Returns a list of Batch consumable resources.
- Parameters:
listConsumableResourcesRequest-- Returns:
- A Java Future containing the result of the ListConsumableResources operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listConsumableResources
default CompletableFuture<ListConsumableResourcesResponse> listConsumableResources(Consumer<ListConsumableResourcesRequest.Builder> listConsumableResourcesRequest) Returns a list of Batch consumable resources.
This is a convenience which creates an instance of the
ListConsumableResourcesRequest.Builderavoiding the need to create one manually viaListConsumableResourcesRequest.builder()- Parameters:
listConsumableResourcesRequest- AConsumerthat will call methods onListConsumableResourcesRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListConsumableResources operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listConsumableResourcesPaginator
default ListConsumableResourcesPublisher listConsumableResourcesPaginator(ListConsumableResourcesRequest listConsumableResourcesRequest) This is a variant of
listConsumableResources(software.amazon.awssdk.services.batch.model.ListConsumableResourcesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.ListConsumableResourcesPublisher publisher = client.listConsumableResourcesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.ListConsumableResourcesPublisher publisher = client.listConsumableResourcesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.ListConsumableResourcesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.ListConsumableResourcesResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listConsumableResources(software.amazon.awssdk.services.batch.model.ListConsumableResourcesRequest)operation.- Parameters:
listConsumableResourcesRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listConsumableResourcesPaginator
default ListConsumableResourcesPublisher listConsumableResourcesPaginator(Consumer<ListConsumableResourcesRequest.Builder> listConsumableResourcesRequest) This is a variant of
listConsumableResources(software.amazon.awssdk.services.batch.model.ListConsumableResourcesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.ListConsumableResourcesPublisher publisher = client.listConsumableResourcesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.ListConsumableResourcesPublisher publisher = client.listConsumableResourcesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.ListConsumableResourcesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.ListConsumableResourcesResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listConsumableResources(software.amazon.awssdk.services.batch.model.ListConsumableResourcesRequest)operation.
This is a convenience which creates an instance of the
ListConsumableResourcesRequest.Builderavoiding the need to create one manually viaListConsumableResourcesRequest.builder()- Parameters:
listConsumableResourcesRequest- AConsumerthat will call methods onListConsumableResourcesRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listJobs
Returns a list of Batch jobs.
You must specify only one of the following items:
-
A job queue ID to return a list of jobs in that job queue
-
A multi-node parallel job ID to return a list of nodes for that job
-
An array job ID to return a list of the children for that job
You can filter the results by job status with the
jobStatusparameter. If you don't specify a status, onlyRUNNINGjobs are returned.- Parameters:
listJobsRequest- Contains the parameters forListJobs.- Returns:
- A Java Future containing the result of the ListJobs operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
-
listJobs
default CompletableFuture<ListJobsResponse> listJobs(Consumer<ListJobsRequest.Builder> listJobsRequest) Returns a list of Batch jobs.
You must specify only one of the following items:
-
A job queue ID to return a list of jobs in that job queue
-
A multi-node parallel job ID to return a list of nodes for that job
-
An array job ID to return a list of the children for that job
You can filter the results by job status with the
jobStatusparameter. If you don't specify a status, onlyRUNNINGjobs are returned.
This is a convenience which creates an instance of the
ListJobsRequest.Builderavoiding the need to create one manually viaListJobsRequest.builder()- Parameters:
listJobsRequest- AConsumerthat will call methods onListJobsRequest.Builderto create a request. Contains the parameters forListJobs.- Returns:
- A Java Future containing the result of the ListJobs operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
-
listJobsByConsumableResource
default CompletableFuture<ListJobsByConsumableResourceResponse> listJobsByConsumableResource(ListJobsByConsumableResourceRequest listJobsByConsumableResourceRequest) Returns a list of Batch jobs that require a specific consumable resource.
- Parameters:
listJobsByConsumableResourceRequest-- Returns:
- A Java Future containing the result of the ListJobsByConsumableResource operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listJobsByConsumableResource
default CompletableFuture<ListJobsByConsumableResourceResponse> listJobsByConsumableResource(Consumer<ListJobsByConsumableResourceRequest.Builder> listJobsByConsumableResourceRequest) Returns a list of Batch jobs that require a specific consumable resource.
This is a convenience which creates an instance of the
ListJobsByConsumableResourceRequest.Builderavoiding the need to create one manually viaListJobsByConsumableResourceRequest.builder()- Parameters:
listJobsByConsumableResourceRequest- AConsumerthat will call methods onListJobsByConsumableResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListJobsByConsumableResource operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listJobsByConsumableResourcePaginator
default ListJobsByConsumableResourcePublisher listJobsByConsumableResourcePaginator(ListJobsByConsumableResourceRequest listJobsByConsumableResourceRequest) This is a variant of
listJobsByConsumableResource(software.amazon.awssdk.services.batch.model.ListJobsByConsumableResourceRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.ListJobsByConsumableResourcePublisher publisher = client.listJobsByConsumableResourcePaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.ListJobsByConsumableResourcePublisher publisher = client.listJobsByConsumableResourcePaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.ListJobsByConsumableResourceResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.ListJobsByConsumableResourceResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listJobsByConsumableResource(software.amazon.awssdk.services.batch.model.ListJobsByConsumableResourceRequest)operation.- Parameters:
listJobsByConsumableResourceRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listJobsByConsumableResourcePaginator
default ListJobsByConsumableResourcePublisher listJobsByConsumableResourcePaginator(Consumer<ListJobsByConsumableResourceRequest.Builder> listJobsByConsumableResourceRequest) This is a variant of
listJobsByConsumableResource(software.amazon.awssdk.services.batch.model.ListJobsByConsumableResourceRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.ListJobsByConsumableResourcePublisher publisher = client.listJobsByConsumableResourcePaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.ListJobsByConsumableResourcePublisher publisher = client.listJobsByConsumableResourcePaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.ListJobsByConsumableResourceResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.ListJobsByConsumableResourceResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listJobsByConsumableResource(software.amazon.awssdk.services.batch.model.ListJobsByConsumableResourceRequest)operation.
This is a convenience which creates an instance of the
ListJobsByConsumableResourceRequest.Builderavoiding the need to create one manually viaListJobsByConsumableResourceRequest.builder()- Parameters:
listJobsByConsumableResourceRequest- AConsumerthat will call methods onListJobsByConsumableResourceRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listJobsPaginator
This is a variant of
listJobs(software.amazon.awssdk.services.batch.model.ListJobsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.ListJobsPublisher publisher = client.listJobsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.ListJobsPublisher publisher = client.listJobsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.ListJobsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.ListJobsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listJobs(software.amazon.awssdk.services.batch.model.ListJobsRequest)operation.- Parameters:
listJobsRequest- Contains the parameters forListJobs.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listJobsPaginator
This is a variant of
listJobs(software.amazon.awssdk.services.batch.model.ListJobsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.ListJobsPublisher publisher = client.listJobsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.ListJobsPublisher publisher = client.listJobsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.ListJobsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.ListJobsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listJobs(software.amazon.awssdk.services.batch.model.ListJobsRequest)operation.
This is a convenience which creates an instance of the
ListJobsRequest.Builderavoiding the need to create one manually viaListJobsRequest.builder()- Parameters:
listJobsRequest- AConsumerthat will call methods onListJobsRequest.Builderto create a request. Contains the parameters forListJobs.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listSchedulingPolicies
default CompletableFuture<ListSchedulingPoliciesResponse> listSchedulingPolicies(ListSchedulingPoliciesRequest listSchedulingPoliciesRequest) Returns a list of Batch scheduling policies.
- Parameters:
listSchedulingPoliciesRequest- Contains the parameters forListSchedulingPolicies.- Returns:
- A Java Future containing the result of the ListSchedulingPolicies operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listSchedulingPolicies
default CompletableFuture<ListSchedulingPoliciesResponse> listSchedulingPolicies(Consumer<ListSchedulingPoliciesRequest.Builder> listSchedulingPoliciesRequest) Returns a list of Batch scheduling policies.
This is a convenience which creates an instance of the
ListSchedulingPoliciesRequest.Builderavoiding the need to create one manually viaListSchedulingPoliciesRequest.builder()- Parameters:
listSchedulingPoliciesRequest- AConsumerthat will call methods onListSchedulingPoliciesRequest.Builderto create a request. Contains the parameters forListSchedulingPolicies.- Returns:
- A Java Future containing the result of the ListSchedulingPolicies operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listSchedulingPoliciesPaginator
default ListSchedulingPoliciesPublisher listSchedulingPoliciesPaginator(ListSchedulingPoliciesRequest listSchedulingPoliciesRequest) This is a variant of
listSchedulingPolicies(software.amazon.awssdk.services.batch.model.ListSchedulingPoliciesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.ListSchedulingPoliciesPublisher publisher = client.listSchedulingPoliciesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.ListSchedulingPoliciesPublisher publisher = client.listSchedulingPoliciesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.ListSchedulingPoliciesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.ListSchedulingPoliciesResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listSchedulingPolicies(software.amazon.awssdk.services.batch.model.ListSchedulingPoliciesRequest)operation.- Parameters:
listSchedulingPoliciesRequest- Contains the parameters forListSchedulingPolicies.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listSchedulingPoliciesPaginator
default ListSchedulingPoliciesPublisher listSchedulingPoliciesPaginator(Consumer<ListSchedulingPoliciesRequest.Builder> listSchedulingPoliciesRequest) This is a variant of
listSchedulingPolicies(software.amazon.awssdk.services.batch.model.ListSchedulingPoliciesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.ListSchedulingPoliciesPublisher publisher = client.listSchedulingPoliciesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.ListSchedulingPoliciesPublisher publisher = client.listSchedulingPoliciesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.ListSchedulingPoliciesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.ListSchedulingPoliciesResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listSchedulingPolicies(software.amazon.awssdk.services.batch.model.ListSchedulingPoliciesRequest)operation.
This is a convenience which creates an instance of the
ListSchedulingPoliciesRequest.Builderavoiding the need to create one manually viaListSchedulingPoliciesRequest.builder()- Parameters:
listSchedulingPoliciesRequest- AConsumerthat will call methods onListSchedulingPoliciesRequest.Builderto create a request. Contains the parameters forListSchedulingPolicies.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listServiceJobs
default CompletableFuture<ListServiceJobsResponse> listServiceJobs(ListServiceJobsRequest listServiceJobsRequest) Returns a list of service jobs for a specified job queue.
- Parameters:
listServiceJobsRequest-- Returns:
- A Java Future containing the result of the ListServiceJobs operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listServiceJobs
default CompletableFuture<ListServiceJobsResponse> listServiceJobs(Consumer<ListServiceJobsRequest.Builder> listServiceJobsRequest) Returns a list of service jobs for a specified job queue.
This is a convenience which creates an instance of the
ListServiceJobsRequest.Builderavoiding the need to create one manually viaListServiceJobsRequest.builder()- Parameters:
listServiceJobsRequest- AConsumerthat will call methods onListServiceJobsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListServiceJobs operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listServiceJobsPaginator
default ListServiceJobsPublisher listServiceJobsPaginator(ListServiceJobsRequest listServiceJobsRequest) This is a variant of
listServiceJobs(software.amazon.awssdk.services.batch.model.ListServiceJobsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.ListServiceJobsPublisher publisher = client.listServiceJobsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.ListServiceJobsPublisher publisher = client.listServiceJobsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.ListServiceJobsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.ListServiceJobsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listServiceJobs(software.amazon.awssdk.services.batch.model.ListServiceJobsRequest)operation.- Parameters:
listServiceJobsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listServiceJobsPaginator
default ListServiceJobsPublisher listServiceJobsPaginator(Consumer<ListServiceJobsRequest.Builder> listServiceJobsRequest) This is a variant of
listServiceJobs(software.amazon.awssdk.services.batch.model.ListServiceJobsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.batch.paginators.ListServiceJobsPublisher publisher = client.listServiceJobsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.batch.paginators.ListServiceJobsPublisher publisher = client.listServiceJobsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.batch.model.ListServiceJobsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.batch.model.ListServiceJobsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listServiceJobs(software.amazon.awssdk.services.batch.model.ListServiceJobsRequest)operation.
This is a convenience which creates an instance of the
ListServiceJobsRequest.Builderavoiding the need to create one manually viaListServiceJobsRequest.builder()- Parameters:
listServiceJobsRequest- AConsumerthat will call methods onListServiceJobsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists the tags for an Batch resource. Batch resources that support tags are compute environments, jobs, job definitions, job queues, and scheduling policies. ARNs for child jobs of array and multi-node parallel (MNP) jobs aren't supported.
- Parameters:
listTagsForResourceRequest- Contains the parameters forListTagsForResource.- Returns:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists the tags for an Batch resource. Batch resources that support tags are compute environments, jobs, job definitions, job queues, and scheduling policies. ARNs for child jobs of array and multi-node parallel (MNP) jobs aren't supported.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto create a request. Contains the parameters forListTagsForResource.- Returns:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
registerJobDefinition
default CompletableFuture<RegisterJobDefinitionResponse> registerJobDefinition(RegisterJobDefinitionRequest registerJobDefinitionRequest) Registers an Batch job definition.
- Parameters:
registerJobDefinitionRequest- Contains the parameters forRegisterJobDefinition.- Returns:
- A Java Future containing the result of the RegisterJobDefinition operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
registerJobDefinition
default CompletableFuture<RegisterJobDefinitionResponse> registerJobDefinition(Consumer<RegisterJobDefinitionRequest.Builder> registerJobDefinitionRequest) Registers an Batch job definition.
This is a convenience which creates an instance of the
RegisterJobDefinitionRequest.Builderavoiding the need to create one manually viaRegisterJobDefinitionRequest.builder()- Parameters:
registerJobDefinitionRequest- AConsumerthat will call methods onRegisterJobDefinitionRequest.Builderto create a request. Contains the parameters forRegisterJobDefinition.- Returns:
- A Java Future containing the result of the RegisterJobDefinition operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
submitJob
Submits an Batch job from a job definition. Parameters that are specified during SubmitJob override parameters defined in the job definition. vCPU and memory requirements that are specified in the
resourceRequirementsobjects in the job definition are the exception. They can't be overridden this way using thememoryandvcpusparameters. Rather, you must specify updates to job definition parameters in aresourceRequirementsobject that's included in thecontainerOverridesparameter.Job queues with a scheduling policy are limited to 500 active share identifiers at a time.
Jobs that run on Fargate resources can't be guaranteed to run for more than 14 days. This is because, after 14 days, Fargate resources might become unavailable and job might be terminated.
- Parameters:
submitJobRequest- Contains the parameters forSubmitJob.- Returns:
- A Java Future containing the result of the SubmitJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
submitJob
default CompletableFuture<SubmitJobResponse> submitJob(Consumer<SubmitJobRequest.Builder> submitJobRequest) Submits an Batch job from a job definition. Parameters that are specified during SubmitJob override parameters defined in the job definition. vCPU and memory requirements that are specified in the
resourceRequirementsobjects in the job definition are the exception. They can't be overridden this way using thememoryandvcpusparameters. Rather, you must specify updates to job definition parameters in aresourceRequirementsobject that's included in thecontainerOverridesparameter.Job queues with a scheduling policy are limited to 500 active share identifiers at a time.
Jobs that run on Fargate resources can't be guaranteed to run for more than 14 days. This is because, after 14 days, Fargate resources might become unavailable and job might be terminated.
This is a convenience which creates an instance of the
SubmitJobRequest.Builderavoiding the need to create one manually viaSubmitJobRequest.builder()- Parameters:
submitJobRequest- AConsumerthat will call methods onSubmitJobRequest.Builderto create a request. Contains the parameters forSubmitJob.- Returns:
- A Java Future containing the result of the SubmitJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
submitServiceJob
default CompletableFuture<SubmitServiceJobResponse> submitServiceJob(SubmitServiceJobRequest submitServiceJobRequest) Submits a service job to a specified job queue to run on SageMaker AI. A service job is a unit of work that you submit to Batch for execution on SageMaker AI.
- Parameters:
submitServiceJobRequest-- Returns:
- A Java Future containing the result of the SubmitServiceJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
submitServiceJob
default CompletableFuture<SubmitServiceJobResponse> submitServiceJob(Consumer<SubmitServiceJobRequest.Builder> submitServiceJobRequest) Submits a service job to a specified job queue to run on SageMaker AI. A service job is a unit of work that you submit to Batch for execution on SageMaker AI.
This is a convenience which creates an instance of the
SubmitServiceJobRequest.Builderavoiding the need to create one manually viaSubmitServiceJobRequest.builder()- Parameters:
submitServiceJobRequest- AConsumerthat will call methods onSubmitServiceJobRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the SubmitServiceJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
Associates the specified tags to a resource with the specified
resourceArn. If existing tags on a resource aren't specified in the request parameters, they aren't changed. When a resource is deleted, the tags that are associated with that resource are deleted as well. Batch resources that support tags are compute environments, jobs, job definitions, job queues, and scheduling policies. ARNs for child jobs of array and multi-node parallel (MNP) jobs aren't supported.- Parameters:
tagResourceRequest- Contains the parameters forTagResource.- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Associates the specified tags to a resource with the specified
resourceArn. If existing tags on a resource aren't specified in the request parameters, they aren't changed. When a resource is deleted, the tags that are associated with that resource are deleted as well. Batch resources that support tags are compute environments, jobs, job definitions, job queues, and scheduling policies. ARNs for child jobs of array and multi-node parallel (MNP) jobs aren't supported.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request. Contains the parameters forTagResource.- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
terminateJob
default CompletableFuture<TerminateJobResponse> terminateJob(TerminateJobRequest terminateJobRequest) Terminates a job in a job queue. Jobs that are in the
STARTINGorRUNNINGstate are terminated, which causes them to transition toFAILED. Jobs that have not progressed to theSTARTINGstate are cancelled.- Parameters:
terminateJobRequest- Contains the parameters forTerminateJob.- Returns:
- A Java Future containing the result of the TerminateJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
terminateJob
default CompletableFuture<TerminateJobResponse> terminateJob(Consumer<TerminateJobRequest.Builder> terminateJobRequest) Terminates a job in a job queue. Jobs that are in the
STARTINGorRUNNINGstate are terminated, which causes them to transition toFAILED. Jobs that have not progressed to theSTARTINGstate are cancelled.
This is a convenience which creates an instance of the
TerminateJobRequest.Builderavoiding the need to create one manually viaTerminateJobRequest.builder()- Parameters:
terminateJobRequest- AConsumerthat will call methods onTerminateJobRequest.Builderto create a request. Contains the parameters forTerminateJob.- Returns:
- A Java Future containing the result of the TerminateJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
terminateServiceJob
default CompletableFuture<TerminateServiceJobResponse> terminateServiceJob(TerminateServiceJobRequest terminateServiceJobRequest) Terminates a service job in a job queue.
- Parameters:
terminateServiceJobRequest-- Returns:
- A Java Future containing the result of the TerminateServiceJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
terminateServiceJob
default CompletableFuture<TerminateServiceJobResponse> terminateServiceJob(Consumer<TerminateServiceJobRequest.Builder> terminateServiceJobRequest) Terminates a service job in a job queue.
This is a convenience which creates an instance of the
TerminateServiceJobRequest.Builderavoiding the need to create one manually viaTerminateServiceJobRequest.builder()- Parameters:
terminateServiceJobRequest- AConsumerthat will call methods onTerminateServiceJobRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the TerminateServiceJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Deletes specified tags from an Batch resource.
- Parameters:
untagResourceRequest- Contains the parameters forUntagResource.- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Deletes specified tags from an Batch resource.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request. Contains the parameters forUntagResource.- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateComputeEnvironment
default CompletableFuture<UpdateComputeEnvironmentResponse> updateComputeEnvironment(UpdateComputeEnvironmentRequest updateComputeEnvironmentRequest) Updates an Batch compute environment.
- Parameters:
updateComputeEnvironmentRequest- Contains the parameters forUpdateComputeEnvironment.- Returns:
- A Java Future containing the result of the UpdateComputeEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateComputeEnvironment
default CompletableFuture<UpdateComputeEnvironmentResponse> updateComputeEnvironment(Consumer<UpdateComputeEnvironmentRequest.Builder> updateComputeEnvironmentRequest) Updates an Batch compute environment.
This is a convenience which creates an instance of the
UpdateComputeEnvironmentRequest.Builderavoiding the need to create one manually viaUpdateComputeEnvironmentRequest.builder()- Parameters:
updateComputeEnvironmentRequest- AConsumerthat will call methods onUpdateComputeEnvironmentRequest.Builderto create a request. Contains the parameters forUpdateComputeEnvironment.- Returns:
- A Java Future containing the result of the UpdateComputeEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateConsumableResource
default CompletableFuture<UpdateConsumableResourceResponse> updateConsumableResource(UpdateConsumableResourceRequest updateConsumableResourceRequest) Updates a consumable resource.
- Parameters:
updateConsumableResourceRequest-- Returns:
- A Java Future containing the result of the UpdateConsumableResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateConsumableResource
default CompletableFuture<UpdateConsumableResourceResponse> updateConsumableResource(Consumer<UpdateConsumableResourceRequest.Builder> updateConsumableResourceRequest) Updates a consumable resource.
This is a convenience which creates an instance of the
UpdateConsumableResourceRequest.Builderavoiding the need to create one manually viaUpdateConsumableResourceRequest.builder()- Parameters:
updateConsumableResourceRequest- AConsumerthat will call methods onUpdateConsumableResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UpdateConsumableResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateJobQueue
default CompletableFuture<UpdateJobQueueResponse> updateJobQueue(UpdateJobQueueRequest updateJobQueueRequest) Updates a job queue.
- Parameters:
updateJobQueueRequest- Contains the parameters forUpdateJobQueue.- Returns:
- A Java Future containing the result of the UpdateJobQueue operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateJobQueue
default CompletableFuture<UpdateJobQueueResponse> updateJobQueue(Consumer<UpdateJobQueueRequest.Builder> updateJobQueueRequest) Updates a job queue.
This is a convenience which creates an instance of the
UpdateJobQueueRequest.Builderavoiding the need to create one manually viaUpdateJobQueueRequest.builder()- Parameters:
updateJobQueueRequest- AConsumerthat will call methods onUpdateJobQueueRequest.Builderto create a request. Contains the parameters forUpdateJobQueue.- Returns:
- A Java Future containing the result of the UpdateJobQueue operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateSchedulingPolicy
default CompletableFuture<UpdateSchedulingPolicyResponse> updateSchedulingPolicy(UpdateSchedulingPolicyRequest updateSchedulingPolicyRequest) Updates a scheduling policy.
- Parameters:
updateSchedulingPolicyRequest- Contains the parameters forUpdateSchedulingPolicy.- Returns:
- A Java Future containing the result of the UpdateSchedulingPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateSchedulingPolicy
default CompletableFuture<UpdateSchedulingPolicyResponse> updateSchedulingPolicy(Consumer<UpdateSchedulingPolicyRequest.Builder> updateSchedulingPolicyRequest) Updates a scheduling policy.
This is a convenience which creates an instance of the
UpdateSchedulingPolicyRequest.Builderavoiding the need to create one manually viaUpdateSchedulingPolicyRequest.builder()- Parameters:
updateSchedulingPolicyRequest- AConsumerthat will call methods onUpdateSchedulingPolicyRequest.Builderto create a request. Contains the parameters forUpdateSchedulingPolicy.- Returns:
- A Java Future containing the result of the UpdateSchedulingPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateServiceEnvironment
default CompletableFuture<UpdateServiceEnvironmentResponse> updateServiceEnvironment(UpdateServiceEnvironmentRequest updateServiceEnvironmentRequest) Updates a service environment. You can update the state of a service environment from
ENABLEDtoDISABLEDto prevent new service jobs from being placed in the service environment.- Parameters:
updateServiceEnvironmentRequest-- Returns:
- A Java Future containing the result of the UpdateServiceEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateServiceEnvironment
default CompletableFuture<UpdateServiceEnvironmentResponse> updateServiceEnvironment(Consumer<UpdateServiceEnvironmentRequest.Builder> updateServiceEnvironmentRequest) Updates a service environment. You can update the state of a service environment from
ENABLEDtoDISABLEDto prevent new service jobs from being placed in the service environment.
This is a convenience which creates an instance of the
UpdateServiceEnvironmentRequest.Builderavoiding the need to create one manually viaUpdateServiceEnvironmentRequest.builder()- Parameters:
updateServiceEnvironmentRequest- AConsumerthat will call methods onUpdateServiceEnvironmentRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UpdateServiceEnvironment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ClientException These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
- ServerException These errors are usually caused by a server issue.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- BatchException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-
create
Create aBatchAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aBatchAsyncClient.
-