aws-sdk-batch 1.62.0 → 1.63.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -352,10 +352,10 @@ module Aws::Batch
352
352
  # @!group API Operations
353
353
 
354
354
  # Cancels a job in an Batch job queue. Jobs that are in the `SUBMITTED`,
355
- # `PENDING`, or `RUNNABLE` state are canceled. Jobs that have progressed
356
- # to `STARTING` or `RUNNING` aren't canceled, but the API operation
357
- # still succeeds, even if no job is canceled. These jobs must be
358
- # terminated with the TerminateJob operation.
355
+ # `PENDING`, or `RUNNABLE` state are canceled. Jobs that progressed to
356
+ # the `STARTING` or `RUNNING` state aren't canceled. However, the API
357
+ # operation still succeeds, even if no job is canceled. These jobs must
358
+ # be terminated with the TerminateJob operation.
359
359
  #
360
360
  # @option params [required, String] :job_id
361
361
  # The Batch job ID of the job to cancel.
@@ -417,9 +417,9 @@ module Aws::Batch
417
417
  # </note>
418
418
  #
419
419
  # In an unmanaged compute environment, you can manage your own EC2
420
- # compute resources and have a lot of flexibility with how you configure
421
- # your compute resources. For example, you can use custom AMIs. However,
422
- # you must verify that each of your AMIs meet the Amazon ECS container
420
+ # compute resources and have flexibility with how you configure your
421
+ # compute resources. For example, you can use custom AMIs. However, you
422
+ # must verify that each of your AMIs meet the Amazon ECS container
423
423
  # instance AMI specification. For more information, see [container
424
424
  # instance AMIs][2] in the *Amazon Elastic Container Service Developer
425
425
  # Guide*. After you created your unmanaged compute environment, you can
@@ -452,7 +452,7 @@ module Aws::Batch
452
452
  # environments][4]. To use the enhanced updating of compute environments
453
453
  # to update AMIs, follow these rules:
454
454
  #
455
- # * Either do not set the service role (`serviceRole`) parameter or set
455
+ # * Either don't set the service role (`serviceRole`) parameter or set
456
456
  # it to the **AWSBatchServiceRole** service-linked role.
457
457
  #
458
458
  # * Set the allocation strategy (`allocationStrategy`) parameter to
@@ -461,28 +461,28 @@ module Aws::Batch
461
461
  # * Set the update to latest image version
462
462
  # (`updateToLatestImageVersion`) parameter to `true`.
463
463
  #
464
- # * Do not specify an AMI ID in `imageId`, `imageIdOverride` (in [
464
+ # * Don't specify an AMI ID in `imageId`, `imageIdOverride` (in [
465
465
  # `ec2Configuration` ][5]), or in the launch template
466
- # (`launchTemplate`). In that case Batch will select the latest Amazon
467
- # ECS optimized AMI supported by Batch at the time the infrastructure
468
- # update is initiated. Alternatively you can specify the AMI ID in the
469
- # `imageId` or `imageIdOverride` parameters, or the launch template
470
- # identified by the `LaunchTemplate` properties. Changing any of these
471
- # properties will trigger an infrastructure update. If the AMI ID is
472
- # specified in the launch template, it can not be replaced by
473
- # specifying an AMI ID in either the `imageId` or `imageIdOverride`
474
- # parameters. It can only be replaced by specifying a different launch
475
- # template, or if the launch template version is set to `$Default` or
476
- # `$Latest`, by setting either a new default version for the launch
477
- # template (if `$Default`)or by adding a new version to the launch
478
- # template (if `$Latest`).
479
- #
480
- # If these rules are followed, any update that triggers an
481
- # infrastructure update will cause the AMI ID to be re-selected. If the
482
- # `version` setting in the launch template (`launchTemplate`) is set to
483
- # `$Latest` or `$Default`, the latest or default version of the launch
484
- # template will be evaluated up at the time of the infrastructure
485
- # update, even if the `launchTemplate` was not updated.
466
+ # (`launchTemplate`). In that case, Batch selects the latest Amazon
467
+ # ECS optimized AMI that's supported by Batch at the time the
468
+ # infrastructure update is initiated. Alternatively, you can specify
469
+ # the AMI ID in the `imageId` or `imageIdOverride` parameters, or the
470
+ # launch template identified by the `LaunchTemplate` properties.
471
+ # Changing any of these properties starts an infrastructure update. If
472
+ # the AMI ID is specified in the launch template, it can't be
473
+ # replaced by specifying an AMI ID in either the `imageId` or
474
+ # `imageIdOverride` parameters. It can only be replaced by specifying
475
+ # a different launch template, or if the launch template version is
476
+ # set to `$Default` or `$Latest`, by setting either a new default
477
+ # version for the launch template (if `$Default`) or by adding a new
478
+ # version to the launch template (if `$Latest`).
479
+ #
480
+ # If these rules are followed, any update that starts an infrastructure
481
+ # update causes the AMI ID to be re-selected. If the `version` setting
482
+ # in the launch template (`launchTemplate`) is set to `$Latest` or
483
+ # `$Default`, the latest or default version of the launch template is
484
+ # evaluated up at the time of the infrastructure update, even if the
485
+ # `launchTemplate` wasn't updated.
486
486
  #
