aws-sdk-batch 1.152.0 → 1.154.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 488e88591b268d8ca48d03a2c3559c70afde23c6245afe96aee62234b5ddbbad
-  data.tar.gz: b688a63582ddbb0ac32a2881a9e52fe7a4309a980b928da55e0cf34b576d27d0
+  metadata.gz: ba786436ff14560699e825e94ff398a18d0ebacef4e7c64805f75a33681c8215
+  data.tar.gz: 401dde7c0532bb4ee15ccb6406ca7b488047b30a12f4e84b53c01b9a2ba849c5
 SHA512:
-  metadata.gz: bde0562b3c1ef181aeb49a6d818fab2b2c67d51c598fd7b550b89cda31899d22056a681a932c2058915e4ab73fc639228486e75cbd940540406f1f6d5faae0ff
-  data.tar.gz: f5b8c9fa62e3b17ec41aa5119665a80cfbc426e51d25a5a2bdfb2c70a45d12da7cf69ba6c93c3e29a16d29fc8783a50f8d826abe476e01da9588b428a4cb8490
+  metadata.gz: 57da98d09d7389968f61eb0e8eb25d7ea799bf35dd5c1065cb9e0db2f2dba966b70627e4f2fc346bcb114e92cb21400f13b65f5afb20aa10d3ff5c0d9a7d6a55
+  data.tar.gz: 4d202ee0f53477584df65ab5cd3e1a2f6566d8a2daa4bd8b5d9e70d190026e62ff1000a0bb24c78f17fd15ea724a432475e3a71b6ad7f9c35d82d90e332f4aed

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.154.0 (2026-09-30)
+------------------
+
+* Feature - AWS Batch adds support for Amazon EKS access entries on EKS compute environments through the new accessEntry setting in CreateComputeEnvironment and UpdateComputeEnvironment.
+
+1.153.0 (2026-09-11)
+------------------
+
+* Feature - Added new bulk job APIs (CancelJobs, TerminateJobs, TerminateServiceJobs) and new fields on ListJobs and ListServiceJobs responses. This allows customers to cancel or terminate multiple jobs in a single request. ListJobs and ListServiceJobs responses now include isCancelled and isTerminated fields.
+
 1.152.0 (2026-09-09)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.152.0
+1.154.0

data/lib/aws-sdk-batch/client.rb

@@ -478,30 +478,30 @@ module Aws::Batch
     # `PENDING`, or `RUNNABLE` state are cancelled and the job status is
     # updated to `FAILED`.
     #
-    # <note markdown="1"> A `PENDING` job is canceled after all dependency jobs are completed.
-    # Therefore, it may take longer than expected to cancel a job in
+    # <note markdown="1"> A `PENDING` job is cancelled after all dependency jobs are completed.
+    # Therefore, it might take longer than expected to cancel a job in
     # `PENDING` status.
     #
     #  When you try to cancel an array parent job in `PENDING`, Batch
-    # attempts to cancel all child jobs. The array parent job is canceled
+    # attempts to cancel all child jobs. The array parent job is cancelled
     # when all child jobs are completed.
     #
     #  </note>
     #
     # Jobs that progressed to the `STARTING` or `RUNNING` state aren't
-    # canceled. However, the API operation still succeeds, even if no job is
-    # canceled. These jobs must be terminated with the TerminateJob
-    # operation.
+    # cancelled. However, the API operation still succeeds, even if no job
+    # is cancelled. These jobs must be terminated with the TerminateJob or
+    # TerminateJobs operation.
     #
     # @option params [required, String] :job_id
     #   The Batch job ID of the job to cancel.
     #
     # @option params [required, String] :reason
-    #   A message to attach to the job that explains the reason for canceling
+    #   A message to attach to the job that explains the reason for cancelling
     #   it. This message is returned by future DescribeJobs operations on the
     #   job. It is also recorded in the Batch activity logs.
     #
