aws-sdk-batch 1.45.0 → 1.49.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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')
@@ -89,8 +93,10 @@ module Aws::Batch
89
93
  JobSummaryList = Shapes::ListShape.new(name: 'JobSummaryList')
90
94
  JobTimeout = Shapes::StructureShape.new(name: 'JobTimeout')
91
95
  KeyValuePair = Shapes::StructureShape.new(name: 'KeyValuePair')
96
+ KeyValuesPair = Shapes::StructureShape.new(name: 'KeyValuesPair')
92
97
  LaunchTemplateSpecification = Shapes::StructureShape.new(name: 'LaunchTemplateSpecification')
93
98
  LinuxParameters = Shapes::StructureShape.new(name: 'LinuxParameters')
99
+ ListJobsFilterList = Shapes::ListShape.new(name: 'ListJobsFilterList')
94
100
  ListJobsRequest = Shapes::StructureShape.new(name: 'ListJobsRequest')
95
101
  ListJobsResponse = Shapes::StructureShape.new(name: 'ListJobsResponse')
96
102
  ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest')
@@ -303,7 +309,7 @@ module Aws::Batch
303
309
  CreateComputeEnvironmentRequest.add_member(:type, Shapes::ShapeRef.new(shape: CEType, required: true, location_name: "type"))
304
310
  CreateComputeEnvironmentRequest.add_member(:state, Shapes::ShapeRef.new(shape: CEState, location_name: "state"))
305
311
  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"))
312
+ CreateComputeEnvironmentRequest.add_member(:service_role, Shapes::ShapeRef.new(shape: String, location_name: "serviceRole"))
307
313
  CreateComputeEnvironmentRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagrisTagsMap, location_name: "tags"))
308
314
  CreateComputeEnvironmentRequest.struct_class = Types::CreateComputeEnvironmentRequest
309
315
 
@@ -381,6 +387,17 @@ module Aws::Batch
381
387
 
382
388
  DevicesList.member = Shapes::ShapeRef.new(shape: Device)
383
389
 
390
+ EFSAuthorizationConfig.add_member(:access_point_id, Shapes::ShapeRef.new(shape: String, location_name: "accessPointId"))
391
+ EFSAuthorizationConfig.add_member(:iam, Shapes::ShapeRef.new(shape: EFSAuthorizationConfigIAM, location_name: "iam"))
392
+ EFSAuthorizationConfig.struct_class = Types::EFSAuthorizationConfig
393
+
394
+ EFSVolumeConfiguration.add_member(:file_system_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "fileSystemId"))
395
+ EFSVolumeConfiguration.add_member(:root_directory, Shapes::ShapeRef.new(shape: String, location_name: "rootDirectory"))
396
+ EFSVolumeConfiguration.add_member(:transit_encryption, Shapes::ShapeRef.new(shape: EFSTransitEncryption, location_name: "transitEncryption"))
397
+ EFSVolumeConfiguration.add_member(:transit_encryption_port, Shapes::ShapeRef.new(shape: Integer, location_name: "transitEncryptionPort"))
398
+ EFSVolumeConfiguration.add_member(:authorization_config, Shapes::ShapeRef.new(shape: EFSAuthorizationConfig, location_name: "authorizationConfig"))
399
+ EFSVolumeConfiguration.struct_class = Types::EFSVolumeConfiguration
400
+
384
401
  Ec2Configuration.add_member(:image_type, Shapes::ShapeRef.new(shape: ImageType, required: true, location_name: "imageType"))
385
402
  Ec2Configuration.add_member(:image_id_override, Shapes::ShapeRef.new(shape: ImageIdOverride, location_name: "imageIdOverride"))
386
403
  Ec2Configuration.struct_class = Types::Ec2Configuration
@@ -475,6 +492,7 @@ module Aws::Batch
475
492
  JobSummary.add_member(:container, Shapes::ShapeRef.new(shape: ContainerSummary, location_name: "container"))
476
493
  JobSummary.add_member(:array_properties, Shapes::ShapeRef.new(shape: ArrayPropertiesSummary, location_name: "arrayProperties"))
477
494
  JobSummary.add_member(:node_properties, Shapes::ShapeRef.new(shape: NodePropertiesSummary, location_name: "nodeProperties"))
495
+ JobSummary.add_member(:job_definition, Shapes::ShapeRef.new(shape: String, location_name: "jobDefinition"))
478
496
  JobSummary.struct_class = Types::JobSummary
479
497
 
480
498
  JobSummaryList.member = Shapes::ShapeRef.new(shape: JobSummary)
@@ -486,6 +504,10 @@ module Aws::Batch
486
504
  KeyValuePair.add_member(:value, Shapes::ShapeRef.new(shape: String, location_name: "value"))
487
505
  KeyValuePair.struct_class = Types::KeyValuePair
488
506
 
507
+ KeyValuesPair.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
508
+ KeyValuesPair.add_member(:values, Shapes::ShapeRef.new(shape: StringList, location_name: "values"))
509
+ KeyValuesPair.struct_class = Types::KeyValuesPair
510
+
489
511
  LaunchTemplateSpecification.add_member(:launch_template_id, Shapes::ShapeRef.new(shape: String, location_name: "launchTemplateId"))
490
512
  LaunchTemplateSpecification.add_member(:launch_template_name, Shapes::ShapeRef.new(shape: String, location_name: "launchTemplateName"))
491
513
  LaunchTemplateSpecification.add_member(:version, Shapes::ShapeRef.new(shape: String, location_name: "version"))
@@ -499,12 +521,15 @@ module Aws::Batch
499
521
  LinuxParameters.add_member(:swappiness, Shapes::ShapeRef.new(shape: Integer, location_name: "swappiness"))
500
522
  LinuxParameters.struct_class = Types::LinuxParameters
501
523
 
524
+ ListJobsFilterList.member = Shapes::ShapeRef.new(shape: KeyValuesPair)
525
+
502
526
  ListJobsRequest.add_member(:job_queue, Shapes::ShapeRef.new(shape: String, location_name: "jobQueue"))
503
527
  ListJobsRequest.add_member(:array_job_id, Shapes::ShapeRef.new(shape: String, location_name: "arrayJobId"))
504
528
  ListJobsRequest.add_member(:multi_node_job_id, Shapes::ShapeRef.new(shape: String, location_name: "multiNodeJobId"))
505
529
  ListJobsRequest.add_member(:job_status, Shapes::ShapeRef.new(shape: JobStatus, location_name: "jobStatus"))
506
530
  ListJobsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: Integer, location_name: "maxResults"))
507
531
  ListJobsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
532
+ ListJobsRequest.add_member(:filters, Shapes::ShapeRef.new(shape: ListJobsFilterList, location_name: "filters"))
508
533
  ListJobsRequest.struct_class = Types::ListJobsRequest
509
534
 
510
535
  ListJobsResponse.add_member(:job_summary_list, Shapes::ShapeRef.new(shape: JobSummaryList, required: true, location_name: "jobSummaryList"))
@@ -696,6 +721,7 @@ module Aws::Batch
696
721
 
697
722
  Volume.add_member(:host, Shapes::ShapeRef.new(shape: Host, location_name: "host"))
698
723
  Volume.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
724
+ Volume.add_member(:efs_volume_configuration, Shapes::ShapeRef.new(shape: EFSVolumeConfiguration, location_name: "efsVolumeConfiguration"))
699
725
  Volume.struct_class = Types::Volume
700
726
 
701
727
  Volumes.member = Shapes::ShapeRef.new(shape: Volume)
@@ -10,7 +10,7 @@
10
10
  module Aws::Batch
11
11
  module Types
12
12
 
13
- # An object representing an AWS Batch array job.
13
+ # An object representing an Batch array job.
14
14
  #
15
15
  # @note When making an API call, you may pass ArrayProperties
16
16
  # data as a hash:
@@ -105,9 +105,9 @@ module Aws::Batch
105
105
  #
106
106
  # @!attribute [rw] log_stream_name
107
107
  # The name of the CloudWatch Logs log stream associated with the
108
- # container. The log group for AWS Batch jobs is `/aws/batch/job`.
109
- # Each container attempt receives a log stream name when they reach
110
- # the `RUNNING` status.
108
+ # container. The log group for Batch jobs is `/aws/batch/job`. Each
109
+ # container attempt receives a log stream name when they reach the
110
+ # `RUNNING` status.
111
111
  # @return [String]
112
112
  #
113
113
  # @!attribute [rw] network_interfaces
@@ -172,14 +172,14 @@ module Aws::Batch
172
172
  # }
173
173
  #
174
174
  # @!attribute [rw] job_id
175
- # The AWS Batch job ID of the job to cancel.
175
+ # The Batch job ID of the job to cancel.
176
176
  # @return [String]
177
177
  #
178
178
  # @!attribute [rw] reason
179
179
  # A message to attach to the job that explains the reason for
180
180
  # canceling it. This message is returned by future DescribeJobs
181
- # operations on the job. This message is also recorded in the AWS
182
- # Batch activity logs.
181
+ # operations on the job. This message is also recorded in the Batch
182
+ # activity logs.
183
183
  # @return [String]
184
184
  #
185
185
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/CancelJobRequest AWS API Documentation
@@ -211,7 +211,7 @@ module Aws::Batch
211
211
  include Aws::Structure
212
212
  end
213
213
 
214
- # An object representing an AWS Batch compute environment.
214
+ # An object representing an Batch compute environment.
215
215
  #
216
216
  # @!attribute [rw] compute_environment_name
217
217
  # The name of the compute environment. Up to 128 letters (uppercase
@@ -233,8 +233,8 @@ module Aws::Batch
233
233
  #
234
234
  # @!attribute [rw] type
235
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*.
236
+ # more information, see [Compute Environments][1] in the *Batch User
237
+ # Guide*.
238
238
  #
239
239
  #
240
240
  #
@@ -245,13 +245,13 @@ module Aws::Batch
245
245
  # The state of the compute environment. The valid values are `ENABLED`
246
246
  # or `DISABLED`.
247
247
  #
248
- # If the state is `ENABLED`, then the AWS Batch scheduler can attempt
249
- # to place jobs from an associated job queue on the compute resources
248
+ # If the state is `ENABLED`, then the Batch scheduler can attempt to
249
+ # place jobs from an associated job queue on the compute resources
250
250
  # within the environment. If the compute environment is managed, then
251
251
  # it can scale its instances out or in automatically, based on the job
252
252
  # queue demand.
253
253
  #
254
- # If the state is `DISABLED`, then the AWS Batch scheduler doesn't
254
+ # If the state is `DISABLED`, then the Batch scheduler doesn't
255
255
  # attempt to place jobs within the environment. Jobs in a `STARTING`
256
256
  # or `RUNNING` state continue to progress normally. Managed compute
257
257
  # environments in the `DISABLED` state don't scale out. However, they
@@ -270,7 +270,7 @@ module Aws::Batch
270
270
  #
271
271
  # @!attribute [rw] compute_resources
272
272
  # The compute resources defined for the compute environment. For more
273
- # information, see [Compute Environments][1] in the *AWS Batch User
273
+ # information, see [Compute Environments][1] in the *Batch User
274
274
  # Guide*.
275
275
  #
276
276
  #
@@ -280,9 +280,9 @@ module Aws::Batch
280
280
  #
281
281
  # @!attribute [rw] service_role
282
282
  # The service role associated with the compute environment that allows
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*.
283
+ # Batch to make calls to Amazon Web Services API operations on your
284
+ # behalf. For more information, see [Batch service IAM role][1] in the
285
+ # *Batch User Guide*.
286
286
  #
287
287
  #
288
288
  #
@@ -317,7 +317,7 @@ module Aws::Batch
317
317
  # can't be mixed.
318
318
  #
319
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
320
+ # share the same architecture. Batch doesn't support mixing compute
321
321
  # environment architecture types in a single job queue.
322
322
  #
323
323
  # </note>
@@ -350,9 +350,8 @@ module Aws::Batch
350
350
  include Aws::Structure
351
351
  end
352
352
 
353
- # An object representing an AWS Batch compute resource. For more
354
- # information, see [Compute Environments][1] in the *AWS Batch User
355
- # Guide*.
353
+ # An object representing an Batch compute resource. For more
354
+ # information, see [Compute Environments][1] in the *Batch User Guide*.
356
355
  #
357
356
  #
358
357
  #
@@ -395,11 +394,11 @@ module Aws::Batch
395
394
  # @!attribute [rw] type
396
395
  # The type of compute environment: `EC2`, `SPOT`, `FARGATE`, or
397
396
  # `FARGATE_SPOT`. For more information, see [Compute Environments][1]
398
- # in the *AWS Batch User Guide*.
397
+ # in the *Batch User Guide*.
399
398
  #
400
399
  # If you choose `SPOT`, you must also specify an Amazon EC2 Spot Fleet
401
400
  # role with the `spotIamFleetRole` parameter. For more information,
402
- # see [Amazon EC2 Spot Fleet role][2] in the *AWS Batch User Guide*.
401
+ # see [Amazon EC2 Spot Fleet role][2] in the *Batch User Guide*.
403
402
  #
404
403
  #
405
404
  #
@@ -412,46 +411,46 @@ module Aws::Batch
412
411
  # enough instances of the best fitting instance type can be allocated.
413
412
  # This might be because of availability of the instance type in the
414
413
  # Region or [Amazon EC2 service limits][1]. For more information, see
415
- # [Allocation Strategies][2] in the *AWS Batch User Guide*.
414
+ # [Allocation Strategies][2] in the *Batch User Guide*.
416
415
  #
417
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
416
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
418
417
  # resources, and shouldn't be specified.
419
418
  #
420
419
  # </note>
421
420
  #
422
421
  # BEST\_FIT (default)
423
422
  #
424
- # : AWS Batch selects an instance type that best fits the needs of the
423
+ # : Batch selects an instance type that best fits the needs of the
425
424
  # jobs with a preference for the lowest-cost instance type. If
426
425
  # additional instances of the selected instance type aren't
427
- # available, AWS Batch will wait for the additional instances to be
428
- # available. If there are not enough instances available, or if the
429
- # user is hitting [Amazon EC2 service limits][1] then additional
430
- # jobs aren't run until currently running jobs have completed. This
431
- # allocation strategy keeps costs lower but can limit scaling. If
432
- # you are using Spot Fleets with `BEST_FIT` then the Spot Fleet IAM
433
- # Role must be specified.
426
+ # available, Batch waits for the additional instances to be
427
+ # available. If there aren't enough instances available, or if the
428
+ # user is reaching [Amazon EC2 service limits][1] then additional
429
+ # jobs aren't run until the currently running jobs have completed.
430
+ # This allocation strategy keeps costs lower but can limit scaling.
431
+ # If you are using Spot Fleets with `BEST_FIT` then the Spot Fleet
432
+ # IAM Role must be specified.
434
433
  #
435
434
  # BEST\_FIT\_PROGRESSIVE
436
435
  #
437
- # : AWS Batch will select additional instance types that are large
438
- # enough to meet the requirements of the jobs in the queue, with a
436
+ # : Batch will select additional instance types that are large enough
437
+ # to meet the requirements of the jobs in the queue, with a
439
438
  # preference for instance types with a lower cost per unit vCPU. If
440
439
  # additional instances of the previously selected instance types
441
- # aren't available, AWS Batch will select new instance types.
440
+ # aren't available, Batch will select new instance types.
442
441
  #
443
442
  # SPOT\_CAPACITY\_OPTIMIZED