487
487
  # </note>
488
488
  #
@@ -495,7 +495,7 @@ module Aws::Batch
495
495
  # [5]: https://docs.aws.amazon.com/batch/latest/APIReference/API_Ec2Configuration.html
496
496
  #
497
497
  # @option params [required, String] :compute_environment_name
498
- # The name for your compute environment. It can be up to 128 letters
498
+ # The name for your compute environment. It can be up to 128 characters
499
499
  # long. It can contain uppercase and lowercase letters, numbers, hyphens
500
500
  # (-), and underscores (\_).
501
501
  #
@@ -562,9 +562,8 @@ module Aws::Batch
562
562
  # If your specified role has a path other than `/`, then you must
563
563
  # specify either the full role ARN (recommended) or prefix the role name
564
564
  # with the path. For example, if a role with the name `bar` has a path
565
- # of `/foo/` then you would specify `/foo/bar` as the role name. For
566
- # more information, see [Friendly names and paths][2] in the *IAM User
567
- # Guide*.
565
+ # of `/foo/`, specify `/foo/bar` as the role name. For more information,
566
+ # see [Friendly names and paths][2] in the *IAM User Guide*.
568
567
  #
569
568
  # <note markdown="1"> Depending on how you created your Batch service role, its ARN might
570
569
  # contain the `service-role` path prefix. When you only specify the name
@@ -596,6 +595,10 @@ module Aws::Batch
596
595
  # [2]: https://docs.aws.amazon.com/batch/latest/APIReference/API_TagResource.html
597
596
  # [3]: https://docs.aws.amazon.com/batch/latest/APIReference/API_UntagResource.html
598
597
  #
598
+ # @option params [Types::EksConfiguration] :eks_configuration
599
+ # The details for the Amazon EKS cluster that supports the compute
600
+ # environment.
601
+ #
599
602
  # @return [Types::CreateComputeEnvironmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
600
603
  #
601
604
  # * {Types::CreateComputeEnvironmentResponse#compute_environment_name #compute_environment_name} => String
@@ -722,6 +725,7 @@ module Aws::Batch
722
725
  # {
723
726
  # image_type: "ImageType", # required
724
727
  # image_id_override: "ImageIdOverride",
728
+ # image_kubernetes_version: "KubernetesVersion",
725
729
  # },
726
730
  # ],
727
731
  # },
@@ -729,6 +733,10 @@ module Aws::Batch
729
733
  # tags: {
730
734
  # "TagKey" => "TagValue",
731
735
  # },
736
+ # eks_configuration: {
737
+ # eks_cluster_arn: "String", # required
738
+ # kubernetes_namespace: "String", # required
739
+ # },
732
740
  # })
733
741
  #
734
742
  # @example Response structure
@@ -775,7 +783,7 @@ module Aws::Batch
775
783
  # scheduling policy. The format is
776
784
  # `aws:Partition:batch:Region:Account:scheduling-policy/Name `. An
777
785
  # example is
778
- # `aws:aws:batch:us-west-2:012345678910:scheduling-policy/MySchedulingPolicy`.
786
+ # `aws:aws:batch:us-west-2:123456789012:scheduling-policy/MySchedulingPolicy`.
779
787
  #
780
788
  # @option params [required, Integer] :priority
781
789
  # The priority of the job queue. Job queues with a higher priority (or a
@@ -1139,9 +1147,8 @@ module Aws::Batch
1139
1147
  # from the end of the previous results that returned the `nextToken`
1140
1148
  # value. This value is `null` when there are no more results to return.
1141
1149
  #
