aws-sdk-batch 1.42.0 → 1.47.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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
 
@@ -63,6 +63,10 @@ module Aws::Batch
63
63
  DeviceCgroupPermission = Shapes::StringShape.new(name: 'DeviceCgroupPermission')
64
64
  DeviceCgroupPermissions = Shapes::ListShape.new(name: 'DeviceCgroupPermissions')
65
65
  DevicesList = Shapes::ListShape.new(name: 'DevicesList')
66
+ EFSAuthorizationConfig = Shapes::StructureShape.new(name: 'EFSAuthorizationConfig')
67
+ EFSAuthorizationConfigIAM = Shapes::StringShape.new(name: 'EFSAuthorizationConfigIAM')
68
+ EFSTransitEncryption = Shapes::StringShape.new(name: 'EFSTransitEncryption')
69
+ EFSVolumeConfiguration = Shapes::StructureShape.new(name: 'EFSVolumeConfiguration')
66
70
  Ec2Configuration = Shapes::StructureShape.new(name: 'Ec2Configuration')
67
71
  Ec2ConfigurationList = Shapes::ListShape.new(name: 'Ec2ConfigurationList')
68
72
  EnvironmentVariables = Shapes::ListShape.new(name: 'EnvironmentVariables')
@@ -303,7 +307,7 @@ module Aws::Batch
303
307
  CreateComputeEnvironmentRequest.add_member(:type, Shapes::ShapeRef.new(shape: CEType, required: true, location_name: "type"))
304
308
  CreateComputeEnvironmentRequest.add_member(:state, Shapes::ShapeRef.new(shape: CEState, location_name: "state"))
305
309
  CreateComputeEnvironmentRequest.add_member(:compute_resources, Shapes::ShapeRef.new(shape: ComputeResource, location_name: "computeResources"))
306
- CreateComputeEnvironmentRequest.add_member(:service_role, Shapes::ShapeRef.new(shape: String, required: true, location_name: "serviceRole"))
310
+ CreateComputeEnvironmentRequest.add_member(:service_role, Shapes::ShapeRef.new(shape: String, location_name: "serviceRole"))
307
311
  CreateComputeEnvironmentRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagrisTagsMap, location_name: "tags"))
308
312
  CreateComputeEnvironmentRequest.struct_class = Types::CreateComputeEnvironmentRequest
309
313
 
@@ -381,6 +385,17 @@ module Aws::Batch
381
385
 
382
386
  DevicesList.member = Shapes::ShapeRef.new(shape: Device)
383
387
 
388
+ EFSAuthorizationConfig.add_member(:access_point_id, Shapes::ShapeRef.new(shape: String, location_name: "accessPointId"))
389
+ EFSAuthorizationConfig.add_member(:iam, Shapes::ShapeRef.new(shape: EFSAuthorizationConfigIAM, location_name: "iam"))
390
+ EFSAuthorizationConfig.struct_class = Types::EFSAuthorizationConfig
391
+
392
+ EFSVolumeConfiguration.add_member(:file_system_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "fileSystemId"))
393
+ EFSVolumeConfiguration.add_member(:root_directory, Shapes::ShapeRef.new(shape: String, location_name: "rootDirectory"))
394
+ EFSVolumeConfiguration.add_member(:transit_encryption, Shapes::ShapeRef.new(shape: EFSTransitEncryption, location_name: "transitEncryption"))
395
+ EFSVolumeConfiguration.add_member(:transit_encryption_port, Shapes::ShapeRef.new(shape: Integer, location_name: "transitEncryptionPort"))
396
+ EFSVolumeConfiguration.add_member(:authorization_config, Shapes::ShapeRef.new(shape: EFSAuthorizationConfig, location_name: "authorizationConfig"))
397
+ EFSVolumeConfiguration.struct_class = Types::EFSVolumeConfiguration
398
+
384
399
  Ec2Configuration.add_member(:image_type, Shapes::ShapeRef.new(shape: ImageType, required: true, location_name: "imageType"))
385
400
  Ec2Configuration.add_member(:image_id_override, Shapes::ShapeRef.new(shape: ImageIdOverride, location_name: "imageIdOverride"))
386
401
  Ec2Configuration.struct_class = Types::Ec2Configuration
@@ -696,6 +711,7 @@ module Aws::Batch
696
711
 
697
712
  Volume.add_member(:host, Shapes::ShapeRef.new(shape: Host, location_name: "host"))
698
713
  Volume.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
714
+ Volume.add_member(:efs_volume_configuration, Shapes::ShapeRef.new(shape: EFSVolumeConfiguration, location_name: "efsVolumeConfiguration"))
699
715
  Volume.struct_class = Types::Volume
700
716
 
701
717
  Volumes.member = Shapes::ShapeRef.new(shape: Volume)
@@ -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
 
@@ -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
 
@@ -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
 
@@ -44,7 +44,7 @@ module Aws::Batch
44
44
  # @return [Integer]
45
45
  #
46
46
  # @!attribute [rw] index
47
- # The job index within the array that is associated with this job.
47
+ # The job index within the array that's associated with this job.
48
48
  # This parameter is returned for array job children.
49
49
  # @return [Integer]
50
50
  #
@@ -66,7 +66,7 @@ module Aws::Batch
66
66
  # @return [Integer]
67
67
  #
68
68
  # @!attribute [rw] index
69
- # The job index within the array that is associated with this job.
69
+ # The job index within the array that's associated with this job.
70
70
  # This parameter is returned for children of array jobs.
71
71
  # @return [Integer]
72
72
  #
@@ -79,7 +79,7 @@ module Aws::Batch
79
79
  include Aws::Structure
80
80
  end
81
81
 
82
- # An object representing the details of a container that is part of a
82
+ # An object representing the details of a container that's part of a
83
83
  # job attempt.
84
84
  #
85
85
  # @!attribute [rw] container_instance_arn
@@ -88,7 +88,7 @@ module Aws::Batch
88
88
  # @return [String]
89
89
  #
90
90
  # @!attribute [rw] task_arn
91
- # The Amazon Resource Name (ARN) of the Amazon ECS task that is
91
+ # The Amazon Resource Name (ARN) of the Amazon ECS task that's
92
92
  # associated with the job attempt. Each container attempt receives a
93
93
  # task ARN when they reach the `STARTING` status.
94
94
  # @return [String]
@@ -161,6 +161,8 @@ module Aws::Batch
161
161
  include Aws::Structure
162
162
  end
163
163
 
164
+ # Contains the parameters for `CancelJob`.
165
+ #
164
166
  # @note When making an API call, you may pass CancelJobRequest
165
167
  # data as a hash:
166
168
  #
@@ -195,7 +197,7 @@ module Aws::Batch
195
197
 
196
198
  # These errors are usually caused by a client action, such as using an
197
199
  # action or resource on behalf of a user that doesn't have permissions
198
- # to use the action or resource, or specifying an identifier that isn't
200
+ # to use the action or resource, or specifying an identifier that's not
199
201
  # valid.
200
202
  #
201
203
  # @!attribute [rw] message
@@ -212,7 +214,8 @@ module Aws::Batch
212
214
  # An object representing an AWS Batch compute environment.
213
215
  #
214
216
  # @!attribute [rw] compute_environment_name
215
- # The name of the compute environment.
217
+ # The name of the compute environment. Up to 128 letters (uppercase
218
+ # and lowercase), numbers, hyphens, and underscores are allowed.
216
219
  # @return [String]
217
220
  #
218
221
  # @!attribute [rw] compute_environment_arn
@@ -229,9 +232,9 @@ module Aws::Batch
229
232
  # @return [Hash<String,String>]
230
233
  #
231
234
  # @!attribute [rw] type
232
- # The type of compute environment: `EC2`, `SPOT`, `FARGATE`, or
233
- # `FARGATE_SPOT`. For more information, see [Compute Environments][1]
234
- # in the *AWS Batch User Guide*.
235
+ # The type of the compute environment: `MANAGED` or `UNMANAGED`. For
236
+ # more information, see [Compute Environments][1] in the *AWS Batch
237
+ # User Guide*.
235
238
  #
236
239
  #
237
240
  #
@@ -251,7 +254,7 @@ module Aws::Batch
251
254
  # If the state is `DISABLED`, then the AWS Batch scheduler doesn't
252
255
  # attempt to place jobs within the environment. Jobs in a `STARTING`
253
256
  # or `RUNNING` state continue to progress normally. Managed compute
254
- # environments in the `DISABLED` state do not scale out. However, they
257
+ # environments in the `DISABLED` state don't scale out. However, they
255
258
  # scale in to `minvCpus` value after instances become idle.
256
259
  # @return [String]
257
260
  #
@@ -266,12 +269,24 @@ module Aws::Batch
266
269
  # @return [String]
267
270
  #
268
271
  # @!attribute [rw] compute_resources
269
- # The compute resources defined for the compute environment.
272
+ # The compute resources defined for the compute environment. For more
273
+ # information, see [Compute Environments][1] in the *AWS Batch User
274
+ # Guide*.
275
+ #
276
+ #
277
+ #
278
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/compute_environments.html
270
279
  # @return [Types::ComputeResource]
271
280
  #
272
281
  # @!attribute [rw] service_role
273
282
  # The service role associated with the compute environment that allows
274
- # AWS Batch to make calls to AWS API operations on your behalf.
283
+ # AWS Batch to make calls to AWS API operations on your behalf. For
284
+ # more information, see [AWS Batch service IAM role][1] in the *AWS
285
+ # Batch User Guide*.
286
+ #
287
+ #
288
+ #
289
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/service_IAM_role.html
275
290
  # @return [String]
276
291
  #
277
292
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ComputeEnvironmentDetail AWS API Documentation
@@ -295,7 +310,17 @@ module Aws::Batch
295
310
  # within a queue. Compute environments are tried in ascending order. For
296
311
  # example, if two compute environments are associated with a job queue,
297
312
  # the compute environment with a lower order integer value is tried for
298
- # job placement first.
313
+ # job placement first. Compute environments must be in the `VALID` state
314
+ # before you can associate them with a job queue. All of the compute
315
+ # environments must be either EC2 (`EC2` or `SPOT`) or Fargate
316
+ # (`FARGATE` or `FARGATE_SPOT`); EC2 and Fargate compute environments
317
+ # can't be mixed.
318
+ #
319
+ # <note markdown="1"> All compute environments that are associated with a job queue must
320
+ # share the same architecture. AWS Batch doesn't support mixing compute
321
+ # environment architecture types in a single job queue.
322
+ #
323
+ # </note>
299
324
  #
300
325
  # @note When making an API call, you may pass ComputeEnvironmentOrder
301
326
  # data as a hash:
@@ -325,7 +350,13 @@ module Aws::Batch
325
350
  include Aws::Structure
326
351
  end
327
352
 
328
- # An object representing an AWS Batch compute resource.
353
+ # An object representing an AWS Batch compute resource. For more
354
+ # information, see [Compute Environments][1] in the *AWS Batch User
355
+ # Guide*.
356
+ #
357
+ #
358
+ #
359
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/compute_environments.html
329
360
  #
330
361
  # @note When making an API call, you may pass ComputeResource
331
362
  # data as a hash:
@@ -366,9 +397,14 @@ module Aws::Batch
366
397
  # `FARGATE_SPOT`. For more information, see [Compute Environments][1]
367
398
  # in the *AWS Batch User Guide*.
368
399
  #
400
+ # If you choose `SPOT`, you must also specify an Amazon EC2 Spot Fleet
401
+ # role with the `spotIamFleetRole` parameter. For more information,
402
+ # see [Amazon EC2 Spot Fleet role][2] in the *AWS Batch User Guide*.
403
+ #
369
404
  #
370
405
  #
371
406
  # [1]: https://docs.aws.amazon.com/batch/latest/userguide/compute_environments.html
407
+ # [2]: https://docs.aws.amazon.com/batch/latest/userguide/spot_fleet_IAM_role.html
372
408
  # @return [String]
373
409
  #
374
410
  # @!attribute [rw] allocation_strategy
@@ -388,13 +424,13 @@ module Aws::Batch
388
424
  # : AWS Batch selects an instance type that best fits the needs of the
