aws-sdk-batch 1.42.0 → 1.47.0

data/VERSION

@@ -0,0 +1 @@
+1.47.0

data/lib/aws-sdk-batch.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-batch/customizations'
 # @!group service
 module Aws::Batch
 
-  GEM_VERSION = '1.42.0'
+  GEM_VERSION = '1.47.0'
 
 end

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -329,8 +329,8 @@ module Aws::Batch
 
     # Cancels a job in an AWS Batch job queue. Jobs that are in the
     # `SUBMITTED`, `PENDING`, or `RUNNABLE` state are canceled. Jobs that
-    # have progressed to `STARTING` or `RUNNING` are not canceled (but the
-    # API operation still succeeds, even if no job is canceled); these jobs
+    # have progressed to `STARTING` or `RUNNING` aren't canceled, but the
+    # API operation still succeeds, even if no job is canceled. These jobs
     # must be terminated with the TerminateJob operation.
     #
     # @option params [required, String] :job_id
@@ -382,34 +382,34 @@ module Aws::Batch
     # instance types of the compute resources within the environment. This
     # is based on the compute resource specification that you define or the
     # [launch template][1] that you specify when you create the compute
-    # environment. You can choose either to use EC2 On-Demand Instances and
-    # EC2 Spot Instances, or to use Fargate and Fargate Spot capacity in
-    # your managed compute environment. You can optionally set a maximum
+    # 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 below a specified percentage of the On-Demand price.
+    # is less than a specified percentage of the On-Demand price.
     #
-    # <note markdown="1"> Multi-node parallel jobs are not supported on Spot Instances.
+    # <note markdown="1"> Multi-node parallel jobs aren't supported on Spot Instances.
     #
     #  </note>
     #
     # In an unmanaged compute environment, you can manage your own EC2
     # compute resources and have a lot of flexibility with how you configure
-    # your compute resources. For example, you can use custom AMI. However,
-    # you need to verify that your AMI meets the Amazon ECS container
+    # 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][2] in the *Amazon Elastic Container Service Developer
-    # Guide*. After you have created your unmanaged compute environment, you
-    # can use the DescribeComputeEnvironments operation to find the Amazon
-    # ECS cluster that is associated with it. Then, manually launch your
-    # container instances into that Amazon ECS cluster. For more
-    # information, see [Launching an Amazon ECS container instance][3] in
-    # the *Amazon Elastic Container Service Developer Guide*.
-    #
-    # <note markdown="1"> AWS Batch doesn't upgrade the AMIs in a compute environment after
-    # it's created. For example, it doesn't update the AMIs when a newer
-    # version of the Amazon ECS-optimized AMI is available. Therefore,
-    # you're responsible for the management of the guest operating system
-    # (including updates and security patches) and any additional
+    # 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][3] in the *Amazon Elastic
+    # Container Service Developer Guide*.
+    #
+    # <note markdown="1"> AWS Batch doesn't upgrade the AMIs in a compute environment after the
+    # environment is created. For example, it doesn't update the AMIs when
+    # a newer version of the Amazon ECS optimized AMI is available.
+    # Therefore, you're responsible for managing the guest operating system
+    # (including its updates and security patches) and any additional
     # application software or utilities that you install on the compute
     # resources. To use a new AMI for your AWS Batch jobs, complete these
     # steps:
@@ -448,6 +448,18 @@ module Aws::Batch
     #   the compute environment accepts jobs from a queue and can scale out
     #   automatically based on queues.
     #
+    #   If the state is `ENABLED`, then the AWS Batch scheduler can attempt to
+    #   place jobs from an associated job queue on the compute resources
+    #   within the environment. If the compute environment is managed, then it
+    #   can scale its instances out or in automatically, based on the job
+    #   queue demand.
+    #
+    #   If the state is `DISABLED`, then the AWS Batch scheduler doesn't
+    #   attempt to place jobs within the environment. Jobs in a `STARTING` or
+    #   `RUNNING` state continue to progress normally. Managed compute
+    #   environments in the `DISABLED` state don't scale out. However, they
+    #   scale in to `minvCpus` value after instances become idle.
+    #
     # @option params [Types::ComputeResource] :compute_resources
     #   Details about the compute resources managed by the compute
     #   environment. This parameter is required for managed compute
