aws-sdk-batch 1.41.0 → 1.46.0

Sign up to get free protection for your applications and to get access to all the features.
data/VERSION ADDED
@@ -0,0 +1 @@
1
+ 1.46.0
data/lib/aws-sdk-batch.rb CHANGED
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-batch/customizations'
48
48
  # @!group service
49
49
  module Aws::Batch
50
50
 
51
- GEM_VERSION = '1.41.0'
51
+ GEM_VERSION = '1.46.0'
52
52
 
53
53
  end
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -328,9 +328,9 @@ module Aws::Batch
328
328
  # @!group API Operations
329
329
 
330
330
  # Cancels a job in an AWS Batch job queue. Jobs that are in the
331
- # `SUBMITTED`, `PENDING`, or `RUNNABLE` state are cancelled. Jobs that
332
- # have progressed to `STARTING` or `RUNNING` are not cancelled (but the
333
- # API operation still succeeds, even if no job is cancelled); these jobs
331
+ # `SUBMITTED`, `PENDING`, or `RUNNABLE` state are canceled. Jobs that
332
+ # have progressed to `STARTING` or `RUNNING` aren't canceled, but the
333
+ # API operation still succeeds, even if no job is canceled. These jobs
334
334
  # must be terminated with the TerminateJob operation.
335
335
  #
336
336
  # @option params [required, String] :job_id
@@ -374,49 +374,53 @@ module Aws::Batch
374
374
  end
375
375
 
376
376
  # Creates an AWS Batch compute environment. You can create `MANAGED` or
377
- # `UNMANAGED` compute environments.
377
+ # `UNMANAGED` compute environments. `MANAGED` compute environments can
378
+ # use Amazon EC2 or AWS Fargate resources. `UNMANAGED` compute
379
+ # environments can only use EC2 resources.
378
380
  #
379
381
  # In a managed compute environment, AWS Batch manages the capacity and
380
382
  # instance types of the compute resources within the environment. This
381
383
  # is based on the compute resource specification that you define or the
382
384
  # [launch template][1] that you specify when you create the compute
383
- # environment. You can choose to use Amazon EC2 On-Demand Instances or
384
- # Spot Instances in your managed compute environment. You can optionally
385
- # set a maximum price so that Spot Instances only launch when the Spot
386
- # Instance price is below a specified percentage of the On-Demand price.
385
+ # environment. Either, you can choose to use EC2 On-Demand Instances and
386
+ # EC2 Spot Instances. Or, you can use Fargate and Fargate Spot capacity
387
+ # in your managed compute environment. You can optionally set a maximum
388
+ # price so that Spot Instances only launch when the Spot Instance price
389
+ # is less than a specified percentage of the On-Demand price.
387
390
  #
388
- # <note markdown="1"> Multi-node parallel jobs are not supported on Spot Instances.
391
+ # <note markdown="1"> Multi-node parallel jobs aren't supported on Spot Instances.
389
392
  #
390
393
  # </note>
391
394
  #
392
- # In an unmanaged compute environment, you can manage your own compute
393
- # resources. This provides more compute resource configuration options,
394
- # such as using a custom AMI, but you must ensure that your AMI meets
395
- # the Amazon ECS container instance AMI specification. For more
396
- # information, see [Container Instance AMIs][2] in the *Amazon Elastic
397
- # Container Service Developer Guide*. After you have created your
398
- # unmanaged compute environment, you can use the
399
- # DescribeComputeEnvironments operation to find the Amazon ECS cluster
400
- # that is associated with it. Then, manually launch your container
395
+ # In an unmanaged compute environment, you can manage your own EC2
396
+ # compute resources and have a lot of flexibility with how you configure
397
+ # your compute resources. For example, you can use custom AMIs. However,
398
+ # you must verify that each of your AMIs meet the Amazon ECS container
399
+ # instance AMI specification. For more information, see [container
400
+ # instance AMIs][2] in the *Amazon Elastic Container Service Developer
401
+ # Guide*. After you created your unmanaged compute environment, you can
402
+ # use the DescribeComputeEnvironments operation to find the Amazon ECS
403
+ # cluster that's associated with it. Then, launch your container
401
404
  # instances into that Amazon ECS cluster. For more information, see
402
- # [Launching an Amazon ECS Container Instance][3] in the *Amazon Elastic
405
+ # [Launching an Amazon ECS container instance][3] in the *Amazon Elastic
403
406
  # Container Service Developer Guide*.
404
407
  #
405
- # <note markdown="1"> AWS Batch does not upgrade the AMIs in a compute environment after it
406
- # is created (for example, when a newer version of the Amazon
407
- # ECS-optimized AMI is available). You are responsible for the
408
- # management of the guest operating system (including updates and
409
- # security patches) and any additional application software or utilities
410
- # that you install on the compute resources. To use a new AMI for your
411
- # AWS Batch jobs:
408
+ # <note markdown="1"> AWS Batch doesn't upgrade the AMIs in a compute environment after the
409
+ # environment is created. For example, it doesn't update the AMIs when
410
+ # a newer version of the Amazon ECS optimized AMI is available.
411
+ # Therefore, you're responsible for managing the guest operating system
412
+ # (including its updates and security patches) and any additional
413
+ # application software or utilities that you install on the compute
414
+ # resources. To use a new AMI for your AWS Batch jobs, complete these
415
+ # steps:
412
416
  #
413
417
  # 1. Create a new compute environment with the new AMI.
414
418
  #
415
419
  # 2. Add the compute environment to an existing job queue.
416
420
  #
417
- # 3. Remove the old compute environment from your job queue.
421
+ # 3. Remove the earlier compute environment from your job queue.
418
422
  #
419
- # 4. Delete the old compute environment.
423
+ # 4. Delete the earlier compute environment.
420
424
  #
421
425
  # </note>
422
426
  #
@@ -431,8 +435,9 @@ module Aws::Batch
431
435
  # and lowercase), numbers, hyphens, and underscores are allowed.
432
436
  #
433
437
  # @option params [required, String] :type
434
- # The type of the compute environment. For more information, see
435
- # [Compute Environments][1] in the *AWS Batch User Guide*.
438
+ # The type of the compute environment: `MANAGED` or `UNMANAGED`. For
439
+ # more information, see [Compute Environments][1] in the *AWS Batch User
440
+ # Guide*.
436
441
  #
437
442
  #
438
443
  #
@@ -443,33 +448,61 @@ module Aws::Batch
443
448
  # the compute environment accepts jobs from a queue and can scale out
444
449
  # automatically based on queues.
445
450
  #
451
+ # If the state is `ENABLED`, then the AWS Batch scheduler can attempt to
452
+ # place jobs from an associated job queue on the compute resources
453
+ # within the environment. If the compute environment is managed, then it
454
+ # can scale its instances out or in automatically, based on the job
455
+ # queue demand.
456
+ #
457
+ # If the state is `DISABLED`, then the AWS Batch scheduler doesn't
458
+ # attempt to place jobs within the environment. Jobs in a `STARTING` or
459
+ # `RUNNING` state continue to progress normally. Managed compute
460
+ # environments in the `DISABLED` state don't scale out. However, they
461
+ # scale in to `minvCpus` value after instances become idle.
462
+ #
446
463
  # @option params [Types::ComputeResource] :compute_resources