-    #   This parameter has as limit of 1024 characters.
+    #   This parameter has a limit of 1024 characters.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -535,6 +535,103 @@ module Aws::Batch
       req.send_request(options)
     end
 
+    # Cancels up to 50 jobs in an Batch job queue. This is a bulk version of
+    # CancelJob. Jobs that are in a `SUBMITTED`, `PENDING`, or `RUNNABLE`
+    # state are cancelled and the job status is updated to `FAILED`.
+    #
+    # <note markdown="1"> A `PENDING` job is cancelled after all dependency jobs are completed.
+    # Therefore, it might take longer than expected to cancel a job in
+    # `PENDING` status.
+    #
+    #  When you try to cancel an array parent job in `PENDING`, Batch
+    # attempts to cancel all child jobs. The array parent job is cancelled
+    # when all child jobs are completed.
+    #
+    #  </note>
+    #
+    # Jobs that progressed to the `STARTING` or `RUNNING` state aren't
+    # cancelled. These jobs must be terminated with the TerminateJob or
+    # TerminateJobs operation.
+    #
+    # Batch reports the result for each job individually in the response.
+    # Jobs that were processed successfully are reported in the `successful`
+    # list. Jobs that encountered errors are reported in the `errors` list.
+    # The response returns an HTTP status code of `200` even when some jobs
+    # encountered errors, so check the `errors` list. Jobs that can't be
+    # found are treated as successfully processed.
+    #
+    # This operation requires `batch:CancelJob` permission for each job in
+    # the request. There is no separate `batch:CancelJobs` IAM action. If a
+    # caller's IAM policy grants `batch:CancelJob`, they can use both the
+    # singular CancelJob and bulk `CancelJobs` operations.
+    #
+    # @option params [required, Array<String>] :jobs
+    #   An array of up to 50 Batch job IDs of the jobs to cancel.
+    #
+    # @option params [required, String] :reason
+    #   A message to attach to the job that explains the reason for cancelling
+    #   it. This message is returned by future DescribeJobs operations on the
+    #   job. It is also recorded in the Batch activity logs.
+    #
+    #   This parameter has a limit of 1024 characters.
+    #
+    # @return [Types::CancelJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CancelJobsResponse#successful #successful} => Array&lt;String&gt;
+    #   * {Types::CancelJobsResponse#errors #errors} => Array&lt;Types::CancelJobsErrorDetail&gt;
+    #
+    #
+    # @example Example: To cancel multiple jobs
+    #
+    #   # This example cancels the jobs with the specified job IDs.
+    #
+    #   resp = client.cancel_jobs({
+    #     jobs: [
+    #       "1d828f65-7a4d-42e8-996d-3b900ed59dc4", 
+    #       "b3d0f26e-6d3a-4a5b-9c2e-7f4a1b2c3d4e", 
+    #     ], 
+    #     reason: "Cancelling jobs.", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     errors: [
+    #       {
+    #         code: "ServerException", 
+    #         job: "b3d0f26e-6d3a-4a5b-9c2e-7f4a1b2c3d4e", 
+    #         message: "Failed to read job state. Please retry this job.", 
+    #       }, 
+    #     ], 
+    #     successful: [
+    #       "1d828f65-7a4d-42e8-996d-3b900ed59dc4", 
+    #     ], 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.cancel_jobs({
+    #     jobs: ["String"], # required
+    #     reason: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.successful #=> Array
+    #   resp.successful[0] #=> String
+    #   resp.errors #=> Array
+    #   resp.errors[0].job #=> String
+    #   resp.errors[0].code #=> String
+    #   resp.errors[0].message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/CancelJobs AWS API Documentation
+    #
+    # @overload cancel_jobs(params = {})
+    # @param [Hash] params ({})
+    def cancel_jobs(params = {}, options = {})
+      req = build_request(:cancel_jobs, params)
+      req.send_request(options)
+    end
+
     # Creates an Batch compute environment. You can create `MANAGED` or
     # `UNMANAGED` compute environments. `MANAGED` compute environments can
     # use Amazon EC2 or Fargate resources. `UNMANAGED` compute environments