389
425
  # jobs with a preference for the lowest-cost instance type. If
390
426
  # additional instances of the selected instance type aren't
391
- # available, AWS Batch will wait for the additional instances to be
392
- # available. If there are not enough instances available, or if the
427
+ # available, AWS Batch waits for the additional instances to be
428
+ # available. If there aren't enough instances available, or if the
393
429
  # user is hitting [Amazon EC2 service limits][1] then additional
394
- # jobs aren't run until currently running jobs have completed. This
395
- # allocation strategy keeps costs lower but can limit scaling. If
396
- # you are using Spot Fleets with `BEST_FIT` then the Spot Fleet IAM
397
- # Role must be specified.
430
+ # jobs aren't run until the currently running jobs have completed.
431
+ # This allocation strategy keeps costs lower but can limit scaling.
432
+ # If you are using Spot Fleets with `BEST_FIT` then the Spot Fleet
433
+ # IAM Role must be specified.
398
434
  #
399
435
  # BEST\_FIT\_PROGRESSIVE
400
436
  #
@@ -434,15 +470,15 @@ module Aws::Batch
434
470
  # @return [Integer]
435
471
  #
436
472
  # @!attribute [rw] maxv_cpus
437
- # The maximum number of Amazon EC2 vCPUs that an environment can
438
- # reach.
473
+ # The maximum number of Amazon EC2 vCPUs that a compute environment
474
+ # can reach.
439
475
  #
440
476
  # <note markdown="1"> With both `BEST_FIT_PROGRESSIVE` and `SPOT_CAPACITY_OPTIMIZED`
441
- # allocation strategies, AWS Batch may need to go above `maxvCpus` to
442
- # meet your capacity requirements. In this event, AWS Batch will never
443
- # go above `maxvCpus` by more than a single instance (e.g., no more
444
- # than a single instance from among those specified in your compute
445
- # environment).
477
+ # allocation strategies, AWS Batch might need to exceed `maxvCpus` to
478
+ # meet your capacity requirements. In this event, AWS Batch never
479
+ # exceeds `maxvCpus` by more than a single instance. For example, no
480
+ # more than a single instance from among those specified in your
481
+ # compute environment is allocated.
446
482
  #
447
483
  # </note>
448
484
  # @return [Integer]
@@ -459,12 +495,12 @@ module Aws::Batch
459
495
  # @return [Integer]
460
496
  #
461
497
  # @!attribute [rw] instance_types
462
- # The instances types that may be launched. You can specify instance
498
+ # The instances types that can be launched. You can specify instance
463
499
  # families to launch any instance type within those families (for
464
500
  # example, `c5` or `p3`), or you can specify specific sizes within a
465
501
  # family (such as `c5.8xlarge`). You can also choose `optimal` to
466
- # select instance types (from the C, M, and R instance families) on
467
- # the fly that match the demand of your job queues.
502
+ # select instance types (from the C4, M4, and R4 instance families)
503
+ # that match the demand of your job queues.
468
504
  #
469
505
  # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
470
506
  # resources, and shouldn't be specified.
@@ -477,6 +513,13 @@ module Aws::Batch
477
513
  # compute environment.
478
514
  #
479
515
  # </note>
516
+ #
517
+ # <note markdown="1"> Currently, `optimal` uses instance types from the C4, M4, and R4
518
+ # instance families. In Regions that don't have instance types from
519
+ # those instance families, instance types from the C5, M5. and R5
520
+ # instance families are used.
521
+ #
522
+ # </note>
480
523
  # @return [Array<String>]
481
524
  #
482
525
  # @!attribute [rw] image_id
@@ -507,10 +550,9 @@ module Aws::Batch
507
550
  #
508
551
  # @!attribute [rw] subnets
509
552
  # The VPC subnets into which the compute resources are launched. These
510
- # subnets must be within the same VPC. This parameter is required for
511
- # jobs running on Fargate resources, where it can contain up to 16
512
- # subnets. For more information, see [VPCs and Subnets][1] in the
513
- # *Amazon VPC User Guide*.
553
+ # subnets must be within the same VPC. Fargate compute resources can
554
+ # contain up to 16 subnets. For more information, see [VPCs and
555
+ # Subnets][1] in the *Amazon VPC User Guide*.
514
556
  #
515
557
  #
516
558
  #
@@ -523,13 +565,13 @@ module Aws::Batch
523
565
  # specified, either in `securityGroupIds` or using a launch template
524
566
  # referenced in `launchTemplate`. This parameter is required for jobs
525
567
  # running on Fargate resources and must contain at least one security
526
- # group. (Fargate does not support launch templates.) If security
527
- # groups are specified using both `securityGroupIds` and
528
- # `launchTemplate`, the values in `securityGroupIds` will be used.
568
+ # group. Fargate doesn't support launch templates. If security groups
569
+ # are specified using both `securityGroupIds` and `launchTemplate`,
570
+ # the values in `securityGroupIds` is used.
529
571
  # @return [Array<String>]
530
572
  #
531
573
  # @!attribute [rw] ec2_key_pair
532
- # The Amazon EC2 key pair that is used for instances launched in the
574
+ # The Amazon EC2 key pair that's used for instances launched in the
533
575
  # compute environment. You can use this key pair to log in to your
534
576
  # instances with SSH.
535
577
  #
@@ -562,13 +604,18 @@ module Aws::Batch
562
604
  # Key-value pair tags to be applied to EC2 resources that are launched
563
605
  # in the compute environment. For AWS Batch, these take the form of
564
606
  # "String1": "String2", where String1 is the tag key and String2
565
- # is the tag valuefor example, \\\{ "Name": "AWS Batch Instance -
607
+ # is the tag valuefor example, \\\{ "Name": "AWS Batch Instance -
566
608
  # C4OnDemand" \\}. This is helpful for recognizing your AWS Batch
567
- # instances in the Amazon EC2 console. These tags can not be updated
568
- # or removed after the compute environment has been created; any
569
- # changes require creating a new compute environment and removing the
570
- # old compute environment. These tags are not seen when using the AWS
609
+ # instances in the Amazon EC2 console. These tags can't be updated or
610
+ # removed after the compute environment has been created; any changes
611
+ # require creating a new compute environment and removing the old
612
+ # compute environment. These tags aren't seen when using the AWS
571
613
  # Batch `ListTagsForResource` API operation.
614
+ #
615
+ # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
616
+ # resources, and shouldn't be specified.
617
+ #
618
+ # </note>
572
619
  # @return [Hash<String,String>]
573
620
  #
574
621
  # @!attribute [rw] placement_group
@@ -595,11 +642,11 @@ module Aws::Batch
595
642
  # The maximum percentage that a Spot Instance price can be when
596
643
  # compared with the On-Demand price for that instance type before
597
644
  # instances are launched. For example, if your maximum percentage is
598
- # 20%, then the Spot price must be below 20% of the current On-Demand
599
- # price for that Amazon EC2 instance. You always pay the lowest
600
- # (market) price and never more than your maximum percentage. If you
601
- # leave this field empty, the default value is 100% of the On-Demand
602
- # price.
645
+ # 20%, then the Spot price must be less than 20% of the current
646
+ # On-Demand price for that Amazon EC2 instance. You always pay the
647
+ # lowest (market) price and never more than your maximum percentage.
648
+ # If you leave this field empty, the default value is 100% of the
649
+ # On-Demand price.
603
650
  #
604
651
  # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
605
652
  # resources, and shouldn't be specified.
@@ -653,8 +700,8 @@ module Aws::Batch
653
700
  #
654
701
  # @!attribute [rw] ec2_configuration
655
702
  # Provides information used to select Amazon Machine Images (AMIs) for
656
- # instances in the compute environment. If `Ec2Configuration` isn't
657
- # specified, the default is `ECS_AL1`.
703
+ # EC2 instances in the compute environment. If `Ec2Configuration`
704
+ # isn't specified, the default is `ECS_AL1`.
658
705
  #
659
706
  # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
660
707
  # resources, and shouldn't be specified.
@@ -687,7 +734,12 @@ module Aws::Batch
687
734
  end
688
735
 
689
736
  # An object representing the attributes of a compute environment that
690
- # can be updated.
737
+ # can be updated. For more information, see [Compute Environments][1] in
738
+ # the *AWS Batch User Guide*.
739
+ #
740
+ #
741
+ #
742
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/compute_environments.html
691
743
  #
692
744
  # @note When making an API call, you may pass ComputeResourceUpdate
693
745
  # data as a hash:
@@ -704,8 +756,8 @@ module Aws::Batch
704
756
  # The minimum number of Amazon EC2 vCPUs that an environment should
705
757
  # maintain.
706
758
  #
707
- # <note markdown="1"> This parameter isnt applicable to jobs running on Fargate resources,
708
- # and shouldn't be specified.
759
+ # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
760
+ # resources, and shouldn't be specified.
709
761
  #
710
762
  # </note>
711
763
  # @return [Integer]
@@ -713,6 +765,15 @@ module Aws::Batch
713
765
  # @!attribute [rw] maxv_cpus
714
766
  # The maximum number of Amazon EC2 vCPUs that an environment can
715
767
  # reach.
768
+ #
769
+ # <note markdown="1"> With both `BEST_FIT_PROGRESSIVE` and `SPOT_CAPACITY_OPTIMIZED`
770
+ # allocation strategies, AWS Batch might need to exceed `maxvCpus` to
771
+ # meet your capacity requirements. In this event, AWS Batch never
772
+ # exceeds `maxvCpus` by more than a single instance. That is, no more
773
+ # than a single instance from among those specified in your compute
774
+ # environment.
775
+ #
776
+ # </note>
716
777
  # @return [Integer]
717
778
  #
718
779
  # @!attribute [rw] desiredv_cpus
@@ -725,13 +786,12 @@ module Aws::Batch
725
786
  # @return [Integer]
726
787
  #
727
788
  # @!attribute [rw] subnets
728
- # The VPC subnets that the compute resources are launched into. This
729
- # parameter is required for jobs running on Fargate compute resources,
730
- # where it can contain up to 16 subnets. For more information, see
731
- # [VPCs and Subnets][1] in the *Amazon VPC User Guide*. This can't be
732
- # specified for EC2 compute resources. Providing an empty list will be
733
- # handled as if this parameter wasn't specified and no change is
734
- # made.
789
+ # The VPC subnets that the compute resources are launched into.
790
+ # Fargate compute resources can contain up to 16 subnets. Providing an
791
+ # empty list will be handled as if this parameter wasn't specified
792
+ # and no change is made. This can't be specified for EC2 compute
793
+ # resources. For more information, see [VPCs and Subnets][1] in the
794
+ # *Amazon VPC User Guide*.
735
795
  #
736
796
  #
737
797
  #
@@ -744,7 +804,7 @@ module Aws::Batch
744
804
  # compute resources, where it can contain up to 5 security groups.
745
805
  # This can't be specified for EC2 compute resources. Providing an
746
806
  # empty list is handled as if this parameter wasn't specified and no
747
- # changeis made.
807
+ # change is made.
748
808
  # @return [Array<String>]
749
809
  #
750
810
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ComputeResourceUpdate AWS API Documentation
@@ -759,7 +819,7 @@ module Aws::Batch
759
819
  include Aws::Structure
760
820
  end
761
821
 
762
- # An object representing the details of a container that is part of a
822
+ # An object representing the details of a container that's part of a
763
823
  # job.
764
824
  #
765
825
  # @!attribute [rw] image
@@ -767,19 +827,20 @@ module Aws::Batch
767
827
  # @return [String]
768
828
  #
769
829
  # @!attribute [rw] vcpus