@@ -458,23 +470,39 @@ module Aws::Batch
     #
     #   [1]: https://docs.aws.amazon.com/batch/latest/userguide/compute_environments.html
     #
-    # @option params [required, String] :service_role
+    # @option params [String] :service_role
     #   The full Amazon Resource Name (ARN) of the IAM role that allows AWS
-    #   Batch to make calls to other AWS services on your behalf.
-    #
-    #   If your specified role has a path other than `/`, then you must either
-    #   specify the full role ARN (this is recommended) or prefix the role
-    #   name with the path.
+    #   Batch to make calls to other AWS services on your behalf. For more
+    #   information, see [AWS Batch service IAM role][1] in the *AWS Batch
+    #   User Guide*.
+    #
+    #   If your account has already created the AWS Batch service-linked role,
+    #   that role is used by default for your compute environment unless you
+    #   specify a role here. If the AWS Batch service-linked role does not
+    #   exist in your account, and no role is specified here, the service will
+    #   try to create the AWS Batch service-linked role in your account.
+    #
+    #   If your specified role has a path other than `/`, then you must
+    #   specify either the full role ARN (recommended) or prefix the role name
+    #   with the path. For example, if a role with the name `bar` has a path
+    #   of `/foo/` then you would specify `/foo/bar` as the role name. For
+    #   more information, see [Friendly names and paths][2] in the *IAM User
+    #   Guide*.
     #
-    #   <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN may
-    #   contain the `service-role` path prefix. When you only specify the name
-    #   of the service role, AWS Batch assumes that your ARN doesn't use the
-    #   `service-role` path prefix. Because of this, we recommend that you
-    #   specify the full ARN of your service role when you create compute
+    #   <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN
+    #   might contain the `service-role` path prefix. When you only specify
+    #   the name of the service role, AWS Batch assumes that your ARN doesn't
+    #   use the `service-role` path prefix. Because of this, we recommend that
+    #   you specify the full ARN of your service role when you create compute
     #   environments.
     #
     #    </note>
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/batch/latest/userguide/service_IAM_role.html
+    #   [2]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-friendly-names
+    #
     # @option params [Hash<String,String>] :tags
     #   The tags that you apply to the compute environment to help you
     #   categorize and organize your resources. Each tag consists of a key and
@@ -619,7 +647,7 @@ module Aws::Batch
     #         },
     #       ],
     #     },
-    #     service_role: "String", # required
+    #     service_role: "String",
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
@@ -643,14 +671,15 @@ module Aws::Batch
     # 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 in
-    # which the AWS Batch scheduler places jobs onto its associated compute
+    # You also set a priority to the job queue that determines the order
+    # that the AWS 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.
     #
     # @option params [required, String] :job_queue_name
-    #   The name of the job queue.
+    #   The name of the job queue. Up to 128 letters (uppercase and
+    #   lowercase), numbers, and underscores are allowed.
     #
     # @option params [String] :state
     #   The state of the job queue. If the job queue state is `ENABLED`, it is
@@ -664,7 +693,9 @@ module Aws::Batch
     #   when associated with the same compute environment. Priority is
     #   determined in descending order. For example, a job queue with a
     #   priority value of `10` is given scheduling preference over a job queue
-    #   with a priority value of `1`.
+    #   with a priority value of `1`. All of the compute environments must be
+    #   either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or `FARGATE_SPOT`);
+    #   EC2 and Fargate compute environments cannot be mixed.
     #
     # @option params [required, Array<Types::ComputeEnvironmentOrder>] :compute_environment_order
     #   The set of compute environments mapped to a job queue and their order
@@ -676,15 +707,21 @@ module Aws::Batch
     #   either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or `FARGATE_SPOT`);
     #   EC2 and Fargate compute environments can't be mixed.
     #