1142
- # <note markdown="1"> This token should be treated as an opaque identifier that's only used
1143
- # to retrieve the next items in a list and not for other programmatic
1144
- # purposes.
1150
+ # <note markdown="1"> Treat this token as an opaque identifier that's only used to retrieve
1151
+ # the next items in a list and not for other programmatic purposes.
1145
1152
  #
1146
1153
  # </note>
1147
1154
  #
@@ -1247,9 +1254,14 @@ module Aws::Batch
1247
1254
  # resp.compute_environments[0].compute_resources.ec2_configuration #=> Array
1248
1255
  # resp.compute_environments[0].compute_resources.ec2_configuration[0].image_type #=> String
1249
1256
  # resp.compute_environments[0].compute_resources.ec2_configuration[0].image_id_override #=> String
1257
+ # resp.compute_environments[0].compute_resources.ec2_configuration[0].image_kubernetes_version #=> String
1250
1258
  # resp.compute_environments[0].service_role #=> String
1251
1259
  # resp.compute_environments[0].update_policy.terminate_jobs_on_update #=> Boolean
1252
1260
  # resp.compute_environments[0].update_policy.job_execution_timeout_minutes #=> Integer
1261
+ # resp.compute_environments[0].eks_configuration.eks_cluster_arn #=> String
1262
+ # resp.compute_environments[0].eks_configuration.kubernetes_namespace #=> String
1263
+ # resp.compute_environments[0].container_orchestration_type #=> String, one of "ECS", "EKS"
1264
+ # resp.compute_environments[0].uuid #=> String
1253
1265
  # resp.next_token #=> String
1254
1266
  #
1255
1267
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/DescribeComputeEnvironments AWS API Documentation
@@ -1295,9 +1307,8 @@ module Aws::Batch
1295
1307
  # from the end of the previous results that returned the `nextToken`
1296
1308
  # value. This value is `null` when there are no more results to return.
1297
1309
  #
1298
- # <note markdown="1"> This token should be treated as an opaque identifier that's only used
1299
- # to retrieve the next items in a list and not for other programmatic
1300
- # purposes.
1310
+ # <note markdown="1"> Treat this token as an opaque identifier that's only used to retrieve
1311
+ # the next items in a list and not for other programmatic purposes.
1301
1312
  #
1302
1313
  # </note>
1303
1314
  #
@@ -1510,6 +1521,41 @@ module Aws::Batch
1510
1521
  # resp.job_definitions[0].propagate_tags #=> Boolean
1511
1522
  # resp.job_definitions[0].platform_capabilities #=> Array
1512
1523
  # resp.job_definitions[0].platform_capabilities[0] #=> String, one of "EC2", "FARGATE"
1524
+ # resp.job_definitions[0].eks_properties.pod_properties.service_account_name #=> String
1525
+ # resp.job_definitions[0].eks_properties.pod_properties.host_network #=> Boolean
1526
+ # resp.job_definitions[0].eks_properties.pod_properties.dns_policy #=> String
1527
+ # resp.job_definitions[0].eks_properties.pod_properties.containers #=> Array
1528
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].name #=> String
1529
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].image #=> String
1530
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].image_pull_policy #=> String
1531
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].command #=> Array
1532
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].command[0] #=> String
1533
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].args #=> Array
1534
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].args[0] #=> String
1535
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].env #=> Array
1536
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].env[0].name #=> String
1537
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].env[0].value #=> String
1538
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].resources.limits #=> Hash
1539
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].resources.limits["String"] #=> String
1540
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].resources.requests #=> Hash
1541
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].resources.requests["String"] #=> String
1542
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].volume_mounts #=> Array
1543
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].volume_mounts[0].name #=> String
1544
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].volume_mounts[0].mount_path #=> String
1545
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].volume_mounts[0].read_only #=> Boolean
1546
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].security_context.run_as_user #=> Integer
1547
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].security_context.run_as_group #=> Integer
1548
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].security_context.privileged #=> Boolean
1549
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].security_context.read_only_root_filesystem #=> Boolean
1550
+ # resp.job_definitions[0].eks_properties.pod_properties.containers[0].security_context.run_as_non_root #=> Boolean
1551
+ # resp.job_definitions[0].eks_properties.pod_properties.volumes #=> Array
1552
+ # resp.job_definitions[0].eks_properties.pod_properties.volumes[0].name #=> String
1553
+ # resp.job_definitions[0].eks_properties.pod_properties.volumes[0].host_path.path #=> String
1554
+ # resp.job_definitions[0].eks_properties.pod_properties.volumes[0].empty_dir.medium #=> String
1555
+ # resp.job_definitions[0].eks_properties.pod_properties.volumes[0].empty_dir.size_limit #=> String
1556
+ # resp.job_definitions[0].eks_properties.pod_properties.volumes[0].secret.secret_name #=> String
1557
+ # resp.job_definitions[0].eks_properties.pod_properties.volumes[0].secret.optional #=> Boolean
1558
+ # resp.job_definitions[0].container_orchestration_type #=> String, one of "ECS", "EKS"
1513
1559
  # resp.next_token #=> String