447
- # Details of the compute resources managed by the compute environment.
448
- # This parameter is required for managed compute environments. For more
449
- # information, see [Compute Environments][1] in the *AWS Batch User
450
- # Guide*.
464
+ # Details about the compute resources managed by the compute
465
+ # environment. This parameter is required for managed compute
466
+ # environments. For more information, see [Compute Environments][1] in
467
+ # the *AWS Batch User Guide*.
451
468
  #
452
469
  #
453
470
  #
454
471
  # [1]: https://docs.aws.amazon.com/batch/latest/userguide/compute_environments.html
455
472
  #
456
- # @option params [required, String] :service_role
473
+ # @option params [String] :service_role
457
474
  # The full Amazon Resource Name (ARN) of the IAM role that allows AWS
458
- # Batch to make calls to other AWS services on your behalf.
459
- #
460
- # If your specified role has a path other than `/`, then you must either
461
- # specify the full role ARN (this is recommended) or prefix the role
462
- # name with the path.
475
+ # Batch to make calls to other AWS services on your behalf. For more
476
+ # information, see [AWS Batch service IAM role][1] in the *AWS Batch
477
+ # User Guide*.
478
+ #
479
+ # If your account has already created the AWS Batch service-linked role,
480
+ # that role is used by default for your compute environment unless you
481
+ # specify a role here. If the AWS Batch service-linked role does not
482
+ # exist in your account, and no role is specified here, the service will
483
+ # try to create the AWS Batch service-linked role in your account.
484
+ #
485
+ # If your specified role has a path other than `/`, then you must
486
+ # specify either the full role ARN (recommended) or prefix the role name
487
+ # with the path. For example, if a role with the name `bar` has a path
488
+ # of `/foo/` then you would specify `/foo/bar` as the role name. For
489
+ # more information, see [Friendly names and paths][2] in the *IAM User
490
+ # Guide*.
463
491
  #
464
- # <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN may
465
- # contain the `service-role` path prefix. When you only specify the name
466
- # of the service role, AWS Batch assumes that your ARN does not use the
467
- # `service-role` path prefix. Because of this, we recommend that you
468
- # specify the full ARN of your service role when you create compute
492
+ # <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN
493
+ # might contain the `service-role` path prefix. When you only specify
494
+ # the name of the service role, AWS Batch assumes that your ARN doesn't
495
+ # use the `service-role` path prefix. Because of this, we recommend that
496
+ # you specify the full ARN of your service role when you create compute
469
497
  # environments.
470
498
  #
471
499
  # </note>
472
500
  #
501
+ #
502
+ #
503
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/service_IAM_role.html
504
+ # [2]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-friendly-names
505
+ #
473
506
  # @option params [Hash<String,String>] :tags
474
507
  # The tags that you apply to the compute environment to help you
475
508
  # categorize and organize your resources. Each tag consists of a key and
@@ -477,7 +510,7 @@ module Aws::Batch
477
510
  # Resources][1] in *AWS General Reference*.
478
511
  #
479
512
  # These tags can be updated or removed using the [TagResource][2] and
480
- # [UntagResource][3] API operations. These tags do not propagate to the
513
+ # [UntagResource][3] API operations. These tags don't propagate to the
481
514
  # underlying compute resources.
482
515
  #
483
516
  #
@@ -585,17 +618,17 @@ module Aws::Batch
585
618
  # type: "MANAGED", # required, accepts MANAGED, UNMANAGED
586
619
  # state: "ENABLED", # accepts ENABLED, DISABLED
587
620
  # compute_resources: {
588
- # type: "EC2", # required, accepts EC2, SPOT
621
+ # type: "EC2", # required, accepts EC2, SPOT, FARGATE, FARGATE_SPOT
589
622
  # allocation_strategy: "BEST_FIT", # accepts BEST_FIT, BEST_FIT_PROGRESSIVE, SPOT_CAPACITY_OPTIMIZED
590
- # minv_cpus: 1, # required
623
+ # minv_cpus: 1,
591
624
  # maxv_cpus: 1, # required
592
625
  # desiredv_cpus: 1,
593
- # instance_types: ["String"], # required
626
+ # instance_types: ["String"],
594
627
  # image_id: "String",
595
628
  # subnets: ["String"], # required
596
629
  # security_group_ids: ["String"],
597
630
  # ec2_key_pair: "String",
598
- # instance_role: "String", # required
631
+ # instance_role: "String",
599
632
  # tags: {
600
633
  # "String" => "String",
601
634
  # },
@@ -614,7 +647,7 @@ module Aws::Batch
614
647
  # },
615
648
  # ],
616
649
  # },
617
- # service_role: "String", # required
650
+ # service_role: "String",
618
651
  # tags: {
619
652
  # "TagKey" => "TagValue",
620
653
  # },
@@ -638,46 +671,57 @@ module Aws::Batch
638
671
  # associate one or more compute environments to the queue and assign an
639
672
  # order of preference for the compute environments.
640
673
  #
641
- # You also set a priority to the job queue that determines the order in
642
- # which the AWS Batch scheduler places jobs onto its associated compute
674
+ # You also set a priority to the job queue that determines the order
675
+ # that the AWS Batch scheduler places jobs onto its associated compute
643
676
  # environments. For example, if a compute environment is associated with
644
677
  # more than one job queue, the job queue with a higher priority is given
645
678
  # preference for scheduling jobs to that compute environment.
646
679
  #
647
680
  # @option params [required, String] :job_queue_name
648
- # The name of the job queue.
681
+ # The name of the job queue. Up to 128 letters (uppercase and
682
+ # lowercase), numbers, and underscores are allowed.
649
683
  #
650
684
  # @option params [String] :state
651
685
  # The state of the job queue. If the job queue state is `ENABLED`, it is
652
686
  # able to accept jobs. If the job queue state is `DISABLED`, new jobs
653
- # cannot be added to the queue, but jobs already in the queue can
687
+ # can't be added to the queue, but jobs already in the queue can
654
688
  # finish.
655
689
  #
656
690
  # @option params [required, Integer] :priority
657
691
  # The priority of the job queue. Job queues with a higher priority (or a
658
692
  # higher integer value for the `priority` parameter) are evaluated first
659
693
  # when associated with the same compute environment. Priority is
660
- # determined in descending order, for example, a job queue with a
694
+ # determined in descending order. For example, a job queue with a
661
695
  # priority value of `10` is given scheduling preference over a job queue
662
- # with a priority value of `1`.
696
+ # with a priority value of `1`. All of the compute environments must be
697
+ # either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or `FARGATE_SPOT`);
698
+ # EC2 and Fargate compute environments cannot be mixed.
663
699
  #