+    #   <note markdown="1"> All compute environments that are associated with a job queue must
+    #   share the same architecture. AWS Batch doesn't support mixing compute
+    #   environment architecture types in a single job queue.
+    #
+    #    </note>
+    #
     # @option params [Hash<String,String>] :tags
     #   The tags that you apply to the job queue to help you categorize and
     #   organize your resources. Each tag consists of a key and an optional
-    #   value. For more information, see [Tagging AWS Resources][1] in *AWS
-    #   General Reference*.
+    #   value. For more information, see [Tagging your AWS Batch resources][1]
+    #   in *AWS Batch User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
+    #   [1]: https://docs.aws.amazon.com/batch/latest/userguide/using-tags.html
     #
     # @return [Types::CreateJobQueueResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -780,7 +817,7 @@ module Aws::Batch
     # operation. Compute environments that use AWS Fargate resources must
     # terminate all active jobs on that compute environment before deleting
     # the compute environment. If this isn't done, the compute environment
-    # will end up in an invalid state.
+    # enters an invalid state.
     #
     # @option params [required, String] :compute_environment
     #   The name or Amazon Resource Name (ARN) of the compute environment to
@@ -818,7 +855,8 @@ module Aws::Batch
 
     # Deletes the specified job queue. You must first disable submissions
     # for a queue with the UpdateJobQueue operation. All jobs in the queue
-    # are terminated when you delete a job 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 `DeleteJobQueue` request.
@@ -923,7 +961,7 @@ module Aws::Batch
     #   from the end of the previous results that returned the `nextToken`
     #   value. This value is `null` when there are no more results to return.
     #
-    #   <note markdown="1"> This token should be treated as an opaque identifier that is only used
+    #   <note markdown="1"> This token should be treated as an opaque identifier that's only used
     #   to retrieve the next items in a list and not for other programmatic
     #   purposes.
     #
@@ -1053,8 +1091,8 @@ module Aws::Batch
     #   The maximum number of results returned by `DescribeJobDefinitions` in
     #   paginated output. When this parameter is used,
     #   `DescribeJobDefinitions` only returns `maxResults` results in a single
-    #   page along with a `nextToken` response element. The remaining results
-    #   of the initial request can be seen by sending another
+    #   page and a `nextToken` response element. The remaining results of the
+    #   initial request can be seen by sending another
     #   `DescribeJobDefinitions` request with the returned `nextToken` value.
     #   This value can be between 1 and 100. If this parameter isn't used,
     #   then `DescribeJobDefinitions` returns up to 100 results and a
@@ -1073,7 +1111,7 @@ module Aws::Batch
     #   from the end of the previous results that returned the `nextToken`
     #   value. This value is `null` when there are no more results to return.
     #
-    #   <note markdown="1"> This token should be treated as an opaque identifier that is only used
+    #   <note markdown="1"> This token should be treated as an opaque identifier that's only used
     #   to retrieve the next items in a list and not for other programmatic
     #   purposes.
     #
@@ -1161,6 +1199,12 @@ module Aws::Batch
     #   resp.job_definitions[0].container_properties.volumes #=> Array
     #   resp.job_definitions[0].container_properties.volumes[0].host.source_path #=> String
     #   resp.job_definitions[0].container_properties.volumes[0].name #=> String
+    #   resp.job_definitions[0].container_properties.volumes[0].efs_volume_configuration.file_system_id #=> String
+    #   resp.job_definitions[0].container_properties.volumes[0].efs_volume_configuration.root_directory #=> String
+    #   resp.job_definitions[0].container_properties.volumes[0].efs_volume_configuration.transit_encryption #=> String, one of "ENABLED", "DISABLED"
+    #   resp.job_definitions[0].container_properties.volumes[0].efs_volume_configuration.transit_encryption_port #=> Integer
+    #   resp.job_definitions[0].container_properties.volumes[0].efs_volume_configuration.authorization_config.access_point_id #=> String
+    #   resp.job_definitions[0].container_properties.volumes[0].efs_volume_configuration.authorization_config.iam #=> String, one of "ENABLED", "DISABLED"
     #   resp.job_definitions[0].container_properties.environment #=> Array
     #   resp.job_definitions[0].container_properties.environment[0].name #=> String
     #   resp.job_definitions[0].container_properties.environment[0].value #=> String