444
443
  #
445
- # : AWS Batch will select one or more instance types that are large
446
- # enough to meet the requirements of the jobs in the queue, with a
444
+ # : Batch will select one or more instance types that are large enough
445
+ # to meet the requirements of the jobs in the queue, with a
447
446
  # preference for instance types that are less likely to be
448
447
  # interrupted. This allocation strategy is only available for Spot
449
448
  # Instance compute resources.
450
449
  #
451
450
  # With both `BEST_FIT_PROGRESSIVE` and `SPOT_CAPACITY_OPTIMIZED`
452
- # strategies, AWS Batch might need to go above `maxvCpus` to meet your
453
- # capacity requirements. In this event, AWS Batch never exceeds
454
- # `maxvCpus` by more than a single instance.
451
+ # strategies, Batch might need to go above `maxvCpus` to meet your
452
+ # capacity requirements. In this event, Batch never exceeds `maxvCpus`
453
+ # by more than a single instance.
455
454
  #
456
455
  #
457
456
  #
@@ -463,7 +462,7 @@ module Aws::Batch
463
462
  # The minimum number of Amazon EC2 vCPUs that an environment should
464
463
  # maintain (even if the compute environment is `DISABLED`).
465
464
  #
466
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
465
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
467
466
  # resources, and shouldn't be specified.
468
467
  #
469
468
  # </note>
@@ -474,21 +473,21 @@ module Aws::Batch
474
473
  # can reach.
475
474
  #
476
475
  # <note markdown="1"> With both `BEST_FIT_PROGRESSIVE` and `SPOT_CAPACITY_OPTIMIZED`
477
- # allocation strategies, AWS Batch might need to go above `maxvCpus`
478
- # to meet your capacity requirements. In this event, AWS Batch will
479
- # never go above `maxvCpus` by more than a single instance (e.g., no
480
- # more than a single instance from among those specified in your
481
- # compute environment).
476
+ # allocation strategies, Batch might need to exceed `maxvCpus` to meet
477
+ # your capacity requirements. In this event, Batch never exceeds
478
+ # `maxvCpus` by more than a single instance. For example, no more than
479
+ # a single instance from among those specified in your compute
480
+ # environment is allocated.
482
481
  #
483
482
  # </note>
484
483
  # @return [Integer]
485
484
  #
486
485
  # @!attribute [rw] desiredv_cpus
487
486
  # The desired number of Amazon EC2 vCPUS in the compute environment.
488
- # AWS Batch modifies this value between the minimum and maximum
489
- # values, based on job queue demand.
487
+ # Batch modifies this value between the minimum and maximum values,
488
+ # based on job queue demand.
490
489
  #
491
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
490
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
492
491
  # resources, and shouldn't be specified.
493
492
  #
494
493
  # </note>
@@ -499,10 +498,10 @@ module Aws::Batch
499
498
  # families to launch any instance type within those families (for
500
499
  # example, `c5` or `p3`), or you can specify specific sizes within a
501
500
  # family (such as `c5.8xlarge`). You can also choose `optimal` to
502
- # select instance types (from the C4, M4, and R4 instance families) on
503
- # the fly that match the demand of your job queues.
501
+ # select instance types (from the C4, M4, and R4 instance families)
502
+ # that match the demand of your job queues.
504
503
  #
505
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
504
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
506
505
  # resources, and shouldn't be specified.
507
506
  #
508
507
  # </note>
@@ -527,7 +526,7 @@ module Aws::Batch
527
526
  # compute environment. This parameter is overridden by the
528
527
  # `imageIdOverride` member of the `Ec2Configuration` structure.
529
528
  #
530
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
529
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
531
530
  # resources, and shouldn't be specified.
532
531
  #
533
532
  # </note>
@@ -549,11 +548,10 @@ module Aws::Batch
549
548
  # @return [String]
550
549
  #
551
550
  # @!attribute [rw] subnets
552
- # The VPC subnets into which the compute resources are launched. These
553
- # subnets must be within the same VPC. This parameter is required for
554
- # jobs running on Fargate resources, where it can contain up to 16
555
- # subnets. For more information, see [VPCs and Subnets][1] in the
556
- # *Amazon VPC User Guide*.
551
+ # The VPC subnets where the compute resources are launched. These
552
+ # subnets must be within the same VPC. Fargate compute resources can
553
+ # contain up to 16 subnets. For more information, see [VPCs and
554
+ # Subnets][1] in the *Amazon VPC User Guide*.
557
555
  #
558
556
  #
559
557
  #
@@ -565,10 +563,10 @@ module Aws::Batch
565
563
  # the compute environment. One or more security groups must be
566
564
  # specified, either in `securityGroupIds` or using a launch template
567
565
  # referenced in `launchTemplate`. This parameter is required for jobs
568
- # running on Fargate resources and must contain at least one security
569
- # group. (Fargate does not support launch templates.) If security
570
- # groups are specified using both `securityGroupIds` and
571
- # `launchTemplate`, the values in `securityGroupIds` will be used.
566
+ # that are running on Fargate resources and must contain at least one
567
+ # security group. Fargate doesn't support launch templates. If
568
+ # security groups are specified using both `securityGroupIds` and
569
+ # `launchTemplate`, the values in `securityGroupIds` are used.
572
570
  # @return [Array<String>]
573
571
  #
574
572
  # @!attribute [rw] ec2_key_pair
@@ -576,7 +574,7 @@ module Aws::Batch
576
574
  # compute environment. You can use this key pair to log in to your
577
575
  # instances with SSH.
578
576
  #
579
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
577
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
580
578
  # resources, and shouldn't be specified.
581
579
  #
582
580
  # </note>
@@ -588,10 +586,10 @@ module Aws::Batch
588
586
  # Resource Name (ARN) of an instance profile. For example, `
589
587
  # ecsInstanceRole ` or
590
588
  # `arn:aws:iam::<aws_account_id>:instance-profile/ecsInstanceRole `.
591
- # For more information, see [Amazon ECS Instance Role][1] in the *AWS
592
- # Batch User Guide*.
589
+ # For more information, see [Amazon ECS Instance Role][1] in the
590
+ # *Batch User Guide*.
593
591
  #
594
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
592
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
595
593
  # resources, and shouldn't be specified.
596
594
  #
597
595
  # </note>
@@ -603,17 +601,17 @@ module Aws::Batch
603
601
  #
604
602
  # @!attribute [rw] tags
605
603
  # Key-value pair tags to be applied to EC2 resources that are launched
606
- # in the compute environment. For AWS Batch, these take the form of
604
+ # in the compute environment. For Batch, these take the form of
607
605
  # "String1": "String2", where String1 is the tag key and String2
608
- # is the tag value−for example, \\\{ "Name": "AWS Batch Instance -
609
- # C4OnDemand" \\}. This is helpful for recognizing your AWS Batch
606
+ # is the tag value−for example, `\{ "Name": "Batch Instance -
607
+ # C4OnDemand" \}`. This is helpful for recognizing your Batch
610
608
  # instances in the Amazon EC2 console. These tags can't be updated or
611
- # removed after the compute environment has been created; any changes
612
- # require creating a new compute environment and removing the old
613
- # compute environment. These tags are not seen when using the AWS
614
- # Batch `ListTagsForResource` API operation.
609
+ # removed after the compute environment is created.Aany changes to
610
+ # these tags require that you create a new compute environment and
611
+ # remove the old compute environment. These tags aren't seen when
612
+ # using the Batch `ListTagsForResource` API operation.
615
613
  #
616
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
614
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
617
615
  # resources, and shouldn't be specified.
618
616
  #
619
617
  # </note>
@@ -629,7 +627,7 @@ module Aws::Batch
629
627
  # potential. For more information, see [Placement Groups][1] in the
630
628
  # *Amazon EC2 User Guide for Linux Instances*.
631
629
  #
632
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
630
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
633
631
  # resources, and shouldn't be specified.
634
632
  #
635
633
  # </note>
@@ -649,7 +647,7 @@ module Aws::Batch
649
647
  # If you leave this field empty, the default value is 100% of the
650
648
  # On-Demand price.
651
649
  #
652
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
650
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
653
651
  # resources, and shouldn't be specified.
654
652
  #
655
653
  # </note>
@@ -660,9 +658,9 @@ module Aws::Batch
660
658
  # applied to a `SPOT` compute environment. This role is required if
661
659
  # the allocation strategy set to `BEST_FIT` or if the allocation
662
660
  # strategy isn't specified. For more information, see [Amazon EC2
663
- # Spot Fleet Role][1] in the *AWS Batch User Guide*.
661
+ # Spot Fleet Role][1] in the *Batch User Guide*.
664
662
  #
665
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
663
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
666
664
  # resources, and shouldn't be specified.
667
665
  #
668
666
  # </note>
@@ -672,7 +670,7 @@ module Aws::Batch
672
670
  # managed policy. The previously recommended
673
671
  # **AmazonEC2SpotFleetRole** managed policy doesn't have the required
674
672
  # permissions to tag Spot Instances. For more information, see [Spot
675
- # Instances not tagged on creation][2] in the *AWS Batch User Guide*.
673
+ # Instances not tagged on creation][2] in the *Batch User Guide*.
676
674
  #
677
675
  #
678
676
  #
@@ -686,10 +684,10 @@ module Aws::Batch
686
684
  # CreateComputeEnvironment API operation override the same parameters
687
685
  # in the launch template. You must specify either the launch template
688
686
  # ID or launch template name in the request, but not both. For more
689
- # information, see [Launch Template Support][1] in the *AWS Batch User
687
+ # information, see [Launch Template Support][1] in the *Batch User
690
688
  # Guide*.
691
689
  #
692
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
690
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
693
691
  # resources, and shouldn't be specified.
694
692
  #
695
693
  # </note>
@@ -704,7 +702,7 @@ module Aws::Batch
704
702
  # EC2 instances in the compute environment. If `Ec2Configuration`
705
703
  # isn't specified, the default is `ECS_AL1`.
706
704
  #
707
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
705
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
708
706
  # resources, and shouldn't be specified.
709
707
  #
710
708
  # </note>
@@ -736,7 +734,7 @@ module Aws::Batch
736
734
 
737
735
  # An object representing the attributes of a compute environment that
738
736
  # can be updated. For more information, see [Compute Environments][1] in
739
- # the *AWS Batch User Guide*.
737
+ # the *Batch User Guide*.
740
738
  #
741
739
  #
742
740
  #
@@ -757,7 +755,7 @@ module Aws::Batch
757
755
  # The minimum number of Amazon EC2 vCPUs that an environment should
758
756
  # maintain.
759
757
  #
760
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
758
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
761
759
  # resources, and shouldn't be specified.
762
760
  #
763
761
  # </note>
@@ -768,11 +766,11 @@ module Aws::Batch
768
766
  # reach.
769
767
  #
770
768
  # <note markdown="1"> With both `BEST_FIT_PROGRESSIVE` and `SPOT_CAPACITY_OPTIMIZED`
771
- # allocation strategies, AWS Batch might need to go above `maxvCpus`
772
- # to meet your capacity requirements. In this event, AWS Batch will
773
- # never go above `maxvCpus` by more than a single instance (e.g., no
774
- # more than a single instance from among those specified in your
775
- # compute environment).
769
+ # allocation strategies, Batch might need to exceed `maxvCpus` to meet
770
+ # your capacity requirements. In this event, Batch never exceeds
771
+ # `maxvCpus` by more than a single instance. That is, no more than a
772
+ # single instance from among those specified in your compute
773
+ # environment.
776
774
  #
777
775
  # </note>
778
776
  # @return [Integer]
@@ -780,20 +778,19 @@ module Aws::Batch
780
778
  # @!attribute [rw] desiredv_cpus
781
779
  # The desired number of Amazon EC2 vCPUS in the compute environment.
782
780
  #
783
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
781
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
784
782
  # resources, and shouldn't be specified.
785
783
  #
786
784
  # </note>
787
785
  # @return [Integer]
788
786
  #
789
787
  # @!attribute [rw] subnets
790
- # The VPC subnets that the compute resources are launched into. This
791
- # parameter is required for jobs running on Fargate compute resources,
792
- # where it can contain up to 16 subnets. For more information, see
793
- # [VPCs and Subnets][1] in the *Amazon VPC User Guide*. This can't be
794
- # specified for EC2 compute resources. Providing an empty list will be
795
- # handled as if this parameter wasn't specified and no change is
796
- # made.
788
+ # The VPC subnets where the compute resources are launched. Fargate
789
+ # compute resources can contain up to 16 subnets. Providing an empty
790
+ # list will be handled as if this parameter wasn't specified and no
791
+ # change is made. This can't be specified for EC2 compute resources.
792
+ # For more information, see [VPCs and Subnets][1] in the *Amazon VPC
793
+ # User Guide*.
797
794
  #
798
795
  #
799
796
  #
@@ -829,19 +826,20 @@ module Aws::Batch
829
826
  # @return [String]
830
827
  #
831
828
  # @!attribute [rw] vcpus
832
- # The number of vCPUs reserved for the container. Jobs running on EC2
833
- # resources can specify the vCPU requirement for the job using
834
- # `resourceRequirements` but the vCPU requirements can't be specified
835
- # both here and in the `resourceRequirement` object. This parameter
836
- # maps to `CpuShares` in the [Create a container][1] section of the
837
- # [Docker Remote API][2] and the `--cpu-shares` option to [docker
838
- # run][3]. Each vCPU is equivalent to 1,024 CPU shares. You must
839
- # specify at least one vCPU. This is required but can be specified in
840
- # several places. It must be specified for each node at least once.
841
- #
842
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
843
- # resources. Jobs running on Fargate resources must specify the vCPU
844
- # requirement for the job using `resourceRequirements`.
829
+ # The number of vCPUs reserved for the container. For jobs that run on
830
+ # EC2 resources, you can specify the vCPU requirement for the job
831
+ # using `resourceRequirements`, but you can't specify the vCPU
832
+ # requirements in both the `vcpus` and `resourceRequirement` object.
833
+ # This parameter maps to `CpuShares` in the [Create a container][1]
834
+ # section of the [Docker Remote API][2] and the `--cpu-shares` option
835
+ # to [docker run][3]. Each vCPU is equivalent to 1,024 CPU shares. You
836
+ # must specify at least one vCPU. This is required but can be
837
+ # specified in several places. It must be specified for each node at
838
+ # least once.
839
+ #
840
+ # <note markdown="1"> This parameter isn't applicable to jobs that run on Fargate
841
+ # resources. For jobs that run on Fargate resources, you must specify
842
+ # the vCPU requirement for the job using `resourceRequirements`.
845
843
  #
846
844
  # </note>
847
845
  #
@@ -869,9 +867,9 @@ module Aws::Batch
869
867
  # @return [String]
870
868
  #
871
869
  # @!attribute [rw] execution_role_arn
872
- # The Amazon Resource Name (ARN) of the execution role that AWS Batch
873
- # can assume. For more information, see [AWS Batch execution IAM
874
- # role][1] in the *AWS Batch User Guide*.
870
+ # The Amazon Resource Name (ARN) of the execution role that Batch can
871
+ # assume. For more information, see [Batch execution IAM role][1] in
872
+ # the *Batch User Guide*.
875
873
  #
876
874
  #
877
875
  #
@@ -886,7 +884,7 @@ module Aws::Batch
886
884
  # The environment variables to pass to a container.
887
885
  #