770
- # The number of vCPUs reserved for the container. Jobs running on EC2
771
- # resources can specify the vCPU requirement for the job using
772
- # `resourceRequirements` but the vCPU requirements can't be specified
773
- # both here and in the `resourceRequirement` object. This parameter
774
- # maps to `CpuShares` in the [Create a container][1] section of the
775
- # [Docker Remote API][2] and the `--cpu-shares` option to [docker
776
- # run][3]. Each vCPU is equivalent to 1,024 CPU shares. You must
777
- # specify at least one vCPU. This is required but can be specified in
778
- # several places. It must be specified for each node at least once.
779
- #
780
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
781
- # resources. Jobs running on Fargate resources must specify the vCPU
782
- # requirement for the job using `resourceRequirements`.
830
+ # The number of vCPUs reserved for the container. For jobs that run on
831
+ # EC2 resources, you can specify the vCPU requirement for the job
832
+ # using `resourceRequirements`, but you can't specify the vCPU
833
+ # requirements in both the `vcpus` and `resourceRequirement` object.
834
+ # This parameter maps to `CpuShares` in the [Create a container][1]
835
+ # section of the [Docker Remote API][2] and the `--cpu-shares` option
836
+ # to [docker run][3]. Each vCPU is equivalent to 1,024 CPU shares. You
837
+ # must specify at least one vCPU. This is required but can be
838
+ # specified in several places. It must be specified for each node at
839
+ # least once.
840
+ #
841
+ # <note markdown="1"> This parameter isn't applicable to jobs that run on Fargate
842
+ # resources. For jobs that run on Fargate resources, you must specify
843
+ # the vCPU requirement for the job using `resourceRequirements`.
783
844
  #
784
845
  # </note>
785
846
  #
@@ -798,7 +859,7 @@ module Aws::Batch
798
859
  # @return [Integer]
799
860
  #
800
861
  # @!attribute [rw] command
801
- # The command that is passed to the container.
862
+ # The command that's passed to the container.
802
863
  # @return [Array<String>]
803
864
  #
804
865
  # @!attribute [rw] job_role_arn
@@ -902,7 +963,7 @@ module Aws::Batch
902
963
  # @return [String]
903
964
  #
904
965
  # @!attribute [rw] task_arn
905
- # The Amazon Resource Name (ARN) of the Amazon ECS task that is
966
+ # The Amazon Resource Name (ARN) of the Amazon ECS task that's
906
967
  # associated with the container job. Each container attempt receives a
907
968
  # task ARN when they reach the `STARTING` status.
908
969
  # @return [String]
@@ -944,7 +1005,7 @@ module Aws::Batch
944
1005
  # This parameter maps to `LogConfig` in the [Create a container][1]
945
1006
  # section of the [Docker Remote API][2] and the `--log-driver` option
946
1007
  # to [docker run][3]. By default, containers use the same logging
947
- # driver that the Docker daemon uses. However the container might use
1008
+ # driver that the Docker daemon uses. However, the container might use
948
1009
  # a different logging driver than the Docker daemon by specifying a
949
1010
  # log driver with this parameter in the container definition. To use a
950
1011
  # different logging driver for a container, the log system must be
@@ -956,8 +1017,8 @@ module Aws::Batch
956
1017
  #
957
1018
  # <note markdown="1"> AWS Batch currently supports a subset of the logging drivers
958
1019
  # available to the Docker daemon (shown in the LogConfiguration data
959
- # type). Additional log drivers may be available in future releases of
960
- # the Amazon ECS container agent.
1020
+ # type). Additional log drivers might be available in future releases
1021
+ # of the Amazon ECS container agent.
961
1022
  #
962
1023
  # </note>
963
1024
  #
@@ -1063,21 +1124,25 @@ module Aws::Batch
1063
1124
  # }
1064
1125
  #
1065
1126
  # @!attribute [rw] vcpus
1066
- # This parameter is deprecated and not supported for jobs run on
1067
- # Fargate resources, see `resourceRequirement`. For jobs run on EC2
1068
- # resources, the number of vCPUs to reserve for the container. This
1069
- # value overrides the value set in the job definition. Jobs run on EC2
1070
- # resources can specify the vCPU requirement using
1071
- # `resourceRequirement` but the vCPU requirements can't be specified
1072
- # both here and in `resourceRequirement`. This parameter maps to
1073
- # `CpuShares` in the [Create a container][1] section of the [Docker
1074
- # Remote API][2] and the `--cpu-shares` option to [docker run][3].
1075
- # Each vCPU is equivalent to 1,024 CPU shares. You must specify at
1076
- # least one vCPU.
1077
- #
1078
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
1079
- # resources and shouldn't be provided. Jobs running on Fargate
1080
- # resources must specify the vCPU requirement for the job using
1127
+ # This parameter indicates the number of vCPUs reserved for the
1128
+ # container.It overrides the `vcpus` parameter that's set in the job
1129
+ # definition, but doesn't override any vCPU requirement specified in
1130
+ # the `resourceRequirement` structure in the job definition.
1131
+ #
1132
+ # This parameter is supported for jobs that run on EC2 resources, but
1133
+ # isn't supported for jobs that run on Fargate resources. For Fargate
1134
+ # resources, you can only use `resourceRequirement`. For EC2
1135
+ # resources, you can use either this parameter or
1136
+ # `resourceRequirement` but not both.
1137
+ #
1138
+ # This parameter maps to `CpuShares` in the [Create a container][1]
1139
+ # section of the [Docker Remote API][2] and the `--cpu-shares` option
1140
+ # to [docker run][3]. Each vCPU is equivalent to 1,024 CPU shares. You
1141
+ # must specify at least one vCPU.
1142
+ #
1143
+ # <note markdown="1"> This parameter isn't applicable to jobs that run on Fargate
1144
+ # resources and shouldn't be provided. For jobs that run on Fargate
1145
+ # resources, you must specify the vCPU requirement for the job using
1081
1146
  # `resourceRequirements`.
1082
1147
  #
1083
1148
  # </note>
@@ -1090,10 +1155,15 @@ module Aws::Batch
1090
1155
  # @return [Integer]
1091
1156
  #
1092
1157
  # @!attribute [rw] memory
1093
- # This parameter is deprecated and not supported for jobs run on
1094
- # Fargate resources, use `ResourceRequirement`. For jobs run on EC2
1095
- # resource, the number of MiB of memory reserved for the job. This
1096
- # value overrides the value set in the job definition.
1158
+ # This parameter indicates the amount of memory (in MiB) that's
1159
+ # reserved for the job. It overrides the `memory` parameter set in the
1160
+ # job definition, but doesn't override any memory requirement
1161
+ # specified in the `ResourceRequirement` structure in the job
1162
+ # definition.
1163
+ #
1164
+ # This parameter is supported for jobs that run on EC2 resources, but
1165
+ # isn't supported for jobs that run on Fargate resources. For these
1166
+ # resources, use `resourceRequirement` instead.
1097
1167
  # @return [Integer]
1098
1168
  #
1099
1169
  # @!attribute [rw] command
@@ -1143,7 +1213,7 @@ module Aws::Batch
1143
1213
  end
1144
1214
 
1145
1215
  # Container properties are used in job definitions to describe the
1146
- # container that is launched as part of a job.
1216
+ # container that's launched as part of a job.
1147
1217
  #
1148
1218
  # @note When making an API call, you may pass ContainerProperties
1149
1219
  # data as a hash:
@@ -1161,6 +1231,16 @@ module Aws::Batch
1161
1231
  # source_path: "String",
1162
1232
  # },
1163
1233
  # name: "String",
1234
+ # efs_volume_configuration: {
1235
+ # file_system_id: "String", # required
1236
+ # root_directory: "String",
1237
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
1238
+ # transit_encryption_port: 1,
1239
+ # authorization_config: {
1240
+ # access_point_id: "String",
1241
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
1242
+ # },
1243
+ # },
1164
1244
  # },
1165
1245
  # ],
1166
1246
  # environment: [
@@ -1276,21 +1356,21 @@ module Aws::Batch
1276
1356
  # @return [String]
1277
1357
  #
1278
1358
  # @!attribute [rw] vcpus
1279
- # This parameter is deprecated and not supported for jobs run on
1280
- # Fargate resources, see `resourceRequirement`. The number of vCPUs
1281
- # reserved for the container. Jobs running on EC2 resources can
1282
- # specify the vCPU requirement for the job using
1283
- # `resourceRequirements` but the vCPU requirements can't be specified
1284
- # both here and in the `resourceRequirement` structure. This parameter
1285
- # maps to `CpuShares` in the [Create a container][1] section of the
1286
- # [Docker Remote API][2] and the `--cpu-shares` option to [docker
1287
- # run][3]. Each vCPU is equivalent to 1,024 CPU shares. You must
1288
- # specify at least one vCPU. This is required but can be specified in
1289
- # several places. It must be specified for each node at least once.
1359
+ # The number of vCPUs reserved for the job. Each vCPU is equivalent to
1360
+ # 1,024 CPU shares. This parameter maps to `CpuShares` in the [Create
1361
+ # a container][1] section of the [Docker Remote API][2] and the
1362
+ # `--cpu-shares` option to [docker run][3]. The number of vCPUs must
1363
+ # be specified but can be be specified in several places. You must
1364
+ # specify it at least once for each node.
1365
+ #
1366
+ # This parameter is supported on EC2 resources but isn't supported
1367
+ # for jobs that run on Fargate resources. For these resources, use
1368
+ # `resourceRequirement` instead. You can use this parameter or
1369
+ # `resourceRequirements` structure but not both.
1290
1370
  #
1291
1371
  # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
1292
- # resources and shouldn't be provided. Jobs running on Fargate
1293
- # resources must specify the vCPU requirement for the job using
1372
+ # resources and shouldn't be provided. For jobs that run on Fargate
1373
+ # resources, you must specify the vCPU requirement for the job using
1294
1374
  # `resourceRequirements`.
1295
1375
  #
1296
1376
  # </note>
@@ -1303,17 +1383,21 @@ module Aws::Batch
1303
1383
  # @return [Integer]
1304
1384
  #
1305
1385
  # @!attribute [rw] memory
1306
- # This parameter is deprecated and not supported for jobs run on
1307
- # Fargate resources, use `ResourceRequirement`. For jobs run on EC2
1308
- # resources can specify the memory requirement using the
1309
- # `ResourceRequirement` structure. The hard limit (in MiB) of memory
1310
- # to present to the container. If your container attempts to exceed
1311
- # the memory specified here, the container is killed. This parameter
1312
- # maps to `Memory` in the [Create a container][1] section of the
1313
- # [Docker Remote API][2] and the `--memory` option to [docker run][3].
1314
- # You must specify at least 4 MiB of memory for a job. This is
1315
- # required but can be specified in several places; it must be
1316
- # specified for each node at least once.
1386
+ # This parameter indicates the memory hard limit (in MiB) for a
1387
+ # container. If your container attempts to exceed the specified
1388
+ # number, it is terminated. You must specify at least 4 MiB of memory
1389
+ # for a job using this parameter. The memory hard limit can be
1390
+ # specified in several places. It must be specified for each node at
1391
+ # least once.
1392
+ #
1393
+ # This parameter maps to `Memory` in the [Create a container][1]
1394
+ # section of the [Docker Remote API][2] and the `--memory` option to
1395
+ # [docker run][3].
1396
+ #
1397
+ # This parameter is supported on EC2 resources but isn't supported on
1398
+ # Fargate resources. For Fargate resources, you should specify the
1399
+ # memory requirement using `resourceRequirement`. You can do this for
1400
+ # EC2 resources.
1317
1401
  #
1318
1402
  # <note markdown="1"> If you're trying to maximize your resource utilization by providing
1319
1403
  # your jobs as much memory as possible for a particular instance type,
@@ -1330,7 +1414,7 @@ module Aws::Batch
1330
1414
  # @return [Integer]
1331
1415
  #
1332
1416
  # @!attribute [rw] command
1333
- # The command that is passed to the container. This parameter maps to
1417
+ # The command that's passed to the container. This parameter maps to
1334
1418
  # `Cmd` in the [Create a container][1] section of the [Docker Remote
1335
1419
  # API][2] and the `COMMAND` parameter to [docker run][3]. For more
1336
1420
  # information, see
@@ -1357,9 +1441,9 @@ module Aws::Batch
1357
1441
  #
1358
1442
  # @!attribute [rw] execution_role_arn
1359
1443
  # The Amazon Resource Name (ARN) of the execution role that AWS Batch
