aws-sdk-batch 1.2.0 → 1.3.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: fc54c3c784c5d2c8e7a5fc64a452838fbf56590a
4
- data.tar.gz: 78448a68c4821502d166d4748204c9d8253dfbbc
3
+ metadata.gz: 660540f10f4b01f51f15f8ba707a1b8831790c2b
4
+ data.tar.gz: 98289444c3b798267f4f512a86f54bbe9a89adbd
5
5
  SHA512:
6
- metadata.gz: e9b63e6342108d1f5bb4ac4a1ce32dba52f62bdd8c964cee5901a86fdb97618f23059c2f52e9d836912512ef2f587044db2e9db46280b8108eae37cbfeff94ad
7
- data.tar.gz: dd756cc49bf13d29afcd955ce3999021d1e7f307cea9168daa3757c34a377e94532756b6518b3394ec016d2736e2a9548d07ffc563165e5aab2342ca5a8605e0
6
+ metadata.gz: f2fe01fe2f20a2eb89d53265827e7680ef954a173aa277a5520de285b6757ff612bc178143245056b8a79574f085108bb3a389e8e7b56cf25fe1f389eebac770
7
+ data.tar.gz: 074804531a19749e5bb5bc32224029d509600fca759046b980455233e214ac1b419b0305efa9f3e35ef772a7c17f553d8155fc13eaaa275e38f08888d84f2ad0
@@ -42,6 +42,6 @@ require_relative 'aws-sdk-batch/customizations'
42
42
  # @service
43
43
  module Aws::Batch
44
44
 
45
- GEM_VERSION = '1.2.0'
45
+ GEM_VERSION = '1.3.0'
46
46
 
47
47
  end
@@ -155,7 +155,7 @@ module Aws::Batch
155
155
  # The AWS Batch job ID of the job to cancel.
156
156
  #
157
157
  # @option params [required, String] :reason
158
- # A message to attach to the job that explains the reason for cancelling
158
+ # A message to attach to the job that explains the reason for canceling
159
159
  # it. This message is returned by future DescribeJobs operations on the
160
160
  # job. This message is also recorded in the AWS Batch activity logs.
161
161
  #
@@ -198,8 +198,8 @@ module Aws::Batch
198
198
  # resources within the environment, based on the compute resources that
199
199
  # you specify. Instances launched into a managed compute environment use
200
200
  # a recent, approved version of the Amazon ECS-optimized AMI. You can
201
- # choose to use Amazon EC2 On-Demand instances in your managed compute
202
- # environment, or you can use Amazon EC2 Spot instances that only launch
201
+ # choose to use Amazon EC2 On-Demand Instances in your managed compute
202
+ # environment, or you can use Amazon EC2 Spot Instances that only launch
203
203
  # when the Spot bid price is below a specified percentage of the
204
204
  # On-Demand price.
205
205
  #
@@ -207,13 +207,13 @@ module Aws::Batch
207
207
  # resources. This provides more compute resource configuration options,
208
208
  # such as using a custom AMI, but you must ensure that your AMI meets
209
209
  # the Amazon ECS container instance AMI specification. For more
210
- # information, see [Container Instance AMIs][1] in the *Amazon EC2
210
+ # information, see [Container Instance AMIs][1] in the *Amazon Elastic
211
211
  # Container Service Developer Guide*. After you have created your
212
212
  # unmanaged compute environment, you can use the
213
213
  # DescribeComputeEnvironments operation to find the Amazon ECS cluster
214
214
  # that is associated with it and then manually launch your container
215
215
  # instances into that Amazon ECS cluster. For more information, see
216
- # [Launching an Amazon ECS Container Instance][2] in the *Amazon EC2
216
+ # [Launching an Amazon ECS Container Instance][2] in the *Amazon Elastic
217
217
  # Container Service Developer Guide*.
218
218
  #
219
219
  #
@@ -416,7 +416,7 @@ module Aws::Batch
416
416
  # relative to each other. The job scheduler uses this parameter to
417
417
  # determine which compute environment should execute a given job.
418
418
  # Compute environments must be in the `VALID` state before you can
419
- # associate them with a job queue. You can associate up to 3 compute
419
+ # associate them with a job queue. You can associate up to three compute
420
420
  # environments with a job queue.
421
421
  #
422
422
  # @return [Types::CreateJobQueueResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1076,6 +1076,7 @@ module Aws::Batch
1076
1076
  # resp.jobs[0].stopped_at #=> Integer
1077
1077
  # resp.jobs[0].depends_on #=> Array
1078
1078
  # resp.jobs[0].depends_on[0].job_id #=> String
1079
+ # resp.jobs[0].depends_on[0].type #=> String, one of "N_TO_N", "SEQUENTIAL"
1079
1080
  # resp.jobs[0].job_definition #=> String
1080
1081
  # resp.jobs[0].parameters #=> Hash
1081
1082
  # resp.jobs[0].parameters["String"] #=> String
