aws-sdk-batch 1.133.0 → 1.134.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: '08628b53a5256cd5d36529ef12d2d77d658a4dd1f10c86592d42ed4973b37983'
4
- data.tar.gz: a4508b0eeb1c20d0b2fd05fee3b11d90321fb2c87d12f95435db6b5c82558237
3
+ metadata.gz: 9b5ea2c994846250f1f4dc318130dfb390bb4e7a3e7027fb9f7a469270b4d45d
4
+ data.tar.gz: af24b457076e7047020a48f9d42708ac121264c6f1908270be4023a81b262bc0
5
5
  SHA512:
6
- metadata.gz: f7cda5f5afb8b0c5f36938c222a13757526d2c4584604830d09073151141cf8162f5d62b1cfa8dbaaddb084720d8a5d43fd198445e7b47bb452e4583ead22a8b
7
- data.tar.gz: 5e873ec2d65a2c4d372d6c27196d0026d876aa6e0fb1b9d3002e8c291219e5171b5d56f9806ca8ce04e5101990c9d8a1f322b1a1162cb7d30d8de7f3fdb6c760
6
+ metadata.gz: 26241a2dc38418c4eefb2135b84a42a5239ea524f857fa4ae025a638113779760c12927abeb5f41f3c47c534ae469af8cb4474d5fb61f605f0755fd563c05433
7
+ data.tar.gz: fddbdfda814db27b85f7b5caf4055ade6aab2ab1cc1fbf39cb0800d0f093d1c6fa04b9a370a0cb1df680db9b48ad00e11547bfb8b9cd286bc1117bdcb3469edd
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.134.0 (2026-02-11)
5
+ ------------------
6
+
7
+ * Feature - Add support for listing jobs by share identifier and getting snapshots of active capacity utilization by job queue and share.
8
+
4
9
  1.133.0 (2026-02-03)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.133.0
1
+ 1.134.0
@@ -3121,6 +3121,7 @@ module Aws::Batch
3121
3121
  # @return [Types::DescribeServiceJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3122
3122
  #
3123
3123
  # * {Types::DescribeServiceJobResponse#attempts #attempts} => Array<Types::ServiceJobAttemptDetail>
3124
+ # * {Types::DescribeServiceJobResponse#capacity_usage #capacity_usage} => Array<Types::ServiceJobCapacityUsageDetail>
3124
3125
  # * {Types::DescribeServiceJobResponse#created_at #created_at} => Integer
3125
3126
  # * {Types::DescribeServiceJobResponse#is_terminated #is_terminated} => Boolean
3126
3127
  # * {Types::DescribeServiceJobResponse#job_arn #job_arn} => String
@@ -3129,6 +3130,7 @@ module Aws::Batch
3129
3130
  # * {Types::DescribeServiceJobResponse#job_queue #job_queue} => String
3130
3131
  # * {Types::DescribeServiceJobResponse#latest_attempt #latest_attempt} => Types::LatestServiceJobAttempt
3131
3132
  # * {Types::DescribeServiceJobResponse#retry_strategy #retry_strategy} => Types::ServiceJobRetryStrategy
3133
+ # * {Types::DescribeServiceJobResponse#scheduled_at #scheduled_at} => Integer
3132
3134
  # * {Types::DescribeServiceJobResponse#scheduling_priority #scheduling_priority} => Integer
3133
3135
  # * {Types::DescribeServiceJobResponse#service_request_payload #service_request_payload} => String
3134
3136
  # * {Types::DescribeServiceJobResponse#service_job_type #service_job_type} => String
@@ -3154,6 +3156,9 @@ module Aws::Batch
3154
3156
  # resp.attempts[0].started_at #=> Integer
3155
3157
  # resp.attempts[0].stopped_at #=> Integer
3156
3158
  # resp.attempts[0].status_reason #=> String
3159
+ # resp.capacity_usage #=> Array
3160
+ # resp.capacity_usage[0].capacity_unit #=> String
3161
+ # resp.capacity_usage[0].quantity #=> Float
3157
3162
  # resp.created_at #=> Integer
3158
3163
  # resp.is_terminated #=> Boolean
3159
3164
  # resp.job_arn #=> String
@@ -3166,6 +3171,7 @@ module Aws::Batch
3166
3171
  # resp.retry_strategy.evaluate_on_exit #=> Array
3167
3172
  # resp.retry_strategy.evaluate_on_exit[0].action #=> String, one of "RETRY", "EXIT"
3168
3173
  # resp.retry_strategy.evaluate_on_exit[0].on_status_reason #=> String
3174
+ # resp.scheduled_at #=> Integer
3169
3175
  # resp.scheduling_priority #=> Integer
3170
3176
  # resp.service_request_payload #=> String
3171
3177
  # resp.service_job_type #=> String, one of "SAGEMAKER_TRAINING"
@@ -3188,7 +3194,8 @@ module Aws::Batch
3188
3194
  end
3189
3195
 
3190
3196
  # Provides a list of the first 100 `RUNNABLE` jobs associated to a
3191
- # single job queue.
3197
+ # single job queue and includes capacity utilization, including total
3198
+ # usage and breakdown by share for fairshare scheduling job queues.
3192
3199
  #
3193
3200
  # @option params [required, String] :job_queue
3194
3201
  # The job queue’s name or full queue Amazon Resource Name (ARN).
@@ -3196,6 +3203,7 @@ module Aws::Batch
3196
3203
  # @return [Types::GetJobQueueSnapshotResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3197
3204
  #
3198
3205
  # * {Types::GetJobQueueSnapshotResponse#front_of_queue #front_of_queue} => Types::FrontOfQueueDetail
3206
+ # * {Types::GetJobQueueSnapshotResponse#queue_utilization #queue_utilization} => Types::QueueSnapshotUtilizationDetail
3199
3207
  #
3200
3208
  # @example Request syntax with placeholder values
3201
3209
  #
@@ -3209,6 +3217,16 @@ module Aws::Batch
3209
3217
  # resp.front_of_queue.jobs[0].job_arn #=> String
3210
3218
  # resp.front_of_queue.jobs[0].earliest_time_at_position #=> Integer
3211
3219
  # resp.front_of_queue.last_updated_at #=> Integer
3220
+ # resp.queue_utilization.total_capacity_usage #=> Array
3221
+ # resp.queue_utilization.total_capacity_usage[0].capacity_unit #=> String
3222
+ # resp.queue_utilization.total_capacity_usage[0].quantity #=> Float
3223
+ # resp.queue_utilization.fairshare_utilization.active_share_count #=> Integer
3224
+ # resp.queue_utilization.fairshare_utilization.top_capacity_utilization #=> Array
3225
+ # resp.queue_utilization.fairshare_utilization.top_capacity_utilization[0].share_identifier #=> String
3226
+ # resp.queue_utilization.fairshare_utilization.top_capacity_utilization[0].capacity_usage #=> Array
3227
+ # resp.queue_utilization.fairshare_utilization.top_capacity_utilization[0].capacity_usage[0].capacity_unit #=> String
3228
+ # resp.queue_utilization.fairshare_utilization.top_capacity_utilization[0].capacity_usage[0].quantity #=> Float
3229
+ # resp.queue_utilization.last_updated_at #=> Integer
3212
3230
  #
3213
3231
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/GetJobQueueSnapshot AWS API Documentation
3214
3232
  #
@@ -3335,10 +3353,6 @@ module Aws::Batch
3335
3353
  #
3336
3354
  # * An array job ID to return a list of the children for that job
3337
3355
  #
3338
- # You can filter the results by job status with the `jobStatus`
3339
- # parameter. If you don't specify a status, only `RUNNING` jobs are
3340
- # returned.
3341
- #
3342
3356
  # @option params [String] :job_queue
3343
3357
  # The name or full Amazon Resource Name (ARN) of the job queue used to
3344
3358
  # list jobs.
@@ -3355,8 +3369,9 @@ module Aws::Batch
3355
3369
  # @option params [String] :job_status
3356
3370
  # The job status used to filter jobs in the specified queue. If the
3357
3371
  # `filters` parameter is specified, the `jobStatus` parameter is ignored
