aws-sdk-batch 1.40.0 → 1.45.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.45.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.40.0'
51
+ GEM_VERSION = '1.45.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` are not 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. You can choose either to use EC2 On-Demand Instances and
386
+ # EC2 Spot Instances, or to use Fargate and Fargate Spot capacity in
387
+ # 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
391
  # <note markdown="1"> Multi-node parallel jobs are not 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
401
- # instances into that Amazon ECS cluster. For more information, see
402
- # [Launching an Amazon ECS Container Instance][3] in the *Amazon Elastic
403
- # Container Service Developer Guide*.
404
- #
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:
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 AMI. However,
398
+ # you need to verify that your AMI meets 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 have created your unmanaged compute environment, you
402
+ # can use the DescribeComputeEnvironments operation to find the Amazon
403
+ # ECS cluster that's associated with it. Then, manually launch your
404
+ # container instances into that Amazon ECS cluster. For more
405
+ # information, see [Launching an Amazon ECS container instance][3] in
406
+ # the *Amazon Elastic Container Service Developer Guide*.
407
+ #
408
+ # <note markdown="1"> AWS Batch doesn't upgrade the AMIs in a compute environment after
409
+ # it's created. For example, it doesn't update the AMIs when a newer
410
+ # version of the Amazon ECS-optimized AMI is available. Therefore,
411
+ # you're responsible for the management of the guest operating system
412
+ # (including 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,11 +448,23 @@ 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
  #
@@ -455,21 +472,27 @@ module Aws::Batch
455
472
  #
456
473
  # @option params [required, 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.
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*.
459
478
  #
460
479
  # If your specified role has a path other than `/`, then you must either
461
480
  # specify the full role ARN (this is recommended) or prefix the role
462
481
  # name with the path.
463
482
  #
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
483
+ # <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN
484
+ # might contain the `service-role` path prefix. When you only specify
485
+ # the name of the service role, AWS Batch assumes that your ARN doesn't
486
+ # use the `service-role` path prefix. Because of this, we recommend that
487
+ # you specify the full ARN of your service role when you create compute
469
488
  # environments.
470
489
  #
471
490
  # </note>
472
491
  #
492
+ #
493
+ #
494
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/service_IAM_role.html
495
+ #
473
496
  # @option params [Hash<String,String>] :tags
474
497
  # The tags that you apply to the compute environment to help you
475
498
  # categorize and organize your resources. Each tag consists of a key and
@@ -477,7 +500,7 @@ module Aws::Batch
477
500
  # Resources][1] in *AWS General Reference*.
478
501
  #
479
502
  # These tags can be updated or removed using the [TagResource][2] and
480
- # [UntagResource][3] API operations. These tags do not propagate to the
503
+ # [UntagResource][3] API operations. These tags don't propagate to the
481
504
  # underlying compute resources.
482
505
  #
483
506
  #
@@ -585,17 +608,17 @@ module Aws::Batch
585
608
  # type: "MANAGED", # required, accepts MANAGED, UNMANAGED
586
609
  # state: "ENABLED", # accepts ENABLED, DISABLED
587
610
  # compute_resources: {
588
- # type: "EC2", # required, accepts EC2, SPOT
611
+ # type: "EC2", # required, accepts EC2, SPOT, FARGATE, FARGATE_SPOT
589
612
  # allocation_strategy: "BEST_FIT", # accepts BEST_FIT, BEST_FIT_PROGRESSIVE, SPOT_CAPACITY_OPTIMIZED
590
- # minv_cpus: 1, # required
613
+ # minv_cpus: 1,
591
614
  # maxv_cpus: 1, # required
592
615
  # desiredv_cpus: 1,
593
- # instance_types: ["String"], # required
616
+ # instance_types: ["String"],
594
617
  # image_id: "String",
595
618
  # subnets: ["String"], # required
596
619
  # security_group_ids: ["String"],
597
620
  # ec2_key_pair: "String",
598
- # instance_role: "String", # required
621
+ # instance_role: "String",
599
622
  # tags: {
600
623
  # "String" => "String",
601
624
  # },
@@ -607,6 +630,12 @@ module Aws::Batch
607
630
  # launch_template_name: "String",
608
631
  # version: "String",
609
632
  # },
633
+ # ec2_configuration: [
634
+ # {
635
+ # image_type: "ImageType", # required
636
+ # image_id_override: "ImageIdOverride",
637
+ # },
638
+ # ],
610
639
  # },
611
640
  # service_role: "String", # required
612
641
  # tags: {
@@ -639,39 +668,50 @@ module Aws::Batch
639
668
  # preference for scheduling jobs to that compute environment.
640
669
  #
641
670
  # @option params [required, String] :job_queue_name
642
- # The name of the job queue.
671
+ # The name of the job queue. Up to 128 letters (uppercase and
672
+ # lowercase), numbers, and underscores are allowed.
643
673
  #
644
674
  # @option params [String] :state
645
675
  # The state of the job queue. If the job queue state is `ENABLED`, it is
646
676
  # able to accept jobs. If the job queue state is `DISABLED`, new jobs
647
- # cannot be added to the queue, but jobs already in the queue can
677
+ # can't be added to the queue, but jobs already in the queue can
648
678
  # finish.
649
679
  #
650
680
  # @option params [required, Integer] :priority
651
681
  # The priority of the job queue. Job queues with a higher priority (or a
652
682
  # higher integer value for the `priority` parameter) are evaluated first
653
683
  # when associated with the same compute environment. Priority is
654
- # determined in descending order, for example, a job queue with a
684
+ # determined in descending order. For example, a job queue with a
655
685
  # priority value of `10` is given scheduling preference over a job queue