1514
1560
  #
1515
1561
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/DescribeJobDefinitions AWS API Documentation
@@ -1544,9 +1590,8 @@ module Aws::Batch
1544
1590
  # from the end of the previous results that returned the `nextToken`
1545
1591
  # value. This value is `null` when there are no more results to return.
1546
1592
  #
1547
- # <note markdown="1"> This token should be treated as an opaque identifier that's only used
1548
- # to retrieve the next items in a list and not for other programmatic
1549
- # purposes.
1593
+ # <note markdown="1"> Treat this token as an opaque identifier that's only used to retrieve
1594
+ # the next items in a list and not for other programmatic purposes.
1550
1595
  #
1551
1596
  # </note>
1552
1597
  #
@@ -1869,6 +1914,53 @@ module Aws::Batch
1869
1914
  # resp.jobs[0].propagate_tags #=> Boolean
1870
1915
  # resp.jobs[0].platform_capabilities #=> Array
1871
1916
  # resp.jobs[0].platform_capabilities[0] #=> String, one of "EC2", "FARGATE"
1917
+ # resp.jobs[0].eks_properties.pod_properties.service_account_name #=> String
1918
+ # resp.jobs[0].eks_properties.pod_properties.host_network #=> Boolean
1919
+ # resp.jobs[0].eks_properties.pod_properties.dns_policy #=> String
1920
+ # resp.jobs[0].eks_properties.pod_properties.containers #=> Array
1921
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].name #=> String
1922
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].image #=> String
1923
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].image_pull_policy #=> String
1924
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].command #=> Array
1925
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].command[0] #=> String
1926
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].args #=> Array
1927
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].args[0] #=> String
1928
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].env #=> Array
1929
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].env[0].name #=> String
1930
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].env[0].value #=> String
1931
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].resources.limits #=> Hash
1932
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].resources.limits["String"] #=> String
1933
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].resources.requests #=> Hash
1934
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].resources.requests["String"] #=> String
1935
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].exit_code #=> Integer
1936
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].reason #=> String
1937
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].volume_mounts #=> Array
1938
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].volume_mounts[0].name #=> String
1939
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].volume_mounts[0].mount_path #=> String
1940
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].volume_mounts[0].read_only #=> Boolean
1941
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].security_context.run_as_user #=> Integer
1942
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].security_context.run_as_group #=> Integer
1943
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].security_context.privileged #=> Boolean
1944
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].security_context.read_only_root_filesystem #=> Boolean
1945
+ # resp.jobs[0].eks_properties.pod_properties.containers[0].security_context.run_as_non_root #=> Boolean
1946
+ # resp.jobs[0].eks_properties.pod_properties.volumes #=> Array
1947
+ # resp.jobs[0].eks_properties.pod_properties.volumes[0].name #=> String
1948
+ # resp.jobs[0].eks_properties.pod_properties.volumes[0].host_path.path #=> String
1949
+ # resp.jobs[0].eks_properties.pod_properties.volumes[0].empty_dir.medium #=> String
1950
+ # resp.jobs[0].eks_properties.pod_properties.volumes[0].empty_dir.size_limit #=> String
1951
+ # resp.jobs[0].eks_properties.pod_properties.volumes[0].secret.secret_name #=> String
1952
+ # resp.jobs[0].eks_properties.pod_properties.volumes[0].secret.optional #=> Boolean
1953
+ # resp.jobs[0].eks_properties.pod_properties.pod_name #=> String
1954
+ # resp.jobs[0].eks_properties.pod_properties.node_name #=> String
1955
+ # resp.jobs[0].eks_attempts #=> Array
1956
+ # resp.jobs[0].eks_attempts[0].containers #=> Array
1957
+ # resp.jobs[0].eks_attempts[0].containers[0].exit_code #=> Integer
1958
+ # resp.jobs[0].eks_attempts[0].containers[0].reason #=> String
1959
+ # resp.jobs[0].eks_attempts[0].pod_name #=> String
1960
+ # resp.jobs[0].eks_attempts[0].node_name #=> String
1961
+ # resp.jobs[0].eks_attempts[0].started_at #=> Integer
1962
+ # resp.jobs[0].eks_attempts[0].stopped_at #=> Integer
1963
+ # resp.jobs[0].eks_attempts[0].status_reason #=> String
1872
1964
  #