@@ -1107,6 +1108,10 @@ module Aws::Batch
1107
1108
  # resp.jobs[0].container.container_instance_arn #=> String
1108
1109
  # resp.jobs[0].container.task_arn #=> String
1109
1110
  # resp.jobs[0].container.log_stream_name #=> String
1111
+ # resp.jobs[0].array_properties.status_summary #=> Hash
1112
+ # resp.jobs[0].array_properties.status_summary["String"] #=> Integer
1113
+ # resp.jobs[0].array_properties.size #=> Integer
1114
+ # resp.jobs[0].array_properties.index #=> Integer
1110
1115
  #
1111
1116
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/DescribeJobs AWS API Documentation
1112
1117
  #
@@ -1121,10 +1126,14 @@ module Aws::Batch
1121
1126
  # the results by job status with the `jobStatus` parameter. If you do
1122
1127
  # not specify a status, only `RUNNING` jobs are returned.
1123
1128
  #
1124
- # @option params [required, String] :job_queue
1129
+ # @option params [String] :job_queue
1125
1130
  # The name or full Amazon Resource Name (ARN) of the job queue with
1126
1131
  # which to list jobs.
1127
1132
  #
1133
+ # @option params [String] :array_job_id
1134
+ # The job ID for an array job. Specifying an array job ID with this
1135
+ # parameter lists all child jobs from within the specified array.
1136
+ #
1128
1137
  # @option params [String] :job_status
1129
1138
  # The job status with which to filter jobs in the specified queue. If
1130
1139
  # you do not specify a status, only `RUNNING` jobs are returned.
@@ -1198,7 +1207,8 @@ module Aws::Batch
1198
1207
  # @example Request syntax with placeholder values
1199
1208
  #
1200
1209
  # resp = client.list_jobs({
1201
- # job_queue: "String", # required
1210
+ # job_queue: "String",
1211
+ # array_job_id: "String",
1202
1212
  # job_status: "SUBMITTED", # accepts SUBMITTED, PENDING, RUNNABLE, STARTING, RUNNING, SUCCEEDED, FAILED
1203
1213
  # max_results: 1,
1204
1214
  # next_token: "String",
@@ -1209,6 +1219,15 @@ module Aws::Batch
1209
1219
  # resp.job_summary_list #=> Array
1210
1220
  # resp.job_summary_list[0].job_id #=> String
1211
1221
  # resp.job_summary_list[0].job_name #=> String
1222
+ # resp.job_summary_list[0].created_at #=> Integer
1223
+ # resp.job_summary_list[0].status #=> String, one of "SUBMITTED", "PENDING", "RUNNABLE", "STARTING", "RUNNING", "SUCCEEDED", "FAILED"
1224
+ # resp.job_summary_list[0].status_reason #=> String
1225
+ # resp.job_summary_list[0].started_at #=> Integer
1226
+ # resp.job_summary_list[0].stopped_at #=> Integer
1227
+ # resp.job_summary_list[0].container.exit_code #=> Integer
1228
+ # resp.job_summary_list[0].container.reason #=> String
1229
+ # resp.job_summary_list[0].array_properties.size #=> Integer
1230
+ # resp.job_summary_list[0].array_properties.index #=> Integer
1212
1231
  # resp.next_token #=> String
1213
1232
  #
1214
1233
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ListJobs AWS API Documentation
@@ -1352,12 +1371,27 @@ module Aws::Batch
1352
1371
  # underscores are allowed.
1353
1372
  #
1354
1373
  # @option params [required, String] :job_queue
1355
- # The job queue into which the job will be submitted. You can specify
1356
- # either the name or the Amazon Resource Name (ARN) of the queue.
1374
+ # The job queue into which the job is submitted. You can specify either
1375
+ # the name or the Amazon Resource Name (ARN) of the queue.
1376
+ #
1377
+ # @option params [Types::ArrayProperties] :array_properties
1378
+ # The array properties for the submitted job, such as the size of the
1379
+ # array. The array size can be between 2 and 10,000. If you specify
1380
+ # array properties for a job, it becomes an array job. For more
1381
+ # information, see [Array Jobs][1] in the *AWS Batch User Guide*.
1382
+ #
1383
+ #
1384
+ #
1385
+ # [1]: http://docs.aws.amazon.com/batch/latest/userguide/array_jobs.html
1357
1386
  #
1358
1387
  # @option params [Array<Types::JobDependency>] :depends_on
1359
- # A list of job IDs on which this job depends. A job can depend upon a
1360
- # maximum of 20 jobs.
1388
+ # A list of dependencies for the job. A job can depend upon a maximum of
1389
+ # 20 jobs. You can specify a `SEQUENTIAL` type dependency without
1390
+ # specifying a job ID for array jobs so that each child array job
1391
+ # completes sequentially, starting at index 0. You can also specify an
1392
+ # `N_TO_N` type dependency with a job ID for array jobs so that each
1393
+ # index child of this job must wait for the corresponding index child of
1394
+ # each dependency to complete before it can begin.
1361
1395
  #