656
- # with a priority value of `1`.
686
+ # with a priority value of `1`. All of the compute environments must be
687
+ # either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or `FARGATE_SPOT`);
688
+ # EC2 and Fargate compute environments cannot be mixed.
657
689
  #
658
690
  # @option params [required, Array<Types::ComputeEnvironmentOrder>] :compute_environment_order
659
691
  # The set of compute environments mapped to a job queue and their order
660
692
  # relative to each other. The job scheduler uses this parameter to
661
- # determine which compute environment should execute a given job.
662
- # Compute environments must be in the `VALID` state before you can
663
- # associate them with a job queue. You can associate up to three compute
664
- # environments with a job queue.
693
+ # determine which compute environment should run a specific job. Compute
694
+ # environments must be in the `VALID` state before you can associate
695
+ # them with a job queue. You can associate up to three compute
696
+ # environments with a job queue. 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 can't be mixed.
699
+ #
700
+ # <note markdown="1"> All compute environments that are associated with a job queue must
701
+ # share the same architecture. AWS Batch doesn't support mixing compute
702
+ # environment architecture types in a single job queue.
703
+ #
704
+ # </note>
665
705
  #
666
706
  # @option params [Hash<String,String>] :tags
667
707
  # The tags that you apply to the job queue to help you categorize and
668
708
  # organize your resources. Each tag consists of a key and an optional
669
- # value. For more information, see [Tagging AWS Resources][1] in *AWS
670
- # General Reference*.
709
+ # value. For more information, see [Tagging your AWS Batch resources][1]
710
+ # in *AWS Batch User Guide*.
671
711
  #
672
712
  #
673
713
  #
674
- # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
714
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/using-tags.html
675
715
  #
676
716
  # @return [Types::CreateJobQueueResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
677
717
  #
@@ -764,7 +804,10 @@ module Aws::Batch
764
804
  # Before you can delete a compute environment, you must set its state to
765
805
  # `DISABLED` with the UpdateComputeEnvironment API operation and
766
806
  # disassociate it from any job queues with the UpdateJobQueue API
767
- # operation.
807
+ # operation. Compute environments that use AWS Fargate resources must
808
+ # terminate all active jobs on that compute environment before deleting
809
+ # the compute environment. If this isn't done, the compute environment
810
+ # will end up in an invalid state.
768
811
  #
769
812
  # @option params [required, String] :compute_environment
770
813
  # The name or Amazon Resource Name (ARN) of the compute environment to
@@ -802,9 +845,10 @@ module Aws::Batch
802
845
 
803
846
  # Deletes the specified job queue. You must first disable submissions
804
847
  # for a queue with the UpdateJobQueue operation. All jobs in the queue
805
- # are terminated when you delete a job queue.
848
+ # are eventually terminated when you delete a job queue. The jobs are
849
+ # terminated at a rate of about 16 jobs each second.
806
850
  #
807
- # It is not necessary to disassociate compute environments from a queue
851
+ # It's not necessary to disassociate compute environments from a queue
808
852
  # before submitting a `DeleteJobQueue` request.
809
853
  #
810
854
  # @option params [required, String] :job_queue
@@ -841,7 +885,7 @@ module Aws::Batch
841
885
  req.send_request(options)
842
886
  end
843
887
 
844
- # Deregisters an AWS Batch job definition. Job definitions will be
888
+ # Deregisters an AWS Batch job definition. Job definitions are
845
889
  # permanently deleted after 180 days.
846
890
  #
847
891
  # @option params [required, String] :job_definition
@@ -880,7 +924,7 @@ module Aws::Batch
880
924
 
881
925
  # Describes one or more of your compute environments.
882
926
  #
883
- # If you are using an unmanaged compute environment, you can use the
927
+ # If you're using an unmanaged compute environment, you can use the
884
928
  # `DescribeComputeEnvironment` operation to determine the
885
929
  # `ecsClusterArn` that you should launch your Amazon ECS container
886
930
  # instances into.
@@ -897,7 +941,7 @@ module Aws::Batch
897
941
  # The remaining results of the initial request can be seen by sending
898
942
  # another `DescribeComputeEnvironments` request with the returned
899
943
  # `nextToken` value. This value can be between 1 and 100. If this
900
- # parameter is not used, then `DescribeComputeEnvironments` returns up
944
+ # parameter isn't used, then `DescribeComputeEnvironments` returns up
901
945
  # to 100 results and a `nextToken` value if applicable.
902
946
  #
903
947
  # @option params [String] :next_token
@@ -907,7 +951,7 @@ module Aws::Batch
907
951
  # from the end of the previous results that returned the `nextToken`
908
952
  # value. This value is `null` when there are no more results to return.
909
953
  #
910
- # <note markdown="1"> This token should be treated as an opaque identifier that is only used
954
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only used
911
955
  # to retrieve the next items in a list and not for other programmatic
912
956
  # purposes.
913
957
  #
@@ -989,7 +1033,7 @@ module Aws::Batch
989
1033
  # resp.compute_environments[0].state #=> String, one of "ENABLED", "DISABLED"
990
1034
  # resp.compute_environments[0].status #=> String, one of "CREATING", "UPDATING", "DELETING", "DELETED", "VALID", "INVALID"
991
1035
  # resp.compute_environments[0].status_reason #=> String
992
- # resp.compute_environments[0].compute_resources.type #=> String, one of "EC2", "SPOT"
1036
+ # resp.compute_environments[0].compute_resources.type #=> String, one of "EC2", "SPOT", "FARGATE", "FARGATE_SPOT"
993
1037
  # resp.compute_environments[0].compute_resources.allocation_strategy #=> String, one of "BEST_FIT", "BEST_FIT_PROGRESSIVE", "SPOT_CAPACITY_OPTIMIZED"