1360
- # can assume. Jobs running on Fargate resources must provide an
1361
- # execution role. For more information, see [AWS Batch execution IAM
1362
- # role][1] in the *AWS Batch User Guide*.
1444
+ # can assume. For jobs that run on Fargate resources, you must provide
1445
+ # an execution role. For more information, see [AWS Batch execution
1446
+ # IAM role][1] in the *AWS Batch User Guide*.
1363
1447
  #
1364
1448
  #
1365
1449
  #
@@ -1469,7 +1553,7 @@ module Aws::Batch
1469
1553
  # groups in a multi-node parallel job must use the same instance type.
1470
1554
  #
1471
1555
  # <note markdown="1"> This parameter isn't applicable to single-node container jobs or
1472
- # for jobs running on Fargate resources and shouldn't be provided.
1556
+ # for jobs that run on Fargate resources and shouldn't be provided.
1473
1557
  #
1474
1558
  # </note>
1475
1559
  # @return [String]
@@ -1596,6 +1680,8 @@ module Aws::Batch
1596
1680
  include Aws::Structure
1597
1681
  end
1598
1682
 
1683
+ # Contains the parameters for `CreateComputeEnvironment`.
1684
+ #
1599
1685
  # @note When making an API call, you may pass CreateComputeEnvironmentRequest
1600
1686
  # data as a hash:
1601
1687
  #
@@ -1633,7 +1719,7 @@ module Aws::Batch
1633
1719
  # },
1634
1720
  # ],
1635
1721
  # },
1636
- # service_role: "String", # required
1722
+ # service_role: "String",
1637
1723
  # tags: {
1638
1724
  # "TagKey" => "TagValue",
1639
1725
  # },
@@ -1658,6 +1744,18 @@ module Aws::Batch
1658
1744
  # The state of the compute environment. If the state is `ENABLED`,
1659
1745
  # then the compute environment accepts jobs from a queue and can scale
1660
1746
  # out automatically based on queues.
1747
+ #
1748
+ # If the state is `ENABLED`, then the AWS Batch scheduler can attempt
1749
+ # to place jobs from an associated job queue on the compute resources
1750
+ # within the environment. If the compute environment is managed, then
1751
+ # it can scale its instances out or in automatically, based on the job
1752
+ # queue demand.
1753
+ #
1754
+ # If the state is `DISABLED`, then the AWS Batch scheduler doesn't
1755
+ # attempt to place jobs within the environment. Jobs in a `STARTING`
1756
+ # or `RUNNING` state continue to progress normally. Managed compute
1757
+ # environments in the `DISABLED` state don't scale out. However, they
1758
+ # scale in to `minvCpus` value after instances become idle.
1661
1759
  # @return [String]
1662
1760
  #
1663
1761
  # @!attribute [rw] compute_resources
@@ -1673,20 +1771,37 @@ module Aws::Batch
1673
1771
  #
1674
1772
  # @!attribute [rw] service_role
1675
1773
  # The full Amazon Resource Name (ARN) of the IAM role that allows AWS
1676
- # Batch to make calls to other AWS services on your behalf.
1774
+ # Batch to make calls to other AWS services on your behalf. For more
1775
+ # information, see [AWS Batch service IAM role][1] in the *AWS Batch
1776
+ # User Guide*.
1777
+ #
1778
+ # If your account has already created the AWS Batch service-linked
1779
+ # role, that role is used by default for your compute environment
1780
+ # unless you specify a role here. If the AWS Batch service-linked role
1781
+ # does not exist in your account, and no role is specified here, the
1782
+ # service will try to create the AWS Batch service-linked role in your
1783
+ # account.
1677
1784
  #
1678
1785
  # If your specified role has a path other than `/`, then you must
1679
- # either specify the full role ARN (this is recommended) or prefix the
1680
- # role name with the path.
1786
+ # specify either the full role ARN (recommended) or prefix the role
1787
+ # name with the path. For example, if a role with the name `bar` has a
1788
+ # path of `/foo/` then you would specify `/foo/bar` as the role name.
1789
+ # For more information, see [Friendly names and paths][2] in the *IAM
1790
+ # User Guide*.
1681
1791
  #
1682
1792
  # <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN
1683
- # may contain the `service-role` path prefix. When you only specify
1793
+ # might contain the `service-role` path prefix. When you only specify
1684
1794
  # the name of the service role, AWS Batch assumes that your ARN
1685
1795
  # doesn't use the `service-role` path prefix. Because of this, we
1686
1796
  # recommend that you specify the full ARN of your service role when
1687
1797
  # you create compute environments.
1688
1798
  #
1689
1799
  # </note>
1800
+ #
1801
+ #
1802
+ #
1803
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/service_IAM_role.html
1804
+ # [2]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-friendly-names
1690
1805
  # @return [String]
1691
1806
  #
1692
1807
  # @!attribute [rw] tags
@@ -1720,7 +1835,8 @@ module Aws::Batch
1720
1835
  end
1721
1836
 
1722
1837
  # @!attribute [rw] compute_environment_name
1723
- # The name of the compute environment.
1838
+ # The name of the compute environment. Up to 128 letters (uppercase
1839
+ # and lowercase), numbers, hyphens, and underscores are allowed.
1724
1840
  # @return [String]
1725
1841
  #
1726
1842
  # @!attribute [rw] compute_environment_arn
@@ -1736,6 +1852,8 @@ module Aws::Batch
1736
1852
  include Aws::Structure
1737
1853
  end
1738
1854
 
1855
+ # Contains the parameters for `CreateJobQueue`.
1856
+ #
1739
1857
  # @note When making an API call, you may pass CreateJobQueueRequest
1740
1858
  # data as a hash:
1741
1859
  #
@@ -1755,7 +1873,8 @@ module Aws::Batch
1755
1873
  # }
1756
1874
  #
1757
1875
  # @!attribute [rw] job_queue_name
1758
- # The name of the job queue.
1876
+ # The name of the job queue. Up to 128 letters (uppercase and
1877
+ # lowercase), numbers, and underscores are allowed.
1759
1878
  # @return [String]
1760
1879
  #
1761
1880
  # @!attribute [rw] state
@@ -1771,7 +1890,10 @@ module Aws::Batch
1771
1890
  # first when associated with the same compute environment. Priority is
1772
1891
  # determined in descending order. For example, a job queue with a
1773
1892
  # priority value of `10` is given scheduling preference over a job
1774
- # queue with a priority value of `1`.
1893
+ # queue with a priority value of `1`. All of the compute environments
1894
+ # must be either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or
1895
+ # `FARGATE_SPOT`); EC2 and Fargate compute environments cannot be
1896
+ # mixed.
1775
1897
  # @return [Integer]
1776
1898
  #
1777
1899
  # @!attribute [rw] compute_environment_order
@@ -1784,17 +1906,23 @@ module Aws::Batch
1784
1906
  # environments must be either EC2 (`EC2` or `SPOT`) or Fargate
1785
1907
  # (`FARGATE` or `FARGATE_SPOT`); EC2 and Fargate compute environments
1786
1908
  # can't be mixed.
1909
+ #
1910
+ # <note markdown="1"> All compute environments that are associated with a job queue must
1911
+ # share the same architecture. AWS Batch doesn't support mixing
1912
+ # compute environment architecture types in a single job queue.
1913
+ #
1914
+ # </note>
1787
1915
  # @return [Array<Types::ComputeEnvironmentOrder>]
1788
1916
  #
1789
1917
  # @!attribute [rw] tags
1790
1918
  # The tags that you apply to the job queue to help you categorize and
1791
1919
  # organize your resources. Each tag consists of a key and an optional
1792
- # value. For more information, see [Tagging AWS Resources][1] in *AWS
1793
- # General Reference*.
1920
+ # value. For more information, see [Tagging your AWS Batch
1921
+ # resources][1] in *AWS Batch User Guide*.
1794
1922
  #
1795
1923
  #
1796
1924
  #
1797
- # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
1925
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/using-tags.html
1798
1926
  # @return [Hash<String,String>]
1799
1927
  #
1800
1928
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/CreateJobQueueRequest AWS API Documentation
@@ -1826,6 +1954,8 @@ module Aws::Batch
1826
1954
  include Aws::Structure
1827
1955
  end
1828
1956
 
1957
+ # Contains the parameters for `DeleteComputeEnvironment`.
1958
+ #
1829
1959
  # @note When making an API call, you may pass DeleteComputeEnvironmentRequest
1830
1960
  # data as a hash:
1831
1961
  #
@@ -1850,6 +1980,8 @@ module Aws::Batch
1850
1980
  #
1851
1981
  class DeleteComputeEnvironmentResponse < Aws::EmptyStructure; end
1852
1982
 
1983
+ # Contains the parameters for `DeleteJobQueue`.
1984
+ #
1853
1985
  # @note When making an API call, you may pass DeleteJobQueueRequest
1854
1986
  # data as a hash:
1855
1987
  #
@@ -1898,6 +2030,8 @@ module Aws::Batch
1898
2030
  #
1899
2031
  class DeregisterJobDefinitionResponse < Aws::EmptyStructure; end
1900
2032
 
2033
+ # Contains the parameters for `DescribeComputeEnvironments`.
2034
+ #
1901
2035
  # @note When making an API call, you may pass DescribeComputeEnvironmentsRequest
1902
2036
  # data as a hash:
1903
2037
  #
@@ -1933,7 +2067,7 @@ module Aws::Batch
1933
2067
  # `nextToken` value. This value is `null` when there are no more
1934
2068
  # results to return.
1935
2069
  #
1936
- # <note markdown="1"> This token should be treated as an opaque identifier that is only
2070
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only
1937
2071
  # used to retrieve the next items in a list and not for other
1938
2072
  # programmatic purposes.
1939
2073
  #
@@ -1971,6 +2105,8 @@ module Aws::Batch
1971
2105
  include Aws::Structure
1972
2106
  end
1973
2107
 
2108
+ # Contains the parameters for `DescribeJobDefinitions`.
2109
+ #
1974
2110
  # @note When making an API call, you may pass DescribeJobDefinitionsRequest
1975
2111
  # data as a hash:
1976
2112
  #
@@ -1991,7 +2127,7 @@ module Aws::Batch
1991
2127
  # The maximum number of results returned by `DescribeJobDefinitions`
1992
2128
  # in paginated output. When this parameter is used,
1993
2129
  # `DescribeJobDefinitions` only returns `maxResults` results in a
1994
- # single page along with a `nextToken` response element. The remaining
2130
+ # single page and a `nextToken` response element. The remaining
1995
2131
  # results of the initial request can be seen by sending another
1996
2132
  # `DescribeJobDefinitions` request with the returned `nextToken`
1997
2133
  # value. This value can be between 1 and 100. If this parameter isn't
@@ -2015,7 +2151,7 @@ module Aws::Batch
2015
2151
  # value. This value is `null` when there are no more results to
2016
2152
  # return.
2017
2153
  #
2018
- # <note markdown="1"> This token should be treated as an opaque identifier that is only
2154
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only
2019
2155
  # used to retrieve the next items in a list and not for other
2020
2156
  # programmatic purposes.
2021
2157
  #
@@ -2055,6 +2191,8 @@ module Aws::Batch
2055
2191
  include Aws::Structure
2056
2192
  end
2057
2193
 
2194
+ # Contains the parameters for `DescribeJobQueues`.
2195
+ #
2058
2196
  # @note When making an API call, you may pass DescribeJobQueuesRequest
2059
2197
  # data as a hash:
2060
2198
  #
@@ -2072,12 +2210,12 @@ module Aws::Batch
2072
2210
  # @!attribute [rw] max_results
2073
2211
  # The maximum number of results returned by `DescribeJobQueues` in
2074
2212
  # paginated output. When this parameter is used, `DescribeJobQueues`