@@ -1219,6 +1263,12 @@ module Aws::Batch
     #   resp.job_definitions[0].node_properties.node_range_properties[0].container.volumes #=> Array
     #   resp.job_definitions[0].node_properties.node_range_properties[0].container.volumes[0].host.source_path #=> String
     #   resp.job_definitions[0].node_properties.node_range_properties[0].container.volumes[0].name #=> String
+    #   resp.job_definitions[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.file_system_id #=> String
+    #   resp.job_definitions[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.root_directory #=> String
+    #   resp.job_definitions[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.transit_encryption #=> String, one of "ENABLED", "DISABLED"
+    #   resp.job_definitions[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.transit_encryption_port #=> Integer
+    #   resp.job_definitions[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.authorization_config.access_point_id #=> String
+    #   resp.job_definitions[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.authorization_config.iam #=> String, one of "ENABLED", "DISABLED"
     #   resp.job_definitions[0].node_properties.node_range_properties[0].container.environment #=> Array
     #   resp.job_definitions[0].node_properties.node_range_properties[0].container.environment[0].name #=> String
     #   resp.job_definitions[0].node_properties.node_range_properties[0].container.environment[0].value #=> String
@@ -1287,12 +1337,12 @@ module Aws::Batch
     # @option params [Integer] :max_results
     #   The maximum number of results returned by `DescribeJobQueues` in
     #   paginated output. When this parameter is used, `DescribeJobQueues`
-    #   only returns `maxResults` results in a single page along with a
-    #   `nextToken` response element. The remaining results of the initial
-    #   request can be seen by sending another `DescribeJobQueues` request
-    #   with the returned `nextToken` value. This value can be between 1 and
-    #   100. If this parameter isn't used, then `DescribeJobQueues` returns
-    #   up to 100 results and a `nextToken` value if applicable.
+    #   only returns `maxResults` results in a single page and a `nextToken`
+    #   response element. The remaining results of the initial request can be
+    #   seen by sending another `DescribeJobQueues` request with the returned
+    #   `nextToken` value. This value can be between 1 and 100. If this
+    #   parameter isn't used, then `DescribeJobQueues` returns up to 100
+    #   results and a `nextToken` value if applicable.
     #
     # @option params [String] :next_token
     #   The `nextToken` value returned from a previous paginated
@@ -1301,7 +1351,7 @@ module Aws::Batch
     #   from the end of the previous results that returned the `nextToken`
     #   value. This value is `null` when there are no more results to return.
     #
-    #   <note markdown="1"> This token should be treated as an opaque identifier that is only used
+    #   <note markdown="1"> This token should be treated as an opaque identifier that's only used
     #   to retrieve the next items in a list and not for other programmatic
     #   purposes.
     #
@@ -1490,6 +1540,12 @@ module Aws::Batch
     #   resp.jobs[0].container.volumes #=> Array
     #   resp.jobs[0].container.volumes[0].host.source_path #=> String
     #   resp.jobs[0].container.volumes[0].name #=> String
+    #   resp.jobs[0].container.volumes[0].efs_volume_configuration.file_system_id #=> String
+    #   resp.jobs[0].container.volumes[0].efs_volume_configuration.root_directory #=> String
+    #   resp.jobs[0].container.volumes[0].efs_volume_configuration.transit_encryption #=> String, one of "ENABLED", "DISABLED"
+    #   resp.jobs[0].container.volumes[0].efs_volume_configuration.transit_encryption_port #=> Integer
+    #   resp.jobs[0].container.volumes[0].efs_volume_configuration.authorization_config.access_point_id #=> String
+    #   resp.jobs[0].container.volumes[0].efs_volume_configuration.authorization_config.iam #=> String, one of "ENABLED", "DISABLED"
     #   resp.jobs[0].container.environment #=> Array
     #   resp.jobs[0].container.environment[0].name #=> String
     #   resp.jobs[0].container.environment[0].value #=> String