994
1038
  # resp.compute_environments[0].compute_resources.minv_cpus #=> Integer
995
1039
  # resp.compute_environments[0].compute_resources.maxv_cpus #=> Integer
@@ -1011,6 +1055,9 @@ module Aws::Batch
1011
1055
  # resp.compute_environments[0].compute_resources.launch_template.launch_template_id #=> String
1012
1056
  # resp.compute_environments[0].compute_resources.launch_template.launch_template_name #=> String
1013
1057
  # resp.compute_environments[0].compute_resources.launch_template.version #=> String
1058
+ # resp.compute_environments[0].compute_resources.ec2_configuration #=> Array
1059
+ # resp.compute_environments[0].compute_resources.ec2_configuration[0].image_type #=> String
1060
+ # resp.compute_environments[0].compute_resources.ec2_configuration[0].image_id_override #=> String
1014
1061
  # resp.compute_environments[0].service_role #=> String
1015
1062
  # resp.next_token #=> String
1016
1063
  #
@@ -1037,7 +1084,7 @@ module Aws::Batch
1037
1084
  # page along with a `nextToken` response element. The remaining results
1038
1085
  # of the initial request can be seen by sending another
1039
1086
  # `DescribeJobDefinitions` request with the returned `nextToken` value.
1040
- # This value can be between 1 and 100. If this parameter is not used,
1087
+ # This value can be between 1 and 100. If this parameter isn't used,
1041
1088
  # then `DescribeJobDefinitions` returns up to 100 results and a
1042
1089
  # `nextToken` value if applicable.
1043
1090
  #
@@ -1045,7 +1092,7 @@ module Aws::Batch
1045
1092
  # The name of the job definition to describe.
1046
1093
  #
1047
1094
  # @option params [String] :status
1048
- # The status with which to filter job definitions.
1095
+ # The status used to filter job definitions.
1049
1096
  #
1050
1097
  # @option params [String] :next_token
1051
1098
  # The `nextToken` value returned from a previous paginated
@@ -1054,7 +1101,7 @@ module Aws::Batch
1054
1101
  # from the end of the previous results that returned the `nextToken`
1055
1102
  # value. This value is `null` when there are no more results to return.
1056
1103
  #
1057
- # <note markdown="1"> This token should be treated as an opaque identifier that is only used
1104
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only used
1058
1105
  # to retrieve the next items in a list and not for other programmatic
1059
1106
  # purposes.
1060
1107
  #
@@ -1159,7 +1206,7 @@ module Aws::Batch
1159
1206
  # resp.job_definitions[0].container_properties.instance_type #=> String
1160
1207
  # resp.job_definitions[0].container_properties.resource_requirements #=> Array
1161
1208
  # resp.job_definitions[0].container_properties.resource_requirements[0].value #=> String
1162
- # resp.job_definitions[0].container_properties.resource_requirements[0].type #=> String, one of "GPU"
1209
+ # resp.job_definitions[0].container_properties.resource_requirements[0].type #=> String, one of "GPU", "VCPU", "MEMORY"
1163
1210
  # resp.job_definitions[0].container_properties.linux_parameters.devices #=> Array
1164
1211
  # resp.job_definitions[0].container_properties.linux_parameters.devices[0].host_path #=> String
1165
1212
  # resp.job_definitions[0].container_properties.linux_parameters.devices[0].container_path #=> String
@@ -1183,6 +1230,8 @@ module Aws::Batch
1183
1230
  # resp.job_definitions[0].container_properties.secrets #=> Array
1184
1231
  # resp.job_definitions[0].container_properties.secrets[0].name #=> String
1185
1232
  # resp.job_definitions[0].container_properties.secrets[0].value_from #=> String
1233
+ # resp.job_definitions[0].container_properties.network_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
1234
+ # resp.job_definitions[0].container_properties.fargate_platform_configuration.platform_version #=> String
1186
1235
  # resp.job_definitions[0].timeout.attempt_duration_seconds #=> Integer
1187
1236
  # resp.job_definitions[0].node_properties.num_nodes #=> Integer
1188
1237
  # resp.job_definitions[0].node_properties.main_node #=> Integer
@@ -1215,7 +1264,7 @@ module Aws::Batch
1215
1264
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.instance_type #=> String
1216
1265
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.resource_requirements #=> Array
1217
1266
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.resource_requirements[0].value #=> String
1218
- # resp.job_definitions[0].node_properties.node_range_properties[0].container.resource_requirements[0].type #=> String, one of "GPU"
1267
+ # resp.job_definitions[0].node_properties.node_range_properties[0].container.resource_requirements[0].type #=> String, one of "GPU", "VCPU", "MEMORY"
1219
1268
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.linux_parameters.devices #=> Array
1220
1269
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.linux_parameters.devices[0].host_path #=> String
1221
1270
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.linux_parameters.devices[0].container_path #=> String
@@ -1239,8 +1288,13 @@ module Aws::Batch
1239
1288
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.secrets #=> Array
1240
1289
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.secrets[0].name #=> String
1241
1290
  # resp.job_definitions[0].node_properties.node_range_properties[0].container.secrets[0].value_from #=> String
1291
+ # resp.job_definitions[0].node_properties.node_range_properties[0].container.network_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
1292
+ # resp.job_definitions[0].node_properties.node_range_properties[0].container.fargate_platform_configuration.platform_version #=> String
1242
1293
  # resp.job_definitions[0].tags #=> Hash