3358
- # and jobs with any status are returned. If you don't specify a status,
3359
- # only `RUNNING` jobs are returned.
3372
+ # and jobs with any status are returned. The exception is the
3373
+ # `SHARE_IDENTIFIER` filter and `jobStatus` can be used together. If you
3374
+ # don't specify a status, only `RUNNING` jobs are returned.
3360
3375
  #
3361
3376
  # <note markdown="1"> Array job parents are updated to `PENDING` when any child job is
3362
3377
  # updated to `RUNNABLE` and remain in `PENDING` status while child jobs
@@ -3399,10 +3414,16 @@ module Aws::Batch
3399
3414
  #
3400
3415
  # @option params [Array<Types::KeyValuesPair>] :filters
3401
3416
  # The filter to apply to the query. Only one filter can be used at a
3402
- # time. When the filter is used, `jobStatus` is ignored. The filter
3403
- # doesn't apply to child jobs in an array or multi-node parallel (MNP)
3404
- # jobs. The results are sorted by the `createdAt` field, with the most
3405
- # recent jobs being first.
3417
+ # time. When the filter is used, `jobStatus` is ignored with the
3418
+ # exception that `SHARE_IDENTIFIER` and `jobStatus` can be used
3419
+ # together. The filter doesn't apply to child jobs in an array or
3420
+ # multi-node parallel (MNP) jobs. The results are sorted by the
3421
+ # `createdAt` field, with the most recent jobs being first.
3422
+ #
3423
+ # <note markdown="1"> The `SHARE_IDENTIFIER` filter and the `jobStatus` field can be used
3424
+ # together to filter results.
3425
+ #
3426
+ # </note>
3406
3427
  #
3407
3428
  # JOB\_NAME
3408
3429
  #
@@ -3445,6 +3466,11 @@ module Aws::Batch
3445
3466
  # string representation of the number of milliseconds since 00:00:00
3446
3467
  # UTC (midnight) on January 1, 1970.
3447
3468
  #
3469
+ # SHARE\_IDENTIFIER
3470
+ #
3471
+ # : The value for the filter is the fairshare scheduling share
3472
+ # identifier.
3473
+ #
3448
3474
  # @return [Types::ListJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3449
3475
  #
3450
3476
  # * {Types::ListJobsResponse#job_summary_list #job_summary_list} => Array&lt;Types::JobSummary&gt;
@@ -3513,7 +3539,12 @@ module Aws::Batch
3513
3539
  # resp.job_summary_list[0].job_arn #=> String
3514
3540
  # resp.job_summary_list[0].job_id #=> String
3515
3541
  # resp.job_summary_list[0].job_name #=> String
3542
+ # resp.job_summary_list[0].capacity_usage #=> Array
3543
+ # resp.job_summary_list[0].capacity_usage[0].capacity_unit #=> String
3544
+ # resp.job_summary_list[0].capacity_usage[0].quantity #=> Float
3516
3545
  # resp.job_summary_list[0].created_at #=> Integer
3546
+ # resp.job_summary_list[0].scheduled_at #=> Integer
3547
+ # resp.job_summary_list[0].share_identifier #=> String
3517
3548
  # resp.job_summary_list[0].status #=> String, one of "SUBMITTED", "PENDING", "RUNNABLE", "STARTING", "RUNNING", "SUCCEEDED", "FAILED"
3518
3549
  # resp.job_summary_list[0].status_reason #=> String
3519
3550
  # resp.job_summary_list[0].started_at #=> Integer
@@ -3735,7 +3766,16 @@ module Aws::Batch
3735
3766
  # The name or ARN of the job queue with which to list service jobs.
3736
3767
  #
3737
3768
  # @option params [String] :job_status
3738
- # The job status with which to filter service jobs.
3769
+ # The job status used to filter service jobs in the specified queue. If
3770
+ # the `filters` parameter is specified, the `jobStatus` parameter is
3771
+ # ignored and jobs with any status are returned. The exception is the
3772
+ # `SHARE_IDENTIFIER` filter and `jobStatus` can be used together. If you
3773
+ # don't specify a status, only `RUNNING` jobs are returned.
3774
+ #
3775
+ # <note markdown="1"> The `SHARE_IDENTIFIER` filter and the `jobStatus` field can be used
3776
+ # together to filter results.
3777
+ #
3778
+ # </note>
3739
3779
  #
3740
3780
  # @option params [Integer] :max_results
3741
3781
  # The maximum number of results returned by `ListServiceJobs` in
@@ -3761,9 +3801,15 @@ module Aws::Batch
3761
3801
  #
3762
3802
  # @option params [Array<Types::KeyValuesPair>] :filters
3763
3803
  # The filter to apply to the query. Only one filter can be used at a
3764
- # time. When the filter is used, `jobStatus` is ignored. The results are
3765
- # sorted by the `createdAt` field, with the most recent jobs being
3766
- # first.
3804
+ # time. When the filter is used, `jobStatus` is ignored with the
3805
+ # exception that `SHARE_IDENTIFIER` and `jobStatus` can be used
3806
+ # together. The results are sorted by the `createdAt` field, with the
3807
+ # most recent jobs being first.
3808
+ #
3809
+ # <note markdown="1"> The `SHARE_IDENTIFIER` filter and the `jobStatus` field can be used
3810
+ # together to filter results.
3811
+ #
3812
+ # </note>
3767
3813
  #
3768
3814
  # JOB\_NAME
3769
3815
  #
@@ -3789,6 +3835,11 @@ module Aws::Batch
3789
3835
  # string representation of the number of milliseconds since 00:00:00
3790
3836
  # UTC (midnight) on January 1, 1970.
3791
3837
  #
3838
+ # SHARE\_IDENTIFIER
3839
+ #
3840
+ # : The value for the filter is the fairshare scheduling share
3841
+ # identifier.
3842
+ #
3792
3843
  # @return [Types::ListServiceJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3793
3844
  #
3794
3845
  # * {Types::ListServiceJobsResponse#job_summary_list #job_summary_list} => Array&lt;Types::ServiceJobSummary&gt;
@@ -3816,10 +3867,14 @@ module Aws::Batch
3816
3867
  # resp.job_summary_list #=> Array
3817
3868
  # resp.job_summary_list[0].latest_attempt.service_resource_id.name #=> String, one of "TrainingJobArn"
3818
3869
  # resp.job_summary_list[0].latest_attempt.service_resource_id.value #=> String
3870
+ # resp.job_summary_list[0].capacity_usage #=> Array
3871
+ # resp.job_summary_list[0].capacity_usage[0].capacity_unit #=> String
3872
+ # resp.job_summary_list[0].capacity_usage[0].quantity #=> Float
3819
3873
  # resp.job_summary_list[0].created_at #=> Integer
3820
3874
  # resp.job_summary_list[0].job_arn #=> String
3821
3875
  # resp.job_summary_list[0].job_id #=> String
3822
3876
  # resp.job_summary_list[0].job_name #=> String
3877
+ # resp.job_summary_list[0].scheduled_at #=> Integer
3823
3878
  # resp.job_summary_list[0].service_job_type #=> String, one of "SAGEMAKER_TRAINING"
3824
3879
  # resp.job_summary_list[0].share_identifier #=> String
3825
3880
  # resp.job_summary_list[0].status #=> String, one of "SUBMITTED", "PENDING", "RUNNABLE", "SCHEDULED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED"
@@ -6141,7 +6196,7 @@ module Aws::Batch
6141
6196
  tracer: tracer
6142
6197
  )
6143
6198
  context[:gem_name] = 'aws-sdk-batch'
6144
- context[:gem_version] = '1.133.0'
6199
+ context[:gem_version] = '1.134.0'
6145
6200
  Seahorse::Client::Request.new(handlers, context)
6146
6201
  end
6147
6202
 
@@ -95,6 +95,7 @@ module Aws::Batch
95
95
  DeviceCgroupPermission = Shapes::StringShape.new(name: 'DeviceCgroupPermission')
96
96
  DeviceCgroupPermissions = Shapes::ListShape.new(name: 'DeviceCgroupPermissions')
97
97
  DevicesList = Shapes::ListShape.new(name: 'DevicesList')