664
700
  # @option params [required, Array<Types::ComputeEnvironmentOrder>] :compute_environment_order
665
701
  # The set of compute environments mapped to a job queue and their order
666
702
  # relative to each other. The job scheduler uses this parameter to
667
- # determine which compute environment should execute a given job.
668
- # Compute environments must be in the `VALID` state before you can
669
- # associate them with a job queue. You can associate up to three compute
670
- # environments with a job queue.
703
+ # determine which compute environment should run a specific job. Compute
704
+ # environments must be in the `VALID` state before you can associate
705
+ # them with a job queue. You can associate up to three compute
706
+ # environments with a job queue. All of the compute environments must be
707
+ # either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or `FARGATE_SPOT`);
708
+ # EC2 and Fargate compute environments can't be mixed.
709
+ #
710
+ # <note markdown="1"> All compute environments that are associated with a job queue must
711
+ # share the same architecture. AWS Batch doesn't support mixing compute
712
+ # environment architecture types in a single job queue.
713
+ #
714
+ # </note>
671
715
  #
672
716
  # @option params [Hash<String,String>] :tags
673
717
  # The tags that you apply to the job queue to help you categorize and
674
718
  # organize your resources. Each tag consists of a key and an optional
675
- # value. For more information, see [Tagging AWS Resources][1] in *AWS
676
- # General Reference*.
719
+ # value. For more information, see [Tagging your AWS Batch resources][1]
720
+ # in *AWS Batch User Guide*.
677
721
  #
678
722
  #
679
723
  #
680
- # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
724
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/using-tags.html
681
725
  #
682
726
  # @return [Types::CreateJobQueueResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
683
727
  #
@@ -770,7 +814,10 @@ module Aws::Batch
770
814
  # Before you can delete a compute environment, you must set its state to
771
815
  # `DISABLED` with the UpdateComputeEnvironment API operation and
772
816
  # disassociate it from any job queues with the UpdateJobQueue API
773
- # operation.
817
+ # operation. Compute environments that use AWS Fargate resources must
818
+ # terminate all active jobs on that compute environment before deleting
819
+ # the compute environment. If this isn't done, the compute environment
820
+ # enters an invalid state.
774
821
  #
775
822
  # @option params [required, String] :compute_environment
776
823
  # The name or Amazon Resource Name (ARN) of the compute environment to
@@ -808,9 +855,10 @@ module Aws::Batch
808
855
 
809
856
  # Deletes the specified job queue. You must first disable submissions
810
857
  # for a queue with the UpdateJobQueue operation. All jobs in the queue
811
- # are terminated when you delete a job queue.
858
+ # are eventually terminated when you delete a job queue. The jobs are
859
+ # terminated at a rate of about 16 jobs each second.
812
860
  #
813
- # It is not necessary to disassociate compute environments from a queue
861
+ # It's not necessary to disassociate compute environments from a queue
814
862
  # before submitting a `DeleteJobQueue` request.
815
863
  #
816
864
  # @option params [required, String] :job_queue
@@ -847,7 +895,7 @@ module Aws::Batch
847
895
  req.send_request(options)
848
896
  end
849
897
 
850
- # Deregisters an AWS Batch job definition. Job definitions will be
898
+ # Deregisters an AWS Batch job definition. Job definitions are
851
899
  # permanently deleted after 180 days.
852
900
  #
853
901
  # @option params [required, String] :job_definition
@@ -886,7 +934,7 @@ module Aws::Batch
886
934
 
887
935
  # Describes one or more of your compute environments.
888
936
  #
889
- # If you are using an unmanaged compute environment, you can use the
937
+ # If you're using an unmanaged compute environment, you can use the
890
938
  # `DescribeComputeEnvironment` operation to determine the
891
939
  # `ecsClusterArn` that you should launch your Amazon ECS container
892
940
  # instances into.
@@ -903,7 +951,7 @@ module Aws::Batch
903
951
  # The remaining results of the initial request can be seen by sending
904
952
  # another `DescribeComputeEnvironments` request with the returned
905
953
  # `nextToken` value. This value can be between 1 and 100. If this
906
- # parameter is not used, then `DescribeComputeEnvironments` returns up
954
+ # parameter isn't used, then `DescribeComputeEnvironments` returns up
907
955
  # to 100 results and a `nextToken` value if applicable.
908
956
  #
909
957
  # @option params [String] :next_token
@@ -913,7 +961,7 @@ module Aws::Batch
913
961
  # from the end of the previous results that returned the `nextToken`
914
962
  # value. This value is `null` when there are no more results to return.
915
963
  #
916
- # <note markdown="1"> This token should be treated as an opaque identifier that is only used
964
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only used
917
965
  # to retrieve the next items in a list and not for other programmatic
918
966
  # purposes.
919
967
  #
@@ -995,7 +1043,7 @@ module Aws::Batch
995
1043
  # resp.compute_environments[0].state #=> String, one of "ENABLED", "DISABLED"
996
1044
  # resp.compute_environments[0].status #=> String, one of "CREATING", "UPDATING", "DELETING", "DELETED", "VALID", "INVALID"
997
1045
  # resp.compute_environments[0].status_reason #=> String
998
- # resp.compute_environments[0].compute_resources.type #=> String, one of "EC2", "SPOT"
1046
+ # resp.compute_environments[0].compute_resources.type #=> String, one of "EC2", "SPOT", "FARGATE", "FARGATE_SPOT"
999
1047
  # resp.compute_environments[0].compute_resources.allocation_strategy #=> String, one of "BEST_FIT", "BEST_FIT_PROGRESSIVE", "SPOT_CAPACITY_OPTIMIZED"
1000
1048
  # resp.compute_environments[0].compute_resources.minv_cpus #=> Integer
1001
1049
  # resp.compute_environments[0].compute_resources.maxv_cpus #=> Integer
@@ -1043,10 +1091,10 @@ module Aws::Batch
1043
1091
  # The maximum number of results returned by `DescribeJobDefinitions` in
1044
1092
  # paginated output. When this parameter is used,
1045
1093
  # `DescribeJobDefinitions` only returns `maxResults` results in a single
1046
- # page along with a `nextToken` response element. The remaining results
1047
- # of the initial request can be seen by sending another
1094
+ # page and a `nextToken` response element. The remaining results of the
1095
+ # initial request can be seen by sending another
1048
1096
  # `DescribeJobDefinitions` request with the returned `nextToken` value.
1049
- # This value can be between 1 and 100. If this parameter is not used,
1097
+ # This value can be between 1 and 100. If this parameter isn't used,
1050
1098
  # then `DescribeJobDefinitions` returns up to 100 results and a
1051
1099
  # `nextToken` value if applicable.
1052
1100
  #
@@ -1054,7 +1102,7 @@ module Aws::Batch
1054
1102
  # The name of the job definition to describe.
1055
1103
  #
1056
1104
  # @option params [String] :status