1243
1294
  # resp.job_definitions[0].tags["TagKey"] #=> String
1295
+ # resp.job_definitions[0].propagate_tags #=> Boolean
1296
+ # resp.job_definitions[0].platform_capabilities #=> Array
1297
+ # resp.job_definitions[0].platform_capabilities[0] #=> String, one of "EC2", "FARGATE"
1244
1298
  # resp.next_token #=> String
1245
1299
  #
1246
1300
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/DescribeJobDefinitions AWS API Documentation
@@ -1265,7 +1319,7 @@ module Aws::Batch
1265
1319
  # `nextToken` response element. The remaining results of the initial
1266
1320
  # request can be seen by sending another `DescribeJobQueues` request
1267
1321
  # with the returned `nextToken` value. This value can be between 1 and
1268
- # 100. If this parameter is not used, then `DescribeJobQueues` returns
1322
+ # 100. If this parameter isn't used, then `DescribeJobQueues` returns
1269
1323
  # up to 100 results and a `nextToken` value if applicable.
1270
1324
  #
1271
1325
  # @option params [String] :next_token
@@ -1275,7 +1329,7 @@ module Aws::Batch
1275
1329
  # from the end of the previous results that returned the `nextToken`
1276
1330
  # value. This value is `null` when there are no more results to return.
1277
1331
  #
1278
- # <note markdown="1"> This token should be treated as an opaque identifier that is only used
1332
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only used
1279
1333
  # to retrieve the next items in a list and not for other programmatic
1280
1334
  # purposes.
1281
1335
  #
@@ -1490,7 +1544,7 @@ module Aws::Batch
1490
1544
  # resp.jobs[0].container.network_interfaces[0].private_ipv_4_address #=> String
1491
1545
  # resp.jobs[0].container.resource_requirements #=> Array
1492
1546
  # resp.jobs[0].container.resource_requirements[0].value #=> String
1493
- # resp.jobs[0].container.resource_requirements[0].type #=> String, one of "GPU"
1547
+ # resp.jobs[0].container.resource_requirements[0].type #=> String, one of "GPU", "VCPU", "MEMORY"
1494
1548
  # resp.jobs[0].container.linux_parameters.devices #=> Array
1495
1549
  # resp.jobs[0].container.linux_parameters.devices[0].host_path #=> String
1496
1550
  # resp.jobs[0].container.linux_parameters.devices[0].container_path #=> String
@@ -1514,6 +1568,8 @@ module Aws::Batch
1514
1568
  # resp.jobs[0].container.secrets #=> Array
1515
1569
  # resp.jobs[0].container.secrets[0].name #=> String
1516
1570
  # resp.jobs[0].container.secrets[0].value_from #=> String
1571
+ # resp.jobs[0].container.network_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
1572
+ # resp.jobs[0].container.fargate_platform_configuration.platform_version #=> String
1517
1573
  # resp.jobs[0].node_details.node_index #=> Integer
1518
1574
  # resp.jobs[0].node_details.is_main_node #=> Boolean
1519
1575
  # resp.jobs[0].node_properties.num_nodes #=> Integer
@@ -1547,7 +1603,7 @@ module Aws::Batch
1547
1603
  # resp.jobs[0].node_properties.node_range_properties[0].container.instance_type #=> String
1548
1604
  # resp.jobs[0].node_properties.node_range_properties[0].container.resource_requirements #=> Array
1549
1605
  # resp.jobs[0].node_properties.node_range_properties[0].container.resource_requirements[0].value #=> String
1550
- # resp.jobs[0].node_properties.node_range_properties[0].container.resource_requirements[0].type #=> String, one of "GPU"
1606
+ # resp.jobs[0].node_properties.node_range_properties[0].container.resource_requirements[0].type #=> String, one of "GPU", "VCPU", "MEMORY"
1551
1607
  # resp.jobs[0].node_properties.node_range_properties[0].container.linux_parameters.devices #=> Array
1552
1608
  # resp.jobs[0].node_properties.node_range_properties[0].container.linux_parameters.devices[0].host_path #=> String
1553
1609
  # resp.jobs[0].node_properties.node_range_properties[0].container.linux_parameters.devices[0].container_path #=> String
@@ -1571,6 +1627,8 @@ module Aws::Batch
1571
1627
  # resp.jobs[0].node_properties.node_range_properties[0].container.secrets #=> Array
1572
1628
  # resp.jobs[0].node_properties.node_range_properties[0].container.secrets[0].name #=> String
1573
1629
  # resp.jobs[0].node_properties.node_range_properties[0].container.secrets[0].value_from #=> String
1630
+ # resp.jobs[0].node_properties.node_range_properties[0].container.network_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
1631
+ # resp.jobs[0].node_properties.node_range_properties[0].container.fargate_platform_configuration.platform_version #=> String
1574
1632
  # resp.jobs[0].array_properties.status_summary #=> Hash
1575
1633
  # resp.jobs[0].array_properties.status_summary["String"] #=> Integer
1576
1634
  # resp.jobs[0].array_properties.size #=> Integer
@@ -1578,6 +1636,9 @@ module Aws::Batch
1578
1636
  # resp.jobs[0].timeout.attempt_duration_seconds #=> Integer
1579
1637
  # resp.jobs[0].tags #=> Hash
1580
1638
  # resp.jobs[0].tags["TagKey"] #=> String
1639
+ # resp.jobs[0].propagate_tags #=> Boolean
1640
+ # resp.jobs[0].platform_capabilities #=> Array
1641
+ # resp.jobs[0].platform_capabilities[0] #=> String, one of "EC2", "FARGATE"
1581
1642
  #