@@ -1558,6 +1614,12 @@ module Aws::Batch
     #   resp.jobs[0].node_properties.node_range_properties[0].container.volumes #=> Array
     #   resp.jobs[0].node_properties.node_range_properties[0].container.volumes[0].host.source_path #=> String
     #   resp.jobs[0].node_properties.node_range_properties[0].container.volumes[0].name #=> String
+    #   resp.jobs[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.file_system_id #=> String
+    #   resp.jobs[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.root_directory #=> String
+    #   resp.jobs[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.transit_encryption #=> String, one of "ENABLED", "DISABLED"
+    #   resp.jobs[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.transit_encryption_port #=> Integer
+    #   resp.jobs[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.authorization_config.access_point_id #=> String
+    #   resp.jobs[0].node_properties.node_range_properties[0].container.volumes[0].efs_volume_configuration.authorization_config.iam #=> String, one of "ENABLED", "DISABLED"
     #   resp.jobs[0].node_properties.node_range_properties[0].container.environment #=> Array
     #   resp.jobs[0].node_properties.node_range_properties[0].container.environment[0].name #=> String
     #   resp.jobs[0].node_properties.node_range_properties[0].container.environment[0].value #=> String
@@ -1627,9 +1689,9 @@ module Aws::Batch
     #
     # * 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 that job's nodes
+    # * A multi-node parallel job ID to return a list of nodes for that job
     #
-    # * An array job ID to return a list of that job's children
+    # * An array job ID to return a list of the children for that job
     #
     # You can filter the results by job status with the `jobStatus`
     # parameter. If you don't specify a status, only `RUNNING` jobs are
@@ -1655,12 +1717,12 @@ module Aws::Batch
     # @option params [Integer] :max_results
     #   The maximum number of results returned by `ListJobs` in paginated
     #   output. When this parameter is used, `ListJobs` only returns
-    #   `maxResults` results in a single page along with a `nextToken`
-    #   response element. The remaining results of the initial request can be
-    #   seen by sending another `ListJobs` request with the returned
-    #   `nextToken` value. This value can be between 1 and 100. If this
-    #   parameter isn't used, then `ListJobs` returns up to 100 results and a
-    #   `nextToken` value if applicable.
+    #   `maxResults` results in a single page and a `nextToken` response
+    #   element. The remaining results of the initial request can be seen by
+    #   sending another `ListJobs` request with the returned `nextToken`
+    #   value. This value can be between 1 and 100. If this parameter isn't
+    #   used, then `ListJobs` returns up to 100 results and a `nextToken`
+    #   value if applicable.
     #
     # @option params [String] :next_token
     #   The `nextToken` value returned from a previous paginated `ListJobs`
@@ -1669,7 +1731,7 @@ module Aws::Batch
     #   results that returned the `nextToken` value. This value is `null` when
     #   there are no more results to return.
     #
-    #   <note markdown="1"> This token should be treated as an opaque identifier that is only used
+    #   <note markdown="1"> This token should be treated as an opaque identifier that's only used
     #   to retrieve the next items in a list and not for other programmatic
     #   purposes.
     #
@@ -1870,7 +1932,7 @@ module Aws::Batch
     #
     # @option params [Types::RetryStrategy] :retry_strategy
     #   The retry strategy to use for failed jobs that are submitted with this
-    #   job definition. Any retry strategy that is specified during a
+    #   job definition. Any retry strategy that's specified during a
     #   SubmitJob operation overrides the retry strategy defined here. If a
     #   job is terminated due to a timeout, it isn't retried.
     #
@@ -1888,7 +1950,7 @@ module Aws::Batch
     #   definition, after which AWS Batch terminates your jobs if they have
     #   not finished. If a job is terminated due to a timeout, it isn't
     #   retried. The minimum value for the timeout is 60 seconds. Any timeout
-    #   configuration that is specified during a SubmitJob operation overrides
+    #   configuration that's specified during a SubmitJob operation overrides
     #   the timeout configuration defined here. For more information, see [Job
     #   Timeouts][1] in the *AWS Batch User Guide*.
     #
@@ -1993,6 +2055,16 @@ module Aws::Batch
     #             source_path: "String",
     #           },
     #           name: "String",