888
886
  # <note markdown="1"> Environment variables must not start with `AWS_BATCH`; this naming
889
- # convention is reserved for variables that are set by the AWS Batch
887
+ # convention is reserved for variables that are set by the Batch
890
888
  # service.
891
889
  #
892
890
  # </note>
@@ -914,7 +912,7 @@ module Aws::Batch
914
912
  # maps to `Ulimits` in the [Create a container][1] section of the
915
913
  # [Docker Remote API][2] and the `--ulimit` option to [docker run][3].
916
914
  #
917
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
915
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
918
916
  # resources.
919
917
  #
920
918
  # </note>
@@ -931,7 +929,7 @@ module Aws::Batch
931
929
  # permissions on the host container instance (similar to the `root`
932
930
  # user). The default value is false.
933
931
  #
934
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
932
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
935
933
  # resources and shouldn't be provided, or specified as false.
936
934
  #
937
935
  # </note>
@@ -971,16 +969,16 @@ module Aws::Batch
971
969
  #
972
970
  # @!attribute [rw] log_stream_name
973
971
  # The name of the CloudWatch Logs log stream associated with the
974
- # container. The log group for AWS Batch jobs is `/aws/batch/job`.
975
- # Each container attempt receives a log stream name when they reach
976
- # the `RUNNING` status.
972
+ # container. The log group for Batch jobs is `/aws/batch/job`. Each
973
+ # container attempt receives a log stream name when they reach the
974
+ # `RUNNING` status.
977
975
  # @return [String]
978
976
  #
979
977
  # @!attribute [rw] instance_type
980
978
  # The instance type of the underlying host infrastructure of a
981
979
  # multi-node parallel job.
982
980
  #
983
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
981
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
984
982
  # resources.
985
983
  #
986
984
  # </note>
@@ -1006,7 +1004,7 @@ module Aws::Batch
1006
1004
  # This parameter maps to `LogConfig` in the [Create a container][1]
1007
1005
  # section of the [Docker Remote API][2] and the `--log-driver` option
1008
1006
  # to [docker run][3]. By default, containers use the same logging
1009
- # driver that the Docker daemon uses. However the container might use
1007
+ # driver that the Docker daemon uses. However, the container might use
1010
1008
  # a different logging driver than the Docker daemon by specifying a
1011
1009
  # log driver with this parameter in the container definition. To use a
1012
1010
  # different logging driver for a container, the log system must be
@@ -1016,10 +1014,10 @@ module Aws::Batch
1016
1014
  # log drivers, see [Configure logging drivers][4] in the Docker
1017
1015
  # documentation.
1018
1016
  #
1019
- # <note markdown="1"> AWS Batch currently supports a subset of the logging drivers
1020
- # available to the Docker daemon (shown in the LogConfiguration data
1021
- # type). Additional log drivers might be available in future releases
1022
- # of the Amazon ECS container agent.
1017
+ # <note markdown="1"> Batch currently supports a subset of the logging drivers available
1018
+ # to the Docker daemon (shown in the LogConfiguration data type).
1019
+ # Additional log drivers might be available in future releases of the
1020
+ # Amazon ECS container agent.
1023
1021
  #
1024
1022
  # </note>
1025
1023
  #
@@ -1050,7 +1048,7 @@ module Aws::Batch
1050
1048
  #
1051
1049
  # @!attribute [rw] secrets
1052
1050
  # The secrets to pass to the container. For more information, see
1053
- # [Specifying sensitive data][1] in the *AWS Batch User Guide*.
1051
+ # [Specifying sensitive data][1] in the *Batch User Guide*.
1054
1052
  #
1055
1053
  #
1056
1054
  #
@@ -1058,13 +1056,15 @@ module Aws::Batch
1058
1056
  # @return [Array<Types::Secret>]
1059
1057
  #
1060
1058
  # @!attribute [rw] network_configuration
1061
- # The network configuration for jobs running on Fargate resources.
1062
- # Jobs running on EC2 resources must not specify this parameter.
1059
+ # The network configuration for jobs that are running on Fargate
1060
+ # resources. Jobs that are running on EC2 resources must not specify
1061
+ # this parameter.
1063
1062
  # @return [Types::NetworkConfiguration]
1064
1063
  #
1065
1064
  # @!attribute [rw] fargate_platform_configuration
1066
- # The platform configuration for jobs running on Fargate resources.
1067
- # Jobs running on EC2 resources must not specify this parameter.
1065
+ # The platform configuration for jobs that are running on Fargate
1066
+ # resources. Jobs that are running on EC2 resources must not specify
1067
+ # this parameter.
1068
1068
  # @return [Types::FargatePlatformConfiguration]
1069
1069
  #
1070
1070
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ContainerDetail AWS API Documentation
@@ -1125,22 +1125,25 @@ module Aws::Batch
1125
1125
  # }
1126
1126
  #
1127
1127
  # @!attribute [rw] vcpus
1128
- # This parameter is deprecated and not supported for jobs run on
1129
- # Fargate resources, see `resourceRequirement`. For jobs run on EC2
1130
- # resources, the number of vCPUs to reserve for the container. This
1131
- # value overrides the value set in the job definition. Jobs run on EC2
1132
- # resources can specify the vCPU requirement using
1133
- # `resourceRequirement` but the vCPU requirements can't be specified
1134
- # both here and in `resourceRequirement`. This parameter maps to
1135
- # `CpuShares` in the [Create a container][1] section of the [Docker
1136
- # Remote API][2] and the `--cpu-shares` option to [docker run][3].
1137
- # Each vCPU is equivalent to 1,024 CPU shares. You must specify at
1138
- # least one vCPU.
1139
- #
1140
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
1141
- # resources and shouldn't be provided. Jobs running on Fargate
1142
- # resources must specify the vCPU requirement for the job using
1143
- # `resourceRequirements`.
1128
+ # This parameter indicates the number of vCPUs reserved for the
1129
+ # container.It overrides the `vcpus` parameter that's set in the job
1130
+ # definition, but doesn't override any vCPU requirement specified in
1131
+ # the `resourceRequirement` structure in the job definition. To
1132
+ # override vCPU requirements that are specified in the
1133
+ # `ResourceRequirement` structure in the job definition,
1134
+ # `ResourceRequirement` must be specified in the `SubmitJob` request,
1135
+ # with `type` set to `VCPU` and `value` set to the new value.
1136
+ #
1137
+ # This parameter maps to `CpuShares` in the [Create a container][1]
1138
+ # section of the [Docker Remote API][2] and the `--cpu-shares` option
1139
+ # to [docker run][3]. Each vCPU is equivalent to 1,024 CPU shares. You
1140
+ # must specify at least one vCPU.
1141
+ #
1142
+ # <note markdown="1"> This parameter is supported for jobs that run on EC2 resources, but
1143
+ # isn't supported for jobs that run on Fargate resources. For Fargate
1144
+ # resources, you can only use `resourceRequirement`. For EC2
1145
+ # resources, you can use either this parameter or
1146
+ # `resourceRequirement` but not both.
1144
1147
  #
1145
1148
  # </note>
1146
1149
  #
@@ -1152,10 +1155,18 @@ module Aws::Batch
1152
1155
  # @return [Integer]
1153
1156
  #
1154
1157
  # @!attribute [rw] memory
1155
- # This parameter is deprecated and not supported for jobs run on
1156
- # Fargate resources, use `ResourceRequirement`. For jobs run on EC2
1157
- # resource, the number of MiB of memory reserved for the job. This
1158
- # 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. To override memory requirements that are specified in
1163
+ # the `ResourceRequirement` structure in the job definition,
1164
+ # `ResourceRequirement` must be specified in the `SubmitJob` request,
1165
+ # with `type` set to `MEMORY` and `value` set to the new value.
1166
+ #
1167
+ # This parameter is supported for jobs that run on EC2 resources, but
1168
+ # isn't supported for jobs that run on Fargate resources. For these
1169
+ # resources, use `resourceRequirement` instead.
1159
1170
  # @return [Integer]
1160
1171
  #
1161
1172
  # @!attribute [rw] command
@@ -1167,7 +1178,7 @@ module Aws::Batch
1167
1178
  # The instance type to use for a multi-node parallel job.
1168
1179
  #
1169
1180
  # <note markdown="1"> This parameter isn't applicable to single-node container jobs or
1170
- # for jobs running on Fargate resources and shouldn't be provided.
1181
+ # jobs that run on Fargate resources, and shouldn't be provided.
1171
1182
  #
1172
1183
  # </note>
1173
1184
  # @return [String]
@@ -1179,7 +1190,7 @@ module Aws::Batch
1179
1190
  # Docker image or the job definition.
1180
1191
  #
1181
1192
  # <note markdown="1"> Environment variables must not start with `AWS_BATCH`; this naming
1182
- # convention is reserved for variables that are set by the AWS Batch
1193
+ # convention is reserved for variables that are set by the Batch
1183
1194
  # service.
1184
1195
  #
1185
1196
  # </note>
@@ -1223,6 +1234,16 @@ module Aws::Batch
1223
1234
  # source_path: "String",
1224
1235
  # },
1225
1236
  # name: "String",
1237
+ # efs_volume_configuration: {
1238
+ # file_system_id: "String", # required
1239
+ # root_directory: "String",
1240
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
1241
+ # transit_encryption_port: 1,
1242
+ # authorization_config: {
1243
+ # access_point_id: "String",
1244
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
1245
+ # },
1246
+ # },
1226
1247
  # },
1227
1248
  # ],
1228
1249
  # environment: [
@@ -1338,21 +1359,21 @@ module Aws::Batch
1338
1359
  # @return [String]
1339
1360
  #
1340
1361
  # @!attribute [rw] vcpus
1341
- # This parameter is deprecated and not supported for jobs run on
1342
- # Fargate resources, see `resourceRequirement`. The number of vCPUs
1343
- # reserved for the container. Jobs running on EC2 resources can
1344
- # specify the vCPU requirement for the job using
1345
- # `resourceRequirements` but the vCPU requirements can't be specified
1346
- # both here and in the `resourceRequirement` structure. This parameter
1347
- # maps to `CpuShares` in the [Create a container][1] section of the
1348
- # [Docker Remote API][2] and the `--cpu-shares` option to [docker
1349
- # run][3]. Each vCPU is equivalent to 1,024 CPU shares. You must
1350
- # specify at least one vCPU. This is required but can be specified in
1351
- # several places. It must be specified for each node at least once.
1352
- #
1353
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
1354
- # resources and shouldn't be provided. Jobs running on Fargate
1355
- # resources must specify the vCPU requirement for the job using
1362
+ # The number of vCPUs reserved for the job. Each vCPU is equivalent to
1363
+ # 1,024 CPU shares. This parameter maps to `CpuShares` in the [Create
1364
+ # a container][1] section of the [Docker Remote API][2] and the
1365
+ # `--cpu-shares` option to [docker run][3]. The number of vCPUs must
1366
+ # be specified but can be specified in several places. You must
1367
+ # specify it at least once for each node.
1368
+ #
1369
+ # This parameter is supported on EC2 resources but isn't supported
1370
+ # for jobs that run on Fargate resources. For these resources, use
1371
+ # `resourceRequirement` instead. You can use this parameter or
1372
+ # `resourceRequirements` structure but not both.
1373
+ #
1374
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
1375
+ # resources and shouldn't be provided. For jobs that run on Fargate
1376
+ # resources, you must specify the vCPU requirement for the job using
1356
1377
  # `resourceRequirements`.
1357
1378
  #
1358
1379
  # </note>
@@ -1365,21 +1386,25 @@ module Aws::Batch
1365
1386
  # @return [Integer]
1366
1387
  #
1367
1388
  # @!attribute [rw] memory
1368
- # This parameter is deprecated and not supported for jobs run on
1369
- # Fargate resources, use `ResourceRequirement`. For jobs run on EC2
1370
- # resources can specify the memory requirement using the
1371
- # `ResourceRequirement` structure. The hard limit (in MiB) of memory
1372
- # to present to the container. If your container attempts to exceed
1373
- # the memory specified here, the container is killed. This parameter
1374
- # maps to `Memory` in the [Create a container][1] section of the
1375
- # [Docker Remote API][2] and the `--memory` option to [docker run][3].
1376
- # You must specify at least 4 MiB of memory for a job. This is
1377
- # required but can be specified in several places; it must be
1378
- # specified for each node at least once.
1389
+ # This parameter indicates the memory hard limit (in MiB) for a
1390
+ # container. If your container attempts to exceed the specified
1391
+ # number, it's terminated. You must specify at least 4 MiB of memory
1392
+ # for a job using this parameter. The memory hard limit can be
1393
+ # specified in several places. It must be specified for each node at
1394
+ # least once.
1395
+ #
1396
+ # This parameter maps to `Memory` in the [Create a container][1]
1397
+ # section of the [Docker Remote API][2] and the `--memory` option to
1398
+ # [docker run][3].
1399
+ #
1400
+ # This parameter is supported on EC2 resources but isn't supported on
1401
+ # Fargate resources. For Fargate resources, you should specify the
1402
+ # memory requirement using `resourceRequirement`. You can also do this
1403
+ # for EC2 resources.
1379
1404
  #
1380
1405
  # <note markdown="1"> If you're trying to maximize your resource utilization by providing
1381
1406
  # your jobs as much memory as possible for a particular instance type,
1382
- # see [Memory Management][4] in the *AWS Batch User Guide*.
1407
+ # see [Memory Management][4] in the *Batch User Guide*.
1383
1408
  #
1384
1409
  # </note>
1385
1410
  #
@@ -1408,9 +1433,9 @@ module Aws::Batch
1408
1433
  #
1409
1434
  # @!attribute [rw] job_role_arn
1410
1435
  # The Amazon Resource Name (ARN) of the IAM role that the container
1411
- # can assume for AWS permissions. For more information, see [IAM Roles
1412
- # for Tasks][1] in the *Amazon Elastic Container Service Developer
1413
- # Guide*.
1436
+ # can assume for Amazon Web Services permissions. For more
1437
+ # information, see [IAM Roles for Tasks][1] in the *Amazon Elastic
1438
+ # Container Service Developer Guide*.
1414
1439
  #
1415
1440
  #
1416
1441
  #
@@ -1418,10 +1443,10 @@ module Aws::Batch
1418
1443
  # @return [String]
1419
1444
  #
1420
1445
  # @!attribute [rw] execution_role_arn
1421
- # The Amazon Resource Name (ARN) of the execution role that AWS Batch
1422
- # can assume. Jobs running on Fargate resources must provide an
1423
- # execution role. For more information, see [AWS Batch execution IAM
1424
- # role][1] in the *AWS Batch User Guide*.
1446
+ # The Amazon Resource Name (ARN) of the execution role that Batch can
1447
+ # assume. For jobs that run on Fargate resources, you must provide an
1448
+ # execution role. For more information, see [Batch execution IAM
1449
+ # role][1] in the *Batch User Guide*.
1425
1450
  #
1426
1451
  #
1427
1452
  #
@@ -1441,7 +1466,7 @@ module Aws::Batch
1441
1466
  # sensitive information, such as credential data.
1442
1467
  #
1443
1468
  # <note markdown="1"> Environment variables must not start with `AWS_BATCH`; this naming
1444
- # convention is reserved for variables that are set by the AWS Batch
1469
+ # convention is reserved for variables that are set by the Batch
1445
1470
  # service.
1446
1471
  #
1447
1472
  # </note>