1582
1643
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/DescribeJobs AWS API Documentation
1583
1644
  #
@@ -1590,21 +1651,21 @@ module Aws::Batch
1590
1651
 
1591
1652
  # Returns a list of AWS Batch jobs.
1592
1653
  #
1593
- # You must specify only one of the following:
1654
+ # You must specify only one of the following items:
1594
1655
  #
1595
- # * a job queue ID to return a list of jobs in that job queue
1656
+ # * A job queue ID to return a list of jobs in that job queue
1596
1657
  #
1597
- # * a multi-node parallel job ID to return a list of that job's nodes
1658
+ # * A multi-node parallel job ID to return a list of that job's nodes
1598
1659
  #
1599
- # * an array job ID to return a list of that job's children
1660
+ # * An array job ID to return a list of that job's children
1600
1661
  #
1601
1662
  # You can filter the results by job status with the `jobStatus`
1602
- # parameter. If you do not specify a status, only `RUNNING` jobs are
1663
+ # parameter. If you don't specify a status, only `RUNNING` jobs are
1603
1664
  # returned.
1604
1665
  #
1605
1666
  # @option params [String] :job_queue
1606
- # The name or full Amazon Resource Name (ARN) of the job queue with
1607
- # which to list jobs.
1667
+ # The name or full Amazon Resource Name (ARN) of the job queue used to
1668
+ # list jobs.
1608
1669
  #
1609
1670
  # @option params [String] :array_job_id
1610
1671
  # The job ID for an array job. Specifying an array job ID with this
@@ -1616,8 +1677,8 @@ module Aws::Batch
1616
1677
  # associated with the specified job.
1617
1678
  #
1618
1679
  # @option params [String] :job_status
1619
- # The job status with which to filter jobs in the specified queue. If
1620
- # you do not specify a status, only `RUNNING` jobs are returned.
1680
+ # The job status used to filter jobs in the specified queue. If you
1681
+ # don't specify a status, only `RUNNING` jobs are returned.
1621
1682
  #
1622
1683
  # @option params [Integer] :max_results
1623
1684
  # The maximum number of results returned by `ListJobs` in paginated
@@ -1626,7 +1687,7 @@ module Aws::Batch
1626
1687
  # response element. The remaining results of the initial request can be
1627
1688
  # seen by sending another `ListJobs` request with the returned
1628
1689
  # `nextToken` value. This value can be between 1 and 100. If this
1629
- # parameter is not used, then `ListJobs` returns up to 100 results and a
1690
+ # parameter isn't used, then `ListJobs` returns up to 100 results and a
1630
1691
  # `nextToken` value if applicable.
1631
1692
  #
1632
1693
  # @option params [String] :next_token
@@ -1636,7 +1697,7 @@ module Aws::Batch
1636
1697
  # results that returned the `nextToken` value. This value is `null` when
1637
1698
  # there are no more results to return.
1638
1699
  #
1639
- # <note markdown="1"> This token should be treated as an opaque identifier that is only used
1700
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only used
1640
1701
  # to retrieve the next items in a list and not for other programmatic
1641
1702
  # purposes.
1642
1703
  #
@@ -1727,14 +1788,14 @@ module Aws::Batch
1727
1788
  req.send_request(options)
1728
1789
  end
1729
1790
 
1730
- # List the tags for an AWS Batch resource. AWS Batch resources that
1791
+ # Lists the tags for an AWS Batch resource. AWS Batch resources that
1731
1792
  # support tags are compute environments, jobs, job definitions, and job
1732
1793
  # queues. ARNs for child jobs of array and multi-node parallel (MNP)
1733
1794
  # jobs are not supported.
1734
1795
  #
1735
1796
  # @option params [required, String] :resource_arn
1736
- # The Amazon Resource Name (ARN) that identifies the resource for which
1737
- # to list the tags. AWS Batch resources that support tags are compute
1797
+ # The Amazon Resource Name (ARN) that identifies the resource that tags
1798
+ # are listed for. AWS Batch resources that support tags are compute
1738
1799
  # environments, jobs, job definitions, and job queues. ARNs for child
1739
1800
  # jobs of array and multi-node parallel (MNP) jobs are not supported.
1740
1801
  #
@@ -1788,7 +1849,18 @@ module Aws::Batch
1788
1849
  # allowed.
1789
1850
  #
1790
1851
  # @option params [required, String] :type
1791
- # The type of job definition.
1852
+ # The type of job definition. For more information about multi-node
1853
+ # parallel jobs, see [Creating a multi-node parallel job definition][1]
1854
+ # in the *AWS Batch User Guide*.
1855
+ #
1856
+ # <note markdown="1"> If the job is run on Fargate resources, then `multinode` isn't
1857
+ # supported.
1858
+ #
1859
+ # </note>
1860
+ #
1861
+ #
1862
+ #
1863
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/multi-node-job-def.html
1792
1864
  #
1793
1865
  # @option params [Hash<String,String>] :parameters
1794
1866
  # Default parameter substitution placeholders to set in the job
@@ -1802,6 +1874,11 @@ module Aws::Batch
1802
1874
  # `container`, then you must specify either `containerProperties` or
1803
1875
  # `nodeProperties`.
1804
1876
  #
1877
+ # <note markdown="1"> If the job runs on Fargate resources, then you must not specify
1878
+ # `nodeProperties`; use only `containerProperties`.
1879
+ #
1880
+ # </note>
1881
+ #
1805
1882
  # @option params [Types::NodeProperties] :node_properties
1806
1883
  # An object with various properties specific to multi-node parallel