+    #           efs_volume_configuration: {
+    #             file_system_id: "String", # required
+    #             root_directory: "String",
+    #             transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
+    #             transit_encryption_port: 1,
+    #             authorization_config: {
+    #               access_point_id: "String",
+    #               iam: "ENABLED", # accepts ENABLED, DISABLED
+    #             },
+    #           },
     #         },
     #       ],
     #       environment: [
@@ -2089,6 +2161,16 @@ module Aws::Batch
     #                   source_path: "String",
     #                 },
     #                 name: "String",
+    #                 efs_volume_configuration: {
+    #                   file_system_id: "String", # required
+    #                   root_directory: "String",
+    #                   transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
+    #                   transit_encryption_port: 1,
+    #                   authorization_config: {
+    #                     access_point_id: "String",
+    #                     iam: "ENABLED", # accepts ENABLED, DISABLED
+    #                   },
+    #                 },
     #               },
     #             ],
     #             environment: [
@@ -2205,12 +2287,18 @@ module Aws::Batch
       req.send_request(options)
     end
 
-    # Submits an AWS Batch job from a job definition. Parameters specified
-    # during SubmitJob override parameters defined in the job definition.
-    #
-    # Jobs run on Fargate resources don't run for more than 14 days. After
-    # 14 days, the Fargate resources might no longer be available and the
-    # job is terminated.
+    # Submits an AWS 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
+    # `ResourceRequirements` objects in the job definition are the
+    # exception. They can't be overridden this way using the `memory` and
+    # `vcpus` parameters. Rather, you must specify updates to job definition
+    # parameters in a `ResourceRequirements` object that's included in the
+    # `containerOverrides` parameter.
+    #
+    # 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.
     #
     # @option params [required, String] :job_name
     #   The name of the job. The first character must be alphanumeric, and up
@@ -2218,8 +2306,8 @@ module Aws::Batch
     #   underscores are allowed.
     #
     # @option params [required, String] :job_queue
-    #   The job queue into which the job is submitted. You can specify either
-    #   the name or the Amazon Resource Name (ARN) of the queue.
+    #   The job queue where the job is submitted. You can specify either the
+    #   name or the Amazon Resource Name (ARN) of the queue.
     #
     # @option params [Types::ArrayProperties] :array_properties
     #   The array properties for the submitted job, such as the size of the
@@ -2254,14 +2342,13 @@ module Aws::Batch
     #   from the job definition.
     #
     # @option params [Types::ContainerOverrides] :container_overrides
-    #   A list of container overrides in JSON format that specify the name of
-    #   a container in the specified job definition and the overrides it
-    #   should receive. You can override the default command for a container
-    #   (that is specified in the job definition or the Docker image) with a
+    #   A list of container overrides in the JSON format that specify the name
+    #   of a container in the specified job definition and the overrides it
+    #   should receive. You can override the default command for a container,
+    #   which is specified in the job definition or the Docker image, with a
     #   `command` override. You can also override existing environment
-    #   variables (that are specified in the job definition or Docker image)
-    #   on a container or add new environment variables to it with an
-    #   `environment` override.
+    #   variables on a container or add new environment variables to it with
+    #   an `environment` override.
     #
     # @option params [Types::NodeOverrides] :node_overrides
     #   A list of node overrides in JSON format that specify the node range to
@@ -2593,13 +2680,36 @@ module Aws::Batch
     #   `ENABLED` state can accept jobs from a queue and scale in or out
     #   automatically based on the workload demand of its associated queues.
     #
+    #   If the state is `ENABLED`, then the AWS Batch scheduler can attempt to
+    #   place jobs from an associated job queue on the compute resources
+    #   within the environment. If the compute environment is managed, then it
+    #   can scale its instances out or in automatically, based on the job
+    #   queue demand.
+    #
+    #   If the state is `DISABLED`, then the AWS Batch scheduler doesn't
+    #   attempt to place jobs within the environment. Jobs in a `STARTING` or
+    #   `RUNNING` state continue to progress normally. Managed compute
+    #   environments in the `DISABLED` state don't scale out. However, they
+    #   scale in to `minvCpus` value after instances become idle.
+    #
     # @option params [Types::ComputeResourceUpdate] :compute_resources
     #   Details of the compute resources managed by the compute environment.