@@ -1485,7 +1510,7 @@ module Aws::Batch
1485
1510
  # `--privileged` option to [docker run][3]. The default value is
1486
1511
  # false.
1487
1512
  #
1488
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
1513
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
1489
1514
  # resources and shouldn't be provided, or specified as false.
1490
1515
  #
1491
1516
  # </note>
@@ -1502,7 +1527,7 @@ module Aws::Batch
1502
1527
  # `Ulimits` in the [Create a container][1] section of the [Docker
1503
1528
  # Remote API][2] and the `--ulimit` option to [docker run][3].
1504
1529
  #
1505
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
1530
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
1506
1531
  # resources and shouldn't be provided.
1507
1532
  #
1508
1533
  # </note>
@@ -1531,7 +1556,7 @@ module Aws::Batch
1531
1556
  # groups in a multi-node parallel job must use the same instance type.
1532
1557
  #
1533
1558
  # <note markdown="1"> This parameter isn't applicable to single-node container jobs or
1534
- # for jobs running on Fargate resources and shouldn't be provided.
1559
+ # jobs that run on Fargate resources, and shouldn't be provided.
1535
1560
  #
1536
1561
  # </note>
1537
1562
  # @return [String]
@@ -1561,9 +1586,8 @@ module Aws::Batch
1561
1586
  # options for different supported log drivers, see [Configure logging
1562
1587
  # drivers][4] in the Docker documentation.
1563
1588
  #
1564
- # <note markdown="1"> AWS Batch currently supports a subset of the logging drivers
1565
- # available to the Docker daemon (shown in the LogConfiguration data
1566
- # type).
1589
+ # <note markdown="1"> Batch currently supports a subset of the logging drivers available
1590
+ # to the Docker daemon (shown in the LogConfiguration data type).
1567
1591
  #
1568
1592
  # </note>
1569
1593
  #
@@ -1594,7 +1618,7 @@ module Aws::Batch
1594
1618
  #
1595
1619
  # @!attribute [rw] secrets
1596
1620
  # The secrets for the container. For more information, see [Specifying
1597
- # sensitive data][1] in the *AWS Batch User Guide*.
1621
+ # sensitive data][1] in the *Batch User Guide*.
1598
1622
  #
1599
1623
  #
1600
1624
  #
@@ -1602,13 +1626,15 @@ module Aws::Batch
1602
1626
  # @return [Array<Types::Secret>]
1603
1627
  #
1604
1628
  # @!attribute [rw] network_configuration
1605
- # The network configuration for jobs running on Fargate resources.
1606
- # Jobs running on EC2 resources must not specify this parameter.
1629
+ # The network configuration for jobs that are running on Fargate
1630
+ # resources. Jobs that are running on EC2 resources must not specify
1631
+ # this parameter.
1607
1632
  # @return [Types::NetworkConfiguration]
1608
1633
  #
1609
1634
  # @!attribute [rw] fargate_platform_configuration
1610
- # The platform configuration for jobs running on Fargate resources.
1611
- # Jobs running on EC2 resources must not specify this parameter.
1635
+ # The platform configuration for jobs that are running on Fargate
1636
+ # resources. Jobs that are running on EC2 resources must not specify
1637
+ # this parameter.
1612
1638
  # @return [Types::FargatePlatformConfiguration]
1613
1639
  #
1614
1640
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ContainerProperties AWS API Documentation
@@ -1697,7 +1723,7 @@ module Aws::Batch
1697
1723
  # },
1698
1724
  # ],
1699
1725
  # },
1700
- # service_role: "String", # required
1726
+ # service_role: "String",
1701
1727
  # tags: {
1702
1728
  # "TagKey" => "TagValue",
1703
1729
  # },
@@ -1710,8 +1736,8 @@ module Aws::Batch
1710
1736
  #
1711
1737
  # @!attribute [rw] type
1712
1738
  # The type of the compute environment: `MANAGED` or `UNMANAGED`. For
1713
- # more information, see [Compute Environments][1] in the *AWS Batch
1714
- # User Guide*.
1739
+ # more information, see [Compute Environments][1] in the *Batch User
1740
+ # Guide*.
1715
1741
  #
1716
1742
  #
1717
1743
  #
@@ -1723,13 +1749,13 @@ module Aws::Batch
1723
1749
  # then the compute environment accepts jobs from a queue and can scale
1724
1750
  # out automatically based on queues.
1725
1751
  #
1726
- # If the state is `ENABLED`, then the AWS Batch scheduler can attempt
1727
- # to place jobs from an associated job queue on the compute resources
1752
+ # If the state is `ENABLED`, then the Batch scheduler can attempt to
1753
+ # place jobs from an associated job queue on the compute resources
1728
1754
  # within the environment. If the compute environment is managed, then
1729
1755
  # it can scale its instances out or in automatically, based on the job
1730
1756
  # queue demand.
1731
1757
  #
1732
- # If the state is `DISABLED`, then the AWS Batch scheduler doesn't
1758
+ # If the state is `DISABLED`, then the Batch scheduler doesn't
1733
1759
  # attempt to place jobs within the environment. Jobs in a `STARTING`
1734
1760
  # or `RUNNING` state continue to progress normally. Managed compute
1735
1761
  # environments in the `DISABLED` state don't scale out. However, they
@@ -1740,7 +1766,7 @@ module Aws::Batch
1740
1766
  # Details about the compute resources managed by the compute
1741
1767
  # environment. This parameter is required for managed compute
1742
1768
  # environments. For more information, see [Compute Environments][1] in
1743
- # the *AWS Batch User Guide*.
1769
+ # the *Batch User Guide*.
1744
1770
  #
1745
1771
  #
1746
1772
  #
@@ -1748,34 +1774,45 @@ module Aws::Batch
1748
1774
  # @return [Types::ComputeResource]
1749
1775
  #
1750
1776
  # @!attribute [rw] service_role
1751
- # The full Amazon Resource Name (ARN) of the IAM role that allows AWS
1752
- # Batch to make calls to other AWS services on your behalf. For more
1753
- # information, see [AWS Batch service IAM role][1] in the *AWS Batch
1754
- # User Guide*.
1777
+ # The full Amazon Resource Name (ARN) of the IAM role that allows
1778
+ # Batch to make calls to other Amazon Web Services services on your
1779
+ # behalf. For more information, see [Batch service IAM role][1] in the
1780
+ # *Batch User Guide*.
1781
+ #
1782
+ # If your account already created the Batch service-linked role, that
1783
+ # role is used by default for your compute environment unless you
1784
+ # specify a different role here. If the Batch service-linked role
1785
+ # doesn't exist in your account, and no role is specified here, the
1786
+ # service attempts to create the Batch service-linked role in your
1787
+ # account.
1755
1788
  #
1756
1789
  # If your specified role has a path other than `/`, then you must
1757
- # either specify the full role ARN (this is recommended) or prefix the
1758
- # role name with the path.
1790
+ # specify either the full role ARN (recommended) or prefix the role
1791
+ # name with the path. For example, if a role with the name `bar` has a
1792
+ # path of `/foo/` then you would specify `/foo/bar` as the role name.
1793
+ # For more information, see [Friendly names and paths][2] in the *IAM
1794
+ # User Guide*.
1759
1795
  #
1760
- # <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN
1761
- # might contain the `service-role` path prefix. When you only specify
1762
- # the name of the service role, AWS Batch assumes that your ARN
1763
- # doesn't use the `service-role` path prefix. Because of this, we
1764
- # recommend that you specify the full ARN of your service role when
1765
- # you create compute environments.
1796
+ # <note markdown="1"> Depending on how you created your Batch service role, its ARN might
1797
+ # contain the `service-role` path prefix. When you only specify the
1798
+ # name of the service role, Batch assumes that your ARN doesn't use
1799
+ # the `service-role` path prefix. Because of this, we recommend that
1800
+ # you specify the full ARN of your service role when you create
1801
+ # compute environments.
1766
1802
  #
1767
1803
  # </note>
1768
1804
  #
1769
1805
  #
1770
1806
  #
1771
1807
  # [1]: https://docs.aws.amazon.com/batch/latest/userguide/service_IAM_role.html
1808
+ # [2]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-friendly-names
1772
1809
  # @return [String]
1773
1810
  #
1774
1811
  # @!attribute [rw] tags
1775
1812
  # The tags that you apply to the compute environment to help you
1776
1813
  # categorize and organize your resources. Each tag consists of a key
1777
- # and an optional value. For more information, see [Tagging AWS
1778
- # Resources][1] in *AWS General Reference*.
1814
+ # and an optional value. For more information, see [Tagging Amazon Web
1815
+ # Services Resources][1] in *Amazon Web Services General Reference*.
1779
1816
  #
1780
1817
  # These tags can be updated or removed using the [TagResource][2] and
1781
1818
  # [UntagResource][3] API operations. These tags don't propagate to
@@ -1859,7 +1896,7 @@ module Aws::Batch
1859
1896
  # priority value of `10` is given scheduling preference over a job
1860
1897
  # queue with a priority value of `1`. All of the compute environments
1861
1898
  # must be either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or
1862
- # `FARGATE_SPOT`); EC2 and Fargate compute environments cannot be
1899
+ # `FARGATE_SPOT`); EC2 and Fargate compute environments can't be
1863
1900
  # mixed.
1864
1901
  # @return [Integer]
1865
1902
  #
@@ -1875,8 +1912,8 @@ module Aws::Batch
1875
1912
  # can't be mixed.
1876
1913
  #
1877
1914
  # <note markdown="1"> All compute environments that are associated with a job queue must
1878
- # share the same architecture. AWS Batch doesn't support mixing
1879
- # compute environment architecture types in a single job queue.
1915
+ # share the same architecture. Batch doesn't support mixing compute
1916
+ # environment architecture types in a single job queue.
1880
1917
  #
1881
1918
  # </note>
1882
1919
  # @return [Array<Types::ComputeEnvironmentOrder>]
@@ -1884,8 +1921,8 @@ module Aws::Batch
1884
1921
  # @!attribute [rw] tags
1885
1922
  # The tags that you apply to the job queue to help you categorize and
1886
1923
  # organize your resources. Each tag consists of a key and an optional
1887
- # value. For more information, see [Tagging your AWS Batch
1888
- # resources][1] in *AWS Batch User Guide*.
1924
+ # value. For more information, see [Tagging your Batch resources][1]
1925
+ # in *Batch User Guide*.
1889
1926
  #
1890
1927
  #
1891
1928
  #
@@ -2086,15 +2123,18 @@ module Aws::Batch
2086
2123
  # }
2087
2124
  #
2088
2125
  # @!attribute [rw] job_definitions
2089
- # A list of up to 100 job definition names or full Amazon Resource
2090
- # Name (ARN) entries.
2126
+ # A list of up to 100 job definitions. Each entry in the list can
2127
+ # either be an ARN of the form
2128
+ # `arn:aws:batch:$\{Region\}:$\{Account\}:job-definition/$\{JobDefinitionName\}:$\{Revision\}`
2129
+ # or a short version using the form
2130
+ # `$\{JobDefinitionName\}:$\{Revision\}`.
2091
2131
  # @return [Array<String>]
2092
2132
  #
2093
2133
  # @!attribute [rw] max_results
2094
2134
  # The maximum number of results returned by `DescribeJobDefinitions`
2095
2135
  # in paginated output. When this parameter is used,
2096
2136
  # `DescribeJobDefinitions` only returns `maxResults` results in a
2097
- # single page along with a `nextToken` response element. The remaining
2137
+ # single page and a `nextToken` response element. The remaining
2098
2138
  # results of the initial request can be seen by sending another
2099
2139
  # `DescribeJobDefinitions` request with the returned `nextToken`
2100
2140
  # value. This value can be between 1 and 100. If this parameter isn't
@@ -2177,12 +2217,12 @@ module Aws::Batch
2177
2217
  # @!attribute [rw] max_results
2178
2218
  # The maximum number of results returned by `DescribeJobQueues` in
2179
2219
  # paginated output. When this parameter is used, `DescribeJobQueues`
2180
- # only returns `maxResults` results in a single page along with a
2181
- # `nextToken` response element. The remaining results of the initial
2182
- # request can be seen by sending another `DescribeJobQueues` request
2183
- # with the returned `nextToken` value. This value can be between 1 and
2184
- # 100. If this parameter isn't used, then `DescribeJobQueues` returns
2185
- # up to 100 results and a `nextToken` value if applicable.
2220
+ # only returns `maxResults` results in a single page and a `nextToken`
2221
+ # response element. The remaining results of the initial request can
2222
+ # be seen by sending another `DescribeJobQueues` request with the
2223
+ # returned `nextToken` value. This value can be between 1 and 100. If
2224
+ # this parameter isn't used, then `DescribeJobQueues` returns up to
2225
+ # 100 results and a `nextToken` value if applicable.
2186
2226
  # @return [Integer]
2187
2227
  #
2188
2228
  # @!attribute [rw] next_token
@@ -2266,8 +2306,8 @@ module Aws::Batch
2266
2306
 
2267
2307
  # An object representing a container instance host device.
2268
2308
  #
2269
- # <note markdown="1"> This object isn't applicable to jobs running on Fargate resources and
2270
- # shouldn't be provided.
2309
+ # <note markdown="1"> This object isn't applicable to jobs that are running on Fargate
2310
+ # resources and shouldn't be provided.
2271
2311
  #
2272
2312
  # </note>
2273
2313
  #
@@ -2285,8 +2325,8 @@ module Aws::Batch
2285
2325
  # @return [String]
2286
2326
  #
2287
2327
  # @!attribute [rw] container_path
2288
- # The path inside the container used to expose the host device. By
2289
- # default the `hostPath` value is used.
2328
+ # The path inside the container that's used to expose the host
2329
+ # device. By default, the `hostPath` value is used.
2290
2330
  # @return [String]
2291
2331
  #
2292
2332
  # @!attribute [rw] permissions
@@ -2305,14 +2345,153 @@ module Aws::Batch
2305
2345
  include Aws::Structure
2306
2346
  end
2307
2347
 