1807
1884
  # jobs. If you specify node properties for a job, it becomes a
@@ -1810,39 +1887,57 @@ module Aws::Batch
1810
1887
  # definition's `type` parameter is `container`, then you must specify
1811
1888
  # either `containerProperties` or `nodeProperties`.
1812
1889
  #
1890
+ # <note markdown="1"> If the job runs on Fargate resources, then you must not specify
1891
+ # `nodeProperties`; use `containerProperties` instead.
1892
+ #
1893
+ # </note>
1894
+ #
1813
1895
  #
1814
1896
  #
1815
1897
  # [1]: https://docs.aws.amazon.com/batch/latest/userguide/multi-node-parallel-jobs.html
1816
1898
  #
1817
1899
  # @option params [Types::RetryStrategy] :retry_strategy
1818
1900
  # The retry strategy to use for failed jobs that are submitted with this
1819
- # job definition. Any retry strategy that is specified during a
1901
+ # job definition. Any retry strategy that's specified during a
1820
1902
  # SubmitJob operation overrides the retry strategy defined here. If a
1821
- # job is terminated due to a timeout, it is not retried.
1903
+ # job is terminated due to a timeout, it isn't retried.
1904
+ #
1905
+ # @option params [Boolean] :propagate_tags
1906
+ # Specifies whether to propagate the tags from the job or job definition
1907
+ # to the corresponding Amazon ECS task. If no value is specified, the
1908
+ # tags are not propagated. Tags can only be propagated to the tasks
1909
+ # during task creation. For tags with the same name, job tags are given
1910
+ # priority over job definitions tags. If the total number of combined
1911
+ # tags from the job and job definition is over 50, the job is moved to
1912
+ # the `FAILED` state.
1822
1913
  #
1823
1914
  # @option params [Types::JobTimeout] :timeout
1824
1915
  # The timeout configuration for jobs that are submitted with this job
1825
1916
  # definition, after which AWS Batch terminates your jobs if they have
1826
- # not finished. If a job is terminated due to a timeout, it is not
1917
+ # not finished. If a job is terminated due to a timeout, it isn't
1827
1918
  # retried. The minimum value for the timeout is 60 seconds. Any timeout
1828
- # configuration that is specified during a SubmitJob operation overrides
1919
+ # configuration that's specified during a SubmitJob operation overrides
1829
1920
  # the timeout configuration defined here. For more information, see [Job
1830
- # Timeouts][1] in the *Amazon Elastic Container Service Developer
1831
- # Guide*.
1921
+ # Timeouts][1] in the *AWS Batch User Guide*.
1832
1922
  #
1833
1923
  #
1834
1924
  #
1835
- # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/job_timeouts.html
1925
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/job_timeouts.html
1836
1926
  #
1837
1927
  # @option params [Hash<String,String>] :tags
1838
1928
  # The tags that you apply to the job definition to help you categorize
1839
1929
  # and organize your resources. Each tag consists of a key and an
1840
1930
  # optional value. For more information, see [Tagging AWS Resources][1]
1841
- # in *AWS General Reference*.
1931
+ # in *AWS Batch User Guide*.
1842
1932
  #
1843
1933
  #
1844
1934
  #
1845
- # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
1935
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/using-tags.html
1936
+ #
1937
+ # @option params [Array<String>] :platform_capabilities
1938
+ # The platform capabilities required by the job definition. If no value
1939
+ # is specified, it defaults to `EC2`. To run the job on Fargate
1940
+ # resources, specify `FARGATE`.
1846
1941
  #
1847
1942
  # @return [Types::RegisterJobDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1848
1943
  #
@@ -1955,7 +2050,7 @@ module Aws::Batch
1955
2050
  # resource_requirements: [
1956
2051
  # {
1957
2052
  # value: "String", # required
1958
- # type: "GPU", # required, accepts GPU
2053
+ # type: "GPU", # required, accepts GPU, VCPU, MEMORY
1959
2054
  # },
1960
2055
  # ],
1961
2056
  # linux_parameters: {
@@ -1996,6 +2091,12 @@ module Aws::Batch
1996
2091
  # value_from: "String", # required
1997
2092
  # },
1998
2093
  # ],
2094
+ # network_configuration: {
2095
+ # assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
2096
+ # },
2097
+ # fargate_platform_configuration: {
2098
+ # platform_version: "String",
2099
+ # },
1999
2100
  # },
2000
2101
  # node_properties: {
2001
2102
  # num_nodes: 1, # required
@@ -2045,7 +2146,7 @@ module Aws::Batch
2045
2146
  # resource_requirements: [
2046
2147
  # {
2047
2148
  # value: "String", # required
2048
- # type: "GPU", # required, accepts GPU
2149
+ # type: "GPU", # required, accepts GPU, VCPU, MEMORY
2049
2150
  # },
2050
2151
  # ],
2051
2152
  # linux_parameters: {
@@ -2086,6 +2187,12 @@ module Aws::Batch
2086
2187
  # value_from: "String", # required
2087
2188
  # },
2088
2189
  # ],
2190
+ # network_configuration: {
2191
+ # assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
2192
+ # },
2193
+ # fargate_platform_configuration: {
2194
+ # platform_version: "String",
2195
+ # },
2089
2196
  # },
2090
2197
  # },
2091
2198
  # ],
@@ -2101,12 +2208,14 @@ module Aws::Batch
2101
2208
  # },
2102
2209
  # ],
2103
2210
  # },
2211
+ # propagate_tags: false,
2104
2212
  # timeout: {
2105
2213
  # attempt_duration_seconds: 1,
2106
2214
  # },