1362
1396
  # @option params [required, String] :job_definition
1363
1397
  # The job definition used by this job. This value can be either a
@@ -1413,9 +1447,13 @@ module Aws::Batch
1413
1447
  # resp = client.submit_job({
1414
1448
  # job_name: "String", # required
1415
1449
  # job_queue: "String", # required
1450
+ # array_properties: {
1451
+ # size: 1,
1452
+ # },
1416
1453
  # depends_on: [
1417
1454
  # {
1418
1455
  # job_id: "String",
1456
+ # type: "N_TO_N", # accepts N_TO_N, SEQUENTIAL
1419
1457
  # },
1420
1458
  # ],
1421
1459
  # job_definition: "String", # required
@@ -1461,7 +1499,7 @@ module Aws::Batch
1461
1499
  # The AWS Batch job ID of the job to terminate.
1462
1500
  #
1463
1501
  # @option params [required, String] :reason
1464
- # A message to attach to the job that explains the reason for cancelling
1502
+ # A message to attach to the job that explains the reason for canceling
1465
1503
  # it. This message is returned by future DescribeJobs operations on the
1466
1504
  # job. This message is also recorded in the AWS Batch activity logs.
1467
1505
  #
@@ -1661,7 +1699,7 @@ module Aws::Batch
1661
1699
  params: params,
1662
1700
  config: config)
1663
1701
  context[:gem_name] = 'aws-sdk-batch'
1664
- context[:gem_version] = '1.2.0'
1702
+ context[:gem_version] = '1.3.0'
1665
1703
  Seahorse::Client::Request.new(handlers, context)
1666
1704
  end
1667
1705
 
@@ -11,6 +11,11 @@ module Aws::Batch
11
11
 
12
12
  include Seahorse::Model
13
13
 
14
+ ArrayJobDependency = Shapes::StringShape.new(name: 'ArrayJobDependency')
15
+ ArrayJobStatusSummary = Shapes::MapShape.new(name: 'ArrayJobStatusSummary')
16
+ ArrayProperties = Shapes::StructureShape.new(name: 'ArrayProperties')
17
+ ArrayPropertiesDetail = Shapes::StructureShape.new(name: 'ArrayPropertiesDetail')
18
+ ArrayPropertiesSummary = Shapes::StructureShape.new(name: 'ArrayPropertiesSummary')
14
19
  AttemptContainerDetail = Shapes::StructureShape.new(name: 'AttemptContainerDetail')
15
20
  AttemptDetail = Shapes::StructureShape.new(name: 'AttemptDetail')
16
21
  AttemptDetails = Shapes::ListShape.new(name: 'AttemptDetails')
@@ -31,6 +36,7 @@ module Aws::Batch
31
36
  ContainerDetail = Shapes::StructureShape.new(name: 'ContainerDetail')
32
37
  ContainerOverrides = Shapes::StructureShape.new(name: 'ContainerOverrides')
33
38
  ContainerProperties = Shapes::StructureShape.new(name: 'ContainerProperties')
39
+ ContainerSummary = Shapes::StructureShape.new(name: 'ContainerSummary')
34
40
  CreateComputeEnvironmentRequest = Shapes::StructureShape.new(name: 'CreateComputeEnvironmentRequest')
35
41
  CreateComputeEnvironmentResponse = Shapes::StructureShape.new(name: 'CreateComputeEnvironmentResponse')
36
42
  CreateJobQueueRequest = Shapes::StructureShape.new(name: 'CreateJobQueueRequest')
@@ -93,6 +99,21 @@ module Aws::Batch
93
99
  Volume = Shapes::StructureShape.new(name: 'Volume')
94
100
  Volumes = Shapes::ListShape.new(name: 'Volumes')
95
101
 
102
+ ArrayJobStatusSummary.key = Shapes::ShapeRef.new(shape: String)
103
+ ArrayJobStatusSummary.value = Shapes::ShapeRef.new(shape: Integer)
104
+
105
+ ArrayProperties.add_member(:size, Shapes::ShapeRef.new(shape: Integer, location_name: "size"))
106
+ ArrayProperties.struct_class = Types::ArrayProperties
107
+
108
+ ArrayPropertiesDetail.add_member(:status_summary, Shapes::ShapeRef.new(shape: ArrayJobStatusSummary, location_name: "statusSummary"))
109
+ ArrayPropertiesDetail.add_member(:size, Shapes::ShapeRef.new(shape: Integer, location_name: "size"))
110
+ ArrayPropertiesDetail.add_member(:index, Shapes::ShapeRef.new(shape: Integer, location_name: "index"))
111
+ ArrayPropertiesDetail.struct_class = Types::ArrayPropertiesDetail
112
+
113
+ ArrayPropertiesSummary.add_member(:size, Shapes::ShapeRef.new(shape: Integer, location_name: "size"))
114
+ ArrayPropertiesSummary.add_member(:index, Shapes::ShapeRef.new(shape: Integer, location_name: "index"))
115
+ ArrayPropertiesSummary.struct_class = Types::ArrayPropertiesSummary
116
+
96
117
  AttemptContainerDetail.add_member(:container_instance_arn, Shapes::ShapeRef.new(shape: String, location_name: "containerInstanceArn"))