2348
+ # The authorization configuration details for the Amazon EFS file
2349
+ # system.
2350
+ #
2351
+ # @note When making an API call, you may pass EFSAuthorizationConfig
2352
+ # data as a hash:
2353
+ #
2354
+ # {
2355
+ # access_point_id: "String",
2356
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
2357
+ # }
2358
+ #
2359
+ # @!attribute [rw] access_point_id
2360
+ # The Amazon EFS access point ID to use. If an access point is
2361
+ # specified, the root directory value specified in the
2362
+ # `EFSVolumeConfiguration` must either be omitted or set to `/` which
2363
+ # will enforce the path set on the EFS access point. If an access
2364
+ # point is used, transit encryption must be enabled in the
2365
+ # `EFSVolumeConfiguration`. For more information, see [Working with
2366
+ # Amazon EFS Access Points][1] in the *Amazon Elastic File System User
2367
+ # Guide*.
2368
+ #
2369
+ #
2370
+ #
2371
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html
2372
+ # @return [String]
2373
+ #
2374
+ # @!attribute [rw] iam
2375
+ # Whether or not to use the Batch job IAM role defined in a job
2376
+ # definition when mounting the Amazon EFS file system. If enabled,
2377
+ # transit encryption must be enabled in the `EFSVolumeConfiguration`.
2378
+ # If this parameter is omitted, the default value of `DISABLED` is
2379
+ # used. For more information, see [Using Amazon EFS Access Points][1]
2380
+ # in the *Batch User Guide*. EFS IAM authorization requires that
2381
+ # `TransitEncryption` be `ENABLED` and that a `JobRoleArn` is
2382
+ # specified.
2383
+ #
2384
+ #
2385
+ #
2386
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/efs-volumes.html#efs-volume-accesspoints
2387
+ # @return [String]
2388
+ #
2389
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/EFSAuthorizationConfig AWS API Documentation
2390
+ #
2391
+ class EFSAuthorizationConfig < Struct.new(
2392
+ :access_point_id,
2393
+ :iam)
2394
+ SENSITIVE = []
2395
+ include Aws::Structure
2396
+ end
2397
+
2398
+ # This is used when you're using an Amazon Elastic File System file
2399
+ # system for job storage. For more information, see [Amazon EFS
2400
+ # Volumes][1] in the *Batch User Guide*.
2401
+ #
2402
+ #
2403
+ #
2404
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/efs-volumes.html
2405
+ #
2406
+ # @note When making an API call, you may pass EFSVolumeConfiguration
2407
+ # data as a hash:
2408
+ #
2409
+ # {
2410
+ # file_system_id: "String", # required
2411
+ # root_directory: "String",
2412
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
2413
+ # transit_encryption_port: 1,
2414
+ # authorization_config: {
2415
+ # access_point_id: "String",
2416
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
2417
+ # },
2418
+ # }
2419
+ #
2420
+ # @!attribute [rw] file_system_id
2421
+ # The Amazon EFS file system ID to use.
2422
+ # @return [String]
2423
+ #
2424
+ # @!attribute [rw] root_directory
2425
+ # The directory within the Amazon EFS file system to mount as the root
2426
+ # directory inside the host. If this parameter is omitted, the root of
2427
+ # the Amazon EFS volume is used instead. Specifying `/` has the same
2428
+ # effect as omitting this parameter. The maximum length is 4,096
2429
+ # characters.
2430
+ #
2431
+ # If an EFS access point is specified in the `authorizationConfig`,
2432
+ # the root directory parameter must either be omitted or set to `/`,
2433
+ # which enforces the path set on the Amazon EFS access point.
2434
+ # @return [String]
2435
+ #
2436
+ # @!attribute [rw] transit_encryption
2437
+ # Determines whether to enable encryption for Amazon EFS data in
2438
+ # transit between the Amazon ECS host and the Amazon EFS server.
2439
+ # Transit encryption must be enabled if Amazon EFS IAM authorization
2440
+ # is used. If this parameter is omitted, the default value of
2441
+ # `DISABLED` is used. For more information, see [Encrypting data in
2442
+ # transit][1] in the *Amazon Elastic File System User Guide*.
2443
+ #
2444
+ #
2445
+ #
2446
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/encryption-in-transit.html
2447
+ # @return [String]
2448
+ #
2449
+ # @!attribute [rw] transit_encryption_port
2450
+ # The port to use when sending encrypted data between the Amazon ECS
2451
+ # host and the Amazon EFS server. If you don't specify a transit
2452
+ # encryption port, it uses the port selection strategy that the Amazon
2453
+ # EFS mount helper uses. The value must be between 0 and 65,535. For
2454
+ # more information, see [EFS Mount Helper][1] in the *Amazon Elastic
2455
+ # File System User Guide*.
2456
+ #
2457
+ #
2458
+ #
2459
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-mount-helper.html
2460
+ # @return [Integer]
2461
+ #
2462
+ # @!attribute [rw] authorization_config
2463
+ # The authorization configuration details for the Amazon EFS file
2464
+ # system.
2465
+ # @return [Types::EFSAuthorizationConfig]
2466
+ #
2467
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/EFSVolumeConfiguration AWS API Documentation
2468
+ #
2469
+ class EFSVolumeConfiguration < Struct.new(
2470
+ :file_system_id,
2471
+ :root_directory,
2472
+ :transit_encryption,
2473
+ :transit_encryption_port,
2474
+ :authorization_config)
2475
+ SENSITIVE = []
2476
+ include Aws::Structure
2477
+ end
2478
+
2308
2479
  # Provides information used to select Amazon Machine Images (AMIs) for
2309
- # instances in the compute environment. If the `Ec2Configuration` isn't
2310
- # specified, the default is `ECS_AL1`.
2480
+ # instances in the compute environment. If `Ec2Configuration` isn't
2481
+ # specified, the default is currently `ECS_AL1` ([Amazon Linux][1]) for
2482
+ # non-GPU, non AWSGraviton instances. Starting on March 31, 2021, this
2483
+ # default will be changing to `ECS_AL2` ([Amazon Linux 2][2]).
2311
2484
  #
2312
- # <note markdown="1"> This object isn't applicable to jobs running on Fargate resources.
2485
+ # <note markdown="1"> This object isn't applicable to jobs that are running on Fargate
2486
+ # resources.
2313
2487
  #
2314
2488
  # </note>
2315
2489
  #
2490
+ #
2491
+ #
2492
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html#alami
2493
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html#al2ami
2494
+ #
2316
2495
  # @note When making an API call, you may pass Ec2Configuration
2317
2496
  # data as a hash:
2318
2497
  #
@@ -2324,25 +2503,28 @@ module Aws::Batch
2324
2503
  # @!attribute [rw] image_type
2325
2504
  # The image type to match with the instance type to select an AMI. If
2326
2505
  # the `imageIdOverride` parameter isn't specified, then a recent
2327
- # [Amazon ECS-optimized AMI][1] is used.
2506
+ # [Amazon ECS-optimized AMI][1] (`ECS_AL1`) is used. Starting on March
2507
+ # 31, 2021, this default will be changing to `ECS_AL2` ([Amazon Linux
2508
+ # 2][2]).
2328
2509
  #
2329
2510
  # ECS\_AL2
2330
2511
  #
2331
- # : [Amazon Linux 2][2]− Default for all AWS Graviton-based instance
2332
- # families (for example, `C6g`, `M6g`, `R6g`, and `T4g`) and can be
2333
- # used for all non-GPU instance types.
2512
+ # : [Amazon Linux 2][2]− Default for all Amazon Web Services
2513
+ # Graviton-based instance families (for example, `C6g`, `M6g`,
2514
+ # `R6g`, and `T4g`) and can be used for all non-GPU instance types.
2334
2515
  #
2335
2516
  # ECS\_AL2\_NVIDIA
2336
2517
  #
2337
2518
  # : [Amazon Linux 2 (GPU)][3]−Default for all GPU instance families
2338
- # (for example `P4` and `G4`) and can be used for all non-AWS
2339
- # Graviton-based instance types.
2519
+ # (for example `P4` and `G4`) and can be used for all non Amazon Web
2520
+ # Services Graviton-based instance types.
2340
2521
  #
2341
2522
  # ECS\_AL1
2342
2523
  #
2343
- # : [Amazon Linux][4]−Default for all non-GPU, non-AWS Graviton
2344
- # instance families. Amazon Linux is reaching the end-of-life of
2345
- # standard support. For more information, see [Amazon Linux AMI][5].
2524
+ # : [Amazon Linux][4]−Default for all non-GPU, non Amazon Web Services
2525
+ # Graviton instance families. Amazon Linux is reaching the
2526
+ # end-of-life of standard support. For more information, see [Amazon
2527
+ # Linux AMI][5].
2346
2528
  #
2347
2529
  #
2348
2530
  #
@@ -2383,32 +2565,34 @@ module Aws::Batch
2383
2565
  #
2384
2566
  # @!attribute [rw] on_status_reason
2385
2567
  # Contains a glob pattern to match against the `StatusReason` returned
2386
- # for a job. The patten can be up to 512 characters long, can contain
2387
- # letters, numbers, periods (.), colons (:), and white space (spaces,
2388
- # tabs). and can optionally end with an asterisk (*) so that only the
2389
- # start of the string needs to be an exact match.
2568
+ # for a job. The pattern can be up to 512 characters in length. It can
2569
+ # contain letters, numbers, periods (.), colons (:), and white space
2570
+ # (including spaces or tabs). It can optionally end with an asterisk
2571
+ # (*) so that only the start of the string needs to be an exact
2572
+ # match.
2390
2573
  # @return [String]
2391
2574
  #
2392
2575
  # @!attribute [rw] on_reason
2393
2576
  # Contains a glob pattern to match against the `Reason` returned for a
2394
- # job. The patten can be up to 512 characters long, can contain
2395
- # letters, numbers, periods (.), colons (:), and white space (spaces,
2396
- # tabs), and can optionally end with an asterisk (*) so that only the
2397
- # start of the string needs to be an exact match.
2577
+ # job. The pattern can be up to 512 characters in length. It can
2578
+ # contain letters, numbers, periods (.), colons (:), and white space
2579
+ # (including spaces and tabs). It can optionally end with an asterisk
2580
+ # (*) so that only the start of the string needs to be an exact
2581
+ # match.
2398
2582
  # @return [String]
2399
2583
  #
2400
2584
  # @!attribute [rw] on_exit_code
2401
2585
  # Contains a glob pattern to match against the decimal representation
2402
- # of the `ExitCode` returned for a job. The patten can be up to 512
2403
- # characters long, can contain only numbers, and can optionally end
2404
- # with an asterisk (*) so that only the start of the string needs to
2405
- # be an exact match.
2586
+ # of the `ExitCode` returned for a job. The pattern can be up to 512
2587
+ # characters in length. It can contain only numbers, and can
2588
+ # optionally end with an asterisk (*) so that only the start of the
2589
+ # string needs to be an exact match.
2406
2590
  # @return [String]
2407
2591
  #
2408
2592
  # @!attribute [rw] action
2409
2593
  # Specifies the action to take if all of the specified conditions
2410
2594
  # (`onStatusReason`, `onReason`, and `onExitCode`) are met. The values
2411
- # are not case sensitive.
2595
+ # aren't case sensitive.
2412
2596
  # @return [String]
2413
2597
  #
2414
2598
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/EvaluateOnExit AWS API Documentation
@@ -2422,8 +2606,9 @@ module Aws::Batch
2422
2606
  include Aws::Structure
2423
2607
  end
2424
2608
 
2425
- # The platform configuration for jobs running on Fargate resources. Jobs
2426
- # running on EC2 resources must not specify this parameter.
2609
+ # The platform configuration for jobs that are running on Fargate
2610
+ # resources. Jobs that run on EC2 resources must not specify this
2611
+ # parameter.
2427
2612
  #
2428
2613
  # @note When making an API call, you may pass FargatePlatformConfiguration
2429
2614
  # data as a hash:
@@ -2433,13 +2618,13 @@ module Aws::Batch
2433
2618
  # }
2434
2619
  #
2435
2620
  # @!attribute [rw] platform_version
2436
- # The AWS Fargate platform version on which the jobs are running. A
2437
- # platform version is specified only for jobs running on Fargate
2621
+ # The Fargate platform version where the jobs are running. A platform
2622
+ # version is specified only for jobs that are running on Fargate
2438
2623
  # resources. If one isn't specified, the `LATEST` platform version is
2439
- # used by default. This will use a recent, approved version of the AWS
2440
- # Fargate platform for compute resources. For more information, see
2441
- # [AWS Fargate platform versions][1] in the *Amazon Elastic Container
2442
- # Service Developer Guide*.
2624
+ # used by default. This uses a recent, approved version of the Fargate
2625
+ # platform for compute resources. For more information, see [Fargate
2626
+ # platform versions][1] in the *Amazon Elastic Container Service
2627
+ # Developer Guide*.
2443
2628
  #
2444
2629
  #
2445
2630
  #
@@ -2473,11 +2658,11 @@ module Aws::Batch
2473
2658
  # assigned a host path for you. If this parameter contains a file
2474
2659
  # location, then the data volume persists at the specified location on
2475
2660
  # the host container instance until you delete it manually. If the
2476
- # source path location does not exist on the host container instance,
2661
+ # source path location doesn't exist on the host container instance,
2477
2662
  # the Docker daemon creates it. If the location does exist, the
2478
2663
  # contents of the source path folder are exported.
2479
2664
  #
2480
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
2665
+ # <note markdown="1"> This parameter isn't applicable to jobs that run on Fargate
2481
2666
  # resources and shouldn't be provided.
2482
2667
  #
2483
2668
  # </note>
@@ -2491,7 +2676,7 @@ module Aws::Batch
2491
2676
  include Aws::Structure
2492
2677
  end
2493
2678
 
2494
- # An object representing an AWS Batch job definition.
2679
+ # An object representing an Batch job definition.
2495
2680
  #
2496
2681
  # @!attribute [rw] job_definition_name
2497
2682
  # The name of the job definition.
@@ -2513,7 +2698,7 @@ module Aws::Batch
2513
2698
  # The type of job definition. If the job is run on Fargate resources,
2514
2699
  # then `multinode` isn't supported. For more information about
2515
2700
  # multi-node parallel jobs, see [Creating a multi-node parallel job
2516
- # definition][1] in the *AWS Batch User Guide*.
2701
+ # definition][1] in the *Batch User Guide*.
2517
2702
  #
2518
2703
  #
2519
2704
  #
@@ -2526,7 +2711,7 @@ module Aws::Batch
2526
2711
  # pair mapping. Parameters in a `SubmitJob` request override any
2527
2712
  # corresponding parameter defaults from the job definition. For more
2528
2713
  # information about specifying parameters, see [Job Definition
2529
- # Parameters][1] in the *AWS Batch User Guide*.
2714
+ # Parameters][1] in the *Batch User Guide*.
2530
2715
  #
2531
2716
  #
2532
2717
  #
@@ -2544,7 +2729,7 @@ module Aws::Batch
2544
2729
  #
2545
2730
  # @!attribute [rw] timeout
2546
2731
  # The timeout configuration for jobs that are submitted with this job
2547
- # definition. You can specify a timeout duration after which AWS Batch
2732
+ # definition. You can specify a timeout duration after which Batch
2548
2733
  # terminates your jobs if they haven't finished.
2549
2734
  # @return [Types::JobTimeout]
2550
2735
  #
@@ -2598,7 +2783,7 @@ module Aws::Batch
2598
2783
  include Aws::Structure
2599
2784
  end
2600
2785
 
2601
- # An object representing an AWS Batch job dependency.
2786
+ # An object representing an Batch job dependency.
2602
2787
  #
2603
2788
  # @note When making an API call, you may pass JobDependency
2604
2789
  # data as a hash:
@@ -2609,7 +2794,7 @@ module Aws::Batch
2609
2794
  # }
2610
2795
  #
2611
2796
  # @!attribute [rw] job_id
2612
- # The job ID of the AWS Batch job associated with this dependency.
2797
+ # The job ID of the Batch job associated with this dependency.
2613
2798
  # @return [String]
2614
2799
  #
2615
2800
  # @!attribute [rw] type
@@ -2625,7 +2810,7 @@ module Aws::Batch
2625
2810
  include Aws::Structure
2626
2811
  end
2627
2812
 
2628
- # An object representing an AWS Batch job.
2813
+ # An object representing an Batch job.
2629
2814
  #
2630
2815
  # @!attribute [rw] job_arn
2631
2816
  # The Amazon Resource Name (ARN) of the job.
@@ -2648,7 +2833,7 @@ module Aws::Batch
2648
2833
  # The current status for the job.
2649
2834
  #
2650
2835
  # <note markdown="1"> If your jobs don't progress to `STARTING`, see [Jobs Stuck in