@@ -702,10 +799,17 @@ module Aws::Batch
     #   environment.
     #
     #   <note markdown="1"> To create a compute environment that uses EKS resources, the caller
-    #   must have permissions to call `eks:DescribeCluster`.
+    #   must have permissions to call `eks:DescribeCluster`. Additional Amazon
+    #   EKS permissions are required for Batch to manage an access entry on
+    #   the cluster; see [Amazon EKS access entry authentication][1] in the
+    #   *Batch User Guide*.
     #
     #    </note>
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/batch/latest/userguide/eks-access-entries.html
+    #
     # @option params [String] :context
     #   Reserved.
     #
@@ -1024,6 +1128,10 @@ module Aws::Batch
     #     eks_configuration: {
     #       eks_cluster_arn: "String", # required
     #       kubernetes_namespace: "String", # required
+    #       access_entry: {
+    #         desired_state: "ENABLED", # required, accepts ENABLED, DISABLED, INHERIT_FROM_CLUSTER
+    #         status: "ACTIVE", # accepts ACTIVE, INACTIVE
+    #       },
     #     },
     #     context: "String",
     #     ecs_settings: {
@@ -1997,6 +2105,8 @@ module Aws::Batch
     #   resp.compute_environments[0].update_policy.job_execution_timeout_minutes #=> Integer
     #   resp.compute_environments[0].eks_configuration.eks_cluster_arn #=> String
     #   resp.compute_environments[0].eks_configuration.kubernetes_namespace #=> String
+    #   resp.compute_environments[0].eks_configuration.access_entry.desired_state #=> String, one of "ENABLED", "DISABLED", "INHERIT_FROM_CLUSTER"
+    #   resp.compute_environments[0].eks_configuration.access_entry.status #=> String, one of "ACTIVE", "INACTIVE"
     #   resp.compute_environments[0].container_orchestration_type #=> String, one of "ECS", "EKS"
     #   resp.compute_environments[0].uuid #=> String
     #   resp.compute_environments[0].context #=> String
@@ -4043,6 +4153,8 @@ module Aws::Batch
     #   resp.job_summary_list[0].node_properties.num_nodes #=> Integer
     #   resp.job_summary_list[0].node_properties.node_index #=> Integer
     #   resp.job_summary_list[0].job_definition #=> String
+    #   resp.job_summary_list[0].is_cancelled #=> Boolean
+    #   resp.job_summary_list[0].is_terminated #=> Boolean
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ListJobs AWS API Documentation
@@ -4438,6 +4550,7 @@ module Aws::Batch
     #   resp.job_summary_list[0].status_reason #=> String
     #   resp.job_summary_list[0].started_at #=> Integer
     #   resp.job_summary_list[0].stopped_at #=> Integer
+    #   resp.job_summary_list[0].is_terminated #=> Boolean
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ListServiceJobs AWS API Documentation
@@ -6352,11 +6465,11 @@ module Aws::Batch
     #   The Batch job ID of the job to terminate.
     #
     # @option params [required, String] :reason
-    #   A message to attach to the job that explains the reason for canceling
-    #   it. This message is returned by future DescribeJobs operations on the
-    #   job. It is also recorded in the Batch activity logs.
+    #   A message to attach to the job that explains the reason for
+    #   terminating it. This message is returned by future DescribeJobs
+    #   operations on the job. It is also recorded in the Batch activity logs.
     #
-    #   This parameter has as limit of 1024 characters.
+    #   This parameter has a limit of 1024 characters.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -6390,6 +6503,90 @@ module Aws::Batch
       req.send_request(options)
     end
 