1873
1965
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/DescribeJobs AWS API Documentation
1874
1966
  #
@@ -1967,9 +2059,8 @@ module Aws::Batch
1967
2059
  # results that returned the `nextToken` value. This value is `null` when
1968
2060
  # there are no more results to return.
1969
2061
  #
1970
- # <note markdown="1"> This token should be treated as an opaque identifier that's only used
1971
- # to retrieve the next items in a list and not for other programmatic
1972
- # purposes.
2062
+ # <note markdown="1"> Treat this token as an opaque identifier that's only used to retrieve
2063
+ # the next items in a list and not for other programmatic purposes.
1973
2064
  #
1974
2065
  # </note>
1975
2066
  #
@@ -1983,7 +2074,7 @@ module Aws::Batch
1983
2074
  # JOB\_NAME
1984
2075
  #
1985
2076
  # : The value of the filter is a case-insensitive match for the job
1986
- # name. If the value ends with an asterisk (*), the filter will match
2077
+ # name. If the value ends with an asterisk (*), the filter matches
1987
2078
  # any job name that begins with the string before the '*'. This
1988
2079
  # corresponds to the `jobName` value. For example, `test1` matches
1989
2080
  # both `Test1` and `test1`, and `test1*` matches both `test1` and
@@ -1997,7 +2088,7 @@ module Aws::Batch
1997
2088
  # value. The value is case sensitive. When the value for the filter is
1998
2089
  # the job definition name, the results include all the jobs that used
1999
2090
  # any revision of that job definition name. If the value ends with an
2000
- # asterisk (*), the filter will match any job definition name that
2091
+ # asterisk (*), the filter matches any job definition name that
2001
2092
  # begins with the string before the '*'. For example, `jd1` matches
2002
2093
  # only `jd1`, and `jd1*` matches both `jd1` and `jd1A`. The version of
2003
2094
  # the job definition that's used doesn't affect the sort order. When
@@ -2005,7 +2096,7 @@ module Aws::Batch
2005
2096
  # the form
2006
2097
  # `arn:$\{Partition\}:batch:$\{Region\}:$\{Account\}:job-definition/$\{JobDefinitionName\}:$\{Revision\}`),
2007
2098
  # the results include jobs that used the specified revision of the job
2008
- # definition. Asterisk (*) is not supported when the ARN is used.
2099
+ # definition. Asterisk (*) isn't supported when the ARN is used.
2009
2100
  #
2010
2101
  # BEFORE\_CREATED\_AT
2011
2102
  #
@@ -2133,9 +2224,8 @@ module Aws::Batch
2133
2224
  # from the end of the previous results that returned the `nextToken`
2134
2225
  # value. This value is `null` when there are no more results to return.
2135
2226
  #
2136
- # <note markdown="1"> This token should be treated as an opaque identifier that's only used
2137
- # to retrieve the next items in a list and not for other programmatic
2138
- # purposes.
2227
+ # <note markdown="1"> Treat this token as an opaque identifier that's only used to retrieve
2228
+ # the next items in a list and not for other programmatic purposes.
2139
2229
  #
2140
2230
  # </note>
2141
2231
  #
@@ -2171,14 +2261,14 @@ module Aws::Batch
2171
2261
  # Lists the tags for an Batch resource. Batch resources that support
2172
2262
  # tags are compute environments, jobs, job definitions, job queues, and
2173
2263
  # scheduling policies. ARNs for child jobs of array and multi-node
2174
- # parallel (MNP) jobs are not supported.
2264
+ # parallel (MNP) jobs aren't supported.
2175
2265
  #
2176
2266
  # @option params [required, String] :resource_arn
2177
2267
  # The Amazon Resource Name (ARN) that identifies the resource that tags
2178
2268
  # are listed for. Batch resources that support tags are compute
2179
2269
  # environments, jobs, job definitions, job queues, and scheduling
2180
2270
  # policies. ARNs for child jobs of array and multi-node parallel (MNP)
2181
- # jobs are not supported.
2271
+ # jobs aren't supported.
2182
2272
  #
2183
2273
  # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2184
2274
  #
@@ -2251,18 +2341,19 @@ module Aws::Batch
2251
2341
  #