98
+ Double = Shapes::FloatShape.new(name: 'Double')
98
99
  EFSAuthorizationConfig = Shapes::StructureShape.new(name: 'EFSAuthorizationConfig')
99
100
  EFSAuthorizationConfigIAM = Shapes::StringShape.new(name: 'EFSAuthorizationConfigIAM')
100
101
  EFSTransitEncryption = Shapes::StringShape.new(name: 'EFSTransitEncryption')
@@ -144,7 +145,12 @@ module Aws::Batch
144
145
  EphemeralStorage = Shapes::StructureShape.new(name: 'EphemeralStorage')
145
146
  EvaluateOnExit = Shapes::StructureShape.new(name: 'EvaluateOnExit')
146
147
  EvaluateOnExitList = Shapes::ListShape.new(name: 'EvaluateOnExitList')
148
+ FairshareCapacityUsage = Shapes::StructureShape.new(name: 'FairshareCapacityUsage')
149
+ FairshareCapacityUsageList = Shapes::ListShape.new(name: 'FairshareCapacityUsageList')
150
+ FairshareCapacityUtilization = Shapes::StructureShape.new(name: 'FairshareCapacityUtilization')
151
+ FairshareCapacityUtilizationList = Shapes::ListShape.new(name: 'FairshareCapacityUtilizationList')
147
152
  FairsharePolicy = Shapes::StructureShape.new(name: 'FairsharePolicy')
153
+ FairshareUtilizationDetail = Shapes::StructureShape.new(name: 'FairshareUtilizationDetail')
148
154
  FargatePlatformConfiguration = Shapes::StructureShape.new(name: 'FargatePlatformConfiguration')
149
155
  FirelensConfiguration = Shapes::StructureShape.new(name: 'FirelensConfiguration')
150
156
  FirelensConfigurationOptionsMap = Shapes::MapShape.new(name: 'FirelensConfigurationOptionsMap')
@@ -163,6 +169,8 @@ module Aws::Batch
163
169
  Integer = Shapes::IntegerShape.new(name: 'Integer')
164
170
  JQState = Shapes::StringShape.new(name: 'JQState')
165
171
  JQStatus = Shapes::StringShape.new(name: 'JQStatus')
172
+ JobCapacityUsageSummary = Shapes::StructureShape.new(name: 'JobCapacityUsageSummary')
173
+ JobCapacityUsageSummaryList = Shapes::ListShape.new(name: 'JobCapacityUsageSummaryList')
166
174
  JobDefinition = Shapes::StructureShape.new(name: 'JobDefinition')
167
175
  JobDefinitionList = Shapes::ListShape.new(name: 'JobDefinitionList')
168
176
  JobDefinitionType = Shapes::StringShape.new(name: 'JobDefinitionType')
@@ -237,6 +245,9 @@ module Aws::Batch
237
245
  PlatformCapability = Shapes::StringShape.new(name: 'PlatformCapability')
238
246
  PlatformCapabilityList = Shapes::ListShape.new(name: 'PlatformCapabilityList')
239
247
  Quantity = Shapes::StringShape.new(name: 'Quantity')
248
+ QueueSnapshotCapacityUsage = Shapes::StructureShape.new(name: 'QueueSnapshotCapacityUsage')
249
+ QueueSnapshotCapacityUsageList = Shapes::ListShape.new(name: 'QueueSnapshotCapacityUsageList')
250
+ QueueSnapshotUtilizationDetail = Shapes::StructureShape.new(name: 'QueueSnapshotUtilizationDetail')
240
251
  RegisterJobDefinitionRequest = Shapes::StructureShape.new(name: 'RegisterJobDefinitionRequest')
241
252
  RegisterJobDefinitionResponse = Shapes::StructureShape.new(name: 'RegisterJobDefinitionResponse')
242
253
  RepositoryCredentials = Shapes::StructureShape.new(name: 'RepositoryCredentials')
@@ -262,6 +273,10 @@ module Aws::Batch
262
273
  ServiceEnvironmentType = Shapes::StringShape.new(name: 'ServiceEnvironmentType')
263
274
  ServiceJobAttemptDetail = Shapes::StructureShape.new(name: 'ServiceJobAttemptDetail')
264
275
  ServiceJobAttemptDetails = Shapes::ListShape.new(name: 'ServiceJobAttemptDetails')
276
+ ServiceJobCapacityUsageDetail = Shapes::StructureShape.new(name: 'ServiceJobCapacityUsageDetail')
277
+ ServiceJobCapacityUsageDetailList = Shapes::ListShape.new(name: 'ServiceJobCapacityUsageDetailList')
278
+ ServiceJobCapacityUsageSummary = Shapes::StructureShape.new(name: 'ServiceJobCapacityUsageSummary')
279
+ ServiceJobCapacityUsageSummaryList = Shapes::ListShape.new(name: 'ServiceJobCapacityUsageSummaryList')
265
280
  ServiceJobEvaluateOnExit = Shapes::StructureShape.new(name: 'ServiceJobEvaluateOnExit')
266
281
  ServiceJobEvaluateOnExitList = Shapes::ListShape.new(name: 'ServiceJobEvaluateOnExitList')
267
282
  ServiceJobRetryAction = Shapes::StringShape.new(name: 'ServiceJobRetryAction')
@@ -690,6 +705,7 @@ module Aws::Batch
690
705
  DescribeServiceJobRequest.struct_class = Types::DescribeServiceJobRequest
691
706
 
692
707
  DescribeServiceJobResponse.add_member(:attempts, Shapes::ShapeRef.new(shape: ServiceJobAttemptDetails, location_name: "attempts"))
708
+ DescribeServiceJobResponse.add_member(:capacity_usage, Shapes::ShapeRef.new(shape: ServiceJobCapacityUsageDetailList, location_name: "capacityUsage"))
693
709
  DescribeServiceJobResponse.add_member(:created_at, Shapes::ShapeRef.new(shape: Long, location_name: "createdAt"))
694
710
  DescribeServiceJobResponse.add_member(:is_terminated, Shapes::ShapeRef.new(shape: Boolean, location_name: "isTerminated"))
695
711
  DescribeServiceJobResponse.add_member(:job_arn, Shapes::ShapeRef.new(shape: String, location_name: "jobArn"))