2075
- # only returns `maxResults` results in a single page along with a
2076
- # `nextToken` response element. The remaining results of the initial
2077
- # request can be seen by sending another `DescribeJobQueues` request
2078
- # with the returned `nextToken` value. This value can be between 1 and
2079
- # 100. If this parameter isn't used, then `DescribeJobQueues` returns
2080
- # up to 100 results and a `nextToken` value if applicable.
2213
+ # only returns `maxResults` results in a single page and a `nextToken`
2214
+ # response element. The remaining results of the initial request can
2215
+ # be seen by sending another `DescribeJobQueues` request with the
2216
+ # returned `nextToken` value. This value can be between 1 and 100. If
2217
+ # this parameter isn't used, then `DescribeJobQueues` returns up to
2218
+ # 100 results and a `nextToken` value if applicable.
2081
2219
  # @return [Integer]
2082
2220
  #
2083
2221
  # @!attribute [rw] next_token
@@ -2088,7 +2226,7 @@ module Aws::Batch
2088
2226
  # value. This value is `null` when there are no more results to
2089
2227
  # return.
2090
2228
  #
2091
- # <note markdown="1"> This token should be treated as an opaque identifier that is only
2229
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only
2092
2230
  # used to retrieve the next items in a list and not for other
2093
2231
  # programmatic purposes.
2094
2232
  #
@@ -2126,6 +2264,8 @@ module Aws::Batch
2126
2264
  include Aws::Structure
2127
2265
  end
2128
2266
 
2267
+ # Contains the parameters for `DescribeJobs`.
2268
+ #
2129
2269
  # @note When making an API call, you may pass DescribeJobsRequest
2130
2270
  # data as a hash:
2131
2271
  #
@@ -2179,7 +2319,7 @@ module Aws::Batch
2179
2319
  #
2180
2320
  # @!attribute [rw] container_path
2181
2321
  # The path inside the container used to expose the host device. By
2182
- # default the `hostPath` value is used.
2322
+ # default, the `hostPath` value is used.
2183
2323
  # @return [String]
2184
2324
  #
2185
2325
  # @!attribute [rw] permissions
@@ -2198,14 +2338,150 @@ module Aws::Batch
2198
2338
  include Aws::Structure
2199
2339
  end
2200
2340
 
2341
+ # The authorization configuration details for the Amazon EFS file
2342
+ # system.
2343
+ #
2344
+ # @note When making an API call, you may pass EFSAuthorizationConfig
2345
+ # data as a hash:
2346
+ #
2347
+ # {
2348
+ # access_point_id: "String",
2349
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
2350
+ # }
2351
+ #
2352
+ # @!attribute [rw] access_point_id
2353
+ # The Amazon EFS access point ID to use. If an access point is
2354
+ # specified, the root directory value specified in the
2355
+ # `EFSVolumeConfiguration` must either be omitted or set to `/` which
2356
+ # will enforce the path set on the EFS access point. If an access
2357
+ # point is used, transit encryption must be enabled in the
2358
+ # `EFSVolumeConfiguration`. For more information, see [Working with
2359
+ # Amazon EFS Access Points][1] in the *Amazon Elastic File System User
2360
+ # Guide*.
2361
+ #
2362
+ #
2363
+ #
2364
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html
2365
+ # @return [String]
2366
+ #
2367
+ # @!attribute [rw] iam
2368
+ # Whether or not to use the AWS Batch execution IAM role defined in a
2369
+ # job definition when mounting the Amazon EFS file system. If enabled,
2370
+ # transit encryption must be enabled in the `EFSVolumeConfiguration`.
2371
+ # If this parameter is omitted, the default value of `DISABLED` is
2372
+ # used. For more information, see [Using Amazon EFS Access Points][1]
2373
+ # in the *AWS Batch User Guide*. EFS IAM authorization requires that
2374
+ # `TransitEncryption` be `ENABLED` and that a `JobRoleArn` is
2375
+ # specified.
2376
+ #
2377
+ #
2378
+ #
2379
+ # [1]: https://docs.aws.amazon.com/batch/latest/ug/efs-volumes.html#efs-volume-accesspoints
2380
+ # @return [String]
2381
+ #
2382
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/EFSAuthorizationConfig AWS API Documentation
2383
+ #
2384
+ class EFSAuthorizationConfig < Struct.new(
2385
+ :access_point_id,
2386
+ :iam)
2387
+ SENSITIVE = []
2388
+ include Aws::Structure
2389
+ end
2390
+
2391
+ # This parameter is specified when you are using an Amazon Elastic File
2392
+ # System file system for task storage. For more information, see [Amazon
2393
+ # EFS Volumes][1] in the *AWS Batch User Guide*.
2394
+ #
2395
+ #
2396
+ #
2397
+ # [1]: https://docs.aws.amazon.com/batch/latest/ug/efs-volumes.html
2398
+ #
2399
+ # @note When making an API call, you may pass EFSVolumeConfiguration
2400
+ # data as a hash:
2401
+ #
2402
+ # {
2403
+ # file_system_id: "String", # required
2404
+ # root_directory: "String",
2405
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
2406
+ # transit_encryption_port: 1,
2407
+ # authorization_config: {
2408
+ # access_point_id: "String",
2409
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
2410
+ # },
2411
+ # }
2412
+ #
2413
+ # @!attribute [rw] file_system_id
2414
+ # The Amazon EFS file system ID to use.
2415
+ # @return [String]
2416
+ #
2417
+ # @!attribute [rw] root_directory
2418
+ # The directory within the Amazon EFS file system to mount as the root
2419
+ # directory inside the host. If this parameter is omitted, the root of
2420
+ # the Amazon EFS volume will be used. Specifying `/` will have the
2421
+ # same effect as omitting this parameter.
2422
+ #
2423
+ # If an EFS access point is specified in the `authorizationConfig`,
2424
+ # the root directory parameter must either be omitted or set to `/`
2425
+ # which will enforce the path set on the Amazon EFS access point.
2426
+ # @return [String]
2427
+ #
2428
+ # @!attribute [rw] transit_encryption
2429
+ # Whether or not to enable encryption for Amazon EFS data in transit
2430
+ # between the Amazon ECS host and the Amazon EFS server. Transit
2431
+ # encryption must be enabled if Amazon EFS IAM authorization is used.
2432
+ # If this parameter is omitted, the default value of `DISABLED` is
2433
+ # used. For more information, see [Encrypting data in transit][1] in
2434
+ # the *Amazon Elastic File System User Guide*.
2435
+ #
2436
+ #
2437
+ #
2438
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/encryption-in-transit.html
2439
+ # @return [String]
2440
+ #
2441
+ # @!attribute [rw] transit_encryption_port
2442
+ # The port to use when sending encrypted data between the Amazon ECS
2443
+ # host and the Amazon EFS server. If you do not specify a transit
2444
+ # encryption port, it will use the port selection strategy that the
2445
+ # Amazon EFS mount helper uses. For more information, see [EFS Mount
2446
+ # Helper][1] in the *Amazon Elastic File System User Guide*.
2447
+ #
2448
+ #
2449
+ #
2450
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-mount-helper.html
2451
+ # @return [Integer]
2452
+ #
2453
+ # @!attribute [rw] authorization_config
2454
+ # The authorization configuration details for the Amazon EFS file
2455
+ # system.
2456
+ # @return [Types::EFSAuthorizationConfig]
2457
+ #
2458
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/EFSVolumeConfiguration AWS API Documentation
2459
+ #
2460
+ class EFSVolumeConfiguration < Struct.new(
2461
+ :file_system_id,
2462
+ :root_directory,
2463
+ :transit_encryption,
2464
+ :transit_encryption_port,
2465
+ :authorization_config)
2466
+ SENSITIVE = []
2467
+ include Aws::Structure
2468
+ end
2469
+
2201
2470
  # Provides information used to select Amazon Machine Images (AMIs) for
2202
- # instances in the compute environment. If the `Ec2Configuration` isn't
2203
- # specified, the default is `ECS_AL1`.
2471
+ # instances in the compute environment. If `Ec2Configuration` isn't
2472
+ # specified, the default is currently `ECS_AL1` ([Amazon Linux][1]) for
2473
+ # non-GPU, non-Graviton instances. Starting on March 31, 2021, this
2474
+ # default will be changing to `ECS_AL2` ([Amazon Linux 2][2]).
2204
2475
  #
2205
2476
  # <note markdown="1"> This object isn't applicable to jobs running on Fargate resources.
2206
2477
  #
2207
2478
  # </note>
2208
2479
  #
2480
+ #
2481
+ #
2482
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html#alami
2483
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html#al2ami
2484
+ #
2209
2485
  # @note When making an API call, you may pass Ec2Configuration
2210
2486
  # data as a hash:
2211
2487
  #
@@ -2217,7 +2493,9 @@ module Aws::Batch
2217
2493
  # @!attribute [rw] image_type
2218
2494
  # The image type to match with the instance type to select an AMI. If
2219
2495
  # the `imageIdOverride` parameter isn't specified, then a recent
2220
- # [Amazon ECS-optimized AMI][1] is used.
2496
+ # [Amazon ECS-optimized AMI][1] (`ECS_AL1`) is used. Starting on March
2497
+ # 31, 2021, this default will be changing to `ECS_AL2` ([Amazon Linux
2498
+ # 2][2]).
2221
2499
  #
2222
2500
  # ECS\_AL2
2223
2501
  #
@@ -2233,7 +2511,7 @@ module Aws::Batch
2233
2511
  #
2234
2512
  # ECS\_AL1
2235
2513
  #
2236
- # : [Amazon Linux][4]−Default for all non-GPU, non-AWS-Graviton
2514
+ # : [Amazon Linux][4]−Default for all non-GPU, non-AWS Graviton
2237
2515
  # instance families. Amazon Linux is reaching the end-of-life of
2238
2516
  # standard support. For more information, see [Amazon Linux AMI][5].
2239
2517
  #
@@ -2276,23 +2554,25 @@ module Aws::Batch
2276
2554
  #
2277
2555
  # @!attribute [rw] on_status_reason
2278
2556
  # Contains a glob pattern to match against the `StatusReason` returned
2279
- # for a job. The patten can be up to 512 characters long, can contain
2280
- # letters, numbers, periods (.), colons (:), and white space (spaces,
2281
- # tabs). and can optionally end with an asterisk (*) so that only the
2282
- # start of the string needs to be an exact match.
2557
+ # for a job. The pattern can be up to 512 characters long, and can
2558
+ # contain letters, numbers, periods (.), colons (:), and white space
2559
+ # (including spaces or tabs). It can optionally end with an asterisk
2560
+ # (*) so that only the start of the string needs to be an exact
2561
+ # match.
2283
2562
  # @return [String]
2284
2563
  #
2285
2564
  # @!attribute [rw] on_reason
2286
2565
  # Contains a glob pattern to match against the `Reason` returned for a
2287
- # job. The patten can be up to 512 characters long, can contain
2288
- # letters, numbers, periods (.), colons (:), and white space (spaces,
2289
- # tabs), and can optionally end with an asterisk (*) so that only the
2290
- # start of the string needs to be an exact match.
2566
+ # job. The pattern can be up to 512 characters long, and can contain
2567
+ # letters, numbers, periods (.), colons (:), and white space
2568
+ # (including spaces and tabs). It can optionally end with an asterisk
2569
+ # (*) so that only the start of the string needs to be an exact
2570
+ # match.
2291
2571
  # @return [String]
2292
2572
  #
2293
2573
  # @!attribute [rw] on_exit_code
2294
2574
  # Contains a glob pattern to match against the decimal representation
2295
- # of the `ExitCode` returned for a job. The patten can be up to 512
2575
+ # of the `ExitCode` returned for a job. The pattern can be up to 512
2296
2576
  # characters long, can contain only numbers, and can optionally end
2297
2577
  # with an asterisk (*) so that only the start of the string needs to
2298
2578
  # be an exact match.
@@ -2301,7 +2581,7 @@ module Aws::Batch
2301
2581
  # @!attribute [rw] action
2302
2582
  # Specifies the action to take if all of the specified conditions
2303
2583
  # (`onStatusReason`, `onReason`, and `onExitCode`) are met. The values
2304
- # are not case sensitive.
2584
+ # aren't case sensitive.
2305
2585
  # @return [String]
2306
2586
  #
2307
2587
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/EvaluateOnExit AWS API Documentation
@@ -2315,8 +2595,8 @@ module Aws::Batch
2315
2595
  include Aws::Structure