2252
2342
  # @option params [Integer] :scheduling_priority
2253
2343
  # The scheduling priority for jobs that are submitted with this job
2254
- # definition. This will only affect jobs in job queues with a fair share
2255
- # policy. Jobs with a higher scheduling priority will be scheduled
2256
- # before jobs with a lower scheduling priority.
2344
+ # definition. This only affects jobs in job queues with a fair share
2345
+ # policy. Jobs with a higher scheduling priority are scheduled before
2346
+ # jobs with a lower scheduling priority.
2257
2347
  #
2258
2348
  # The minimum supported value is 0 and the maximum supported value is
2259
2349
  # 9999.
2260
2350
  #
2261
2351
  # @option params [Types::ContainerProperties] :container_properties
2262
- # An object with various properties specific to single-node
2263
- # container-based jobs. If the job definition's `type` parameter is
2264
- # `container`, then you must specify either `containerProperties` or
2265
- # `nodeProperties`.
2352
+ # An object with various properties specific to Amazon ECS based
2353
+ # single-node container-based jobs. If the job definition's `type`
2354
+ # parameter is `container`, then you must specify either
2355
+ # `containerProperties` or `nodeProperties`. This must not be specified
2356
+ # for Amazon EKS based job definitions.
2266
2357
  #
2267
2358
  # <note markdown="1"> If the job runs on Fargate resources, then you must not specify
2268
2359
  # `nodeProperties`; use only `containerProperties`.
@@ -2282,6 +2373,11 @@ module Aws::Batch
2282
2373
  #
2283
2374
  # </note>
2284
2375
  #
2376
+ # <note markdown="1"> If the job runs on Amazon EKS resources, then you must not specify
2377
+ # `nodeProperties`.
2378
+ #
2379
+ # </note>
2380
+ #
2285
2381
  #
2286
2382
  #
2287
2383
  # [1]: https://docs.aws.amazon.com/batch/latest/userguide/multi-node-parallel-jobs.html
@@ -2301,6 +2397,11 @@ module Aws::Batch
2301
2397
  # tags from the job and job definition is over 50, the job is moved to
2302
2398
  # the `FAILED` state.
2303
2399
  #
2400
+ # <note markdown="1"> If the job runs on Amazon EKS resources, then you must not specify
2401
+ # `propagateTags`.
2402
+ #
2403
+ # </note>
2404
+ #
2304
2405
  # @option params [Types::JobTimeout] :timeout
2305
2406
  # The timeout configuration for jobs that are submitted with this job
2306
2407
  # definition, after which Batch terminates your jobs if they have not
@@ -2329,6 +2430,16 @@ module Aws::Batch
2329
2430
  # is specified, it defaults to `EC2`. To run the job on Fargate
2330
2431
  # resources, specify `FARGATE`.
2331
2432
  #
2433
+ # <note markdown="1"> If the job runs on Amazon EKS resources, then you must not specify
2434
+ # `platformCapabilities`.
2435
+ #
2436
+ # </note>
2437
+ #
2438
+ # @option params [Types::EksProperties] :eks_properties
2439
+ # An object with various properties that are specific to Amazon EKS
2440
+ # based jobs. This must not be specified for Amazon ECS based job
2441
+ # definitions.
2442
+ #
2332
2443
  # @return [Types::RegisterJobDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2333
2444
  #
2334
2445
  # * {Types::RegisterJobDefinitionResponse#job_definition_name #job_definition_name} => String
@@ -2643,6 +2754,66 @@ module Aws::Batch
2643
2754
  # "TagKey" => "TagValue",
2644
2755
  # },
2645
2756
  # platform_capabilities: ["EC2"], # accepts EC2, FARGATE