97
118
  AttemptContainerDetail.add_member(:task_arn, Shapes::ShapeRef.new(shape: String, location_name: "taskArn"))
98
119
  AttemptContainerDetail.add_member(:exit_code, Shapes::ShapeRef.new(shape: Integer, location_name: "exitCode"))
@@ -192,6 +213,10 @@ module Aws::Batch
192
213
  ContainerProperties.add_member(:user, Shapes::ShapeRef.new(shape: String, location_name: "user"))
193
214
  ContainerProperties.struct_class = Types::ContainerProperties
194
215
 
216
+ ContainerSummary.add_member(:exit_code, Shapes::ShapeRef.new(shape: Integer, location_name: "exitCode"))
217
+ ContainerSummary.add_member(:reason, Shapes::ShapeRef.new(shape: String, location_name: "reason"))
218
+ ContainerSummary.struct_class = Types::ContainerSummary
219
+
195
220
  CreateComputeEnvironmentRequest.add_member(:compute_environment_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "computeEnvironmentName"))
196
221
  CreateComputeEnvironmentRequest.add_member(:type, Shapes::ShapeRef.new(shape: CEType, required: true, location_name: "type"))
197
222
  CreateComputeEnvironmentRequest.add_member(:state, Shapes::ShapeRef.new(shape: CEState, location_name: "state"))
@@ -281,6 +306,7 @@ module Aws::Batch
281
306
  JobDefinitionList.member = Shapes::ShapeRef.new(shape: JobDefinition)
282
307
 
283
308
  JobDependency.add_member(:job_id, Shapes::ShapeRef.new(shape: String, location_name: "jobId"))
309
+ JobDependency.add_member(:type, Shapes::ShapeRef.new(shape: ArrayJobDependency, location_name: "type"))
284
310
  JobDependency.struct_class = Types::JobDependency
285
311
 
286
312
  JobDependencyList.member = Shapes::ShapeRef.new(shape: JobDependency)