2316
2596
  end
2317
2597
 
2318
- # The platform configuration for jobs running on Fargate resources. Jobs
2319
- # running on EC2 resources must not specify this parameter.
2598
+ # The platform configuration for jobs running on Fargate resources. For
2599
+ # jobs that run on EC2 resources, you shouldn't specify this parameter.
2320
2600
  #
2321
2601
  # @note When making an API call, you may pass FargatePlatformConfiguration
2322
2602
  # data as a hash:
@@ -2326,10 +2606,10 @@ module Aws::Batch
2326
2606
  # }
2327
2607
  #
2328
2608
  # @!attribute [rw] platform_version
2329
- # The AWS Fargate platform version on which the jobs are running. A
2609
+ # The AWS Fargate platform version where the jobs are running. A
2330
2610
  # platform version is specified only for jobs running on Fargate
2331
2611
  # resources. If one isn't specified, the `LATEST` platform version is
2332
- # used by default. This will use a recent, approved version of the AWS
2612
+ # used by default. This uses a recent, approved version of the AWS
2333
2613
  # Fargate platform for compute resources. For more information, see
2334
2614
  # [AWS Fargate platform versions][1] in the *Amazon Elastic Container
2335
2615
  # Service Developer Guide*.
@@ -2361,16 +2641,16 @@ module Aws::Batch
2361
2641
  # }
2362
2642
  #
2363
2643
  # @!attribute [rw] source_path
2364
- # The path on the host container instance that is presented to the
2644
+ # The path on the host container instance that's presented to the
2365
2645
  # container. If this parameter is empty, then the Docker daemon has
2366
2646
  # assigned a host path for you. If this parameter contains a file
2367
2647
  # location, then the data volume persists at the specified location on
2368
2648
  # the host container instance until you delete it manually. If the
2369
- # source path location does not exist on the host container instance,
2649
+ # source path location doesn't exist on the host container instance,
2370
2650
  # the Docker daemon creates it. If the location does exist, the
2371
2651
  # contents of the source path folder are exported.
2372
2652
  #
2373
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
2653
+ # <note markdown="1"> This parameter isn't applicable to jobs that run on Fargate
2374
2654
  # resources and shouldn't be provided.
2375
2655
  #
2376
2656
  # </note>
@@ -2540,7 +2820,7 @@ module Aws::Batch
2540
2820
  # @!attribute [rw] status
2541
2821
  # The current status for the job.
2542
2822
  #
2543
- # <note markdown="1"> If your jobs do not progress to `STARTING`, see [Jobs Stuck in
2823
+ # <note markdown="1"> If your jobs don't progress to `STARTING`, see [Jobs Stuck in
2544
2824
  # RUNNABLE Status][1] in the troubleshooting section of the *AWS Batch
2545
2825
  # User Guide*.
2546
2826
  #
@@ -2590,7 +2870,7 @@ module Aws::Batch
2590
2870
  # @return [Array<Types::JobDependency>]
2591
2871
  #
2592
2872
  # @!attribute [rw] job_definition
2593
- # The job definition that is used by this job.
2873
+ # The job definition that's used by this job.
2594
2874
  # @return [String]
2595
2875
  #
2596
2876
  # @!attribute [rw] parameters
@@ -2605,7 +2885,7 @@ module Aws::Batch
2605
2885
  # @return [Types::ContainerDetail]
2606
2886
  #
2607
2887
  # @!attribute [rw] node_details
2608
- # An object representing the details of a node that is associated with
2888
+ # An object representing the details of a node that's associated with
2609
2889
  # a multi-node parallel job.
2610
2890
  # @return [Types::NodeDetails]
2611
2891
  #
@@ -2633,7 +2913,7 @@ module Aws::Batch
2633
2913
  # @!attribute [rw] propagate_tags
2634
2914
  # Specifies whether to propagate the tags from the job or job
2635
2915
  # definition to the corresponding Amazon ECS task. If no value is
2636
- # specified, the tags are not propagated. Tags can only be propagated
2916
+ # specified, the tags aren't propagated. Tags can only be propagated
2637
2917
  # to the tasks during task creation. For tags with the same name, job
2638
2918
  # tags are given priority over job definitions tags. If the total
2639
2919
  # number of combined tags from the job and job definition is over 50,
@@ -2702,7 +2982,15 @@ module Aws::Batch
2702
2982
  # @return [String]
2703
2983
  #
2704
2984
  # @!attribute [rw] priority
2705
- # The priority of the job queue.
2985
+ # The priority of the job queue. Job queues with a higher priority (or
2986
+ # a higher integer value for the `priority` parameter) are evaluated
2987
+ # first when associated with the same compute environment. Priority is
2988
+ # determined in descending order, for example, a job queue with a
2989
+ # priority value of `10` is given scheduling preference over a job
2990
+ # queue with a priority value of `1`. All of the compute environments
2991
+ # must be either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or
2992
+ # `FARGATE_SPOT`); EC2 and Fargate compute environments can't be
2993
+ # mixed.
2706
2994
  # @return [Integer]
2707
2995
  #
2708
2996
  # @!attribute [rw] compute_environment_order
@@ -2712,7 +3000,12 @@ module Aws::Batch
2712
3000
  # @return [Array<Types::ComputeEnvironmentOrder>]
2713
3001
  #
2714
3002
  # @!attribute [rw] tags
2715
- # The tags applied to the job queue.
3003
+ # The tags applied to the job queue. For more information, see
3004
+ # [Tagging your AWS Batch resources][1] in *AWS Batch User Guide*.
3005
+ #
3006
+ #
3007
+ #
3008
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/using-tags.html
2716
3009
  # @return [Hash<String,String>]
2717
3010
  #
2718
3011
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/JobQueueDetail AWS API Documentation
@@ -2773,7 +3066,7 @@ module Aws::Batch
2773
3066
  # @return [Integer]
2774
3067
  #
2775
3068
  # @!attribute [rw] container
2776
- # An object representing the details of the container that is
3069
+ # An object representing the details of the container that's
2777
3070
  # associated with the job.
2778
3071
  # @return [Types::ContainerSummary]
2779
3072
  #
@@ -2897,6 +3190,14 @@ module Aws::Batch
2897
3190
  # is used. If the value is `$Default`, the default version of the
2898
3191
  # launch template is used.
2899
3192
  #
3193
+ # After the compute environment is created, the launch template
3194
+ # version used will not be changed, even if the `$Default` or
3195
+ # `$Latest` version for the launch template is updated. To use a new
3196
+ # launch template version, create a new compute environment, add the
3197
+ # new compute environment to the existing job queue, remove the old
3198
+ # compute environment from the job queue, and delete the old compute
3199
+ # environment.
3200
+ #
2900
3201
  # Default: `$Default`.
2901
3202
  # @return [String]
2902
3203
  #
@@ -3029,9 +3330,32 @@ module Aws::Batch
3029
3330
  # be swapped very aggressively. Accepted values are whole numbers
3030
3331
  # between `0` and `100`. If the `swappiness` parameter isn't
3031
3332
  # specified, a default value of `60` is used. If a value isn't
3032
- # specified for `maxSwap` then this parameter is ignored. This
3033
- # parameter maps to the `--memory-swappiness` option to [docker
3034
- # run][1].
3333
+ # specified for `maxSwap` then this parameter is ignored. If `maxSwap`
3334
+ # is set to 0, the container doesn't use swap. This parameter maps to
3335
+ # the `--memory-swappiness` option to [docker run][1].
3336
+ #
3337
+ # Consider the following when you use a per-container swap
3338
+ # configuration.
3339
+ #
3340
+ # * Swap space must be enabled and allocated on the container instance
3341
+ # for the containers to use.
3342
+ #
3343
+ # <note markdown="1"> The Amazon ECS optimized AMIs don't have swap enabled by default.
3344
+ # You must enable swap on the instance to use this feature. For more
3345
+ # information, see [Instance Store Swap Volumes][2] in the *Amazon
3346
+ # EC2 User Guide for Linux Instances* or [How do I allocate memory
3347
+ # to work as swap space in an Amazon EC2 instance by using a swap
3348
+ # file?][3]
3349
+ #
3350
+ # </note>
3351
+ #
3352
+ # * The swap space parameters are only supported for job definitions
3353
+ # using EC2 resources.
3354
+ #
3355
+ # * If the `maxSwap` and `swappiness` parameters are omitted from a
3356
+ # job definition, each container will have a default `swappiness`
3357
+ # value of 60, and the total swap usage will be limited to two times
3358
+ # the memory reservation of the container.
3035
3359
  #
3036
3360
  # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
3037
3361
  # resources and shouldn't be provided.
@@ -3041,6 +3365,8 @@ module Aws::Batch
3041
3365
  #
3042
3366
  #
3043
3367
  # [1]: https://docs.docker.com/engine/reference/run/
3368
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-store-swap-volumes.html
3369
+ # [3]: http://aws.amazon.com/premiumsupport/knowledge-center/ec2-memory-swap-file/
3044
3370
  # @return [Integer]
3045
3371
  #
3046
3372
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/LinuxParameters AWS API Documentation
@@ -3056,6 +3382,8 @@ module Aws::Batch
3056
3382
  include Aws::Structure
3057
3383
  end
3058
3384
 
3385
+ # Contains the parameters for `ListJobs`.
3386
+ #
3059
3387
  # @note When making an API call, you may pass ListJobsRequest
3060
3388
  # data as a hash:
3061
3389
  #
@@ -3092,12 +3420,12 @@ module Aws::Batch
3092
3420
  # @!attribute [rw] max_results
3093
3421
  # The maximum number of results returned by `ListJobs` in paginated
3094
3422
  # output. When this parameter is used, `ListJobs` only returns
3095
- # `maxResults` results in a single page along with a `nextToken`
3096
- # response element. The remaining results of the initial request can
3097
- # be seen by sending another `ListJobs` request with the returned
3098
- # `nextToken` value. This value can be between 1 and 100. If this
3099
- # parameter isn't used, then `ListJobs` returns up to 100 results and
3100
- # a `nextToken` value if applicable.
3423
+ # `maxResults` results in a single page and a `nextToken` response
3424
+ # element. The remaining results of the initial request can be seen by
3425
+ # sending another `ListJobs` request with the returned `nextToken`
3426
+ # value. This value can be between 1 and 100. If this parameter isn't
3427
+ # used, then `ListJobs` returns up to 100 results and a `nextToken`
3428
+ # value if applicable.
3101
3429
  # @return [Integer]
3102
3430
  #
3103
3431
  # @!attribute [rw] next_token
@@ -3107,7 +3435,7 @@ module Aws::Batch
3107
3435
  # previous results that returned the `nextToken` value. This value is
3108
3436
  # `null` when there are no more results to return.
3109
3437
  #
3110
- # <note markdown="1"> This token should be treated as an opaque identifier that is only
3438
+ # <note markdown="1"> This token should be treated as an opaque identifier that's only
3111
3439
  # used to retrieve the next items in a list and not for other
3112
3440
  # programmatic purposes.
3113
3441
  #
@@ -3257,9 +3585,9 @@ module Aws::Batch
3257
3585
  # including usage and options, see [Syslog logging driver][8] in the
3258
3586
  # Docker documentation.
3259
3587
  #
3260
- # <note markdown="1"> If you have a custom driver that isn't listed earlier that you want
3588
+ # <note markdown="1"> If you have a custom driver that's not listed earlier that you want
3261
3589
  # to work with the Amazon ECS container agent, you can fork the Amazon
3262
- # ECS container agent project that is [available on GitHub][9] and
3590
+ # ECS container agent project that's [available on GitHub][9] and
3263
3591
  # customize it to work with that driver. We encourage you to submit
3264
3592
  # pull requests for changes that you want to have included. However,
3265
3593
  # Amazon Web Services doesn't currently support running modified
@@ -3313,7 +3641,7 @@ module Aws::Batch
3313
3641
  include Aws::Structure
3314
3642
  end
3315
3643
 