2757
+ # eks_properties: {
2758
+ # pod_properties: {
2759
+ # service_account_name: "String",
2760
+ # host_network: false,
2761
+ # dns_policy: "String",
2762
+ # containers: [
2763
+ # {
2764
+ # name: "String",
2765
+ # image: "String", # required
2766
+ # image_pull_policy: "String",
2767
+ # command: ["String"],
2768
+ # args: ["String"],
2769
+ # env: [
2770
+ # {
2771
+ # name: "String", # required
2772
+ # value: "String",
2773
+ # },
2774
+ # ],
2775
+ # resources: {
2776
+ # limits: {
2777
+ # "String" => "Quantity",
2778
+ # },
2779
+ # requests: {
2780
+ # "String" => "Quantity",
2781
+ # },
2782
+ # },
2783
+ # volume_mounts: [
2784
+ # {
2785
+ # name: "String",
2786
+ # mount_path: "String",
2787
+ # read_only: false,
2788
+ # },
2789
+ # ],
2790
+ # security_context: {
2791
+ # run_as_user: 1,
2792
+ # run_as_group: 1,
2793
+ # privileged: false,
2794
+ # read_only_root_filesystem: false,
2795
+ # run_as_non_root: false,
2796
+ # },
2797
+ # },
2798
+ # ],
2799
+ # volumes: [
2800
+ # {
2801
+ # name: "String", # required
2802
+ # host_path: {
2803
+ # path: "String",
2804
+ # },
2805
+ # empty_dir: {
2806
+ # medium: "String",
2807
+ # size_limit: "Quantity",
2808
+ # },
2809
+ # secret: {
2810
+ # secret_name: "String", # required
2811
+ # optional: false,
2812
+ # },
2813
+ # },
2814
+ # ],
2815
+ # },
2816
+ # },
2646
2817
  # })
2647
2818
  #
2648
2819
  # @example Response structure
@@ -2688,17 +2859,16 @@ module Aws::Batch
2688
2859
  # name or the Amazon Resource Name (ARN) of the queue.
2689
2860
  #
2690
2861
  # @option params [String] :share_identifier
2691
- # The share identifier for the job. If the job queue does not have a
2862
+ # The share identifier for the job. If the job queue doesn't have a
2692
2863
  # scheduling policy, then this parameter must not be specified. If the
2693
2864
  # job queue has a scheduling policy, then this parameter must be
2694
2865
  # specified.
2695
2866
  #
2696
2867
  # @option params [Integer] :scheduling_priority_override
2697
- # The scheduling priority for the job. This will only affect jobs in job
2868
+ # The scheduling priority for the job. This only affects jobs in job
2698
2869
  # queues with a fair share policy. Jobs with a higher scheduling
2699
- # priority will be scheduled before jobs with a lower scheduling
2700
- # priority. This will override any scheduling priority in the job
2701
- # definition.
2870
+ # priority are scheduled before jobs with a lower scheduling priority.
2871
+ # This overrides any scheduling priority in the job definition.
2702
2872
  #
2703
2873
  # The minimum supported value is 0 and the maximum supported value is
2704
2874
  # 9999.
@@ -2736,13 +2906,13 @@ module Aws::Batch
2736
2906
  # from the job definition.
2737
2907
  #
2738
2908
  # @option params [Types::ContainerOverrides] :container_overrides
2739
- # A list of container overrides in the JSON format that specify the name
2740
- # of a container in the specified job definition and the overrides it
2741
- # receives. You can override the default command for a container, which
2742
- # is specified in the job definition or the Docker image, with a
2743
- # `command` override. You can also override existing environment
2744
- # variables on a container or add new environment variables to it with
2745
- # an `environment` override.
2909
+ # An object with various properties that override the defaults for the
2910
+ # job definition that specify the name of a container in the specified
2911
+ # job definition and the overrides it should receive. You can override
2912
+ # the default command for a container, which is specified in the job
2913
+ # definition or the Docker image, with a `command` override. You can
2914
+ # also override existing environment variables on a container or add new
2915
+ # environment variables to it with an `environment` override.
2746
2916
  #
2747
2917
  # @option params [Types::NodeOverrides] :node_overrides
2748
2918
  # A list of node overrides in JSON format that specify the node range to
@@ -2793,6 +2963,11 @@ module Aws::Batch
2793
2963
  #
2794
2964
  # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
2795
2965
  #
2966
+ # @option params [Types::EksPropertiesOverride] :eks_properties_override
2967
+ # An object that can only be specified for jobs that are run on Amazon
2968
+ # EKS resources with various properties that override defaults for the
2969
+ # job definition.
2970
+ #
2796
2971
  # @return [Types::SubmitJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2797
2972
  #
2798
2973
  # * {Types::SubmitJobResponse#job_arn #job_arn} => String
@@ -2898,6 +3073,31 @@ module Aws::Batch
2898
3073
  # tags: {
2899
3074
  # "TagKey" => "TagValue",
2900
3075
  # },