1057
- # The status with which to filter job definitions.
1105
+ # The status used to filter job definitions.
1058
1106
  #
1059
1107
  # @option params [String] :next_token
1060
1108
  # The `nextToken` value returned from a previous paginated
@@ -1063,7 +1111,7 @@ module Aws::Batch
1063
1111
  # from the end of the previous results that returned the `nextToken`
1064
1112
  # value. This value is `null` when there are no more results to return.
1065
1113
  #
1066
- # <note markdown="1"> This token should be treated as an opaque identifier that is only used
1114
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only used
1067
1115
  # to retrieve the next items in a list and not for other programmatic
1068
1116
  # purposes.
1069
1117
  #
@@ -1168,7 +1216,7 @@ module Aws::Batch
1168
1216
  # resp.job_definitions[0].container_properties.instance_type #=> String
1169
1217
  # resp.job_definitions[0].container_properties.resource_requirements #=> Array
1170
1218
  # resp.job_definitions[0].container_properties.resource_requirements[0].value #=> String
1171
- # resp.job_definitions[0].container_properties.resource_requirements[0].type #=> String, one of "GPU"
1219
+ # resp.job_definitions[0].container_properties.resource_requirements[0].type #=> String, one of "GPU", "VCPU", "MEMORY"
1172
1220
  # resp.job_definitions[0].container_properties.linux_parameters.devices #=> Array
1173
1221
  # resp.job_definitions[0].container_properties.linux_parameters.devices[0].host_path #=> String
1174
1222
  # resp.job_definitions[0].container_properties.linux_parameters.devices[0].container_path #=> String
@@ -1192,6 +1240,8 @@ module Aws::Batch
1192
1240
  # resp.job_definitions[0].container_properties.secrets #=> Array
1193
1241
  # resp.job_definitions[0].container_properties.secrets[0].name #=> String
1194
1242
  # resp.job_definitions[0].container_properties.secrets[0].value_from #=> String
1243
+ # resp.job_definitions[0].container_properties.network_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
1244
+ # resp.job_definitions[0].container_properties.fargate_platform_configuration.platform_version #=> String
1195
1245
  # resp.job_definitions[0].timeout.attempt_duration_seconds #=> Integer
1196
1246
  # resp.job_definitions[0].node_properties.num_nodes #=> Integer
1197
1247
  # resp.job_definitions[0].node_properties.main_node #=> Integer
@@ -1224,7 +1274,7 @@ module Aws::Batch
1224
1274
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.instance_type #=> String
1225
1275
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.resource_requirements #=> Array
1226
1276
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.resource_requirements[0].value #=> String
1227
- # resp.job_definitions[0].node_properties.node_range_properties[0].container.resource_requirements[0].type #=> String, one of "GPU"
1277
+ # resp.job_definitions[0].node_properties.node_range_properties[0].container.resource_requirements[0].type #=> String, one of "GPU", "VCPU", "MEMORY"
1228
1278
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.linux_parameters.devices #=> Array
1229
1279
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.linux_parameters.devices[0].host_path #=> String
1230
1280
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.linux_parameters.devices[0].container_path #=> String
@@ -1248,8 +1298,13 @@ module Aws::Batch
1248
1298
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.secrets #=> Array
1249
1299
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.secrets[0].name #=> String
1250
1300
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.secrets[0].value_from #=> String
1301
+ # resp.job_definitions[0].node_properties.node_range_properties[0].container.network_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
1302
+ # resp.job_definitions[0].node_properties.node_range_properties[0].container.fargate_platform_configuration.platform_version #=> String
1251
1303
  # resp.job_definitions[0].tags #=> Hash
1252
1304
  # resp.job_definitions[0].tags["TagKey"] #=> String
1305
+ # resp.job_definitions[0].propagate_tags #=> Boolean
1306
+ # resp.job_definitions[0].platform_capabilities #=> Array
1307
+ # resp.job_definitions[0].platform_capabilities[0] #=> String, one of "EC2", "FARGATE"
1253
1308
  # resp.next_token #=> String
1254
1309
  #
1255
1310
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/DescribeJobDefinitions AWS API Documentation
@@ -1270,12 +1325,12 @@ module Aws::Batch
1270
1325
  # @option params [Integer] :max_results
1271
1326
  # The maximum number of results returned by `DescribeJobQueues` in
1272
1327
  # paginated output. When this parameter is used, `DescribeJobQueues`
1273
- # only returns `maxResults` results in a single page along with a
1274
- # `nextToken` response element. The remaining results of the initial
1275
- # request can be seen by sending another `DescribeJobQueues` request
1276
- # with the returned `nextToken` value. This value can be between 1 and
1277
- # 100. If this parameter is not used, then `DescribeJobQueues` returns
1278
- # up to 100 results and a `nextToken` value if applicable.
1328
+ # only returns `maxResults` results in a single page and a `nextToken`
1329
+ # response element. The remaining results of the initial request can be
1330
+ # seen by sending another `DescribeJobQueues` request with the returned
1331
+ # `nextToken` value. This value can be between 1 and 100. If this
1332
+ # parameter isn't used, then `DescribeJobQueues` returns up to 100
1333
+ # results and a `nextToken` value if applicable.
1279
1334
  #
1280
1335
  # @option params [String] :next_token
1281
1336
  # The `nextToken` value returned from a previous paginated
@@ -1284,7 +1339,7 @@ module Aws::Batch
1284
1339
  # from the end of the previous results that returned the `nextToken`
1285
1340
  # value. This value is `null` when there are no more results to return.
1286
1341
  #
1287
- # <note markdown="1"> This token should be treated as an opaque identifier that is only used
1342
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only used
1288
1343
  # to retrieve the next items in a list and not for other programmatic
1289
1344
  # purposes.
1290
1345
  #
@@ -1499,7 +1554,7 @@ module Aws::Batch
1499
1554
  # resp.jobs[0].container.network_interfaces[0].private_ipv_4_address #=> String
1500
1555
  # resp.jobs[0].container.resource_requirements #=> Array
1501
1556
  # resp.jobs[0].container.resource_requirements[0].value #=> String
1502
- # resp.jobs[0].container.resource_requirements[0].type #=> String, one of "GPU"
1557
+ # resp.jobs[0].container.resource_requirements[0].type #=> String, one of "GPU", "VCPU", "MEMORY"
1503
1558
  # resp.jobs[0].container.linux_parameters.devices #=> Array
1504
1559
  # resp.jobs[0].container.linux_parameters.devices[0].host_path #=> String
1505
1560
  # resp.jobs[0].container.linux_parameters.devices[0].container_path #=> String
@@ -1523,6 +1578,8 @@ module Aws::Batch
1523
1578
  # resp.jobs[0].container.secrets #=> Array
1524
1579
  # resp.jobs[0].container.secrets[0].name #=> String
1525
1580
  # resp.jobs[0].container.secrets[0].value_from #=> String
1581
+ # resp.jobs[0].container.network_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
1582
+ # resp.jobs[0].container.fargate_platform_configuration.platform_version #=> String
1526
1583
  # resp.jobs[0].node_details.node_index #=> Integer