3316
- # Details on a Docker volume mount point that is used in a job's
3644
+ # Details on a Docker volume mount point that's used in a job's
3317
3645
  # container properties. This parameter maps to `Volumes` in the [Create
3318
3646
  # a container][1] section of the Docker Remote API and the `--volume`
3319
3647
  # option to docker run.
@@ -3433,7 +3761,7 @@ module Aws::Batch
3433
3761
  include Aws::Structure
3434
3762
  end
3435
3763
 
3436
- # Object representing any node overrides to a job definition that is
3764
+ # Object representing any node overrides to a job definition that's
3437
3765
  # used in a SubmitJob API operation.
3438
3766
  #
3439
3767
  # <note markdown="1"> This isn't applicable to jobs running on Fargate resources and
@@ -3525,6 +3853,16 @@ module Aws::Batch
3525
3853
  # source_path: "String",
3526
3854
  # },
3527
3855
  # name: "String",
3856
+ # efs_volume_configuration: {
3857
+ # file_system_id: "String", # required
3858
+ # root_directory: "String",
3859
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
3860
+ # transit_encryption_port: 1,
3861
+ # authorization_config: {
3862
+ # access_point_id: "String",
3863
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
3864
+ # },
3865
+ # },
3528
3866
  # },
3529
3867
  # ],
3530
3868
  # environment: [
@@ -3630,7 +3968,7 @@ module Aws::Batch
3630
3968
  include Aws::Structure
3631
3969
  end
3632
3970
 
3633
- # An object representing the properties of a node that is associated
3971
+ # An object representing the properties of a node that's associated
3634
3972
  # with a multi-node parallel job.
3635
3973
  #
3636
3974
  # @!attribute [rw] is_main_node
@@ -3658,7 +3996,7 @@ module Aws::Batch
3658
3996
  include Aws::Structure
3659
3997
  end
3660
3998
 
3661
- # Object representing any node overrides to a job definition that is
3999
+ # Object representing any node overrides to a job definition that's
3662
4000
  # used in a SubmitJob API operation.
3663
4001
  #
3664
4002
  # @note When making an API call, you may pass NodePropertyOverride
@@ -3729,6 +4067,16 @@ module Aws::Batch
3729
4067
  # source_path: "String",
3730
4068
  # },
3731
4069
  # name: "String",
4070
+ # efs_volume_configuration: {
4071
+ # file_system_id: "String", # required
4072
+ # root_directory: "String",
4073
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
4074
+ # transit_encryption_port: 1,
4075
+ # authorization_config: {
4076
+ # access_point_id: "String",
4077
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
4078
+ # },
4079
+ # },
3732
4080
  # },
3733
4081
  # ],
3734
4082
  # environment: [
@@ -3814,7 +4162,7 @@ module Aws::Batch
3814
4162
  # starting range value is omitted (`:n`), then `0` is used to start
3815
4163
  # the range. If the ending range value is omitted (`n:`), then the
3816
4164
  # highest possible node index is used to end the range. Your
3817
- # accumulative node ranges must account for all nodes (`0:n`). You may
4165
+ # accumulative node ranges must account for all nodes (`0:n`). You can
3818
4166
  # nest node ranges, for example `0:10` and `4:5`, in which case the
3819
4167
  # `4:5` range properties override the `0:10` properties.
3820
4168
  # @return [String]
@@ -3832,6 +4180,8 @@ module Aws::Batch
3832
4180
  include Aws::Structure
3833
4181
  end
3834
4182
 
4183
+ # Contains the parameters for `RegisterJobDefinition`.
4184
+ #
3835
4185
  # @note When making an API call, you may pass RegisterJobDefinitionRequest
3836
4186
  # data as a hash:
3837
4187
  #
@@ -3854,6 +4204,16 @@ module Aws::Batch
3854
4204
  # source_path: "String",
3855
4205
  # },
3856
4206
  # name: "String",
4207
+ # efs_volume_configuration: {
4208
+ # file_system_id: "String", # required
4209
+ # root_directory: "String",
4210
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
4211
+ # transit_encryption_port: 1,
4212
+ # authorization_config: {
4213
+ # access_point_id: "String",
4214
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
4215
+ # },
4216
+ # },
3857
4217
  # },
3858
4218
  # ],
3859
4219
  # environment: [
@@ -3950,6 +4310,16 @@ module Aws::Batch
3950
4310
  # source_path: "String",
3951
4311
  # },
3952
4312
  # name: "String",
4313
+ # efs_volume_configuration: {
4314
+ # file_system_id: "String", # required
4315
+ # root_directory: "String",
4316
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
4317
+ # transit_encryption_port: 1,
4318
+ # authorization_config: {
4319
+ # access_point_id: "String",
4320
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
4321
+ # },
4322
+ # },
3953
4323
  # },
3954
4324
  # ],
3955
4325
  # environment: [
@@ -4111,7 +4481,7 @@ module Aws::Batch
4111
4481
  #
4112
4482
  # @!attribute [rw] retry_strategy
4113
4483
  # The retry strategy to use for failed jobs that are submitted with
4114
- # this job definition. Any retry strategy that is specified during a
4484
+ # this job definition. Any retry strategy that's specified during a
4115
4485
  # SubmitJob operation overrides the retry strategy defined here. If a
4116
4486
  # job is terminated due to a timeout, it isn't retried.
4117
4487
  # @return [Types::RetryStrategy]
@@ -4131,7 +4501,7 @@ module Aws::Batch
4131
4501
  # definition, after which AWS Batch terminates your jobs if they have
4132
4502
  # not finished. If a job is terminated due to a timeout, it isn't
4133
4503
  # retried. The minimum value for the timeout is 60 seconds. Any
4134
- # timeout configuration that is specified during a SubmitJob operation
4504
+ # timeout configuration that's specified during a SubmitJob operation
4135
4505
  # overrides the timeout configuration defined here. For more
4136
4506
  # information, see [Job Timeouts][1] in the *AWS Batch User Guide*.
4137
4507
  #
@@ -4224,18 +4594,17 @@ module Aws::Batch
4224
4594
  #
4225
4595
  # type="MEMORY"
4226
4596
  #
4227
- # : For jobs running on EC2 resources, the hard limit (in MiB) of
4228
- # memory to present to the container. If your container attempts to
4229
- # exceed the memory specified here, the container is killed. This
4230
- # parameter maps to `Memory` in the [Create a container][1] section
4231
- # of the [Docker Remote API][2] and the `--memory` option to [docker
4232
- # run][3]. You must specify at least 4 MiB of memory for a job. This
4233
- # is required but can be specified in several places for multi-node
4234
- # parallel (MNP) jobs. It must be specified for each node at least
4235
- # once. This parameter maps to `Memory` in the [Create a
4597
+ # : The memory hard limit (in MiB) present to the container. This
4598
+ # parameter is supported for jobs running on EC2 resources. If your
4599
+ # container attempts to exceed the memory specified, the container
4600
+ # is terminated. This parameter maps to `Memory` in the [Create a
4236
4601
  # container][1] section of the [Docker Remote API][2] and the
4237
4602
  # `--memory` option to [docker run][3]. You must specify at least 4
4238
- # MiB of memory for a job.
4603
+ # MiB of memory for a job. This is required but can be specified in
4604
+ # several places for multi-node parallel (MNP) jobs. It must be
4605
+ # specified for each node at least once. This parameter maps to
4606
+ # `Memory` in the [Create a container][1] section of the [Docker
4607
+ # Remote API][2] and the `--memory` option to [docker run][3].
4239
4608
  #
4240
4609
  # <note markdown="1"> If you're trying to maximize your resource utilization by
4241
4610
  # providing your jobs as much memory as possible for a particular
@@ -4245,44 +4614,43 @@ module Aws::Batch
4245
4614
  # </note>
4246
4615
  #
4247
4616
  # For jobs running on Fargate resources, then `value` is the hard
4248
- # limit (in GiB), represented in decimal form, and must match one of
4249
- # the supported values (0.5 and whole numbers between 1 and 30,
4250
- # inclusive) and the `VCPU` values must be one of the values
4251
- # supported for that memory value.
4617
+ # limit (in MiB), and must match one of the supported values and the
4618
+ # `VCPU` values must be one of the values supported for that memory
4619
+ # value.
4252
4620
  #
4253
- # value = 0.5
4621
+ # value = 512
4254
4622
  #
4255
4623
  # : `VCPU` = 0.25
4256
4624
  #
4257
- # value = 1
4625
+ # value = 1024
4258
4626
  #
4259
4627
  # : `VCPU` = 0.25 or 0.5
4260
4628
  #
4261
- # value = 2
4629
+ # value = 2048
4262
4630
  #
4263
4631
  # : `VCPU` = 0.25, 0.5, or 1
4264
4632
  #
4265
- # value = 3
4633
+ # value = 3072
4266
4634
  #
4267
4635
  # : `VCPU` = 0.5, or 1
4268
4636
  #
4269
- # value = 4
4637
+ # value = 4096
4270
4638
  #
4271
4639
  # : `VCPU` = 0.5, 1, or 2
4272
4640
  #
4273
- # value = 5, 6, or 7
4641
+ # value = 5120, 6144, or 7168
4274
4642
  #
4275
4643
  # : `VCPU` = 1 or 2
4276
4644
  #
4277
- # value = 8
4645
+ # value = 8192
4278
4646
  #
4279
4647
  # : `VCPU` = 1, 2, or 4
4280
4648
  #
4281
- # value = 9, 10, 11, 12, 13, 14, 15, or 16
4649
+ # value = 9216, 10240, 11264, 12288, 13312, 14336, 15360, or 16384
4282
4650
  #
4283
4651
  # : `VCPU` = 2 or 4
4284
4652
  #
4285
- # value = 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, or 30
4653
+ # value = 17408, 18432, 19456, 20480, 21504, 22528, 23552, 24576, 25600, 26624, 27648, 28672, 29696, or 30720
4286
4654
  #
4287
4655
  # : `VCPU` = 4
4288
4656
  #
@@ -4291,10 +4659,10 @@ module Aws::Batch
4291
4659
  # : The number of vCPUs reserved for the container. This parameter
4292
4660
  # maps to `CpuShares` in the [Create a container][1] section of the
4293
4661
  # [Docker Remote API][2] and the `--cpu-shares` option to [docker
4294
- # run][3]. Each vCPU is equivalent to 1,024 CPU shares. You must
4295
- # specify at least one vCPU. This is required but can be specified
4296
- # in several places; it must be specified for each node at least
4297
- # once.
4662
+ # run][3]. Each vCPU is equivalent to 1,024 CPU shares. For EC2
4663
+ # resources, you must specify at least one vCPU. This is required
4664
+ # but can be specified in several places; it must be specified for
4665
+ # each node at least once.
4298
4666
  #
4299
4667
  # For jobs running on Fargate resources, then `value` must match one
4300
4668
  # of the supported values and the `MEMORY` values must be one of the
@@ -4303,24 +4671,26 @@ module Aws::Batch
4303
4671
  #
4304
4672
  # value = 0.25
4305
4673
  #
4306
- # : `MEMORY` = 0.5, 1, or 2
4674
+ # : `MEMORY` = 512, 1024, or 2048
4307
4675
  #
4308
4676
  # value = 0.5
4309
4677
  #
4310
- # : `MEMORY` = 1, 2, 3, or 4
4678
+ # : `MEMORY` = 1024, 2048, 3072, or 4096
4311
4679
  #
4312
4680
  # value = 1
4313
4681
  #
4314
- # : `MEMORY` = 2, 3, 4, 5, 6, 7, or 8
4682
+ # : `MEMORY` = 2048, 3072, 4096, 5120, 6144, 7168, or 8192
4315
4683
  #
4316
4684
  # value = 2
4317
4685
  #
4318
- # : `MEMORY` = 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, or 16
4686
+ # : `MEMORY` = 4096, 5120, 6144, 7168, 8192, 9216, 10240, 11264,
4687
+ # 12288, 13312, 14336, 15360, or 16384
4319
4688
  #
4320
4689
  # value = 4
4321
4690
  #