2107
2215
  # tags: {
2108
2216
  # "TagKey" => "TagValue",
2109
2217
  # },
2218
+ # platform_capabilities: ["EC2"], # accepts EC2, FARGATE
2110
2219
  # })
2111
2220
  #
2112
2221
  # @example Response structure
@@ -2127,6 +2236,10 @@ module Aws::Batch
2127
2236
  # Submits an AWS Batch job from a job definition. Parameters specified
2128
2237
  # during SubmitJob override parameters defined in the job definition.
2129
2238
  #
2239
+ # Jobs run on Fargate resources don't run for more than 14 days. After
2240
+ # 14 days, the Fargate resources might no longer be available and the
2241
+ # job is terminated.
2242
+ #
2130
2243
  # @option params [required, String] :job_name
2131
2244
  # The name of the job. The first character must be alphanumeric, and up
2132
2245
  # to 128 letters (uppercase and lowercase), numbers, hyphens, and
@@ -2172,7 +2285,7 @@ module Aws::Batch
2172
2285
  # A list of container overrides in JSON format that specify the name of
2173
2286
  # a container in the specified job definition and the overrides it
2174
2287
  # should receive. You can override the default command for a container
2175
- # (that is specified in the job definition or the Docker image) with a
2288
+ # (that's specified in the job definition or the Docker image) with a
2176
2289
  # `command` override. You can also override existing environment
2177
2290
  # variables (that are specified in the job definition or Docker image)
2178
2291
  # on a container or add new environment variables to it with an
@@ -2182,16 +2295,31 @@ module Aws::Batch
2182
2295
  # A list of node overrides in JSON format that specify the node range to
2183
2296
  # target and the container overrides for that node range.
2184
2297
  #
2298
+ # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate resources;
2299
+ # use `containerOverrides` instead.
2300
+ #
2301
+ # </note>
2302
+ #
2185
2303
  # @option params [Types::RetryStrategy] :retry_strategy
2186
2304
  # The retry strategy to use for failed jobs from this SubmitJob
2187
2305
  # operation. When a retry strategy is specified here, it overrides the
2188
2306
  # retry strategy defined in the job definition.
2189
2307
  #
2308
+ # @option params [Boolean] :propagate_tags
2309
+ # Specifies whether to propagate the tags from the job or job definition
2310
+ # to the corresponding Amazon ECS task. If no value is specified, the
2311
+ # tags aren't propagated. Tags can only be propagated to the tasks
2312
+ # during task creation. For tags with the same name, job tags are given
2313
+ # priority over job definitions tags. If the total number of combined
2314
+ # tags from the job and job definition is over 50, the job is moved to
2315
+ # the `FAILED` state. When specified, this overrides the tag propagation
2316
+ # setting in the job definition.
2317
+ #
2190
2318
  # @option params [Types::JobTimeout] :timeout
2191
2319
  # The timeout configuration for this SubmitJob operation. You can
2192
2320
  # specify a timeout duration after which AWS Batch terminates your jobs
2193
- # if they have not finished. If a job is terminated due to a timeout, it
2194
- # is not retried. The minimum value for the timeout is 60 seconds. This
2321
+ # if they haven't finished. If a job is terminated due to a timeout, it
2322
+ # isn't retried. The minimum value for the timeout is 60 seconds. This
2195
2323
  # configuration overrides any timeout configuration specified in the job
2196
2324
  # definition. For array jobs, child jobs have the same timeout
2197
2325
  # configuration as the parent job. For more information, see [Job
@@ -2267,7 +2395,7 @@ module Aws::Batch
2267
2395
  # resource_requirements: [
2268
2396
  # {
2269
2397
  # value: "String", # required
2270
- # type: "GPU", # required, accepts GPU
2398
+ # type: "GPU", # required, accepts GPU, VCPU, MEMORY
2271
2399
  # },
2272
2400
  # ],
2273
2401
  # },
@@ -2290,7 +2418,7 @@ module Aws::Batch
2290
2418
  # resource_requirements: [
2291
2419
  # {
2292
2420
  # value: "String", # required
2293
- # type: "GPU", # required, accepts GPU
2421
+ # type: "GPU", # required, accepts GPU, VCPU, MEMORY
2294
2422
  # },
2295
2423
  # ],
2296
2424
  # },
@@ -2308,6 +2436,7 @@ module Aws::Batch
2308
2436
  # },
2309
2437
  # ],
2310
2438
  # },
2439
+ # propagate_tags: false,
2311
2440
  # timeout: {
2312
2441
  # attempt_duration_seconds: 1,
2313
2442
  # },
@@ -2332,15 +2461,15 @@ module Aws::Batch
2332
2461
  end
2333
2462
 
2334
2463
  # Associates the specified tags to a resource with the specified
2335
- # `resourceArn`. If existing tags on a resource are not specified in the
2336
- # request parameters, they are not changed. When a resource is deleted,
2464
+ # `resourceArn`. If existing tags on a resource aren't specified in the
2465
+ # request parameters, they aren't changed. When a resource is deleted,
2337
2466
  # the tags associated with that resource are deleted as well. AWS Batch
2338
2467
  # resources that support tags are compute environments, jobs, job
2339
2468
  # definitions, and job queues. ARNs for child jobs of array and
2340
2469
  # multi-node parallel (MNP) jobs are not supported.
2341
2470
  #
2342
2471
  # @option params [required, String] :resource_arn
2343
- # The Amazon Resource Name (ARN) of the resource to which to add tags.
2472
+ # The Amazon Resource Name (ARN) of the resource that tags are added to.
2344
2473
  # AWS Batch resources that support tags are compute environments, jobs,