3076
+ # eks_properties_override: {
3077
+ # pod_properties: {
3078
+ # containers: [
3079
+ # {
3080
+ # image: "String",
3081
+ # command: ["String"],
3082
+ # args: ["String"],
3083
+ # env: [
3084
+ # {
3085
+ # name: "String", # required
3086
+ # value: "String",
3087
+ # },
3088
+ # ],
3089
+ # resources: {
3090
+ # limits: {
3091
+ # "String" => "Quantity",
3092
+ # },
3093
+ # requests: {
3094
+ # "String" => "Quantity",
3095
+ # },
3096
+ # },
3097
+ # },
3098
+ # ],
3099
+ # },
3100
+ # },
2901
3101
  # })
2902
3102
  #
2903
3103
  # @example Response structure
@@ -2921,13 +3121,13 @@ module Aws::Batch
2921
3121
  # the tags that are associated with that resource are deleted as well.
2922
3122
  # Batch resources that support tags are compute environments, jobs, job
2923
3123
  # definitions, job queues, and scheduling policies. ARNs for child jobs
2924
- # of array and multi-node parallel (MNP) jobs are not supported.
3124
+ # of array and multi-node parallel (MNP) jobs aren't supported.
2925
3125
  #
2926
3126
  # @option params [required, String] :resource_arn
2927
3127
  # The Amazon Resource Name (ARN) of the resource that tags are added to.
2928
3128
  # Batch resources that support tags are compute environments, jobs, job
2929
3129
  # definitions, job queues, and scheduling policies. ARNs for child jobs
2930
- # of array and multi-node parallel (MNP) jobs are not supported.
3130
+ # of array and multi-node parallel (MNP) jobs aren't supported.
2931
3131
  #
2932
3132
  # @option params [required, Hash<String,String>] :tags
2933
3133
  # The tags that you apply to the resource to help you categorize and
@@ -3026,7 +3226,7 @@ module Aws::Batch
3026
3226
  # The Amazon Resource Name (ARN) of the resource from which to delete
3027
3227
  # tags. Batch resources that support tags are compute environments,
3028
3228
  # jobs, job definitions, job queues, and scheduling policies. ARNs for
3029
- # child jobs of array and multi-node parallel (MNP) jobs are not
3229
+ # child jobs of array and multi-node parallel (MNP) jobs aren't
3030
3230
  # supported.
3031
3231
  #
3032
3232
  # @option params [required, Array<String>] :tag_keys
@@ -3091,11 +3291,11 @@ module Aws::Batch
3091
3291
  #
3092
3292
  # @option params [Integer] :unmanagedv_cpus
3093
3293
  # The maximum number of vCPUs expected to be used for an unmanaged
3094
- # compute environment. Do not specify this parameter for a managed
3294
+ # compute environment. Don't specify this parameter for a managed
3095
3295
  # compute environment. This parameter is only used for fair share
3096
3296
  # scheduling to reserve vCPU capacity for new share identifiers. If this
3097
- # parameter is not provided for a fair share job queue, no vCPU capacity
3098
- # will be reserved.
3297
+ # parameter isn't provided for a fair share job queue, no vCPU capacity
3298
+ # is reserved.
3099
3299
  #
3100
3300
  # @option params [Types::ComputeResourceUpdate] :compute_resources
3101
3301
  # Details of the compute resources managed by the compute environment.
@@ -3199,6 +3399,7 @@ module Aws::Batch
3199
3399
  # {
3200
3400
  # image_type: "ImageType", # required
3201
3401
  # image_id_override: "ImageIdOverride",
3402
+ # image_kubernetes_version: "KubernetesVersion",
3202
3403
  # },
3203
3404
  # ],
3204
3405
  # update_to_latest_image_version: false,
@@ -3243,7 +3444,7 @@ module Aws::Batch
3243
3444
  # but not removed. The format is
3244
3445
  # `aws:Partition:batch:Region:Account:scheduling-policy/Name `. For
3245
3446
  # example,
3246
- # `aws:aws:batch:us-west-2:012345678910:scheduling-policy/MySchedulingPolicy`.
3447
+ # `aws:aws:batch:us-west-2:123456789012:scheduling-policy/MySchedulingPolicy`.
3247
3448
  #
3248
3449
  # @option params [Integer] :priority
3249
3450
  # The priority of the job queue. Job queues with a higher priority (or a
@@ -3369,7 +3570,7 @@ module Aws::Batch
3369
3570
  params: params,
3370
3571
  config: config)
3371
3572
  context[:gem_name] = 'aws-sdk-batch'
3372
- context[:gem_version] = '1.62.0'
3573
+ context[:gem_version] = '1.63.0'
3373
3574
  Seahorse::Client::Request.new(handlers, context)
3374
3575
  end
3375
3576