@@ -299,6 +325,7 @@ module Aws::Batch
299
325
  JobDetail.add_member(:job_definition, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobDefinition"))
300
326
  JobDetail.add_member(:parameters, Shapes::ShapeRef.new(shape: ParametersMap, location_name: "parameters"))
301
327
  JobDetail.add_member(:container, Shapes::ShapeRef.new(shape: ContainerDetail, location_name: "container"))
328
+ JobDetail.add_member(:array_properties, Shapes::ShapeRef.new(shape: ArrayPropertiesDetail, location_name: "arrayProperties"))
302
329
  JobDetail.struct_class = Types::JobDetail
303
330
 
304
331
  JobDetailList.member = Shapes::ShapeRef.new(shape: JobDetail)
@@ -316,6 +343,13 @@ module Aws::Batch
316
343
 
317
344
  JobSummary.add_member(:job_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobId"))
318
345
  JobSummary.add_member(:job_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobName"))
346
+ JobSummary.add_member(:created_at, Shapes::ShapeRef.new(shape: Long, location_name: "createdAt"))
347
+ JobSummary.add_member(:status, Shapes::ShapeRef.new(shape: JobStatus, location_name: "status"))
348
+ JobSummary.add_member(:status_reason, Shapes::ShapeRef.new(shape: String, location_name: "statusReason"))
349
+ JobSummary.add_member(:started_at, Shapes::ShapeRef.new(shape: Long, location_name: "startedAt"))
350
+ JobSummary.add_member(:stopped_at, Shapes::ShapeRef.new(shape: Long, location_name: "stoppedAt"))
351
+ JobSummary.add_member(:container, Shapes::ShapeRef.new(shape: ContainerSummary, location_name: "container"))
352
+ JobSummary.add_member(:array_properties, Shapes::ShapeRef.new(shape: ArrayPropertiesSummary, location_name: "arrayProperties"))
319
353
  JobSummary.struct_class = Types::JobSummary
320
354
 
321
355
  JobSummaryList.member = Shapes::ShapeRef.new(shape: JobSummary)
@@ -324,7 +358,8 @@ module Aws::Batch
324
358
  KeyValuePair.add_member(:value, Shapes::ShapeRef.new(shape: String, location_name: "value"))
325
359
  KeyValuePair.struct_class = Types::KeyValuePair
326
360
 
327
- ListJobsRequest.add_member(:job_queue, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobQueue"))
361
+ ListJobsRequest.add_member(:job_queue, Shapes::ShapeRef.new(shape: String, location_name: "jobQueue"))
362
+ ListJobsRequest.add_member(:array_job_id, Shapes::ShapeRef.new(shape: String, location_name: "arrayJobId"))
328
363
  ListJobsRequest.add_member(:job_status, Shapes::ShapeRef.new(shape: JobStatus, location_name: "jobStatus"))
329
364
  ListJobsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: Integer, location_name: "maxResults"))
330
365
  ListJobsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
@@ -363,6 +398,7 @@ module Aws::Batch
363
398
 
364
399
  SubmitJobRequest.add_member(:job_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobName"))
365
400
  SubmitJobRequest.add_member(:job_queue, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobQueue"))
401
+ SubmitJobRequest.add_member(:array_properties, Shapes::ShapeRef.new(shape: ArrayProperties, location_name: "arrayProperties"))
366
402
  SubmitJobRequest.add_member(:depends_on, Shapes::ShapeRef.new(shape: JobDependencyList, location_name: "dependsOn"))
367
403
  SubmitJobRequest.add_member(:job_definition, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobDefinition"))
368
404
  SubmitJobRequest.add_member(:parameters, Shapes::ShapeRef.new(shape: ParametersMap, location_name: "parameters"))
@@ -8,6 +8,72 @@
8
8
  module Aws::Batch
9
9
  module Types
10
10
 
11
+ # An object representing an AWS Batch array job.
12
+ #
13
+ # @note When making an API call, you may pass ArrayProperties
14
+ # data as a hash:
15
+ #
16
+ # {
17
+ # size: 1,
18
+ # }
19
+ #
20
+ # @!attribute [rw] size
21
+ # The size of the array job.
22
+ # @return [Integer]
23
+ #
24
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ArrayProperties AWS API Documentation
25
+ #
26
+ class ArrayProperties < Struct.new(
27
+ :size)
28
+ include Aws::Structure
29
+ end
30
+
31
+ # An object representing the array properties of a job.
32
+ #
33
+ # @!attribute [rw] status_summary
34
+ # A summary of the number of array job children in each available job
35
+ # status. This parameter is returned for parent array jobs.
36
+ # @return [Hash<String,Integer>]
37
+ #
38
+ # @!attribute [rw] size
39
+ # The size of the array job. This parameter is returned for parent
40
+ # array jobs.
41
+ # @return [Integer]
42
+ #
43
+ # @!attribute [rw] index
44
+ # The job index within the array that is associated with this job.
45
+ # This parameter is returned for array job children.
46
+ # @return [Integer]
47
+ #
48
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ArrayPropertiesDetail AWS API Documentation
49
+ #
50
+ class ArrayPropertiesDetail < Struct.new(
51
+ :status_summary,
52
+ :size,
53
+ :index)
54
+ include Aws::Structure
55
+ end
56
+
57
+ # An object representing the array properties of a job.
58
+ #
59
+ # @!attribute [rw] size
60
+ # The size of the array job. This parameter is returned for parent
61
+ # array jobs.
62
+ # @return [Integer]
63
+ #
64
+ # @!attribute [rw] index
65
+ # The job index within the array that is associated with this job.
66
+ # This parameter is returned for children of array jobs.
67
+ # @return [Integer]
68
+ #
69
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ArrayPropertiesSummary AWS API Documentation
70
+ #
71
+ class ArrayPropertiesSummary < Struct.new(
72
+ :size,
73
+ :index)
74
+ include Aws::Structure
75
+ end
76
+
11
77
  # An object representing the details of a container that is part of a
12
78
  # job attempt.
13
79
  #
@@ -57,13 +123,15 @@ module Aws::Batch
57
123
  # @return [Types::AttemptContainerDetail]
58
124
  #
59
125
  # @!attribute [rw] started_at
60
- # The Unix timestamp for when the attempt was started (when the task
61
- # transitioned from the `PENDING` state to the `RUNNING` state).
126
+ # The Unix time stamp for when the attempt was started (when the
127
+ # attempt transitioned from the `STARTING` state to the `RUNNING`
128
+ # state).
62
129
  # @return [Integer]
63
130
  #
64
131
  # @!attribute [rw] stopped_at
65
- # The Unix timestamp for when the attempt was stopped (when the task
66
- # transitioned from the `RUNNING` state to the `STOPPED` state).
132
+ # The Unix time stamp for when the attempt was stopped (when the
133
+ # attempt transitioned from the `RUNNING` state to a terminal state,
134
+ # such as `SUCCEEDED` or `FAILED`).
67
135
  # @return [Integer]
68
136
  #
69
137
  # @!attribute [rw] status_reason
@@ -95,7 +163,7 @@ module Aws::Batch
95
163
  #
96
164
  # @!attribute [rw] reason
97
165
  # A message to attach to the job that explains the reason for
98
- # cancelling it. This message is returned by future DescribeJobs
166
+ # canceling it. This message is returned by future DescribeJobs
99
167
  # operations on the job. This message is also recorded in the AWS
100
168
  # Batch activity logs.
101
169
  # @return [String]
@@ -599,7 +667,7 @@ module Aws::Batch
599
667
  # to `CpuShares` in the [Create a container][1] section of the [Docker
600
668
  # Remote API][2] and the `--cpu-shares` option to [docker run][3].
601
669
  # Each vCPU is equivalent to 1,024 CPU shares. You must specify at
602
- # least 1 vCPU.
670
+ # least one vCPU.
603
671
  #
604
672
  #
605
673
  #
@@ -652,7 +720,7 @@ module Aws::Batch
652
720
  # maps to `Env` in the [Create a container][1] section of the [Docker
653
721
  # Remote API][2] and the `--env` option to [docker run][3].
654
722
  #
655
- # We do not recommend using plain text environment variables for
723
+ # We do not recommend using plaintext environment variables for
656
724
  # sensitive information, such as credential data.
657
725
  #
658
726
  # <note markdown="1"> Environment variables must not start with `AWS_BATCH`; this naming
@@ -748,6 +816,25 @@ module Aws::Batch
748
816
  include Aws::Structure
749
817
  end
750
818
 
819
+ # An object representing summary details of a container within a job.
820
+ #
821
+ # @!attribute [rw] exit_code
822
+ # The exit code to return upon completion.
823
+ # @return [Integer]
824
+ #
825
+ # @!attribute [rw] reason
826
+ # A short (255 max characters) human-readable string to provide
827
+ # additional details about a running or stopped container.
828
+ # @return [String]
829
+ #
830
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ContainerSummary AWS API Documentation
831
+ #
832
+ class ContainerSummary < Struct.new(
833
+ :exit_code,
834
+ :reason)
835
+ include Aws::Structure
836
+ end
837
+
751
838
  # @note When making an API call, you may pass CreateComputeEnvironmentRequest
752
839
  # data as a hash:
753
840
  #
@@ -878,8 +965,8 @@ module Aws::Batch
878
965
  # order relative to each other. The job scheduler uses this parameter
879
966
  # to determine which compute environment should execute a given job.
880
967
  # Compute environments must be in the `VALID` state before you can
881
- # associate them with a job queue. You can associate up to 3 compute
882
- # environments with a job queue.
968
+ # associate them with a job queue. You can associate up to three
969
+ # compute environments with a job queue.
883
970
  # @return [Array<Types::ComputeEnvironmentOrder>]
884
971
  #
885
972
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/CreateJobQueueRequest AWS API Documentation
@@ -1318,16 +1405,22 @@ module Aws::Batch
1318
1405
  #
1319
1406
  # {
1320
1407
  # job_id: "String",
1408
+ # type: "N_TO_N", # accepts N_TO_N, SEQUENTIAL
1321
1409
  # }
1322
1410
  #
1323
1411
  # @!attribute [rw] job_id
1324
1412
  # The job ID of the AWS Batch job associated with this dependency.
1325
1413
  # @return [String]
1326
1414
  #
1415
+ # @!attribute [rw] type
1416
+ # The type of the job dependency.
1417
+ # @return [String]
1418
+ #
1327
1419
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/JobDependency AWS API Documentation
1328
1420
  #
1329
1421
  class JobDependency < Struct.new(
1330
- :job_id)
1422
+ :job_id,
1423
+ :type)
1331
1424
  include Aws::Structure
1332
1425
  end
1333
1426
 
@@ -1360,8 +1453,11 @@ module Aws::Batch
1360
1453
  # @return [String]
1361
1454
  #
1362
1455
  # @!attribute [rw] created_at
1363
- # The Unix timestamp for when the job was created (when the task
1364
- # entered the `PENDING` state).
1456
+ # The Unix time stamp for when the job was created. For non-array jobs
1457
+ # and parent array jobs, this is when the job entered the `SUBMITTED`
1458
+ # state (at the time SubmitJob was called). For array child jobs, this
1459
+ # is when the child job was spawned by its parent and entered the
1460
+ # `PENDING` state.
1365
1461
  # @return [Integer]
1366
1462
  #
1367
1463
  # @!attribute [rw] retry_strategy
@@ -1369,13 +1465,14 @@ module Aws::Batch
1369
1465
  # @return [Types::RetryStrategy]
1370
1466
  #
1371
1467
  # @!attribute [rw] started_at
1372
- # The Unix timestamp for when the job was started (when the task
1373
- # transitioned from the `PENDING` state to the `RUNNING` state).
1468
+ # The Unix time stamp for when the job was started (when the job
1469
+ # transitioned from the `STARTING` state to the `RUNNING` state).
1374
1470
  # @return [Integer]
1375
1471
  #
1376
1472
  # @!attribute [rw] stopped_at
1377
- # The Unix timestamp for when the job was stopped (when the task
1378
- # transitioned from the `RUNNING` state to the `STOPPED` state).
1473
+ # The Unix time stamp for when the job was stopped (when the job
1474
+ # transitioned from the `RUNNING` state to a terminal state, such as
1475
+ # `SUCCEEDED` or `FAILED`).
1379
1476
  # @return [Integer]
1380
1477
  #
1381
1478
  # @!attribute [rw] depends_on
@@ -1397,6 +1494,10 @@ module Aws::Batch
1397
1494
  # associated with the job.
1398
1495
  # @return [Types::ContainerDetail]
1399
1496
  #
1497
+ # @!attribute [rw] array_properties
1498
+ # The array properties of the job, if it is an array job.
1499
+ # @return [Types::ArrayPropertiesDetail]
1500
+ #
1400
1501
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/JobDetail AWS API Documentation
1401
1502
  #
1402
1503
  class JobDetail < Struct.new(
@@ -1413,7 +1514,8 @@ module Aws::Batch
1413
1514
  :depends_on,
1414
1515
  :job_definition,
1415
1516
  :parameters,
1416
- :container)
1517
+ :container,
1518
+ :array_properties)
1417
1519
  include Aws::Structure
1418
1520
  end
1419
1521
 
@@ -1473,11 +1575,55 @@ module Aws::Batch
1473
1575
  # The name of the job.
1474
1576
  # @return [String]
1475
1577
  #
1578
+ # @!attribute [rw] created_at
1579
+ # The Unix time stamp for when the job was created. For non-array jobs
1580
+ # and parent array jobs, this is when the job entered the `SUBMITTED`
1581
+ # state (at the time SubmitJob was called). For array child jobs, this
1582
+ # is when the child job was spawned by its parent and entered the
1583
+ # `PENDING` state.
1584
+ # @return [Integer]
1585
+ #
1586
+ # @!attribute [rw] status
1587
+ # The current status for the job.
1588
+ # @return [String]
1589
+ #
1590
+ # @!attribute [rw] status_reason
1591
+ # A short, human-readable string to provide additional details about
1592
+ # the current status of the job.
1593
+ # @return [String]
1594
+ #
1595
+ # @!attribute [rw] started_at
1596
+ # The Unix time stamp for when the job was started (when the job
1597
+ # transitioned from the `STARTING` state to the `RUNNING` state).
1598
+ # @return [Integer]
1599
+ #
1600
+ # @!attribute [rw] stopped_at
1601
+ # The Unix time stamp for when the job was stopped (when the job
1602
+ # transitioned from the `RUNNING` state to a terminal state, such as
1603
+ # `SUCCEEDED` or `FAILED`).
1604
+ # @return [Integer]
1605
+ #
1606
+ # @!attribute [rw] container
1607
+ # An object representing the details of the container that is
1608
+ # associated with the job.
1609
+ # @return [Types::ContainerSummary]
1610
+ #
1611
+ # @!attribute [rw] array_properties
1612
+ # The array properties of the job, if it is an array job.
1613
+ # @return [Types::ArrayPropertiesSummary]
1614
+ #
1476
1615
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/JobSummary AWS API Documentation
1477
1616
  #
1478
1617
  class JobSummary < Struct.new(
1479
1618
  :job_id,
1480
- :job_name)
1619
+ :job_name,
1620
+ :created_at,
1621
+ :status,
1622
+ :status_reason,
1623
+ :started_at,
1624
+ :stopped_at,
1625
+ :container,
1626
+ :array_properties)
1481
1627
  include Aws::Structure
1482
1628
  end
1483
1629
 
@@ -1492,12 +1638,12 @@ module Aws::Batch
1492
1638
  # }
1493
1639
  #
1494
1640
  # @!attribute [rw] name
1495
- # The name of the key value pair. For environment variables, this is
1641
+ # The name of the key-value pair. For environment variables, this is
1496
1642
  # the name of the environment variable.
1497
1643
  # @return [String]
1498
1644
  #
1499
1645
  # @!attribute [rw] value
1500
- # The value of the key value pair. For environment variables, this is
1646
+ # The value of the key-value pair. For environment variables, this is
1501
1647
  # the value of the environment variable.
1502
1648
  # @return [String]
1503
1649
  #
@@ -1513,7 +1659,8 @@ module Aws::Batch
1513
1659
  # data as a hash:
1514
1660
  #
1515
1661
  # {
1516
- # job_queue: "String", # required
1662
+ # job_queue: "String",
1663
+ # array_job_id: "String",
1517
1664
  # job_status: "SUBMITTED", # accepts SUBMITTED, PENDING, RUNNABLE, STARTING, RUNNING, SUCCEEDED, FAILED
1518
1665
  # max_results: 1,
1519
1666
  # next_token: "String",
@@ -1524,6 +1671,11 @@ module Aws::Batch
1524
1671
  # which to list jobs.
1525
1672
  # @return [String]
1526
1673
  #
1674
+ # @!attribute [rw] array_job_id
1675
+ # The job ID for an array job. Specifying an array job ID with this
1676
+ # parameter lists all child jobs from within the specified array.
1677
+ # @return [String]
1678
+ #
1527
1679
  # @!attribute [rw] job_status
1528
1680
  # The job status with which to filter jobs in the specified queue. If
1529
1681
  # you do not specify a status, only `RUNNING` jobs are returned.
@@ -1558,6 +1710,7 @@ module Aws::Batch
1558
1710
  #
1559
1711
  class ListJobsRequest < Struct.new(
1560
1712
  :job_queue,
1713
+ :array_job_id,
1561
1714
  :job_status,
1562
1715
  :max_results,
1563
1716
  :next_token)
@@ -1741,9 +1894,9 @@ module Aws::Batch
1741
1894
  #
1742
1895
  # @!attribute [rw] attempts
1743
1896
  # The number of times to move a job to the `RUNNABLE` status. You may
1744
- # specify between 1 and 10 attempts. If `attempts` is greater than
1745
- # one, the job is retried if it fails until it has moved to `RUNNABLE`
1746
- # that many times.
1897
+ # specify between 1 and 10 attempts. If the value of `attempts` is
1898
+ # greater than one, the job is retried if it fails until it has moved
1899
+ # to `RUNNABLE` that many times.
1747
1900
  # @return [Integer]
1748
1901
  #
1749
1902
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/RetryStrategy AWS API Documentation
@@ -1759,9 +1912,13 @@ module Aws::Batch
1759
1912
  # {
1760
1913
  # job_name: "String", # required
1761
1914
  # job_queue: "String", # required
1915
+ # array_properties: {
1916
+ # size: 1,
1917
+ # },
1762
1918
  # depends_on: [
1763
1919
  # {
1764
1920
  # job_id: "String",
1921
+ # type: "N_TO_N", # accepts N_TO_N, SEQUENTIAL
1765
1922
  # },
1766
1923
  # ],
1767
1924
  # job_definition: "String", # required
@@ -1791,13 +1948,29 @@ module Aws::Batch
1791
1948
  # @return [String]
1792
1949
  #
1793
1950
  # @!attribute [rw] job_queue
1794
- # The job queue into which the job will be submitted. You can specify
1951
+ # The job queue into which the job is submitted. You can specify
1795
1952
  # either the name or the Amazon Resource Name (ARN) of the queue.
1796
1953
  # @return [String]
1797
1954
  #
1955
+ # @!attribute [rw] array_properties
1956
+ # The array properties for the submitted job, such as the size of the
1957
+ # array. The array size can be between 2 and 10,000. If you specify
1958
+ # array properties for a job, it becomes an array job. For more
1959
+ # information, see [Array Jobs][1] in the *AWS Batch User Guide*.
1960
+ #
1961
+ #
1962
+ #
1963
+ # [1]: http://docs.aws.amazon.com/batch/latest/userguide/array_jobs.html
1964
+ # @return [Types::ArrayProperties]
1965
+ #
1798
1966
  # @!attribute [rw] depends_on
1799
- # A list of job IDs on which this job depends. A job can depend upon a
1800
- # maximum of 20 jobs.
1967
+ # A list of dependencies for the job. A job can depend upon a maximum
1968
+ # of 20 jobs. You can specify a `SEQUENTIAL` type dependency without
1969
+ # specifying a job ID for array jobs so that each child array job
1970
+ # completes sequentially, starting at index 0. You can also specify an
1971
+ # `N_TO_N` type dependency with a job ID for array jobs so that each
1972
+ # index child of this job must wait for the corresponding index child
1973
+ # of each dependency to complete before it can begin.
1801
1974
  # @return [Array<Types::JobDependency>]
1802
1975
  #
1803
1976
  # @!attribute [rw] job_definition
@@ -1836,6 +2009,7 @@ module Aws::Batch
1836
2009
  class SubmitJobRequest < Struct.new(
1837
2010
  :job_name,
1838
2011
  :job_queue,
2012
+ :array_properties,
1839
2013
  :depends_on,
1840
2014
  :job_definition,
1841
2015
  :parameters,
@@ -1874,7 +2048,7 @@ module Aws::Batch
1874
2048
  #
1875
2049
  # @!attribute [rw] reason
1876
2050
  # A message to attach to the job that explains the reason for
1877
- # cancelling it. This message is returned by future DescribeJobs
2051
+ # canceling it. This message is returned by future DescribeJobs
1878
2052
  # operations on the job. This message is also recorded in the AWS
1879
2053
  # Batch activity logs.
1880
2054
  # @return [String]
@@ -2078,7 +2252,7 @@ module Aws::Batch
2078
2252
  # The contents of the `host` parameter determine whether your data
2079
2253
  # volume persists on the host container instance and where it is
2080
2254
  # stored. If the host parameter is empty, then the Docker daemon
2081
- # assigns a host path for your data volume, but the data is not
2255
+ # assigns a host path for your data volume. However, the data is not
2082
2256
  # guaranteed to persist after the containers associated with it stop
2083
2257
  # running.
2084
2258
  # @return [Types::Host]
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-batch
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.2.0
4
+ version: 1.3.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2017-11-08 00:00:00.000000000 Z
11
+ date: 2017-11-29 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core