-    #   Required for a managed compute environment.
+    #   Required for a managed compute environment. For more information, see
+    #   [Compute Environments][1] in the *AWS Batch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/batch/latest/userguide/compute_environments.html
     #
     # @option params [String] :service_role
     #   The full Amazon Resource Name (ARN) of the IAM role that allows AWS
-    #   Batch to make calls to other AWS services on your behalf.
+    #   Batch to make calls to other AWS services on your behalf. For more
+    #   information, see [AWS Batch service IAM role][1] in the *AWS Batch
+    #   User Guide*.
+    #
+    #   If the compute environment has a service-linked role, it cannot be
+    #   changed to use a regular IAM role. If the compute environment has a
+    #   regular IAM role, it cannot be changed to use a service-linked role.
     #
     #   If your specified role has a path other than `/`, then you must either
     #   specify the full role ARN (this is recommended) or prefix the role
@@ -2607,13 +2717,17 @@ module Aws::Batch
     #
     #   <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN
     #   might contain the `service-role` path prefix. When you only specify
-    #   the name of the service role, AWS Batch assumes that your ARN does not
+    #   the name of the service role, AWS Batch assumes that your ARN doesn't
     #   use the `service-role` path prefix. Because of this, we recommend that
     #   you specify the full ARN of your service role when you create compute
     #   environments.
     #
     #    </note>
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/batch/latest/userguide/service_IAM_role.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
@@ -2671,9 +2785,9 @@ module Aws::Batch
     #
     # @option params [String] :state
     #   Describes the queue's ability to accept new jobs. If the job queue
-    #   state is `ENABLED`, it is able to accept jobs. If the job queue state
-    #   is `DISABLED`, new jobs cannot be added to the queue, but jobs already
-    #   in the queue can finish.
+    #   state is `ENABLED`, it can accept jobs. If the job queue state is
+    #   `DISABLED`, new jobs can't be added to the queue, but jobs already in
+    #   the queue can finish.
     #
     # @option params [Integer] :priority
     #   The priority of the job queue. Job queues with a higher priority (or a
@@ -2681,15 +2795,25 @@ module Aws::Batch
     #   when associated with the same compute environment. Priority is
     #   determined in descending order, for example, a job queue with a
     #   priority value of `10` is given scheduling preference over a job queue
-    #   with a priority value of `1`.
+    #   with a priority value of `1`. All of the compute environments must be
+    #   either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or `FARGATE_SPOT`).
+    #   EC2 and Fargate compute environments can't be mixed.
     #
     # @option params [Array<Types::ComputeEnvironmentOrder>] :compute_environment_order
     #   Details the set of compute environments mapped to a job queue and
     #   their order relative to each other. This is one of the parameters used
     #   by the job scheduler to determine which compute environment should run
-    #   a given job. All of the compute environments must be either EC2 (`EC2`
-    #   or `SPOT`) or Fargate (`FARGATE` or `FARGATE_SPOT`); EC2 and Fargate
-    #   compute environments can't be mixed.
+    #   a given job. Compute environments must be in the `VALID` state before
+    #   you can associate them with a job queue. All of the compute
+    #   environments must be either EC2 (`EC2` or `SPOT`) or Fargate
+    #   (`FARGATE` or `FARGATE_SPOT`). EC2 and Fargate compute environments
+    #   can't be mixed.
+    #
+    #   <note markdown="1"> All compute environments that are associated with a job queue must
+    #   share the same architecture. AWS Batch doesn't support mixing compute
+    #   environment architecture types in a single job queue.
+    #
+    #    </note>
     #
     # @return [Types::UpdateJobQueueResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2753,7 +2877,7 @@ module Aws::Batch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-batch'
-      context[:gem_version] = '1.42.0'
+      context[:gem_version] = '1.47.0'
       Seahorse::Client::Request.new(handlers, context)
     end