@@ -698,6 +714,7 @@ module Aws::Batch
698
714
  DescribeServiceJobResponse.add_member(:job_queue, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobQueue"))
699
715
  DescribeServiceJobResponse.add_member(:latest_attempt, Shapes::ShapeRef.new(shape: LatestServiceJobAttempt, location_name: "latestAttempt"))
700
716
  DescribeServiceJobResponse.add_member(:retry_strategy, Shapes::ShapeRef.new(shape: ServiceJobRetryStrategy, location_name: "retryStrategy"))
717
+ DescribeServiceJobResponse.add_member(:scheduled_at, Shapes::ShapeRef.new(shape: Long, location_name: "scheduledAt"))
701
718
  DescribeServiceJobResponse.add_member(:scheduling_priority, Shapes::ShapeRef.new(shape: Integer, location_name: "schedulingPriority"))
702
719
  DescribeServiceJobResponse.add_member(:service_request_payload, Shapes::ShapeRef.new(shape: String, location_name: "serviceRequestPayload"))
703
720
  DescribeServiceJobResponse.add_member(:service_job_type, Shapes::ShapeRef.new(shape: ServiceJobType, required: true, location_name: "serviceJobType"))
@@ -955,11 +972,27 @@ module Aws::Batch
955
972
 
956
973
  EvaluateOnExitList.member = Shapes::ShapeRef.new(shape: EvaluateOnExit)
957
974
 
975
+ FairshareCapacityUsage.add_member(:capacity_unit, Shapes::ShapeRef.new(shape: String, location_name: "capacityUnit"))
976
+ FairshareCapacityUsage.add_member(:quantity, Shapes::ShapeRef.new(shape: Double, location_name: "quantity"))
977
+ FairshareCapacityUsage.struct_class = Types::FairshareCapacityUsage
978
+
979
+ FairshareCapacityUsageList.member = Shapes::ShapeRef.new(shape: FairshareCapacityUsage)
980
+
981
+ FairshareCapacityUtilization.add_member(:share_identifier, Shapes::ShapeRef.new(shape: String, location_name: "shareIdentifier"))
982
+ FairshareCapacityUtilization.add_member(:capacity_usage, Shapes::ShapeRef.new(shape: FairshareCapacityUsageList, location_name: "capacityUsage"))
983
+ FairshareCapacityUtilization.struct_class = Types::FairshareCapacityUtilization
984
+
985
+ FairshareCapacityUtilizationList.member = Shapes::ShapeRef.new(shape: FairshareCapacityUtilization)
986
+
958
987
  FairsharePolicy.add_member(:share_decay_seconds, Shapes::ShapeRef.new(shape: Integer, location_name: "shareDecaySeconds"))
959
988
  FairsharePolicy.add_member(:compute_reservation, Shapes::ShapeRef.new(shape: Integer, location_name: "computeReservation"))
960
989
  FairsharePolicy.add_member(:share_distribution, Shapes::ShapeRef.new(shape: ShareAttributesList, location_name: "shareDistribution"))
961
990
  FairsharePolicy.struct_class = Types::FairsharePolicy
962
991
 
992
+ FairshareUtilizationDetail.add_member(:active_share_count, Shapes::ShapeRef.new(shape: Long, location_name: "activeShareCount"))
993
+ FairshareUtilizationDetail.add_member(:top_capacity_utilization, Shapes::ShapeRef.new(shape: FairshareCapacityUtilizationList, location_name: "topCapacityUtilization"))
994
+ FairshareUtilizationDetail.struct_class = Types::FairshareUtilizationDetail
995
+
963
996
  FargatePlatformConfiguration.add_member(:platform_version, Shapes::ShapeRef.new(shape: String, location_name: "platformVersion"))
964
997
  FargatePlatformConfiguration.struct_class = Types::FargatePlatformConfiguration
965
998
 
@@ -984,6 +1017,7 @@ module Aws::Batch
984
1017
  GetJobQueueSnapshotRequest.struct_class = Types::GetJobQueueSnapshotRequest
985
1018
 
986
1019
  GetJobQueueSnapshotResponse.add_member(:front_of_queue, Shapes::ShapeRef.new(shape: FrontOfQueueDetail, location_name: "frontOfQueue"))
1020
+ GetJobQueueSnapshotResponse.add_member(:queue_utilization, Shapes::ShapeRef.new(shape: QueueSnapshotUtilizationDetail, location_name: "queueUtilization"))
987
1021
  GetJobQueueSnapshotResponse.struct_class = Types::GetJobQueueSnapshotResponse
988
1022
 
989
1023
  Host.add_member(:source_path, Shapes::ShapeRef.new(shape: String, location_name: "sourcePath"))
@@ -994,6 +1028,12 @@ module Aws::Batch
994
1028
 
995
1029
  ImagePullSecrets.member = Shapes::ShapeRef.new(shape: ImagePullSecret)
996
1030
 
1031
+ JobCapacityUsageSummary.add_member(:capacity_unit, Shapes::ShapeRef.new(shape: String, location_name: "capacityUnit"))
1032
+ JobCapacityUsageSummary.add_member(:quantity, Shapes::ShapeRef.new(shape: Double, location_name: "quantity"))
1033
+ JobCapacityUsageSummary.struct_class = Types::JobCapacityUsageSummary
1034
+
1035
+ JobCapacityUsageSummaryList.member = Shapes::ShapeRef.new(shape: JobCapacityUsageSummary)
1036
+
997
1037
  JobDefinition.add_member(:job_definition_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobDefinitionName"))
998
1038
  JobDefinition.add_member(:job_definition_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobDefinitionArn"))
999
1039
  JobDefinition.add_member(:revision, Shapes::ShapeRef.new(shape: Integer, required: true, location_name: "revision"))
@@ -1083,7 +1123,10 @@ module Aws::Batch
1083
1123
  JobSummary.add_member(:job_arn, Shapes::ShapeRef.new(shape: String, location_name: "jobArn"))
1084
1124
  JobSummary.add_member(:job_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobId"))
1085
1125
  JobSummary.add_member(:job_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobName"))
1126
+ JobSummary.add_member(:capacity_usage, Shapes::ShapeRef.new(shape: JobCapacityUsageSummaryList, location_name: "capacityUsage"))
1086
1127
  JobSummary.add_member(:created_at, Shapes::ShapeRef.new(shape: Long, location_name: "createdAt"))
1128
+ JobSummary.add_member(:scheduled_at, Shapes::ShapeRef.new(shape: Long, location_name: "scheduledAt"))
1129
+ JobSummary.add_member(:share_identifier, Shapes::ShapeRef.new(shape: String, location_name: "shareIdentifier"))
1087
1130
  JobSummary.add_member(:status, Shapes::ShapeRef.new(shape: JobStatus, location_name: "status"))
1088
1131
  JobSummary.add_member(:status_reason, Shapes::ShapeRef.new(shape: String, location_name: "statusReason"))
1089
1132
  JobSummary.add_member(:started_at, Shapes::ShapeRef.new(shape: Long, location_name: "startedAt"))
@@ -1296,6 +1339,17 @@ module Aws::Batch
1296
1339
 
1297
1340
  PlatformCapabilityList.member = Shapes::ShapeRef.new(shape: PlatformCapability)
1298
1341
 
1342
+ QueueSnapshotCapacityUsage.add_member(:capacity_unit, Shapes::ShapeRef.new(shape: String, location_name: "capacityUnit"))
1343
+ QueueSnapshotCapacityUsage.add_member(:quantity, Shapes::ShapeRef.new(shape: Double, location_name: "quantity"))
1344
+ QueueSnapshotCapacityUsage.struct_class = Types::QueueSnapshotCapacityUsage
1345
+
1346
+ QueueSnapshotCapacityUsageList.member = Shapes::ShapeRef.new(shape: QueueSnapshotCapacityUsage)
1347
+
1348
+ QueueSnapshotUtilizationDetail.add_member(:total_capacity_usage, Shapes::ShapeRef.new(shape: QueueSnapshotCapacityUsageList, location_name: "totalCapacityUsage"))
1349
+ QueueSnapshotUtilizationDetail.add_member(:fairshare_utilization, Shapes::ShapeRef.new(shape: FairshareUtilizationDetail, location_name: "fairshareUtilization"))
1350
+ QueueSnapshotUtilizationDetail.add_member(:last_updated_at, Shapes::ShapeRef.new(shape: Long, location_name: "lastUpdatedAt"))
1351
+ QueueSnapshotUtilizationDetail.struct_class = Types::QueueSnapshotUtilizationDetail
1352
+
1299
1353
  RegisterJobDefinitionRequest.add_member(:job_definition_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobDefinitionName"))
1300
1354
  RegisterJobDefinitionRequest.add_member(:type, Shapes::ShapeRef.new(shape: JobDefinitionType, required: true, location_name: "type"))
1301
1355
  RegisterJobDefinitionRequest.add_member(:parameters, Shapes::ShapeRef.new(shape: ParametersMap, location_name: "parameters"))
@@ -1381,6 +1435,18 @@ module Aws::Batch
1381
1435
 
1382
1436
  ServiceJobAttemptDetails.member = Shapes::ShapeRef.new(shape: ServiceJobAttemptDetail)
1383
1437
 
1438
+ ServiceJobCapacityUsageDetail.add_member(:capacity_unit, Shapes::ShapeRef.new(shape: String, location_name: "capacityUnit"))
1439
+ ServiceJobCapacityUsageDetail.add_member(:quantity, Shapes::ShapeRef.new(shape: Double, location_name: "quantity"))
1440
+ ServiceJobCapacityUsageDetail.struct_class = Types::ServiceJobCapacityUsageDetail
1441
+
1442
+ ServiceJobCapacityUsageDetailList.member = Shapes::ShapeRef.new(shape: ServiceJobCapacityUsageDetail)
1443
+
1444
+ ServiceJobCapacityUsageSummary.add_member(:capacity_unit, Shapes::ShapeRef.new(shape: String, location_name: "capacityUnit"))
1445
+ ServiceJobCapacityUsageSummary.add_member(:quantity, Shapes::ShapeRef.new(shape: Double, location_name: "quantity"))
1446
+ ServiceJobCapacityUsageSummary.struct_class = Types::ServiceJobCapacityUsageSummary
1447
+
1448
+ ServiceJobCapacityUsageSummaryList.member = Shapes::ShapeRef.new(shape: ServiceJobCapacityUsageSummary)
1449
+
1384
1450
  ServiceJobEvaluateOnExit.add_member(:action, Shapes::ShapeRef.new(shape: ServiceJobRetryAction, location_name: "action"))
1385
1451
  ServiceJobEvaluateOnExit.add_member(:on_status_reason, Shapes::ShapeRef.new(shape: String, location_name: "onStatusReason"))
1386
1452
  ServiceJobEvaluateOnExit.struct_class = Types::ServiceJobEvaluateOnExit
@@ -1392,10 +1458,12 @@ module Aws::Batch
1392
1458
  ServiceJobRetryStrategy.struct_class = Types::ServiceJobRetryStrategy
1393
1459
 
1394
1460
  ServiceJobSummary.add_member(:latest_attempt, Shapes::ShapeRef.new(shape: LatestServiceJobAttempt, location_name: "latestAttempt"))
1461
+ ServiceJobSummary.add_member(:capacity_usage, Shapes::ShapeRef.new(shape: ServiceJobCapacityUsageSummaryList, location_name: "capacityUsage"))
1395
1462
  ServiceJobSummary.add_member(:created_at, Shapes::ShapeRef.new(shape: Long, location_name: "createdAt"))
1396
1463
  ServiceJobSummary.add_member(:job_arn, Shapes::ShapeRef.new(shape: String, location_name: "jobArn"))
1397
1464
  ServiceJobSummary.add_member(:job_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobId"))
1398
1465
  ServiceJobSummary.add_member(:job_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "jobName"))
1466
+ ServiceJobSummary.add_member(:scheduled_at, Shapes::ShapeRef.new(shape: Long, location_name: "scheduledAt"))
1399
1467
  ServiceJobSummary.add_member(:service_job_type, Shapes::ShapeRef.new(shape: ServiceJobType, required: true, location_name: "serviceJobType"))
1400
1468
  ServiceJobSummary.add_member(:share_identifier, Shapes::ShapeRef.new(shape: String, location_name: "shareIdentifier"))
1401
1469
  ServiceJobSummary.add_member(:status, Shapes::ShapeRef.new(shape: ServiceJobStatus, location_name: "status"))
@@ -3310,6 +3310,12 @@ module Aws::Batch
3310
3310
  # A list of job attempts associated with the service job.
3311
3311
  # @return [Array<Types::ServiceJobAttemptDetail>]
3312
3312
  #
3313
+ # @!attribute [rw] capacity_usage
3314
+ # The configured capacity for the service job, such as the number of
3315
+ # instances. The number of instances should be the same value as the
3316
+ # `serviceRequestPayload.InstanceCount` field.
3317
+ # @return [Array<Types::ServiceJobCapacityUsageDetail>]
3318
+ #
3313
3319
  # @!attribute [rw] created_at
3314
3320
  # The Unix timestamp (in milliseconds) for when the service job was
3315
3321
  # created.
@@ -3344,6 +3350,12 @@ module Aws::Batch
3344
3350
  # with this service job.
3345
3351
  # @return [Types::ServiceJobRetryStrategy]
3346
3352
  #
3353
+ # @!attribute [rw] scheduled_at
3354
+ # The Unix timestamp (in milliseconds) for when the service job was
3355
+ # scheduled. This represents when the service job was dispatched to
3356
+ # SageMaker and the service job transitioned to the `SCHEDULED` state.
3357
+ # @return [Integer]
3358
+ #
3347
3359
  # @!attribute [rw] scheduling_priority
3348
3360
  # The scheduling priority of the service job.
3349
3361
  # @return [Integer]
@@ -3400,6 +3412,7 @@ module Aws::Batch
3400
3412
  #
3401
3413
  class DescribeServiceJobResponse < Struct.new(
3402
3414
  :attempts,
3415
+ :capacity_usage,
3403
3416
  :created_at,
3404
3417
  :is_terminated,
3405
3418
  :job_arn,
@@ -3408,6 +3421,7 @@ module Aws::Batch
3408
3421
  :job_queue,
3409
3422
  :latest_attempt,
3410
3423
  :retry_strategy,
3424
+ :scheduled_at,
3411
3425
  :scheduling_priority,
3412
3426
  :service_request_payload,
3413
3427
  :service_job_type,
@@ -5405,6 +5419,51 @@ module Aws::Batch
5405
5419
  include Aws::Structure
5406
5420
  end
5407
5421
 
5422
+ # The capacity usage for a fairshare scheduling job queue.
5423
+ #
5424
+ # @!attribute [rw] capacity_unit
5425
+ # The unit of measure for the capacity usage. For compute jobs, this
5426
+ # is `VCPU` for Amazon EC2 and `cpu` for Amazon EKS. For service jobs,
5427
+ # this is `NUM_INSTANCES`.
5428
+ # @return [String]
5429
+ #
5430
+ # @!attribute [rw] quantity
5431
+ # The quantity of capacity being used, measured in the units specified
5432
+ # by `capacityUnit`.
5433
+ # @return [Float]
5434
+ #
5435
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/FairshareCapacityUsage AWS API Documentation
5436
+ #
5437
+ class FairshareCapacityUsage < Struct.new(
5438
+ :capacity_unit,
5439
+ :quantity)
5440
+ SENSITIVE = []
5441
+ include Aws::Structure
5442
+ end
5443
+
5444
+ # The capacity utilization for a specific share in a fairshare
5445
+ # scheduling job queue, including the share identifier and its current
5446
+ # usage.
5447
+ #
5448
+ # @!attribute [rw] share_identifier
5449
+ # The share identifier for the fairshare scheduling job queue.
5450
+ # @return [String]
5451
+ #
5452
+ # @!attribute [rw] capacity_usage
5453
+ # The capacity usage information for this share, including the unit of
5454
+ # measure and quantity being used. This is `VCPU` for Amazon EC2 and
5455
+ # `cpu` for Amazon EKS.
5456
+ # @return [Array<Types::FairshareCapacityUsage>]
5457
+ #
5458
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/FairshareCapacityUtilization AWS API Documentation
5459
+ #
5460
+ class FairshareCapacityUtilization < Struct.new(
5461
+ :share_identifier,
5462
+ :capacity_usage)
5463
+ SENSITIVE = []
5464
+ include Aws::Structure
5465
+ end
5466
+
5408
5467
  # The fair-share scheduling policy details.
5409
5468
  #
5410
5469
  # @!attribute [rw] share_decay_seconds
@@ -5456,6 +5515,28 @@ module Aws::Batch
5456
5515
  include Aws::Structure
5457
5516
  end
5458
5517
 
5518
+ # The fairshare utilization for a job queue, including the number of
5519
+ # active shares and top capacity utilization.
5520
+ #
5521
+ # @!attribute [rw] active_share_count
5522
+ # The total number of active shares in the fairshare scheduling job
5523
+ # queue that are currently utilizing capacity.
5524
+ # @return [Integer]
5525
+ #
5526
+ # @!attribute [rw] top_capacity_utilization
5527
+ # A list of the top 20 shares with the highest capacity utilization,
5528
+ # ordered by usage amount.
5529
+ # @return [Array<Types::FairshareCapacityUtilization>]
5530
+ #
5531
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/FairshareUtilizationDetail AWS API Documentation
5532
+ #
5533
+ class FairshareUtilizationDetail < Struct.new(
5534
+ :active_share_count,
5535
+ :top_capacity_utilization)
5536
+ SENSITIVE = []
5537
+ include Aws::Structure
5538
+ end
5539
+
5459
5540
  # The platform configuration for jobs that are running on Fargate
5460
5541
  # resources. Jobs that run on Amazon EC2 resources must not specify this
5461
5542
  # parameter.
@@ -5586,10 +5667,16 @@ module Aws::Batch
5586
5667
  # jobs are ordered based on their job priority and share usage.
5587
5668
  # @return [Types::FrontOfQueueDetail]
5588
5669
  #
5670
+ # @!attribute [rw] queue_utilization
5671
+ # The job queue's capacity utilization, including total usage and
5672
+ # breakdown by fairshare scheduling queue.
5673
+ # @return [Types::QueueSnapshotUtilizationDetail]
5674
+ #
5589
5675
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/GetJobQueueSnapshotResponse AWS API Documentation
5590
5676
  #
5591
5677
  class GetJobQueueSnapshotResponse < Struct.new(
5592
- :front_of_queue)
5678
+ :front_of_queue,
5679
+ :queue_utilization)
5593
5680
  SENSITIVE = []
5594
5681
  include Aws::Structure
5595
5682
  end
@@ -5642,6 +5729,28 @@ module Aws::Batch
5642
5729
  include Aws::Structure
5643
5730
  end
5644
5731
 
5732
+ # The capacity usage for a job, including the unit of measure and
5733
+ # quantity of resources being used.
5734
+ #
5735
+ # @!attribute [rw] capacity_unit
5736
+ # The unit of measure for the capacity usage. This is `VCPU` for
5737
+ # Amazon EC2 and `cpu` for Amazon EKS.
5738
+ # @return [String]
5739
+ #
5740
+ # @!attribute [rw] quantity
5741
+ # The quantity of capacity being used by the job, measured in the
5742
+ # units specified by `capacityUnit`.
5743
+ # @return [Float]
5744
+ #
5745
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/JobCapacityUsageSummary AWS API Documentation
5746
+ #
5747
+ class JobCapacityUsageSummary < Struct.new(
5748
+ :capacity_unit,
5749
+ :quantity)
5750
+ SENSITIVE = []
5751
+ include Aws::Structure
5752
+ end
5753
+
5645
5754
  # An object that represents an Batch job definition.
5646
5755
  #
5647
5756
  # @!attribute [rw] job_definition_name
@@ -6202,6 +6311,11 @@ module Aws::Batch
6202
6311
  # The job name.
6203
6312
  # @return [String]
6204
6313
  #
6314
+ # @!attribute [rw] capacity_usage
6315
+ # The configured capacity usage information for this job, including
6316
+ # the unit of measure and quantity of resources.
6317
+ # @return [Array<Types::JobCapacityUsageSummary>]
6318
+ #
6205
6319
  # @!attribute [rw] created_at
6206
6320
  # The Unix timestamp (in milliseconds) for when the job was created.
6207
6321
  # For non-array jobs and parent array jobs, this is when the job
@@ -6214,6 +6328,21 @@ module Aws::Batch
6214
6328
  # [1]: https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html
6215
6329
  # @return [Integer]
6216
6330
  #
6331
+ # @!attribute [rw] scheduled_at
6332
+ # The Unix timestamp (in milliseconds) for when the job was scheduled
6333
+ # for execution. For more information on job statues, see [Service job
6334
+ # status][1] in the *Batch User Guide*.
6335
+ #
6336
+ #
6337
+ #
6338
+ # [1]: https://docs.aws.amazon.com/batch/latest/userguide/service-job-status.html
6339
+ # @return [Integer]
6340
+ #
6341
+ # @!attribute [rw] share_identifier
6342
+ # The share identifier for the fairshare scheduling queue that this
6343
+ # job is associated with.
6344
+ # @return [String]
6345
+ #
6217
6346
  # @!attribute [rw] status
6218
6347
  # The current status for the job.
6219
6348
  # @return [String]
@@ -6263,7 +6392,10 @@ module Aws::Batch
6263
6392
  :job_arn,
6264
6393
  :job_id,
6265
6394
  :job_name,
6395
+ :capacity_usage,
6266
6396
  :created_at,
6397
+ :scheduled_at,
6398
+ :share_identifier,
6267
6399
  :status,
6268
6400
  :status_reason,
6269
6401
  :started_at,
@@ -6892,7 +7024,7 @@ module Aws::Batch
6892
7024
  # @return [String]
6893
7025
  #
6894
7026
  # @!attribute [rw] share_identifier
6895
- # The fair-share scheduling policy identifier for the job.
7027
+ # The fair-share scheduling identifier for the job.
6896
7028
  # @return [String]
6897
7029
  #
6898
7030
  # @!attribute [rw] job_status
@@ -6976,8 +7108,9 @@ module Aws::Batch
6976
7108
  # @!attribute [rw] job_status
6977
7109
  # The job status used to filter jobs in the specified queue. If the
6978
7110
  # `filters` parameter is specified, the `jobStatus` parameter is
6979
- # ignored and jobs with any status are returned. If you don't specify
6980
- # a status, only `RUNNING` jobs are returned.
7111
+ # ignored and jobs with any status are returned. The exception is the
7112
+ # `SHARE_IDENTIFIER` filter and `jobStatus` can be used together. If
7113
+ # you don't specify a status, only `RUNNING` jobs are returned.
6981
7114
  #
6982
7115
  # <note markdown="1"> Array job parents are updated to `PENDING` when any child job is
6983
7116
  # updated to `RUNNABLE` and remain in `PENDING` status while child
@@ -7024,10 +7157,16 @@ module Aws::Batch
7024
7157
  #
7025
7158
  # @!attribute [rw] filters
7026
7159
  # The filter to apply to the query. Only one filter can be used at a
7027
- # time. When the filter is used, `jobStatus` is ignored. The filter
7028
- # doesn't apply to child jobs in an array or multi-node parallel
7029
- # (MNP) jobs. The results are sorted by the `createdAt` field, with
7030
- # the most recent jobs being first.
7160
+ # time. When the filter is used, `jobStatus` is ignored with the
7161
+ # exception that `SHARE_IDENTIFIER` and `jobStatus` can be used
7162
+ # together. The filter doesn't apply to child jobs in an array or
7163
+ # multi-node parallel (MNP) jobs. The results are sorted by the
7164
+ # `createdAt` field, with the most recent jobs being first.
7165
+ #
7166
+ # <note markdown="1"> The `SHARE_IDENTIFIER` filter and the `jobStatus` field can be used
7167
+ # together to filter results.
7168
+ #
7169
+ # </note>
7031
7170
  #
7032
7171
  # JOB\_NAME
7033
7172
  #
@@ -7070,6 +7209,11 @@ module Aws::Batch
7070
7209
  # created. This corresponds to the `createdAt` value. The value is a
7071
7210
  # string representation of the number of milliseconds since 00:00:00
7072
7211
  # UTC (midnight) on January 1, 1970.
7212
+ #
7213
+ # SHARE\_IDENTIFIER
7214
+ #
7215
+ # : The value for the filter is the fairshare scheduling share
7216
+ # identifier.
7073
7217
  # @return [Array<Types::KeyValuesPair>]
7074
7218
  #
7075
7219
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ListJobsRequest AWS API Documentation
@@ -7170,7 +7314,16 @@ module Aws::Batch
7170
7314
  # @return [String]
7171
7315
  #
7172
7316
  # @!attribute [rw] job_status
7173
- # The job status with which to filter service jobs.
7317
+ # The job status used to filter service jobs in the specified queue.
7318
+ # If the `filters` parameter is specified, the `jobStatus` parameter
7319
+ # is ignored and jobs with any status are returned. The exception is
7320
+ # the `SHARE_IDENTIFIER` filter and `jobStatus` can be used together.
7321
+ # If you don't specify a status, only `RUNNING` jobs are returned.
7322
+ #
7323
+ # <note markdown="1"> The `SHARE_IDENTIFIER` filter and the `jobStatus` field can be used
7324
+ # together to filter results.
7325
+ #
7326
+ # </note>
7174
7327
  # @return [String]
7175
7328
  #
7176
7329
  # @!attribute [rw] max_results
@@ -7201,9 +7354,15 @@ module Aws::Batch
7201
7354
  #
7202
7355
  # @!attribute [rw] filters
7203
7356
  # The filter to apply to the query. Only one filter can be used at a
7204
- # time. When the filter is used, `jobStatus` is ignored. The results
7205
- # are sorted by the `createdAt` field, with the most recent jobs being
7206
- # first.
7357
+ # time. When the filter is used, `jobStatus` is ignored with the
7358
+ # exception that `SHARE_IDENTIFIER` and `jobStatus` can be used
7359
+ # together. The results are sorted by the `createdAt` field, with the
7360
+ # most recent jobs being first.
7361
+ #
7362
+ # <note markdown="1"> The `SHARE_IDENTIFIER` filter and the `jobStatus` field can be used
7363
+ # together to filter results.
7364
+ #
7365
+ # </note>
7207
7366
  #
7208
7367
  # JOB\_NAME
7209
7368
  #
@@ -7228,6 +7387,11 @@ module Aws::Batch
7228
7387
  # created. This corresponds to the `createdAt` value. The value is a
7229
7388
  # string representation of the number of milliseconds since 00:00:00
7230
7389
  # UTC (midnight) on January 1, 1970.
7390
+ #
7391
+ # SHARE\_IDENTIFIER
7392
+ #
7393
+ # : The value for the filter is the fairshare scheduling share
7394
+ # identifier.
7231
7395
  # @return [Array<Types::KeyValuesPair>]
7232
7396
  #
7233
7397
  # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ListServiceJobsRequest AWS API Documentation
@@ -7739,6 +7903,57 @@ module Aws::Batch
7739
7903
  include Aws::Structure
7740
7904
  end
7741
7905
 
7906
+ # The configured capacity usage for a job queue snapshot, including the
7907
+ # unit of measure and quantity of resources being used.
7908
+ #
7909
+ # @!attribute [rw] capacity_unit
7910
+ # The unit of measure for the capacity usage. For compute jobs, this
7911
+ # is `VCPU` for Amazon EC2 and `cpu` for Amazon EKS. For service jobs,
7912
+ # this is `NUM_INSTANCES`.
7913
+ # @return [String]
7914
+ #
7915
+ # @!attribute [rw] quantity
7916
+ # The quantity of capacity being used in the queue snapshot, measured
7917
+ # in the units specified by `capacityUnit`.
7918
+ # @return [Float]
7919
+ #
7920
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/QueueSnapshotCapacityUsage AWS API Documentation
7921
+ #
7922
+ class QueueSnapshotCapacityUsage < Struct.new(
7923
+ :capacity_unit,
7924
+ :quantity)
7925
+ SENSITIVE = []
7926
+ include Aws::Structure
7927
+ end
7928
+
7929
+ # The job queue utilization at a specific point in time, including total
7930
+ # capacity usage and fairshare utilization breakdown.
7931
+ #
7932
+ # @!attribute [rw] total_capacity_usage
7933
+ # The total capacity usage for the entire job queue, for both
7934
+ # first-in, first-out (FIFO) and fairshare scheduling job queue.
7935
+ # @return [Array<Types::QueueSnapshotCapacityUsage>]
7936
+ #
7937
+ # @!attribute [rw] fairshare_utilization
7938
+ # The utilization information for a fairshare scheduling job queues,
7939
+ # including active share count and top capacity utilization by share.
7940
+ # @return [Types::FairshareUtilizationDetail]
7941
+ #
7942
+ # @!attribute [rw] last_updated_at
7943
+ # The Unix timestamp (in milliseconds) for when the queue utilization
7944
+ # information was last updated.
7945
+ # @return [Integer]
7946
+ #
7947
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/QueueSnapshotUtilizationDetail AWS API Documentation
7948
+ #
7949
+ class QueueSnapshotUtilizationDetail < Struct.new(
7950
+ :total_capacity_usage,
7951
+ :fairshare_utilization,
7952
+ :last_updated_at)
7953
+ SENSITIVE = []
7954
+ include Aws::Structure
7955
+ end
7956
+
7742
7957
  # Contains the parameters for `RegisterJobDefinition`.
7743
7958
  #
7744
7959
  # @!attribute [rw] job_definition_name
@@ -8440,6 +8655,50 @@ module Aws::Batch
8440
8655
  include Aws::Structure
8441
8656
  end
8442
8657
 
8658
+ # The capacity usage for a service job, including the unit of measure
8659
+ # and quantity of resources being consumed.
8660
+ #
8661
+ # @!attribute [rw] capacity_unit
8662
+ # The unit of measure for the service job capacity usage. For service
8663
+ # jobs, this is `NUM_INSTANCES`.
8664
+ # @return [String]
8665
+ #
8666
+ # @!attribute [rw] quantity
8667
+ # The quantity of capacity being used by the service job, measured in
8668
+ # the units specified by `capacityUnit`.
8669
+ # @return [Float]
8670
+ #
8671
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ServiceJobCapacityUsageDetail AWS API Documentation
8672
+ #
8673
+ class ServiceJobCapacityUsageDetail < Struct.new(
8674
+ :capacity_unit,
8675
+ :quantity)
8676
+ SENSITIVE = []
8677
+ include Aws::Structure
8678
+ end
8679
+
8680
+ # The capacity usage for a service job, including the unit of measure
8681
+ # and quantity of resources being used.
8682
+ #
8683
+ # @!attribute [rw] capacity_unit
8684
+ # The unit of measure for the service job capacity usage. For service
8685
+ # jobs, this is `NUM_INSTANCES`.
8686
+ # @return [String]
8687
+ #
8688
+ # @!attribute [rw] quantity
8689
+ # The quantity of capacity being used by the service job, measured in
8690
+ # the units specified by `capacityUnit`.
8691
+ # @return [Float]
8692
+ #
8693
+ # @see http://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/ServiceJobCapacityUsageSummary AWS API Documentation
8694
+ #
8695
+ class ServiceJobCapacityUsageSummary < Struct.new(
8696
+ :capacity_unit,
8697
+ :quantity)
8698
+ SENSITIVE = []
8699
+ include Aws::Structure
8700
+ end
8701
+
8443
8702
  # Specifies conditions for when to exit or retry a service job based on
8444
8703
  # the exit status or status reason.
8445
8704
  #
@@ -8499,6 +8758,11 @@ module Aws::Batch
8499
8758
  # Information about the latest attempt for the service job.
8500
8759
  # @return [Types::LatestServiceJobAttempt]
8501
8760
  #
8761
+ # @!attribute [rw] capacity_usage
8762
+ # The capacity usage information for this service job, including the
8763
+ # unit of measure and quantity of resources being used.
8764
+ # @return [Array<Types::ServiceJobCapacityUsageSummary>]
8765
+ #
8502
8766
  # @!attribute [rw] created_at
8503
8767
  # The Unix timestamp (in milliseconds) for when the service job was
8504
8768
  # created.
@@ -8516,6 +8780,11 @@ module Aws::Batch
8516
8780
  # The name of the service job.
8517
8781
  # @return [String]
8518
8782
  #
8783
+ # @!attribute [rw] scheduled_at
8784
+ # The Unix timestamp (in milliseconds) for when the service job was
8785
+ # scheduled for execution.
8786
+ # @return [Integer]
8787
+ #
8519
8788
  # @!attribute [rw] service_job_type
8520
8789
  # The type of service job. For SageMaker Training jobs, this value is
8521
8790
  # `SAGEMAKER_TRAINING`.
@@ -8548,10 +8817,12 @@ module Aws::Batch
8548
8817
  #
8549
8818
  class ServiceJobSummary < Struct.new(
8550
8819
  :latest_attempt,
8820
+ :capacity_usage,
8551
8821
  :created_at,
8552
8822
  :job_arn,
8553
8823
  :job_id,
8554
8824
  :job_name,
8825
+ :scheduled_at,
8555
8826
  :service_job_type,
8556
8827
  :share_identifier,
8557
8828
  :status,
data/lib/aws-sdk-batch.rb CHANGED
@@ -54,7 +54,7 @@ module Aws::Batch
54
54
  autoload :EndpointProvider, 'aws-sdk-batch/endpoint_provider'
55
55
  autoload :Endpoints, 'aws-sdk-batch/endpoints'
56
56
 
57
- GEM_VERSION = '1.133.0'
57
+ GEM_VERSION = '1.134.0'
58
58
 
59
59
  end
60
60
 
data/sig/client.rbs CHANGED
@@ -388,6 +388,7 @@ module Aws
388
388
  interface _DescribeServiceJobResponseSuccess
389
389
  include ::Seahorse::Client::_ResponseSuccess[Types::DescribeServiceJobResponse]
390
390
  def attempts: () -> ::Array[Types::ServiceJobAttemptDetail]
391
+ def capacity_usage: () -> ::Array[Types::ServiceJobCapacityUsageDetail]
391
392
  def created_at: () -> ::Integer
392
393
  def is_terminated: () -> bool
393
394
  def job_arn: () -> ::String
@@ -396,6 +397,7 @@ module Aws
396
397
  def job_queue: () -> ::String
397
398
  def latest_attempt: () -> Types::LatestServiceJobAttempt
398
399
  def retry_strategy: () -> Types::ServiceJobRetryStrategy
400
+ def scheduled_at: () -> ::Integer
399
401
  def scheduling_priority: () -> ::Integer
400
402
  def service_request_payload: () -> ::String
401
403
  def service_job_type: () -> ("SAGEMAKER_TRAINING")
@@ -416,6 +418,7 @@ module Aws
416
418
  interface _GetJobQueueSnapshotResponseSuccess
417
419
  include ::Seahorse::Client::_ResponseSuccess[Types::GetJobQueueSnapshotResponse]
418
420
  def front_of_queue: () -> Types::FrontOfQueueDetail
421
+ def queue_utilization: () -> Types::QueueSnapshotUtilizationDetail
419
422
  end
420
423
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Batch/Client.html#get_job_queue_snapshot-instance_method
421
424
  def get_job_queue_snapshot: (
data/sig/types.rbs CHANGED
@@ -476,6 +476,7 @@ module Aws::Batch
476
476
 
477
477
  class DescribeServiceJobResponse
478
478
  attr_accessor attempts: ::Array[Types::ServiceJobAttemptDetail]
479
+ attr_accessor capacity_usage: ::Array[Types::ServiceJobCapacityUsageDetail]
479
480
  attr_accessor created_at: ::Integer
480
481
  attr_accessor is_terminated: bool
481
482
  attr_accessor job_arn: ::String
@@ -484,6 +485,7 @@ module Aws::Batch
484
485
  attr_accessor job_queue: ::String
485
486
  attr_accessor latest_attempt: Types::LatestServiceJobAttempt
486
487
  attr_accessor retry_strategy: Types::ServiceJobRetryStrategy
488
+ attr_accessor scheduled_at: ::Integer
487
489
  attr_accessor scheduling_priority: ::Integer
488
490
  attr_accessor service_request_payload: ::String
489
491
  attr_accessor service_job_type: ("SAGEMAKER_TRAINING")
@@ -770,6 +772,18 @@ module Aws::Batch
770
772
  SENSITIVE: []
771
773
  end
772
774
 
775
+ class FairshareCapacityUsage
776
+ attr_accessor capacity_unit: ::String
777
+ attr_accessor quantity: ::Float
778
+ SENSITIVE: []
779
+ end
780
+
781
+ class FairshareCapacityUtilization
782
+ attr_accessor share_identifier: ::String
783
+ attr_accessor capacity_usage: ::Array[Types::FairshareCapacityUsage]
784
+ SENSITIVE: []
785
+ end
786
+
773
787
  class FairsharePolicy
774
788
  attr_accessor share_decay_seconds: ::Integer
775
789
  attr_accessor compute_reservation: ::Integer
@@ -777,6 +791,12 @@ module Aws::Batch
777
791
  SENSITIVE: []
778
792
  end
779
793
 
794
+ class FairshareUtilizationDetail
795
+ attr_accessor active_share_count: ::Integer
796
+ attr_accessor top_capacity_utilization: ::Array[Types::FairshareCapacityUtilization]
797
+ SENSITIVE: []
798
+ end
799
+
780
800
  class FargatePlatformConfiguration
781
801
  attr_accessor platform_version: ::String
782
802
  SENSITIVE: []
@@ -807,6 +827,7 @@ module Aws::Batch
807
827
 
808
828
  class GetJobQueueSnapshotResponse
809
829
  attr_accessor front_of_queue: Types::FrontOfQueueDetail
830
+ attr_accessor queue_utilization: Types::QueueSnapshotUtilizationDetail
810
831
  SENSITIVE: []
811
832
  end
812
833
 
@@ -820,6 +841,12 @@ module Aws::Batch
820
841
  SENSITIVE: []
821
842
  end
822
843
 
844
+ class JobCapacityUsageSummary
845
+ attr_accessor capacity_unit: ::String
846
+ attr_accessor quantity: ::Float
847
+ SENSITIVE: []
848
+ end
849
+
823
850
  class JobDefinition
824
851
  attr_accessor job_definition_name: ::String
825
852
  attr_accessor job_definition_arn: ::String
@@ -910,7 +937,10 @@ module Aws::Batch
910
937
  attr_accessor job_arn: ::String
911
938
  attr_accessor job_id: ::String
912
939
  attr_accessor job_name: ::String
940
+ attr_accessor capacity_usage: ::Array[Types::JobCapacityUsageSummary]
913
941
  attr_accessor created_at: ::Integer
942
+ attr_accessor scheduled_at: ::Integer
943
+ attr_accessor share_identifier: ::String
914
944
  attr_accessor status: ("SUBMITTED" | "PENDING" | "RUNNABLE" | "STARTING" | "RUNNING" | "SUCCEEDED" | "FAILED")
915
945
  attr_accessor status_reason: ::String
916
946
  attr_accessor started_at: ::Integer
@@ -1140,6 +1170,19 @@ module Aws::Batch
1140
1170
  SENSITIVE: []
1141
1171
  end
1142
1172
 
1173
+ class QueueSnapshotCapacityUsage
1174
+ attr_accessor capacity_unit: ::String
1175
+ attr_accessor quantity: ::Float
1176
+ SENSITIVE: []
1177
+ end
1178
+
1179
+ class QueueSnapshotUtilizationDetail
1180
+ attr_accessor total_capacity_usage: ::Array[Types::QueueSnapshotCapacityUsage]
1181
+ attr_accessor fairshare_utilization: Types::FairshareUtilizationDetail
1182
+ attr_accessor last_updated_at: ::Integer
1183
+ SENSITIVE: []
1184
+ end
1185
+
1143
1186
  class RegisterJobDefinitionRequest
1144
1187
  attr_accessor job_definition_name: ::String
1145
1188
  attr_accessor type: ("container" | "multinode")
@@ -1237,6 +1280,18 @@ module Aws::Batch
1237
1280
  SENSITIVE: []
1238
1281
  end
1239
1282
 
1283
+ class ServiceJobCapacityUsageDetail
1284
+ attr_accessor capacity_unit: ::String
1285
+ attr_accessor quantity: ::Float
1286
+ SENSITIVE: []
1287
+ end
1288
+
1289
+ class ServiceJobCapacityUsageSummary
1290
+ attr_accessor capacity_unit: ::String
1291
+ attr_accessor quantity: ::Float
1292
+ SENSITIVE: []
1293
+ end
1294
+
1240
1295
  class ServiceJobEvaluateOnExit
1241
1296
  attr_accessor action: ("RETRY" | "EXIT")
1242
1297
  attr_accessor on_status_reason: ::String
@@ -1251,10 +1306,12 @@ module Aws::Batch
1251
1306
 
1252
1307
  class ServiceJobSummary
1253
1308
  attr_accessor latest_attempt: Types::LatestServiceJobAttempt
1309
+ attr_accessor capacity_usage: ::Array[Types::ServiceJobCapacityUsageSummary]
1254
1310
  attr_accessor created_at: ::Integer
1255
1311
  attr_accessor job_arn: ::String
1256
1312
  attr_accessor job_id: ::String
1257
1313
  attr_accessor job_name: ::String
1314
+ attr_accessor scheduled_at: ::Integer
1258
1315
  attr_accessor service_job_type: ("SAGEMAKER_TRAINING")
1259
1316
  attr_accessor share_identifier: ::String
1260
1317
  attr_accessor status: ("SUBMITTED" | "PENDING" | "RUNNABLE" | "SCHEDULED" | "STARTING" | "RUNNING" | "SUCCEEDED" | "FAILED")
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-batch
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.133.0
4
+ version: 1.134.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services