1527
1584
  # resp.jobs[0].node_details.is_main_node #=> Boolean
1528
1585
  # resp.jobs[0].node_properties.num_nodes #=> Integer
@@ -1556,7 +1613,7 @@ module Aws::Batch
1556
1613
  # resp.jobs[0].node_properties.node_range_properties[0].container.instance_type #=> String
1557
1614
  # resp.jobs[0].node_properties.node_range_properties[0].container.resource_requirements #=> Array
1558
1615
  # resp.jobs[0].node_properties.node_range_properties[0].container.resource_requirements[0].value #=> String
1559
- # resp.jobs[0].node_properties.node_range_properties[0].container.resource_requirements[0].type #=> String, one of "GPU"
1616
+ # resp.jobs[0].node_properties.node_range_properties[0].container.resource_requirements[0].type #=> String, one of "GPU", "VCPU", "MEMORY"
1560
1617
  # resp.jobs[0].node_properties.node_range_properties[0].container.linux_parameters.devices #=> Array
1561
1618
  # resp.jobs[0].node_properties.node_range_properties[0].container.linux_parameters.devices[0].host_path #=> String
1562
1619
  # resp.jobs[0].node_properties.node_range_properties[0].container.linux_parameters.devices[0].container_path #=> String
@@ -1580,6 +1637,8 @@ module Aws::Batch
1580
1637
  # resp.jobs[0].node_properties.node_range_properties[0].container.secrets #=> Array
1581
1638
  # resp.jobs[0].node_properties.node_range_properties[0].container.secrets[0].name #=> String
1582
1639
  # resp.jobs[0].node_properties.node_range_properties[0].container.secrets[0].value_from #=> String
1640
+ # resp.jobs[0].node_properties.node_range_properties[0].container.network_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
1641
+ # resp.jobs[0].node_properties.node_range_properties[0].container.fargate_platform_configuration.platform_version #=> String
1583
1642
  # resp.jobs[0].array_properties.status_summary #=> Hash
1584
1643
  # resp.jobs[0].array_properties.status_summary["String"] #=> Integer
1585
1644
  # resp.jobs[0].array_properties.size #=> Integer
@@ -1587,6 +1646,9 @@ module Aws::Batch
1587
1646
  # resp.jobs[0].timeout.attempt_duration_seconds #=> Integer
1588
1647
  # resp.jobs[0].tags #=> Hash
1589
1648
  # resp.jobs[0].tags["TagKey"] #=> String
1649
+ # resp.jobs[0].propagate_tags #=> Boolean
1650
+ # resp.jobs[0].platform_capabilities #=> Array
1651
+ # resp.jobs[0].platform_capabilities[0] #=> String, one of "EC2", "FARGATE"
1590
1652
  #
1591
1653
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/DescribeJobs AWS API Documentation
1592
1654
  #
@@ -1599,21 +1661,21 @@ module Aws::Batch
1599
1661
 
1600
1662
  # Returns a list of AWS Batch jobs.
1601
1663
  #
1602
- # You must specify only one of the following:
1664
+ # You must specify only one of the following items:
1603
1665
  #
1604
- # * a job queue ID to return a list of jobs in that job queue
1666
+ # * A job queue ID to return a list of jobs in that job queue
1605
1667
  #
1606
- # * a multi-node parallel job ID to return a list of that job's nodes
1668
+ # * A multi-node parallel job ID to return a list of nodes for that job
1607
1669
  #
1608
- # * an array job ID to return a list of that job's children
1670
+ # * An array job ID to return a list of the children for that job
1609
1671
  #
1610
1672
  # You can filter the results by job status with the `jobStatus`
1611
- # parameter. If you do not specify a status, only `RUNNING` jobs are
1673
+ # parameter. If you don't specify a status, only `RUNNING` jobs are
1612
1674
  # returned.
1613
1675
  #
1614
1676
  # @option params [String] :job_queue
1615
- # The name or full Amazon Resource Name (ARN) of the job queue with
1616
- # which to list jobs.
1677
+ # The name or full Amazon Resource Name (ARN) of the job queue used to
1678
+ # list jobs.
1617
1679
  #
1618
1680
  # @option params [String] :array_job_id
1619
1681
  # The job ID for an array job. Specifying an array job ID with this
@@ -1625,18 +1687,18 @@ module Aws::Batch
1625
1687
  # associated with the specified job.
1626
1688
  #
1627
1689
  # @option params [String] :job_status
1628
- # The job status with which to filter jobs in the specified queue. If
1629
- # you do not specify a status, only `RUNNING` jobs are returned.
1690
+ # The job status used to filter jobs in the specified queue. If you
1691
+ # don't specify a status, only `RUNNING` jobs are returned.
1630
1692
  #
1631
1693
  # @option params [Integer] :max_results
1632
1694
  # The maximum number of results returned by `ListJobs` in paginated
1633
1695
  # output. When this parameter is used, `ListJobs` only returns
1634
- # `maxResults` results in a single page along with a `nextToken`
1635
- # response element. The remaining results of the initial request can be
1636
- # seen by sending another `ListJobs` request with the returned
1637
- # `nextToken` value. This value can be between 1 and 100. If this
1638
- # parameter is not used, then `ListJobs` returns up to 100 results and a
1639
- # `nextToken` value if applicable.
1696
+ # `maxResults` results in a single page and a `nextToken` response
1697
+ # element. The remaining results of the initial request can be seen by
1698
+ # sending another `ListJobs` request with the returned `nextToken`
1699
+ # value. This value can be between 1 and 100. If this parameter isn't
1700
+ # used, then `ListJobs` returns up to 100 results and a `nextToken`
1701
+ # value if applicable.
1640
1702
  #
1641
1703
  # @option params [String] :next_token
1642
1704
  # The `nextToken` value returned from a previous paginated `ListJobs`
@@ -1645,7 +1707,7 @@ module Aws::Batch
1645
1707
  # results that returned the `nextToken` value. This value is `null` when
1646
1708
  # there are no more results to return.
1647
1709
  #
1648
- # <note markdown="1"> This token should be treated as an opaque identifier that is only used
1710
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only used
1649
1711
  # to retrieve the next items in a list and not for other programmatic
1650
1712
  # purposes.
1651
1713
  #
@@ -1736,14 +1798,14 @@ module Aws::Batch
1736
1798
  req.send_request(options)
1737
1799
  end
1738
1800
 
1739
- # List the tags for an AWS Batch resource. AWS Batch resources that
1801
+ # Lists the tags for an AWS Batch resource. AWS Batch resources that
1740
1802
  # support tags are compute environments, jobs, job definitions, and job
1741
1803
  # queues. ARNs for child jobs of array and multi-node parallel (MNP)
1742
1804
  # jobs are not supported.
1743
1805
  #
1744
1806
  # @option params [required, String] :resource_arn