2651
- # RUNNABLE Status][1] in the troubleshooting section of the *AWS Batch
2836
+ # RUNNABLE Status][1] in the troubleshooting section of the *Batch
2652
2837
  # User Guide*.
2653
2838
  #
2654
2839
  # </note>
@@ -2720,7 +2905,8 @@ module Aws::Batch
2720
2905
  # An object representing the node properties of a multi-node parallel
2721
2906
  # job.
2722
2907
  #
2723
- # <note markdown="1"> This isn't applicable to jobs running on Fargate resources.
2908
+ # <note markdown="1"> This isn't applicable to jobs that are running on Fargate
2909
+ # resources.
2724
2910
  #
2725
2911
  # </note>
2726
2912
  # @return [Types::NodeProperties]
@@ -2740,7 +2926,7 @@ module Aws::Batch
2740
2926
  # @!attribute [rw] propagate_tags
2741
2927
  # Specifies whether to propagate the tags from the job or job
2742
2928
  # definition to the corresponding Amazon ECS task. If no value is
2743
- # specified, the tags are not propagated. Tags can only be propagated
2929
+ # specified, the tags aren't propagated. Tags can only be propagated
2744
2930
  # to the tasks during task creation. For tags with the same name, job
2745
2931
  # tags are given priority over job definitions tags. If the total
2746
2932
  # number of combined tags from the job and job definition is over 50,
@@ -2782,7 +2968,7 @@ module Aws::Batch
2782
2968
  include Aws::Structure
2783
2969
  end
2784
2970
 
2785
- # An object representing the details of an AWS Batch job queue.
2971
+ # An object representing the details of an Batch job queue.
2786
2972
  #
2787
2973
  # @!attribute [rw] job_queue_name
2788
2974
  # The name of the job queue.
@@ -2816,7 +3002,7 @@ module Aws::Batch
2816
3002
  # priority value of `10` is given scheduling preference over a job
2817
3003
  # queue with a priority value of `1`. All of the compute environments
2818
3004
  # must be either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or
2819
- # `FARGATE_SPOT`); EC2 and Fargate compute environments cannot be
3005
+ # `FARGATE_SPOT`); EC2 and Fargate compute environments can't be
2820
3006
  # mixed.
2821
3007
  # @return [Integer]
2822
3008
  #
@@ -2828,7 +3014,7 @@ module Aws::Batch
2828
3014
  #
2829
3015
  # @!attribute [rw] tags
2830
3016
  # The tags applied to the job queue. For more information, see
2831
- # [Tagging your AWS Batch resources][1] in *AWS Batch User Guide*.
3017
+ # [Tagging your Batch resources][1] in *Batch User Guide*.
2832
3018
  #
2833
3019
  #
2834
3020
  #
@@ -2904,11 +3090,16 @@ module Aws::Batch
2904
3090
  # @!attribute [rw] node_properties
2905
3091
  # The node properties for a single node in a job summary list.
2906
3092
  #
2907
- # <note markdown="1"> This isn't applicable to jobs running on Fargate resources.
3093
+ # <note markdown="1"> This isn't applicable to jobs that are running on Fargate
3094
+ # resources.
2908
3095
  #
2909
3096
  # </note>
2910
3097
  # @return [Types::NodePropertiesSummary]
2911
3098
  #
3099
+ # @!attribute [rw] job_definition
3100
+ # The Amazon Resource Name (ARN) of the job definition.
3101
+ # @return [String]
3102
+ #
2912
3103
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/JobSummary AWS API Documentation
2913
3104
  #
2914
3105
  class JobSummary < Struct.new(
@@ -2922,7 +3113,8 @@ module Aws::Batch
2922
3113
  :stopped_at,
2923
3114
  :container,
2924
3115
  :array_properties,
2925
- :node_properties)
3116
+ :node_properties,
3117
+ :job_definition)
2926
3118
  SENSITIVE = []
2927
3119
  include Aws::Structure
2928
3120
  end
@@ -2938,7 +3130,7 @@ module Aws::Batch
2938
3130
  #
2939
3131
  # @!attribute [rw] attempt_duration_seconds
2940
3132
  # The time duration in seconds (measured from the job attempt's
2941
- # `startedAt` timestamp) after which AWS Batch terminates your jobs if
3133
+ # `startedAt` timestamp) after which Batch terminates your jobs if
2942
3134
  # they have not finished. The minimum value for the timeout is 60
2943
3135
  # seconds.
2944
3136
  # @return [Integer]
@@ -2980,6 +3172,34 @@ module Aws::Batch
2980
3172
  include Aws::Structure
2981
3173
  end
2982
3174
 
3175
+ # A filter name and value pair that's used to return a more specific
3176
+ # list of results from a `ListJobs` API operation.
3177
+ #
3178
+ # @note When making an API call, you may pass KeyValuesPair
3179
+ # data as a hash:
3180
+ #
3181
+ # {
3182
+ # name: "String",
3183
+ # values: ["String"],
3184
+ # }
3185
+ #
3186
+ # @!attribute [rw] name
3187
+ # The name of the filter. Filter names are case sensitive.
3188
+ # @return [String]
3189
+ #
3190
+ # @!attribute [rw] values
3191
+ # The filter values.
3192
+ # @return [Array<String>]
3193
+ #
3194
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/KeyValuesPair AWS API Documentation
3195
+ #
3196
+ class KeyValuesPair < Struct.new(
3197
+ :name,
3198
+ :values)
3199
+ SENSITIVE = []
3200
+ include Aws::Structure
3201
+ end
3202
+
2983
3203
  # An object representing a launch template associated with a compute
2984
3204
  # resource. You must specify either the launch template ID or launch
2985
3205
  # template name in the request, but not both.
@@ -2989,7 +3209,8 @@ module Aws::Batch
2989
3209
  # values in the `securityGroupIds` parameter of
2990
3210
  # `CreateComputeEnvironment` will be used.
2991
3211
  #
2992
- # <note markdown="1"> This object isn't applicable to jobs running on Fargate resources.
3212
+ # <note markdown="1"> This object isn't applicable to jobs that are running on Fargate
3213
+ # resources.
2993
3214
  #
2994
3215
  # </note>
2995
3216
  #
@@ -3017,6 +3238,14 @@ module Aws::Batch
3017
3238
  # is used. If the value is `$Default`, the default version of the
3018
3239
  # launch template is used.
3019
3240
  #
3241
+ # After the compute environment is created, the launch template
3242
+ # version that's used isn't changed, even if the `$Default` or
3243
+ # `$Latest` version for the launch template is updated. To use a new
3244
+ # launch template version, create a new compute environment, add the
3245
+ # new compute environment to the existing job queue, remove the old
3246
+ # compute environment from the job queue, and delete the old compute
3247
+ # environment.
3248
+ #
3020
3249
  # Default: `$Default`.
3021
3250
  # @return [String]
3022
3251
  #
@@ -3062,7 +3291,7 @@ module Aws::Batch
3062
3291
  # `Devices` in the [Create a container][1] section of the [Docker
3063
3292
  # Remote API][2] and the `--device` option to [docker run][3].
3064
3293
  #
3065
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
3294
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
3066
3295
  # resources and shouldn't be provided.
3067
3296
  #
3068
3297
  # </note>
@@ -3092,7 +3321,7 @@ module Aws::Batch
3092
3321
  # The value for the size (in MiB) of the `/dev/shm` volume. This
3093
3322
  # parameter maps to the `--shm-size` option to [docker run][1].
3094
3323
  #
3095
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
3324
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
3096
3325
  # resources and shouldn't be provided.
3097
3326
  #
3098
3327
  # </note>
@@ -3107,7 +3336,7 @@ module Aws::Batch
3107
3336
  # mount. This parameter maps to the `--tmpfs` option to [docker
3108
3337
  # run][1].
3109
3338
  #
3110
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
3339
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
3111
3340
  # resources and shouldn't be provided.
3112
3341
  #
3113
3342
  # </note>
@@ -3131,7 +3360,7 @@ module Aws::Batch
3131
3360
  # `maxSwap` value must be set for the `swappiness` parameter to be
3132
3361
  # used.
3133
3362
  #
3134
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
3363
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
3135
3364
  # resources and shouldn't be provided.
3136
3365
  #
3137
3366
  # </note>
@@ -3149,9 +3378,10 @@ module Aws::Batch
3149
3378
  # be swapped very aggressively. Accepted values are whole numbers
3150
3379
  # between `0` and `100`. If the `swappiness` parameter isn't
3151
3380
  # specified, a default value of `60` is used. If a value isn't
3152
- # specified for `maxSwap` then this parameter is ignored. If `maxSwap`
3153
- # is set to 0, the container doesn't use swap. This parameter maps to
3154
- # the `--memory-swappiness` option to [docker run][1].
3381
+ # specified for `maxSwap`, then this parameter is ignored. If
3382
+ # `maxSwap` is set to 0, the container doesn't use swap. This
3383
+ # parameter maps to the `--memory-swappiness` option to [docker
3384
+ # run][1].
3155
3385
  #
3156
3386
  # Consider the following when you use a per-container swap
3157
3387
  # configuration.
@@ -3173,10 +3403,10 @@ module Aws::Batch
3173
3403
  #
3174
3404
  # * If the `maxSwap` and `swappiness` parameters are omitted from a
3175
3405
  # job definition, each container will have a default `swappiness`
3176
- # value of 60 and the total swap usage will be limited to two times
3406
+ # value of 60, and the total swap usage will be limited to two times
3177
3407
  # the memory reservation of the container.
3178
3408
  #
3179
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
3409
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
3180
3410
  # resources and shouldn't be provided.
3181
3411
  #
3182
3412
  # </note>
@@ -3213,6 +3443,12 @@ module Aws::Batch
3213
3443
  # job_status: "SUBMITTED", # accepts SUBMITTED, PENDING, RUNNABLE, STARTING, RUNNING, SUCCEEDED, FAILED
3214
3444
  # max_results: 1,
3215
3445
  # next_token: "String",
3446
+ # filters: [
3447
+ # {
3448
+ # name: "String",
3449
+ # values: ["String"],
3450
+ # },
3451
+ # ],
3216
3452
  # }
3217
3453
  #
3218
3454
  # @!attribute [rw] job_queue
@@ -3232,19 +3468,21 @@ module Aws::Batch
3232
3468
  # @return [String]
3233
3469
  #
3234
3470
  # @!attribute [rw] job_status
3235
- # The job status used to filter jobs in the specified queue. If you
3236
- # don't specify a status, only `RUNNING` jobs are returned.
3471
+ # The job status used to filter jobs in the specified queue. If the
3472
+ # `filters` parameter is specified, the `jobStatus` parameter is
3473
+ # ignored and jobs with any status are returned. If you don't specify
3474
+ # a status, only `RUNNING` jobs are returned.
3237
3475
  # @return [String]
3238
3476
  #
3239
3477
  # @!attribute [rw] max_results
3240
3478
  # The maximum number of results returned by `ListJobs` in paginated
3241
3479
  # output. When this parameter is used, `ListJobs` only returns
3242
- # `maxResults` results in a single page along with a `nextToken`
3243
- # response element. The remaining results of the initial request can
3244
- # be seen by sending another `ListJobs` request with the returned
3245
- # `nextToken` value. This value can be between 1 and 100. If this
3246
- # parameter isn't used, then `ListJobs` returns up to 100 results and
3247
- # a `nextToken` value if applicable.
3480
+ # `maxResults` results in a single page and a `nextToken` response
3481
+ # element. The remaining results of the initial request can be seen by
3482
+ # sending another `ListJobs` request with the returned `nextToken`
3483
+ # value. This value can be between 1 and 100. If this parameter isn't
3484
+ # used, then `ListJobs` returns up to 100 results and a `nextToken`
3485
+ # value if applicable.
3248
3486
  # @return [Integer]
3249
3487
  #
3250
3488
  # @!attribute [rw] next_token
@@ -3261,6 +3499,56 @@ module Aws::Batch
3261
3499
  # </note>
3262
3500
  # @return [String]
3263
3501
  #
3502
+ # @!attribute [rw] filters
3503
+ # The filter to apply to the query. Only one filter can be used at a
3504
+ # time. When the filter is used, `jobStatus` is ignored. The filter
3505
+ # doesn't apply to child jobs in an array or multi-node parallel
3506
+ # (MNP) jobs. The results are sorted by the `createdAt` field, with
3507
+ # the most recent jobs being first.
3508
+ #
3509
+ # JOB\_NAME
3510
+ #
3511
+ # : The value of the filter is a case-insensitive match for the job
3512
+ # name. If the value ends with an asterisk (*), the filter will
3513
+ # match any job name that begins with the string before the '*'.
3514
+ # This corresponds to the `jobName` value. For example, `test1`
3515
+ # matches both `Test1` and `test1`, and `test1*` matches both
3516
+ # `test1` and `Test10`. When the `JOB_NAME` filter is used, the
3517
+ # results are grouped by the job name and version.
3518
+ #
3519
+ # JOB\_DEFINITION
3520
+ #
3521
+ # : The value for the filter is the name or Amazon Resource Name (ARN)
3522
+ # of the job definition. This corresponds to the `jobDefinition`
3523
+ # value. The value is case sensitive. When the value for the filter
3524
+ # is the job definition name, the results include all the jobs that
3525
+ # used any revision of that job definition name. If the value ends
3526
+ # with an asterisk (*), the filter will match any job definition
3527
+ # name that begins with the string before the '*'. For example,
3528
+ # `jd1` matches only `jd1`, and `jd1*` matches both `jd1` and
3529
+ # `jd1A`. The version of the job definition that's used doesn't
3530
+ # affect the sort order. When the `JOB_DEFINITION` filter is used
3531
+ # and the ARN is used (which is in the form
3532
+ # `arn:$\{Partition\}:batch:$\{Region\}:$\{Account\}:job-definition/$\{JobDefinitionName\}:$\{Revision\}`),
3533
+ # the results include jobs that used the specified revision of the
3534
+ # job definition. Asterisk (*) is not supported when the ARN is
3535
+ # used.
3536
+ #
3537
+ # BEFORE\_CREATED\_AT
3538
+ #
3539
+ # : The value for the filter is the time that's before the job was
3540
+ # created. This corresponds to the `createdAt` value. The value is a
3541
+ # string representation of the number of seconds since 00:00:00 UTC
3542
+ # (midnight) on January 1, 1970.
3543
+ #
3544
+ # AFTER\_CREATED\_AT
3545
+ #
3546
+ # : The value for the filter is the time that's after the job was
3547
+ # created. This corresponds to the `createdAt` value. The value is a
3548
+ # string representation of the number of seconds since 00:00:00 UTC
3549
+ # (midnight) on January 1, 1970.
3550
+ # @return [Array<Types::KeyValuesPair>]
3551
+ #
3264
3552
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ListJobsRequest AWS API Documentation
3265
3553
  #
3266
3554
  class ListJobsRequest < Struct.new(
@@ -3269,7 +3557,8 @@ module Aws::Batch
3269
3557
  :multi_node_job_id,
3270
3558
  :job_status,
3271
3559
  :max_results,
3272
- :next_token)
3560
+ :next_token,
3561
+ :filters)
3273
3562
  SENSITIVE = []
3274
3563
  include Aws::Structure
3275
3564
  end
@@ -3303,10 +3592,9 @@ module Aws::Batch
3303
3592
  #
3304
3593
  # @!attribute [rw] resource_arn
3305
3594
  # The Amazon Resource Name (ARN) that identifies the resource that