2345
2474
  # job definitions, and job queues. ARNs for child jobs of array and
2346
2475
  # multi-node parallel (MNP) jobs are not supported.
@@ -2492,27 +2621,50 @@ module Aws::Batch
2492
2621
  # `ENABLED` state can accept jobs from a queue and scale in or out
2493
2622
  # automatically based on the workload demand of its associated queues.
2494
2623
  #
2624
+ # If the state is `ENABLED`, then the AWS Batch scheduler can attempt to
2625
+ # place jobs from an associated job queue on the compute resources
2626
+ # within the environment. If the compute environment is managed, then it
2627
+ # can scale its instances out or in automatically, based on the job
2628
+ # queue demand.
2629
+ #
2630
+ # If the state is `DISABLED`, then the AWS Batch scheduler doesn't
2631
+ # attempt to place jobs within the environment. Jobs in a `STARTING` or
2632
+ # `RUNNING` state continue to progress normally. Managed compute
2633
+ # environments in the `DISABLED` state don't scale out. However, they
2634
+ # scale in to `minvCpus` value after instances become idle.
2635
+ #
2495
2636
  # @option params [Types::ComputeResourceUpdate] :compute_resources
2496
2637
  # Details of the compute resources managed by the compute environment.
2497
- # Required for a managed compute environment.
2638
+ # Required for a managed compute environment. For more information, see
2639
+ # [Compute Environments][1] in the *AWS Batch User Guide*.
2640
+ #
2641
+ #
2642
+ #
2643
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/compute_environments.html
2498
2644
  #
2499
2645
  # @option params [String] :service_role
2500
2646
  # The full Amazon Resource Name (ARN) of the IAM role that allows AWS
2501
- # Batch to make calls to other AWS services on your behalf.
2647
+ # Batch to make calls to other AWS services on your behalf. For more
2648
+ # information, see [AWS Batch service IAM role][1] in the *AWS Batch
2649
+ # User Guide*.
2502
2650
  #
2503
2651
  # If your specified role has a path other than `/`, then you must either
2504
2652
  # specify the full role ARN (this is recommended) or prefix the role
2505
2653
  # name with the path.
2506
2654
  #
2507
- # <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN may
2508
- # contain the `service-role` path prefix. When you only specify the name
2509
- # of the service role, AWS Batch assumes that your ARN does not use the
2510
- # `service-role` path prefix. Because of this, we recommend that you
2511
- # specify the full ARN of your service role when you create compute
2655
+ # <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN
2656
+ # might contain the `service-role` path prefix. When you only specify
2657
+ # the name of the service role, AWS Batch assumes that your ARN does not
2658
+ # use the `service-role` path prefix. Because of this, we recommend that
2659
+ # you specify the full ARN of your service role when you create compute
2512
2660
  # environments.
2513
2661
  #
2514
2662
  # </note>
2515
2663
  #
2664
+ #
2665
+ #
2666
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/service_IAM_role.html
2667
+ #
2516
2668
  # @return [Types::UpdateComputeEnvironmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2517
2669
  #
2518
2670
  # * {Types::UpdateComputeEnvironmentResponse#compute_environment_name #compute_environment_name} => String
@@ -2543,6 +2695,8 @@ module Aws::Batch
2543
2695
  # minv_cpus: 1,
2544
2696
  # maxv_cpus: 1,
2545
2697
  # desiredv_cpus: 1,
2698
+ # subnets: ["String"],
2699
+ # security_group_ids: ["String"],
2546
2700
  # },
2547
2701
  # service_role: "String",
2548
2702
  # })
@@ -2578,13 +2732,25 @@ module Aws::Batch
2578
2732
  # when associated with the same compute environment. Priority is
2579
2733
  # determined in descending order, for example, a job queue with a
2580
2734
  # priority value of `10` is given scheduling preference over a job queue
2581
- # with a priority value of `1`.
2735
+ # with a priority value of `1`. All of the compute environments must be
2736
+ # either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or `FARGATE_SPOT`);
2737
+ # EC2 and Fargate compute environments cannot be mixed.
2582
2738
  #
2583
2739
  # @option params [Array<Types::ComputeEnvironmentOrder>] :compute_environment_order
2584
2740
  # Details the set of compute environments mapped to a job queue and
2585
2741
  # their order relative to each other. This is one of the parameters used
2586
- # by the job scheduler to determine which compute environment should
2587
- # execute a given job.
2742
+ # by the job scheduler to determine which compute environment should run
2743
+ # a given job. Compute environments must be in the `VALID` state before
2744
+ # you can associate them with a job queue. All of the compute
2745
+ # environments must be either EC2 (`EC2` or `SPOT`) or Fargate
2746
+ # (`FARGATE` or `FARGATE_SPOT`); EC2 and Fargate compute environments
2747
+ # can't be mixed.
2748
+ #
2749
+ # <note markdown="1"> All compute environments that are associated with a job queue must
2750
+ # share the same architecture. AWS Batch doesn't support mixing compute
2751
+ # environment architecture types in a single job queue.
2752
+ #
2753
+ # </note>
2588
2754
  #
2589
2755
  # @return [Types::UpdateJobQueueResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2590
2756
  #
@@ -2648,7 +2814,7 @@ module Aws::Batch
2648
2814
  params: params,
2649
2815
  config: config)
2650
2816
  context[:gem_name] = 'aws-sdk-batch'
2651
- context[:gem_version] = '1.40.0'
2817
+ context[:gem_version] = '1.45.0'
2652
2818
  Seahorse::Client::Request.new(handlers, context)
2653
2819
  end
2654
2820