1745
- # The Amazon Resource Name (ARN) that identifies the resource for which
1746
- # to list the tags. AWS Batch resources that support tags are compute
1807
+ # The Amazon Resource Name (ARN) that identifies the resource that tags
1808
+ # are listed for. AWS Batch resources that support tags are compute
1747
1809
  # environments, jobs, job definitions, and job queues. ARNs for child
1748
1810
  # jobs of array and multi-node parallel (MNP) jobs are not supported.
1749
1811
  #
@@ -1797,7 +1859,18 @@ module Aws::Batch
1797
1859
  # allowed.
1798
1860
  #
1799
1861
  # @option params [required, String] :type
1800
- # The type of job definition.
1862
+ # The type of job definition. For more information about multi-node
1863
+ # parallel jobs, see [Creating a multi-node parallel job definition][1]
1864
+ # in the *AWS Batch User Guide*.
1865
+ #
1866
+ # <note markdown="1"> If the job is run on Fargate resources, then `multinode` isn't
1867
+ # supported.
1868
+ #
1869
+ # </note>
1870
+ #
1871
+ #
1872
+ #
1873
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/multi-node-job-def.html
1801
1874
  #
1802
1875
  # @option params [Hash<String,String>] :parameters
1803
1876
  # Default parameter substitution placeholders to set in the job
@@ -1811,6 +1884,11 @@ module Aws::Batch
1811
1884
  # `container`, then you must specify either `containerProperties` or
1812
1885
  # `nodeProperties`.
1813
1886
  #
1887
+ # <note markdown="1"> If the job runs on Fargate resources, then you must not specify
1888
+ # `nodeProperties`; use only `containerProperties`.
1889
+ #
1890
+ # </note>
1891
+ #
1814
1892
  # @option params [Types::NodeProperties] :node_properties
1815
1893
  # An object with various properties specific to multi-node parallel
1816
1894
  # jobs. If you specify node properties for a job, it becomes a
@@ -1819,39 +1897,57 @@ module Aws::Batch
1819
1897
  # definition's `type` parameter is `container`, then you must specify
1820
1898
  # either `containerProperties` or `nodeProperties`.
1821
1899
  #
1900
+ # <note markdown="1"> If the job runs on Fargate resources, then you must not specify
1901
+ # `nodeProperties`; use `containerProperties` instead.
1902
+ #
1903
+ # </note>
1904
+ #
1822
1905
  #
1823
1906
  #
1824
1907
  # [1]: https://docs.aws.amazon.com/batch/latest/userguide/multi-node-parallel-jobs.html
1825
1908
  #
1826
1909
  # @option params [Types::RetryStrategy] :retry_strategy
1827
1910
  # The retry strategy to use for failed jobs that are submitted with this
1828
- # job definition. Any retry strategy that is specified during a
1911
+ # job definition. Any retry strategy that's specified during a
1829
1912
  # SubmitJob operation overrides the retry strategy defined here. If a
1830
- # job is terminated due to a timeout, it is not retried.
1913
+ # job is terminated due to a timeout, it isn't retried.
1914
+ #
1915
+ # @option params [Boolean] :propagate_tags
1916
+ # Specifies whether to propagate the tags from the job or job definition
1917
+ # to the corresponding Amazon ECS task. If no value is specified, the
1918
+ # tags are not propagated. Tags can only be propagated to the tasks
1919
+ # during task creation. For tags with the same name, job tags are given
1920
+ # priority over job definitions tags. If the total number of combined
1921
+ # tags from the job and job definition is over 50, the job is moved to
1922
+ # the `FAILED` state.
1831
1923
  #
1832
1924
  # @option params [Types::JobTimeout] :timeout
1833
1925
  # The timeout configuration for jobs that are submitted with this job
1834
1926
  # definition, after which AWS Batch terminates your jobs if they have
1835
- # not finished. If a job is terminated due to a timeout, it is not
1927
+ # not finished. If a job is terminated due to a timeout, it isn't
1836
1928
  # retried. The minimum value for the timeout is 60 seconds. Any timeout
1837
- # configuration that is specified during a SubmitJob operation overrides
1929
+ # configuration that's specified during a SubmitJob operation overrides
1838
1930
  # the timeout configuration defined here. For more information, see [Job
1839
- # Timeouts][1] in the *Amazon Elastic Container Service Developer
1840
- # Guide*.
1931
+ # Timeouts][1] in the *AWS Batch User Guide*.
1841
1932
  #
1842
1933
  #
1843
1934
  #
1844
- # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/job_timeouts.html
1935
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/job_timeouts.html
1845
1936
  #
1846
1937
  # @option params [Hash<String,String>] :tags
1847
1938
  # The tags that you apply to the job definition to help you categorize
1848
1939
  # and organize your resources. Each tag consists of a key and an
1849
1940
  # optional value. For more information, see [Tagging AWS Resources][1]
1850
- # in *AWS General Reference*.
1941
+ # in *AWS Batch User Guide*.
1851
1942
  #
1852
1943
  #
1853
1944
  #
1854
- # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
1945
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/using-tags.html
1946
+ #
1947
+ # @option params [Array<String>] :platform_capabilities
1948
+ # The platform capabilities required by the job definition. If no value
1949
+ # is specified, it defaults to `EC2`. To run the job on Fargate
1950
+ # resources, specify `FARGATE`.
1855
1951
  #
1856
1952
  # @return [Types::RegisterJobDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1857
1953
  #
@@ -1964,7 +2060,7 @@ module Aws::Batch
1964
2060
  # resource_requirements: [
1965
2061
  # {
1966
2062
  # value: "String", # required
1967
- # type: "GPU", # required, accepts GPU
2063
+ # type: "GPU", # required, accepts GPU, VCPU, MEMORY
1968
2064
  # },
1969
2065
  # ],
1970
2066
  # linux_parameters: {
@@ -2005,6 +2101,12 @@ module Aws::Batch
2005
2101
  # value_from: "String", # required
2006
2102
  # },
2007
2103
  # ],
2104
+ # network_configuration: {
2105
+ # assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
2106
+ # },
2107
+ # fargate_platform_configuration: {
2108
+ # platform_version: "String",
2109
+ # },
2008
2110
  # },
2009
2111
  # node_properties: {
2010
2112
  # num_nodes: 1, # required
@@ -2054,7 +2156,7 @@ module Aws::Batch
2054
2156
  # resource_requirements: [
2055
2157
  # {
2056
2158
  # value: "String", # required
2057
- # type: "GPU", # required, accepts GPU
2159
+ # type: "GPU", # required, accepts GPU, VCPU, MEMORY
2058
2160
  # },
2059
2161
  # ],
2060
2162
  # linux_parameters: {
@@ -2095,6 +2197,12 @@ module Aws::Batch
2095
2197
  # value_from: "String", # required
2096
2198
  # },
2097
2199
  # ],
2200
+ # network_configuration: {
2201
+ # assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
2202
+ # },
2203
+ # fargate_platform_configuration: {
2204
+ # platform_version: "String",
2205
+ # },
2098
2206
  # },