3306
- # tags are listed for. AWS Batch resources that support tags are
3307
- # compute environments, jobs, job definitions, and job queues. ARNs
3308
- # for child jobs of array and multi-node parallel (MNP) jobs are not
3309
- # supported.
3595
+ # tags are listed for. Batch resources that support tags are compute
3596
+ # environments, jobs, job definitions, and job queues. ARNs for child
3597
+ # jobs of array and multi-node parallel (MNP) jobs are not supported.
3310
3598
  # @return [String]
3311
3599
  #
3312
3600
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ListTagsForResourceRequest AWS API Documentation
@@ -3356,17 +3644,17 @@ module Aws::Batch
3356
3644
  # The supported log drivers are `awslogs`, `fluentd`, `gelf`,
3357
3645
  # `json-file`, `journald`, `logentries`, `syslog`, and `splunk`.
3358
3646
  #
3359
- # <note markdown="1"> Jobs running on Fargate resources are restricted to the `awslogs`
3360
- # and `splunk` log drivers.
3647
+ # <note markdown="1"> Jobs that are running on Fargate resources are restricted to the
3648
+ # `awslogs` and `splunk` log drivers.
3361
3649
  #
3362
3650
  # </note>
3363
3651
  #
3364
3652
  # awslogs
3365
3653
  #
3366
3654
  # : Specifies the Amazon CloudWatch Logs logging driver. For more
3367
- # information, see [Using the awslogs Log Driver][1] in the *AWS
3368
- # Batch User Guide* and [Amazon CloudWatch Logs logging driver][2]
3369
- # in the Docker documentation.
3655
+ # information, see [Using the awslogs Log Driver][1] in the *Batch
3656
+ # User Guide* and [Amazon CloudWatch Logs logging driver][2] in the
3657
+ # Docker documentation.
3370
3658
  #
3371
3659
  # fluentd
3372
3660
  #
@@ -3404,7 +3692,7 @@ module Aws::Batch
3404
3692
  # including usage and options, see [Syslog logging driver][8] in the
3405
3693
  # Docker documentation.
3406
3694
  #
3407
- # <note markdown="1"> If you have a custom driver that'sn't listed earlier that you want
3695
+ # <note markdown="1"> If you have a custom driver that's not listed earlier that you want
3408
3696
  # to work with the Amazon ECS container agent, you can fork the Amazon
3409
3697
  # ECS container agent project that's [available on GitHub][9] and
3410
3698
  # customize it to work with that driver. We encourage you to submit
@@ -3443,7 +3731,7 @@ module Aws::Batch
3443
3731
  #
3444
3732
  # @!attribute [rw] secret_options
3445
3733
  # The secrets to pass to the log configuration. For more information,
3446
- # see [Specifying Sensitive Data][1] in the *AWS Batch User Guide*.
3734
+ # see [Specifying Sensitive Data][1] in the *Batch User Guide*.
3447
3735
  #
3448
3736
  #
3449
3737
  #
@@ -3502,8 +3790,9 @@ module Aws::Batch
3502
3790
  include Aws::Structure
3503
3791
  end
3504
3792
 
3505
- # The network configuration for jobs running on Fargate resources. Jobs
3506
- # running on EC2 resources must not specify this parameter.
3793
+ # The network configuration for jobs that are running on Fargate
3794
+ # resources. Jobs that are running on EC2 resources must not specify
3795
+ # this parameter.
3507
3796
  #
3508
3797
  # @note When making an API call, you may pass NetworkConfiguration
3509
3798
  # data as a hash:
@@ -3514,8 +3803,8 @@ module Aws::Batch
3514
3803
  #
3515
3804
  # @!attribute [rw] assign_public_ip
3516
3805
  # Indicates whether the job should have a public IP address. For a job
3517
- # running on Fargate resources in a private subnet to send outbound
3518
- # traffic to the internet (for example, in order to pull container
3806
+ # that is running on Fargate resources in a private subnet to send
3807
+ # outbound traffic to the internet (for example, to pull container
3519
3808
  # images), the private subnet requires a NAT gateway be attached to
3520
3809
  # route requests to the internet. For more information, see [Amazon
3521
3810
  # ECS task networking][1]. The default value is "DISABLED".
@@ -3583,8 +3872,8 @@ module Aws::Batch
3583
3872
  # Object representing any node overrides to a job definition that's
3584
3873
  # used in a SubmitJob API operation.
3585
3874
  #
3586
- # <note markdown="1"> This isn't applicable to jobs running on Fargate resources and
3587
- # shouldn't be provided; use `containerOverrides` instead.
3875
+ # <note markdown="1"> This isn't applicable to jobs that are running on Fargate resources
3876
+ # and shouldn't be provided; use `containerOverrides` instead.
3588
3877
  #
3589
3878
  # </note>
3590
3879
  #
@@ -3672,6 +3961,16 @@ module Aws::Batch
3672
3961
  # source_path: "String",
3673
3962
  # },
3674
3963
  # name: "String",
3964
+ # efs_volume_configuration: {
3965
+ # file_system_id: "String", # required
3966
+ # root_directory: "String",
3967
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
3968
+ # transit_encryption_port: 1,
3969
+ # authorization_config: {
3970
+ # access_point_id: "String",
3971
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
3972
+ # },
3973
+ # },
3675
3974
  # },
3676
3975
  # ],
3677
3976
  # environment: [
@@ -3876,6 +4175,16 @@ module Aws::Batch
3876
4175
  # source_path: "String",
3877
4176
  # },
3878
4177
  # name: "String",
4178
+ # efs_volume_configuration: {
4179
+ # file_system_id: "String", # required
4180
+ # root_directory: "String",
4181
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
4182
+ # transit_encryption_port: 1,
4183
+ # authorization_config: {
4184
+ # access_point_id: "String",
4185
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
4186
+ # },
4187
+ # },
3879
4188
  # },
3880
4189
  # ],
3881
4190
  # environment: [
@@ -4003,6 +4312,16 @@ module Aws::Batch
4003
4312
  # source_path: "String",
4004
4313
  # },
4005
4314
  # name: "String",
4315
+ # efs_volume_configuration: {
4316
+ # file_system_id: "String", # required
4317
+ # root_directory: "String",
4318
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
4319
+ # transit_encryption_port: 1,
4320
+ # authorization_config: {
4321
+ # access_point_id: "String",
4322
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
4323
+ # },
4324
+ # },
4006
4325
  # },
4007
4326
  # ],
4008
4327
  # environment: [
@@ -4099,6 +4418,16 @@ module Aws::Batch
4099
4418
  # source_path: "String",
4100
4419
  # },
4101
4420
  # name: "String",
4421
+ # efs_volume_configuration: {
4422
+ # file_system_id: "String", # required
4423
+ # root_directory: "String",
4424
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
4425
+ # transit_encryption_port: 1,
4426
+ # authorization_config: {
4427
+ # access_point_id: "String",
4428
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
4429
+ # },
4430
+ # },
4102
4431
  # },
4103
4432
  # ],
4104
4433
  # environment: [
@@ -4209,7 +4538,7 @@ module Aws::Batch
4209
4538
  # @!attribute [rw] type
4210
4539
  # The type of job definition. For more information about multi-node
4211
4540
  # parallel jobs, see [Creating a multi-node parallel job
4212
- # definition][1] in the *AWS Batch User Guide*.
4541
+ # definition][1] in the *Batch User Guide*.
4213
4542
  #
4214
4543
  # <note markdown="1"> If the job is run on Fargate resources, then `multinode` isn't
4215
4544
  # supported.
@@ -4244,7 +4573,7 @@ module Aws::Batch
4244
4573
  # An object with various properties specific to multi-node parallel
4245
4574
  # jobs. If you specify node properties for a job, it becomes a
4246
4575
  # multi-node parallel job. For more information, see [Multi-node
4247
- # Parallel Jobs][1] in the *AWS Batch User Guide*. If the job
4576
+ # Parallel Jobs][1] in the *Batch User Guide*. If the job
4248
4577
  # definition's `type` parameter is `container`, then you must specify
4249
4578
  # either `containerProperties` or `nodeProperties`.
4250
4579
  #
@@ -4277,12 +4606,12 @@ module Aws::Batch
4277
4606
  #
4278
4607
  # @!attribute [rw] timeout
4279
4608
  # The timeout configuration for jobs that are submitted with this job
4280
- # definition, after which AWS Batch terminates your jobs if they have
4281
- # not finished. If a job is terminated due to a timeout, it isn't
4609
+ # definition, after which Batch terminates your jobs if they have not
4610
+ # finished. If a job is terminated due to a timeout, it isn't
4282
4611
  # retried. The minimum value for the timeout is 60 seconds. Any
4283
4612
  # timeout configuration that's specified during a SubmitJob operation
4284
4613
  # overrides the timeout configuration defined here. For more
4285
- # information, see [Job Timeouts][1] in the *AWS Batch User Guide*.
4614
+ # information, see [Job Timeouts][1] in the *Batch User Guide*.
4286
4615
  #
4287
4616
  #
4288
4617
  #
@@ -4292,8 +4621,8 @@ module Aws::Batch
4292
4621
  # @!attribute [rw] tags
4293
4622
  # The tags that you apply to the job definition to help you categorize
4294
4623
  # and organize your resources. Each tag consists of a key and an
4295
- # optional value. For more information, see [Tagging AWS Resources][1]
4296
- # in *AWS Batch User Guide*.
4624
+ # optional value. For more information, see [Tagging Amazon Web
4625
+ # Services Resources][1] in *Batch User Guide*.
4297
4626
  #
4298
4627
  #
4299
4628
  #
@@ -4367,35 +4696,36 @@ module Aws::Batch
4367
4696
  # exceed the number of available GPUs on the compute resource that
4368
4697
  # the job is launched on.
4369
4698
  #
4370
- # <note markdown="1"> GPUs are not available for jobs running on Fargate resources.
4699
+ # <note markdown="1"> GPUs are not available for jobs that are running on Fargate
4700
+ # resources.
4371
4701
  #
4372
4702
  # </note>
4373
4703
  #
4374
4704
  # type="MEMORY"
4375
4705
  #
4376
- # : For jobs running on EC2 resources, the hard limit (in MiB) of
4377
- # memory to present to the container. If your container attempts to
4378
- # exceed the memory specified here, the container is killed. This
4379
- # parameter maps to `Memory` in the [Create a container][1] section
4380
- # of the [Docker Remote API][2] and the `--memory` option to [docker
4381
- # run][3]. You must specify at least 4 MiB of memory for a job. This
4382
- # is required but can be specified in several places for multi-node
4383
- # parallel (MNP) jobs. It must be specified for each node at least
4384
- # once. This parameter maps to `Memory` in the [Create a
4385
- # container][1] section of the [Docker Remote API][2] and the
4386
- # `--memory` option to [docker run][3].
4706
+ # : The memory hard limit (in MiB) present to the container. This
4707
+ # parameter is supported for jobs that are running on EC2 resources.
4708
+ # If your container attempts to exceed the memory specified, the
4709
+ # container is terminated. This parameter maps to `Memory` in the
4710
+ # [Create a container][1] section of the [Docker Remote API][2] and
4711
+ # the `--memory` option to [docker run][3]. You must specify at
4712
+ # least 4 MiB of memory for a job. This is required but can be
4713
+ # specified in several places for multi-node parallel (MNP) jobs. It
4714
+ # must be specified for each node at least once. This parameter maps
4715
+ # to `Memory` in the [Create a container][1] section of the [Docker
4716
+ # Remote API][2] and the `--memory` option to [docker run][3].
4387
4717
  #
4388
4718
  # <note markdown="1"> If you're trying to maximize your resource utilization by
4389
4719
  # providing your jobs as much memory as possible for a particular
4390
- # instance type, see [Memory Management][4] in the *AWS Batch User
4720
+ # instance type, see [Memory Management][4] in the *Batch User
4391
4721
  # Guide*.
4392
4722
  #
4393
4723
  # </note>
4394
4724
  #
4395
- # For jobs running on Fargate resources, then `value` is the hard
4396
- # limit (in MiB), and must match one of the supported values and the
4397
- # `VCPU` values must be one of the values supported for that memory
4398
- # value.
4725
+ # For jobs that are running on Fargate resources, then `value` is
4726
+ # the hard limit (in MiB), and must match one of the supported
4727
+ # values and the `VCPU` values must be one of the values supported
4728
+ # for that memory value.
4399
4729
  #
4400
4730
  # value = 512
4401
4731
  #
@@ -4443,10 +4773,10 @@ module Aws::Batch
4443
4773
  # but can be specified in several places; it must be specified for
4444
4774
  # each node at least once.
4445
4775
  #
4446
- # For jobs running on Fargate resources, then `value` must match one
4447
- # of the supported values and the `MEMORY` values must be one of the
4448
- # values supported for that VCPU value. The supported values are
4449
- # 0.25, 0.5, 1, 2, and 4
4776
+ # For jobs that are running on Fargate resources, then `value` must
4777
+ # match one of the supported values and the `MEMORY` values must be
4778
+ # one of the values supported for that VCPU value. The supported
4779
+ # values are 0.25, 0.5, 1, 2, and 4
4450
4780
  #
4451
4781
  # value = 0.25
4452
4782
  #
@@ -4494,7 +4824,7 @@ module Aws::Batch
4494
4824
  end
4495
4825
 
4496
4826
  # The retry strategy associated with a job. For more information, see
4497
- # [Automated job retries][1] in the *AWS Batch User Guide*.
4827
+ # [Automated job retries][1] in the *Batch User Guide*.
4498
4828
  #
4499
4829
  #
4500
4830
  #
@@ -4546,8 +4876,8 @@ module Aws::Batch
4546
4876
  # * To reference sensitive information in the log configuration of a
4547
4877
  # container, use the `secretOptions` container definition parameter.
4548
4878
  #
4549
- # For more information, see [Specifying sensitive data][1] in the *AWS
4550
- # Batch User Guide*.
4879
+ # For more information, see [Specifying sensitive data][1] in the *Batch
4880
+ # User Guide*.
4551
4881
  #
4552
4882
  #
4553
4883
  #
@@ -4567,13 +4897,14 @@ module Aws::Batch
4567
4897
  #
4568
4898
  # @!attribute [rw] value_from
4569
4899
  # The secret to expose to the container. The supported values are
4570
- # either the full ARN of the AWS Secrets Manager secret or the full
4571
- # ARN of the parameter in the AWS Systems Manager Parameter Store.
4900
+ # either the full ARN of the Secrets Manager secret or the full ARN of
4901
+ # the parameter in the Amazon Web Services Systems Manager Parameter
4902
+ # Store.
4572
4903
  #
4573
- # <note markdown="1"> If the AWS Systems Manager Parameter Store parameter exists in the
4574
- # same Region as the job you are launching, then you can use either
4575
- # the full ARN or name of the parameter. If the parameter exists in a
4576
- # different Region, then the full ARN must be specified.
4904
+ # <note markdown="1"> If the Amazon Web Services Systems Manager Parameter Store parameter
4905
+ # exists in the same Region as the job you're launching, then you can
4906
+ # use either the full ARN or name of the parameter. If the parameter
4907
+ # exists in a different Region, then the full ARN must be specified.
4577
4908
  #
4578
4909
  # </note>
4579
4910
  # @return [String]
@@ -4692,15 +5023,15 @@ module Aws::Batch
4692
5023
  # @return [String]
4693
5024
  #