4322
- # : `MEMORY` = 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21,
4323
- # 22, 23, 24, 25, 26, 27, 28, 29, or 30
4691
+ # : `MEMORY` = 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360,
4692
+ # 16384, 17408, 18432, 19456, 20480, 21504, 22528, 23552, 24576,
4693
+ # 25600, 26624, 27648, 28672, 29696, or 30720
4324
4694
  #
4325
4695
  #
4326
4696
  #
@@ -4367,7 +4737,7 @@ module Aws::Batch
4367
4737
  # }
4368
4738
  #
4369
4739
  # @!attribute [rw] attempts
4370
- # The number of times to move a job to the `RUNNABLE` status. You may
4740
+ # The number of times to move a job to the `RUNNABLE` status. You can
4371
4741
  # specify between 1 and 10 attempts. If the value of `attempts` is
4372
4742
  # greater than one, the job is retried on failure the same number of
4373
4743
  # attempts as the value.
@@ -4422,7 +4792,7 @@ module Aws::Batch
4422
4792
  # ARN of the parameter in the AWS Systems Manager Parameter Store.
4423
4793
  #
4424
4794
  # <note markdown="1"> If the AWS Systems Manager Parameter Store parameter exists in the
4425
- # same Region as the job you are launching, then you can use either
4795
+ # same Region as the job you're launching, then you can use either
4426
4796
  # the full ARN or name of the parameter. If the parameter exists in a
4427
4797
  # different Region, then the full ARN must be specified.
4428
4798
  #
@@ -4451,6 +4821,8 @@ module Aws::Batch
4451
4821
  include Aws::Structure
4452
4822
  end
4453
4823
 
4824
+ # Contains the parameters for `SubmitJob`.
4825
+ #
4454
4826
  # @note When making an API call, you may pass SubmitJobRequest
4455
4827
  # data as a hash:
4456
4828
  #
@@ -4541,8 +4913,8 @@ module Aws::Batch
4541
4913
  # @return [String]
4542
4914
  #
4543
4915
  # @!attribute [rw] job_queue
4544
- # The job queue into which the job is submitted. You can specify
4545
- # either the name or the Amazon Resource Name (ARN) of the queue.
4916
+ # The job queue where the job is submitted. You can specify either the
4917
+ # name or the Amazon Resource Name (ARN) of the queue.
4546
4918
  # @return [String]
4547
4919
  #
4548
4920
  # @!attribute [rw] array_properties
@@ -4582,14 +4954,13 @@ module Aws::Batch
4582
4954
  # @return [Hash<String,String>]
4583
4955
  #
4584
4956
  # @!attribute [rw] container_overrides
4585
- # A list of container overrides in JSON format that specify the name
4586
- # of a container in the specified job definition and the overrides it
4587
- # should receive. You can override the default command for a container
4588
- # (that is specified in the job definition or the Docker image) with a
4589
- # `command` override. You can also override existing environment
4590
- # variables (that are specified in the job definition or Docker image)
4591
- # on a container or add new environment variables to it with an
4592
- # `environment` override.
4957
+ # A list of container overrides in the JSON format that specify the
4958
+ # name of a container in the specified job definition and the
4959
+ # overrides it should receive. You can override the default command
4960
+ # for a container, which is specified in the job definition or the
4961
+ # Docker image, with a `command` override. You can also override
4962
+ # existing environment variables on a container or add new environment
4963
+ # variables to it with an `environment` override.
4593
4964
  # @return [Types::ContainerOverrides]
4594
4965
  #
4595
4966
  # @!attribute [rw] node_overrides
@@ -4728,6 +5099,8 @@ module Aws::Batch
4728
5099
  #
4729
5100
  class TagResourceResponse < Aws::EmptyStructure; end
4730
5101
 
5102
+ # Contains the parameters for `TerminateJob`.
5103
+ #
4731
5104
  # @note When making an API call, you may pass TerminateJobRequest
4732
5105
  # data as a hash:
4733
5106
  #
@@ -4878,6 +5251,8 @@ module Aws::Batch
4878
5251
  #
4879
5252
  class UntagResourceResponse < Aws::EmptyStructure; end
4880
5253
 
5254
+ # Contains the parameters for `UpdateComputeEnvironment`.
5255
+ #
4881
5256
  # @note When making an API call, you may pass UpdateComputeEnvironmentRequest
4882
5257
  # data as a hash:
4883
5258
  #
@@ -4903,16 +5278,39 @@ module Aws::Batch
4903
5278
  # The state of the compute environment. Compute environments in the
4904
5279
  # `ENABLED` state can accept jobs from a queue and scale in or out
4905
5280
  # automatically based on the workload demand of its associated queues.
5281
+ #
5282
+ # If the state is `ENABLED`, then the AWS Batch scheduler can attempt
5283
+ # to place jobs from an associated job queue on the compute resources
5284
+ # within the environment. If the compute environment is managed, then
5285
+ # it can scale its instances out or in automatically, based on the job
5286
+ # queue demand.
5287
+ #
5288
+ # If the state is `DISABLED`, then the AWS Batch scheduler doesn't
5289
+ # attempt to place jobs within the environment. Jobs in a `STARTING`
5290
+ # or `RUNNING` state continue to progress normally. Managed compute
5291
+ # environments in the `DISABLED` state don't scale out. However, they
5292
+ # scale in to `minvCpus` value after instances become idle.
4906
5293
  # @return [String]
4907
5294
  #
4908
5295
  # @!attribute [rw] compute_resources
4909
5296
  # Details of the compute resources managed by the compute environment.
4910
- # Required for a managed compute environment.
5297
+ # Required for a managed compute environment. For more information,
5298
+ # see [Compute Environments][1] in the *AWS Batch User Guide*.
5299
+ #
5300
+ #
5301
+ #
5302
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/compute_environments.html
4911
5303
  # @return [Types::ComputeResourceUpdate]
4912
5304
  #
4913
5305
  # @!attribute [rw] service_role
4914
5306
  # The full Amazon Resource Name (ARN) of the IAM role that allows AWS
4915
- # Batch to make calls to other AWS services on your behalf.
5307
+ # Batch to make calls to other AWS services on your behalf. For more
5308
+ # information, see [AWS Batch service IAM role][1] in the *AWS Batch
5309
+ # User Guide*.
5310
+ #
5311
+ # If the compute environment has a service-linked role, it cannot be
5312
+ # changed to use a regular IAM role. If the compute environment has a
5313
+ # regular IAM role, it cannot be changed to use a service-linked role.
4916
5314
  #
4917
5315
  # If your specified role has a path other than `/`, then you must
4918
5316
  # either specify the full role ARN (this is recommended) or prefix the
@@ -4920,12 +5318,16 @@ module Aws::Batch
4920
5318
  #
4921
5319
  # <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN
4922
5320
  # might contain the `service-role` path prefix. When you only specify
4923
- # the name of the service role, AWS Batch assumes that your ARN does
4924
- # not use the `service-role` path prefix. Because of this, we
5321
+ # the name of the service role, AWS Batch assumes that your ARN
5322
+ # doesn't use the `service-role` path prefix. Because of this, we
4925
5323
  # recommend that you specify the full ARN of your service role when
4926
5324
  # you create compute environments.
4927
5325
  #
4928
5326
  # </note>
5327
+ #
5328
+ #
5329
+ #
5330
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/service_IAM_role.html
4929
5331
  # @return [String]
4930
5332
  #
4931
5333
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/UpdateComputeEnvironmentRequest AWS API Documentation
@@ -4940,7 +5342,8 @@ module Aws::Batch
4940
5342
  end
4941
5343
 
4942
5344
  # @!attribute [rw] compute_environment_name
4943
- # The name of the compute environment.
5345
+ # The name of the compute environment. Up to 128 letters (uppercase
5346
+ # and lowercase), numbers, hyphens, and underscores are allowed.
4944
5347
  # @return [String]
4945
5348
  #
4946
5349
  # @!attribute [rw] compute_environment_arn
@@ -4956,6 +5359,8 @@ module Aws::Batch
4956
5359
  include Aws::Structure
4957
5360
  end
4958
5361
 
5362
+ # Contains the parameters for `UpdateJobQueue`.
5363
+ #
4959
5364
  # @note When making an API call, you may pass UpdateJobQueueRequest
4960
5365
  # data as a hash:
4961
5366
  #
@@ -4977,9 +5382,9 @@ module Aws::Batch
4977
5382
  #
4978
5383
  # @!attribute [rw] state
4979
5384
  # Describes the queue's ability to accept new jobs. If the job queue
4980
- # state is `ENABLED`, it is able to accept jobs. If the job queue
4981
- # state is `DISABLED`, new jobs cannot be added to the queue, but jobs
4982
- # already in the queue can finish.
5385
+ # state is `ENABLED`, it can accept jobs. If the job queue state is
5386
+ # `DISABLED`, new jobs can't be added to the queue, but jobs already
5387
+ # in the queue can finish.
4983
5388
  # @return [String]
4984
5389
  #
4985
5390
  # @!attribute [rw] priority
@@ -4988,17 +5393,27 @@ module Aws::Batch
4988
5393
  # first when associated with the same compute environment. Priority is
4989
5394
  # determined in descending order, for example, a job queue with a
4990
5395
  # priority value of `10` is given scheduling preference over a job
4991
- # queue with a priority value of `1`.
5396
+ # queue with a priority value of `1`. All of the compute environments
5397
+ # must be either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or
5398
+ # `FARGATE_SPOT`). EC2 and Fargate compute environments can't be
5399
+ # mixed.
4992
5400
  # @return [Integer]
4993
5401
  #
4994
5402
  # @!attribute [rw] compute_environment_order
4995
5403
  # Details the set of compute environments mapped to a job queue and
4996
5404
  # their order relative to each other. This is one of the parameters
4997
5405
  # used by the job scheduler to determine which compute environment
4998
- # should run a given job. All of the compute environments must be
4999
- # either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or
5000
- # `FARGATE_SPOT`); EC2 and Fargate compute environments can't be
5001
- # mixed.
5406
+ # should run a given job. Compute environments must be in the `VALID`
5407
+ # state before you can associate them with a job queue. All of the
5408
+ # compute environments must be either EC2 (`EC2` or `SPOT`) or Fargate
5409
+ # (`FARGATE` or `FARGATE_SPOT`). EC2 and Fargate compute environments
5410
+ # can't be mixed.
5411
+ #
5412
+ # <note markdown="1"> All compute environments that are associated with a job queue must
5413
+ # share the same architecture. AWS Batch doesn't support mixing
5414
+ # compute environment architecture types in a single job queue.
5415
+ #
5416
+ # </note>
5002
5417
  # @return [Array<Types::ComputeEnvironmentOrder>]
5003
5418
  #
5004
5419
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/UpdateJobQueueRequest AWS API Documentation
@@ -5039,6 +5454,16 @@ module Aws::Batch
5039
5454
  # source_path: "String",
5040
5455
  # },
5041
5456
  # name: "String",
5457
+ # efs_volume_configuration: {
5458
+ # file_system_id: "String", # required
5459
+ # root_directory: "String",
5460
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
5461
+ # transit_encryption_port: 1,
5462
+ # authorization_config: {
5463
+ # access_point_id: "String",
5464
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
5465
+ # },
5466
+ # },
5042
5467
  # }
5043
5468
  #
5044
5469
  # @!attribute [rw] host
@@ -5062,11 +5487,18 @@ module Aws::Batch
5062
5487
  # `mountPoints`.
5063
5488
  # @return [String]
5064
5489
  #
5490
+ # @!attribute [rw] efs_volume_configuration
5491
+ # This parameter is specified when you are using an Amazon Elastic
5492
+ # File System file system for job storage. Jobs running on Fargate
5493
+ # resources must specify a `platformVersion` of at least `1.4.0`.
5494
+ # @return [Types::EFSVolumeConfiguration]
5495
+ #
5065
5496
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/Volume AWS API Documentation
5066
5497
  #
5067
5498
  class Volume < Struct.new(
5068
5499
  :host,
5069
- :name)
5500
+ :name,
5501
+ :efs_volume_configuration)
5070
5502
  SENSITIVE = []
5071
5503
  include Aws::Structure
5072
5504
  end