2099
2207
  # },
2100
2208
  # ],
@@ -2110,12 +2218,14 @@ module Aws::Batch
2110
2218
  # },
2111
2219
  # ],
2112
2220
  # },
2221
+ # propagate_tags: false,
2113
2222
  # timeout: {
2114
2223
  # attempt_duration_seconds: 1,
2115
2224
  # },
2116
2225
  # tags: {
2117
2226
  # "TagKey" => "TagValue",
2118
2227
  # },
2228
+ # platform_capabilities: ["EC2"], # accepts EC2, FARGATE
2119
2229
  # })
2120
2230
  #
2121
2231
  # @example Response structure
@@ -2133,8 +2243,18 @@ module Aws::Batch
2133
2243
  req.send_request(options)
2134
2244
  end
2135
2245
 
2136
- # Submits an AWS Batch job from a job definition. Parameters specified
2137
- # during SubmitJob override parameters defined in the job definition.
2246
+ # Submits an AWS Batch job from a job definition. Parameters that are
2247
+ # specified during SubmitJob override parameters defined in the job
2248
+ # definition. vCPU and memory requirements that are specified in the
2249
+ # `ResourceRequirements` objects in the job definition are the
2250
+ # exception. They can't be overridden this way using the `memory` and
2251
+ # `vcpus` parameters. Rather, you must specify updates to job definition
2252
+ # parameters in a `ResourceRequirements` object that's included in the
2253
+ # `containerOverrides` parameter.
2254
+ #
2255
+ # Jobs that run on Fargate resources can't be guaranteed to run for
2256
+ # more than 14 days. This is because, after 14 days, Fargate resources
2257
+ # might become unavailable and job might be terminated.
2138
2258
  #
2139
2259
  # @option params [required, String] :job_name
2140
2260
  # The name of the job. The first character must be alphanumeric, and up
@@ -2142,8 +2262,8 @@ module Aws::Batch
2142
2262
  # underscores are allowed.
2143
2263
  #
2144
2264
  # @option params [required, String] :job_queue
2145
- # The job queue into which the job is submitted. You can specify either
2146
- # the name or the Amazon Resource Name (ARN) of the queue.
2265
+ # The job queue where the job is submitted. You can specify either the
2266
+ # name or the Amazon Resource Name (ARN) of the queue.
2147
2267
  #
2148
2268
  # @option params [Types::ArrayProperties] :array_properties
2149
2269
  # The array properties for the submitted job, such as the size of the
@@ -2178,29 +2298,43 @@ module Aws::Batch
2178
2298
  # from the job definition.
2179
2299
  #
2180
2300
  # @option params [Types::ContainerOverrides] :container_overrides
2181
- # A list of container overrides in JSON format that specify the name of
2182
- # a container in the specified job definition and the overrides it
2183
- # should receive. You can override the default command for a container
2184
- # (that is specified in the job definition or the Docker image) with a
2301
+ # A list of container overrides in the JSON format that specify the name
2302
+ # of a container in the specified job definition and the overrides it
2303
+ # should receive. You can override the default command for a container,
2304
+ # which is specified in the job definition or the Docker image, with a
2185
2305
  # `command` override. You can also override existing environment
2186
- # variables (that are specified in the job definition or Docker image)
2187
- # on a container or add new environment variables to it with an
2188
- # `environment` override.
2306
+ # variables on a container or add new environment variables to it with
2307
+ # an `environment` override.
2189
2308
  #
2190
2309
  # @option params [Types::NodeOverrides] :node_overrides
2191
2310
  # A list of node overrides in JSON format that specify the node range to
2192
2311
  # target and the container overrides for that node range.
2193
2312
  #
2313
+ # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate resources;
2314
+ # use `containerOverrides` instead.
2315
+ #
2316
+ # </note>
2317
+ #
2194
2318
  # @option params [Types::RetryStrategy] :retry_strategy
2195
2319
  # The retry strategy to use for failed jobs from this SubmitJob
2196
2320
  # operation. When a retry strategy is specified here, it overrides the
2197
2321
  # retry strategy defined in the job definition.
2198
2322
  #
2323
+ # @option params [Boolean] :propagate_tags
2324
+ # Specifies whether to propagate the tags from the job or job definition
2325
+ # to the corresponding Amazon ECS task. If no value is specified, the
2326
+ # tags aren't propagated. Tags can only be propagated to the tasks
2327
+ # during task creation. For tags with the same name, job tags are given
2328
+ # priority over job definitions tags. If the total number of combined
2329
+ # tags from the job and job definition is over 50, the job is moved to
2330
+ # the `FAILED` state. When specified, this overrides the tag propagation
2331
+ # setting in the job definition.
2332
+ #
2199
2333
  # @option params [Types::JobTimeout] :timeout
2200
2334
  # The timeout configuration for this SubmitJob operation. You can
2201
2335
  # specify a timeout duration after which AWS Batch terminates your jobs
2202
- # if they have not finished. If a job is terminated due to a timeout, it
2203
- # is not retried. The minimum value for the timeout is 60 seconds. This
2336
+ # if they haven't finished. If a job is terminated due to a timeout, it
2337
+ # isn't retried. The minimum value for the timeout is 60 seconds. This
2204
2338
  # configuration overrides any timeout configuration specified in the job
2205
2339
  # definition. For array jobs, child jobs have the same timeout
2206
2340
  # configuration as the parent job. For more information, see [Job
@@ -2276,7 +2410,7 @@ module Aws::Batch
2276
2410
  # resource_requirements: [
2277
2411
  # {
2278
2412
  # value: "String", # required
2279
- # type: "GPU", # required, accepts GPU
2413
+ # type: "GPU", # required, accepts GPU, VCPU, MEMORY
2280
2414
  # },
2281
2415
  # ],
2282
2416
  # },
@@ -2299,7 +2433,7 @@ module Aws::Batch
2299
2433
  # resource_requirements: [
2300
2434
  # {
2301
2435
  # value: "String", # required
2302
- # type: "GPU", # required, accepts GPU
2436
+ # type: "GPU", # required, accepts GPU, VCPU, MEMORY
2303
2437
  # },
2304
2438
  # ],
2305
2439
  # },
@@ -2317,6 +2451,7 @@ module Aws::Batch
2317
2451
  # },
2318
2452
  # ],
2319
2453
  # },
2454
+ # propagate_tags: false,
2320
2455
  # timeout: {
2321
2456
  # attempt_duration_seconds: 1,
2322
2457
  # },
@@ -2341,15 +2476,15 @@ module Aws::Batch
2341
2476
  end
2342
2477
 
2343
2478
  # Associates the specified tags to a resource with the specified
2344
- # `resourceArn`. If existing tags on a resource are not specified in the
2345
- # request parameters, they are not changed. When a resource is deleted,
2479
+ # `resourceArn`. If existing tags on a resource aren't specified in the
2480
+ # request parameters, they aren't changed. When a resource is deleted,
2346
2481
  # the tags associated with that resource are deleted as well. AWS Batch