4694
5025
  # @!attribute [rw] job_queue
4695
- # The job queue into which the job is submitted. You can specify
4696
- # either the name or the Amazon Resource Name (ARN) of the queue.
5026
+ # The job queue where the job is submitted. You can specify either the
5027
+ # name or the Amazon Resource Name (ARN) of the queue.
4697
5028
  # @return [String]
4698
5029
  #
4699
5030
  # @!attribute [rw] array_properties
4700
5031
  # The array properties for the submitted job, such as the size of the
4701
5032
  # array. The array size can be between 2 and 10,000. If you specify
4702
5033
  # array properties for a job, it becomes an array job. For more
4703
- # information, see [Array Jobs][1] in the *AWS Batch User Guide*.
5034
+ # information, see [Array Jobs][1] in the *Batch User Guide*.
4704
5035
  #
4705
5036
  #
4706
5037
  #
@@ -4733,21 +5064,20 @@ module Aws::Batch
4733
5064
  # @return [Hash<String,String>]
4734
5065
  #
4735
5066
  # @!attribute [rw] container_overrides
4736
- # A list of container overrides in JSON format that specify the name
4737
- # of a container in the specified job definition and the overrides it
4738
- # should receive. You can override the default command for a container
4739
- # (that's specified in the job definition or the Docker image) with a
4740
- # `command` override. You can also override existing environment
4741
- # variables (that are specified in the job definition or Docker image)
4742
- # on a container or add new environment variables to it with an
4743
- # `environment` override.
5067
+ # A list of container overrides in the JSON format that specify the
5068
+ # name of a container in the specified job definition and the
5069
+ # overrides it should receive. You can override the default command
5070
+ # for a container, which is specified in the job definition or the
5071
+ # Docker image, with a `command` override. You can also override
5072
+ # existing environment variables on a container or add new environment
5073
+ # variables to it with an `environment` override.
4744
5074
  # @return [Types::ContainerOverrides]
4745
5075
  #
4746
5076
  # @!attribute [rw] node_overrides
4747
5077
  # A list of node overrides in JSON format that specify the node range
4748
5078
  # to target and the container overrides for that node range.
4749
5079
  #
4750
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
5080
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
4751
5081
  # resources; use `containerOverrides` instead.
4752
5082
  #
4753
5083
  # </note>
@@ -4772,14 +5102,14 @@ module Aws::Batch
4772
5102
  #
4773
5103
  # @!attribute [rw] timeout
4774
5104
  # The timeout configuration for this SubmitJob operation. You can
4775
- # specify a timeout duration after which AWS Batch terminates your
4776
- # jobs if they haven't finished. If a job is terminated due to a
4777
- # timeout, it isn't retried. The minimum value for the timeout is 60
4778
- # seconds. This configuration overrides any timeout configuration
4779
- # specified in the job definition. For array jobs, child jobs have the
4780
- # same timeout configuration as the parent job. For more information,
4781
- # see [Job Timeouts][1] in the *Amazon Elastic Container Service
4782
- # Developer Guide*.
5105
+ # specify a timeout duration after which Batch terminates your jobs if
5106
+ # they haven't finished. If a job is terminated due to a timeout, it
5107
+ # isn't retried. The minimum value for the timeout is 60 seconds.
5108
+ # This configuration overrides any timeout configuration specified in
5109
+ # the job definition. For array jobs, child jobs have the same timeout
5110
+ # configuration as the parent job. For more information, see [Job
5111
+ # Timeouts][1] in the *Amazon Elastic Container Service Developer
5112
+ # Guide*.
4783
5113
  #
4784
5114
  #
4785
5115
  #
@@ -4789,8 +5119,8 @@ module Aws::Batch
4789
5119
  # @!attribute [rw] tags
4790
5120
  # The tags that you apply to the job request to help you categorize
4791
5121
  # and organize your resources. Each tag consists of a key and an
4792
- # optional value. For more information, see [Tagging AWS Resources][1]
4793
- # in *AWS General Reference*.
5122
+ # optional value. For more information, see [Tagging Amazon Web
5123
+ # Services Resources][1] in *Amazon Web Services General Reference*.
4794
5124
  #
4795
5125
  #
4796
5126
  #
@@ -4850,7 +5180,7 @@ module Aws::Batch
4850
5180
  #
4851
5181
  # @!attribute [rw] resource_arn
4852
5182
  # The Amazon Resource Name (ARN) of the resource that tags are added
4853
- # to. AWS Batch resources that support tags are compute environments,
5183
+ # to. Batch resources that support tags are compute environments,
4854
5184
  # jobs, job definitions, and job queues. ARNs for child jobs of array
4855
5185
  # and multi-node parallel (MNP) jobs are not supported.
4856
5186
  # @return [String]
@@ -4858,8 +5188,8 @@ module Aws::Batch
4858
5188
  # @!attribute [rw] tags
4859
5189
  # The tags that you apply to the resource to help you categorize and
4860
5190
  # organize your resources. Each tag consists of a key and an optional
4861
- # value. For more information, see [Tagging AWS Resources][1] in *AWS
4862
- # General Reference*.
5191
+ # value. For more information, see [Tagging Amazon Web Services
5192
+ # Resources][1] in *Amazon Web Services General Reference*.
4863
5193
  #
4864
5194
  #
4865
5195
  #
@@ -4890,14 +5220,14 @@ module Aws::Batch
4890
5220
  # }
4891
5221
  #
4892
5222
  # @!attribute [rw] job_id
4893
- # The AWS Batch job ID of the job to terminate.
5223
+ # The Batch job ID of the job to terminate.
4894
5224
  # @return [String]
4895
5225
  #
4896
5226
  # @!attribute [rw] reason
4897
5227
  # A message to attach to the job that explains the reason for
4898
5228
  # canceling it. This message is returned by future DescribeJobs
4899
- # operations on the job. This message is also recorded in the AWS
4900
- # Batch activity logs.
5229
+ # operations on the job. This message is also recorded in the Batch
5230
+ # activity logs.
4901
5231
  # @return [String]
4902
5232
  #
4903
5233
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/TerminateJobRequest AWS API Documentation
@@ -4915,7 +5245,8 @@ module Aws::Batch
4915
5245
 
4916
5246
  # The container path, mount options, and size of the tmpfs mount.
4917
5247
  #
4918
- # <note markdown="1"> This object isn't applicable to jobs running on Fargate resources.
5248
+ # <note markdown="1"> This object isn't applicable to jobs that are running on Fargate
5249
+ # resources.
4919
5250
  #
4920
5251
  # </note>
4921
5252
  #
@@ -4964,7 +5295,8 @@ module Aws::Batch
4964
5295
 
4965
5296
  # The `ulimit` settings to pass to the container.
4966
5297
  #
4967
- # <note markdown="1"> This object isn't applicable to jobs running on Fargate resources.
5298
+ # <note markdown="1"> This object isn't applicable to jobs that are running on Fargate
5299
+ # resources.
4968
5300
  #
4969
5301
  # </note>
4970
5302
  #
@@ -5009,9 +5341,9 @@ module Aws::Batch
5009
5341
  #
5010
5342
  # @!attribute [rw] resource_arn
5011
5343
  # The Amazon Resource Name (ARN) of the resource from which to delete
5012
- # tags. AWS Batch resources that support tags are compute
5013
- # environments, jobs, job definitions, and job queues. ARNs for child
5014
- # jobs of array and multi-node parallel (MNP) jobs are not supported.
5344
+ # tags. Batch resources that support tags are compute environments,
5345
+ # jobs, job definitions, and job queues. ARNs for child jobs of array
5346
+ # and multi-node parallel (MNP) jobs are not supported.
5015
5347
  # @return [String]
5016
5348
  #
5017
5349
  # @!attribute [rw] tag_keys
@@ -5059,13 +5391,13 @@ module Aws::Batch
5059
5391
  # `ENABLED` state can accept jobs from a queue and scale in or out
5060
5392
  # automatically based on the workload demand of its associated queues.
5061
5393
  #
5062
- # If the state is `ENABLED`, then the AWS Batch scheduler can attempt
5063
- # to place jobs from an associated job queue on the compute resources
5394
+ # If the state is `ENABLED`, then the Batch scheduler can attempt to
5395
+ # place jobs from an associated job queue on the compute resources
5064
5396
  # within the environment. If the compute environment is managed, then
5065
5397
  # it can scale its instances out or in automatically, based on the job
5066
5398
  # queue demand.
5067
5399
  #
5068
- # If the state is `DISABLED`, then the AWS Batch scheduler doesn't
5400
+ # If the state is `DISABLED`, then the Batch scheduler doesn't
5069
5401
  # attempt to place jobs within the environment. Jobs in a `STARTING`
5070
5402
  # or `RUNNING` state continue to progress normally. Managed compute
5071
5403
  # environments in the `DISABLED` state don't scale out. However, they
@@ -5075,7 +5407,7 @@ module Aws::Batch
5075
5407
  # @!attribute [rw] compute_resources
5076
5408
  # Details of the compute resources managed by the compute environment.
5077
5409
  # Required for a managed compute environment. For more information,
5078
- # see [Compute Environments][1] in the *AWS Batch User Guide*.
5410
+ # see [Compute Environments][1] in the *Batch User Guide*.
5079
5411
  #
5080
5412
  #
5081
5413
  #
@@ -5083,21 +5415,26 @@ module Aws::Batch
5083
5415
  # @return [Types::ComputeResourceUpdate]
5084
5416
  #
5085
5417
  # @!attribute [rw] service_role
5086
- # The full Amazon Resource Name (ARN) of the IAM role that allows AWS
5087
- # Batch to make calls to other AWS services on your behalf. For more
5088
- # information, see [AWS Batch service IAM role][1] in the *AWS Batch
5089
- # User Guide*.
5418
+ # The full Amazon Resource Name (ARN) of the IAM role that allows
5419
+ # Batch to make calls to other Amazon Web Services services on your
5420
+ # behalf. For more information, see [Batch service IAM role][1] in the
5421
+ # *Batch User Guide*.
5422
+ #
5423
+ # If the compute environment has a service-linked role, it can't be
5424
+ # changed to use a regular IAM role. Likewise, if the compute
5425
+ # environment has a regular IAM role, it can't be changed to use a
5426
+ # service-linked role.
5090
5427
  #
5091
5428
  # If your specified role has a path other than `/`, then you must
5092
5429
  # either specify the full role ARN (this is recommended) or prefix the
5093
5430
  # role name with the path.
5094
5431
  #
5095
- # <note markdown="1"> Depending on how you created your AWS Batch service role, its ARN
5096
- # might contain the `service-role` path prefix. When you only specify
5097
- # the name of the service role, AWS Batch assumes that your ARN does
5098
- # not use the `service-role` path prefix. Because of this, we
5099
- # recommend that you specify the full ARN of your service role when
5100
- # you create compute environments.
5432
+ # <note markdown="1"> Depending on how you created your Batch service role, its ARN might
5433
+ # contain the `service-role` path prefix. When you only specify the
5434
+ # name of the service role, Batch assumes that your ARN doesn't use
5435
+ # the `service-role` path prefix. Because of this, we recommend that
5436
+ # you specify the full ARN of your service role when you create
5437
+ # compute environments.
5101
5438
  #
5102
5439
  # </note>
5103
5440
  #
@@ -5158,9 +5495,9 @@ module Aws::Batch
5158
5495
  #
5159
5496
  # @!attribute [rw] state
5160
5497
  # Describes the queue's ability to accept new jobs. If the job queue
5161
- # state is `ENABLED`, it is able to accept jobs. If the job queue
5162
- # state is `DISABLED`, new jobs cannot be added to the queue, but jobs
5163
- # already in the queue can finish.
5498
+ # state is `ENABLED`, it can accept jobs. If the job queue state is
5499
+ # `DISABLED`, new jobs can't be added to the queue, but jobs already
5500
+ # in the queue can finish.
5164
5501
  # @return [String]
5165
5502
  #
5166
5503
  # @!attribute [rw] priority
@@ -5171,7 +5508,7 @@ module Aws::Batch
5171
5508
  # priority value of `10` is given scheduling preference over a job
5172
5509
  # queue with a priority value of `1`. All of the compute environments
5173
5510
  # must be either EC2 (`EC2` or `SPOT`) or Fargate (`FARGATE` or
5174
- # `FARGATE_SPOT`); EC2 and Fargate compute environments cannot be
5511
+ # `FARGATE_SPOT`). EC2 and Fargate compute environments can't be
5175
5512
  # mixed.
5176
5513
  # @return [Integer]
5177
5514
  #
@@ -5182,12 +5519,12 @@ module Aws::Batch
5182
5519
  # should run a given job. Compute environments must be in the `VALID`
5183
5520
  # state before you can associate them with a job queue. All of the
5184
5521
  # compute environments must be either EC2 (`EC2` or `SPOT`) or Fargate
5185
- # (`FARGATE` or `FARGATE_SPOT`); EC2 and Fargate compute environments
5522
+ # (`FARGATE` or `FARGATE_SPOT`). EC2 and Fargate compute environments
5186
5523
  # can't be mixed.
5187
5524
  #
5188
5525
  # <note markdown="1"> All compute environments that are associated with a job queue must
5189
- # share the same architecture. AWS Batch doesn't support mixing
5190
- # compute environment architecture types in a single job queue.
5526
+ # share the same architecture. Batch doesn't support mixing compute
5527
+ # environment architecture types in a single job queue.
5191
5528
  #
5192
5529
  # </note>
5193
5530
  # @return [Array<Types::ComputeEnvironmentOrder>]
@@ -5230,6 +5567,16 @@ module Aws::Batch
5230
5567
  # source_path: "String",
5231
5568
  # },
5232
5569
  # name: "String",
5570
+ # efs_volume_configuration: {
5571
+ # file_system_id: "String", # required
5572
+ # root_directory: "String",
5573
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
5574
+ # transit_encryption_port: 1,
5575
+ # authorization_config: {
5576
+ # access_point_id: "String",
5577
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
5578
+ # },
5579
+ # },
5233
5580
  # }
5234
5581
  #
5235
5582
  # @!attribute [rw] host
@@ -5240,7 +5587,7 @@ module Aws::Batch
5240
5587
  # guaranteed to persist after the containers associated with it stop
5241
5588
  # running.
5242
5589
  #
5243
- # <note markdown="1"> This parameter isn't applicable to jobs running on Fargate
5590
+ # <note markdown="1"> This parameter isn't applicable to jobs that are running on Fargate
5244
5591
  # resources and shouldn't be provided.
5245
5592
  #
5246
5593
  # </note>
@@ -5253,11 +5600,19 @@ module Aws::Batch
5253
5600
  # `mountPoints`.
5254
5601
  # @return [String]
5255
5602
  #
5603
+ # @!attribute [rw] efs_volume_configuration
5604
+ # This parameter is specified when you are using an Amazon Elastic
5605
+ # File System file system for job storage. Jobs that are running on
5606
+ # Fargate resources must specify a `platformVersion` of at least
5607
+ # `1.4.0`.
5608
+ # @return [Types::EFSVolumeConfiguration]
5609
+ #
5256
5610
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/Volume AWS API Documentation
5257
5611
  #
5258
5612
  class Volume < Struct.new(
5259
5613
  :host,
5260
- :name)
5614
+ :name,
5615
+ :efs_volume_configuration)
5261
5616
  SENSITIVE = []
5262
5617
  include Aws::Structure
5263
5618
  end