+    # Terminates up to 50 jobs in a job queue. This is a bulk version of
+    # TerminateJob. Jobs that are in the `STARTING` or `RUNNING` state are
+    # terminated, which causes them to transition to `FAILED`. Jobs that
+    # have not progressed to the `STARTING` state are cancelled.
+    #
+    # Batch reports the result for each job individually in the response.
+    # Jobs that were processed successfully are reported in the `successful`
+    # list. Jobs that encountered errors are reported in the `errors` list.
+    # The response returns an HTTP status code of `200` even when some jobs
+    # encountered errors, so check the `errors` list. Jobs that can't be
+    # found are treated as successfully processed.
+    #
+    # This operation requires `batch:TerminateJob` permission for each job
+    # in the request. There is no separate `batch:TerminateJobs` IAM action.
+    # If a caller's IAM policy grants `batch:TerminateJob`, they can use
+    # both the singular TerminateJob and bulk `TerminateJobs` operations.
+    #
+    # @option params [required, Array<String>] :jobs
+    #   An array of up to 50 Batch job IDs of the jobs to terminate.
+    #
+    # @option params [required, String] :reason
+    #   A message to attach to the job that explains the reason for
+    #   terminating it. This message is returned by future DescribeJobs
+    #   operations on the job. It is also recorded in the Batch activity logs.
+    #
+    #   This parameter has a limit of 1024 characters.
+    #
+    # @return [Types::TerminateJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::TerminateJobsResponse#successful #successful} => Array&lt;String&gt;
+    #   * {Types::TerminateJobsResponse#errors #errors} => Array&lt;Types::TerminateJobsErrorDetail&gt;
+    #
+    #
+    # @example Example: To terminate multiple jobs
+    #
+    #   # This example terminates the jobs with the specified job IDs.
+    #
+    #   resp = client.terminate_jobs({
+    #     jobs: [
+    #       "61e743ed-35e4-48da-b2de-5c8333821c84", 
+    #       "b3d0f26e-6d3a-4a5b-9c2e-7f4a1b2c3d4e", 
+    #     ], 
+    #     reason: "Terminating jobs.", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     errors: [
+    #       {
+    #         code: "ServerException", 
+    #         job: "b3d0f26e-6d3a-4a5b-9c2e-7f4a1b2c3d4e", 
+    #         message: "Failed to read job state. Please retry this job.", 
+    #       }, 
+    #     ], 
+    #     successful: [
+    #       "61e743ed-35e4-48da-b2de-5c8333821c84", 
+    #     ], 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.terminate_jobs({
+    #     jobs: ["String"], # required
+    #     reason: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.successful #=> Array
+    #   resp.successful[0] #=> String
+    #   resp.errors #=> Array
+    #   resp.errors[0].job #=> String
+    #   resp.errors[0].code #=> String
+    #   resp.errors[0].message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/TerminateJobs AWS API Documentation
+    #
+    # @overload terminate_jobs(params = {})
+    # @param [Hash] params ({})
+    def terminate_jobs(params = {}, options = {})
+      req = build_request(:terminate_jobs, params)
+      req.send_request(options)
+    end
+
     # Terminates a service job in a job queue.
     #
     # @option params [required, String] :job_id
@@ -6397,7 +6594,7 @@ module Aws::Batch
     #
     # @option params [required, String] :reason
     #   A message to attach to the service job that explains the reason for
-    #   canceling it. This message is returned by `DescribeServiceJob`
+    #   terminating it. This message is returned by `DescribeServiceJob`
     #   operations on the service job.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -6418,6 +6615,88 @@ module Aws::Batch
       req.send_request(options)
     end
 