2347
2482
  # resources that support tags are compute environments, jobs, job
2348
2483
  # definitions, and job queues. ARNs for child jobs of array and
2349
2484
  # multi-node parallel (MNP) jobs are not supported.
2350
2485
  #
2351
2486
  # @option params [required, String] :resource_arn
2352
- # The Amazon Resource Name (ARN) of the resource to which to add tags.
2487
+ # The Amazon Resource Name (ARN) of the resource that tags are added to.
2353
2488
  # AWS Batch resources that support tags are compute environments, jobs,
2354
2489
  # job definitions, and job queues. ARNs for child jobs of array and
2355
2490
  # multi-node parallel (MNP) jobs are not supported.
@@ -2501,27 +2636,50 @@ module Aws::Batch
2501
2636
  # `ENABLED` state can accept jobs from a queue and scale in or out
2502
2637
  # automatically based on the workload demand of its associated queues.
2503
2638
  #
2639
+ # If the state is `ENABLED`, then the AWS Batch scheduler can attempt to
2640
+ # place jobs from an associated job queue on the compute resources
2641
+ # within the environment. If the compute environment is managed, then it
2642
+ # can scale its instances out or in automatically, based on the job
2643
+ # queue demand.
2644
+ #
2645
+ # If the state is `DISABLED`, then the AWS Batch scheduler doesn't
2646
+ # attempt to place jobs within the environment. Jobs in a `STARTING` or
2647
+ # `RUNNING` state continue to progress normally. Managed compute
2648
+ # environments in the `DISABLED` state don't scale out. However, they
2649
+ # scale in to `minvCpus` value after instances become idle.
2650
+ #
2504
2651
  # @option params [Types::ComputeResourceUpdate] :compute_resources
2505
2652
  # Details of the compute resources managed by the compute environment.
2506
- # Required for a managed compute environment.
2653
+ # Required for a managed compute environment. For more information, see
2654
+ # [Compute Environments][1] in the *AWS Batch User Guide*.
2655
+ #
2656
+ #
2657
+ #
2658
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/compute_environments.html
2507
2659
  #
2508
2660
  # @option params [String] :service_role
2509
2661
  # The full Amazon Resource Name (ARN) of the IAM role that allows AWS
2510
- # Batch to make calls to other AWS services on your behalf.
2662
+ # Batch to make calls to other AWS services on your behalf. For more
2663
+ # information, see [AWS Batch service IAM role][1] in the *AWS Batch
2664
+ # User Guide*.
2511
2665
  #
2512
2666
  # If your specified role has a path other than `/`, then you must either
2513
2667
  # specify the full role ARN (this is recommended) or prefix the role
2514
2668
  # name with the path.
2515
2669
  #
2516
- # <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN may
2517
- # contain the `service-role` path prefix. When you only specify the name
2518
- # of the service role, AWS Batch assumes that your ARN does not use the
2519
- # `service-role` path prefix. Because of this, we recommend that you
2520
- # specify the full ARN of your service role when you create compute
2670
+ # <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN
2671
+ # might contain the `service-role` path prefix. When you only specify
2672
+ # the name of the service role, AWS Batch assumes that your ARN doesn't
2673
+ # use the `service-role` path prefix. Because of this, we recommend that
2674
+ # you specify the full ARN of your service role when you create compute
2521
2675
  # environments.
2522
2676
  #
2523
2677
  # </note>
2524
2678
  #
2679
+ #
2680
+ #
2681
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/service_IAM_role.html
2682
+ #
2525
2683
  # @return [Types::UpdateComputeEnvironmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2526
2684
  #
2527
2685
  # * {Types::UpdateComputeEnvironmentResponse#compute_environment_name #compute_environment_name} => String
@@ -2552,6 +2710,8 @@ module Aws::Batch
2552
2710
  # minv_cpus: 1,
2553
2711
  # maxv_cpus: 1,
2554
2712
  # desiredv_cpus: 1,
2713
+ # subnets: ["String"],
2714
+ # security_group_ids: ["String"],
2555
2715
  # },
2556
2716
  # service_role: "String",
2557
2717
  # })
@@ -2577,9 +2737,9 @@ module Aws::Batch
2577
2737
  #
2578
2738
  # @option params [String] :state
2579
2739
  # Describes the queue's ability to accept new jobs. If the job queue
2580
- # state is `ENABLED`, it is able to accept jobs. If the job queue state
2581
- # is `DISABLED`, new jobs cannot be added to the queue, but jobs already
2582
- # in the queue can finish.
2740
+ # state is `ENABLED`, it can accept jobs. If the job queue state is
2741
+ # `DISABLED`, new jobs can't be added to the queue, but jobs already in
2742
+ # the queue can finish.
2583
2743
  #
2584
2744
  # @option params [Integer] :priority
2585
2745
  # The priority of the job queue. Job queues with a higher priority (or a
@@ -2587,13 +2747,25 @@ module Aws::Batch
2587
2747
  # when associated with the same compute environment. Priority is
2588
2748
  # determined in descending order, for example, a job queue with a
2589
2749
  # priority value of `10` is given scheduling preference over a job queue
2590
- # with a priority value of `1`.
2750
+ # with a priority value of `1`. All of the compute environments must be
2751
+ # either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or `FARGATE_SPOT`).
2752
+ # EC2 and Fargate compute environments can't be mixed.
2591
2753
  #
2592
2754
  # @option params [Array<Types::ComputeEnvironmentOrder>] :compute_environment_order
2593
2755
  # Details the set of compute environments mapped to a job queue and
2594
2756
  # their order relative to each other. This is one of the parameters used
2595
- # by the job scheduler to determine which compute environment should
2596
- # execute a given job.
2757
+ # by the job scheduler to determine which compute environment should run
2758
+ # a given job. Compute environments must be in the `VALID` state before
2759
+ # you can associate them with a job queue. All of the compute
2760
+ # environments must be either EC2 (`EC2` or `SPOT`) or Fargate
2761
+ # (`FARGATE` or `FARGATE_SPOT`). EC2 and Fargate compute environments
2762
+ # can't be mixed.
2763
+ #
2764
+ # <note markdown="1"> All compute environments that are associated with a job queue must
2765
+ # share the same architecture. AWS Batch doesn't support mixing compute
2766
+ # environment architecture types in a single job queue.
2767
+ #
2768
+ # </note>
2597
2769
  #
2598
2770
  # @return [Types::UpdateJobQueueResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2599
2771
  #
@@ -2657,7 +2829,7 @@ module Aws::Batch
2657
2829
  params: params,
2658
2830
  config: config)
2659
2831
  context[:gem_name] = 'aws-sdk-batch'
2660
- context[:gem_version] = '1.41.0'
2832
+ context[:gem_version] = '1.46.0'
2661
2833
  Seahorse::Client::Request.new(handlers, context)
2662
2834
  end
2663
2835