+    # Terminates up to 50 service jobs in a job queue. This is a bulk
+    # version of TerminateServiceJob.
+    #
+    # Batch reports the result for each service job individually in the
+    # response. Service jobs that were processed successfully are reported
+    # in the `successful` list. Service jobs that encountered errors are
+    # reported in the `errors` list. The response returns an HTTP status
+    # code of `200` even when some service jobs encountered errors, so check
+    # the `errors` list. Service jobs that can't be found are treated as
+    # successfully processed.
+    #
+    # This operation requires `batch:TerminateServiceJob` permission for
+    # each service job in the request. There is no separate
+    # `batch:TerminateServiceJobs` IAM action. If a caller's IAM policy
+    # grants `batch:TerminateServiceJob`, they can use both the singular
+    # `TerminateServiceJob` and bulk `TerminateServiceJobs` operations.
+    #
+    # @option params [required, Array<String>] :jobs
+    #   An array of up to 50 service job IDs of the service jobs to terminate.
+    #
+    # @option params [required, String] :reason
+    #   A message to attach to the service job that explains the reason for
+    #   terminating it. This message is returned by `DescribeServiceJob`
+    #   operations on the service job.
+    #
+    # @return [Types::TerminateServiceJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::TerminateServiceJobsResponse#successful #successful} => Array&lt;String&gt;
+    #   * {Types::TerminateServiceJobsResponse#errors #errors} => Array&lt;Types::TerminateServiceJobsErrorDetail&gt;
+    #
+    #
+    # @example Example: To terminate multiple service jobs
+    #
+    #   # This example terminates the specified service jobs with a reason.
+    #
+    #   resp = client.terminate_service_jobs({
+    #     jobs: [
+    #       "a4d6c728-8ee8-4c65-8e2a-9a5e8f4b7c3d", 
+    #       "b3d0f26e-6d3a-4a5b-9c2e-7f4a1b2c3d4e", 
+    #     ], 
+    #     reason: "Job terminated by user request", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     errors: [
+    #       {
+    #         code: "ServerException", 
+    #         job: "b3d0f26e-6d3a-4a5b-9c2e-7f4a1b2c3d4e", 
+    #         message: "Failed to read job state. Please retry this job.", 
+    #       }, 
+    #     ], 
+    #     successful: [
+    #       "a4d6c728-8ee8-4c65-8e2a-9a5e8f4b7c3d", 
+    #     ], 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.terminate_service_jobs({
+    #     jobs: ["String"], # required
+    #     reason: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.successful #=> Array
+    #   resp.successful[0] #=> String
+    #   resp.errors #=> Array
+    #   resp.errors[0].job #=> String
+    #   resp.errors[0].code #=> String
+    #   resp.errors[0].message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/TerminateServiceJobs AWS API Documentation
+    #
+    # @overload terminate_service_jobs(params = {})
+    # @param [Hash] params ({})
+    def terminate_service_jobs(params = {}, options = {})
+      req = build_request(:terminate_service_jobs, params)
+      req.send_request(options)
+    end
+
     # Deletes specified tags from an Batch resource.
     #
     # @option params [required, String] :resource_arn
@@ -6567,6 +6846,18 @@ module Aws::Batch
     #   control CloudWatch Container Insights collection for the compute
     #   environment.
     #
+    # @option params [Types::EksConfigurationUpdate] :eks_configuration
+    #   Updates the Amazon EKS configuration for the compute environment. Only
+    #   specify this parameter if the compute environment's
+    #   `containerOrchestrationType` is `EKS`. Currently, the `accessEntry`
+    #   setting is the only Amazon EKS configuration that you can change after
+    #   the compute environment is created. For more information, see [Amazon
+    #   EKS access entry authentication][1] in the *Batch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/batch/latest/userguide/eks-access-entries.html
+    #
     # @return [Types::UpdateComputeEnvironmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateComputeEnvironmentResponse#compute_environment_name #compute_environment_name} => String
@@ -6680,6 +6971,12 @@ module Aws::Batch
     #     ecs_settings: {
     #       container_insights: "ENABLED", # accepts ENABLED, ENHANCED, DISABLED
     #     },
+    #     eks_configuration: {
+    #       access_entry: {
+    #         desired_state: "ENABLED", # required, accepts ENABLED, DISABLED, INHERIT_FROM_CLUSTER
+    #         status: "ACTIVE", # accepts ACTIVE, INACTIVE
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -7114,7 +7411,7 @@ module Aws::Batch
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-batch'
-      context[:gem_version] = '1.152.0'
+      context[:gem_version] = '1.154.0'
       Seahorse::Client::Request.new(handlers, context)
     end