@aws-sdk/client-emr-serverless 3.378.0 → 3.382.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.
@@ -1,4 +1,7 @@
1
1
  import { Endpoint, EndpointParameters as __EndpointParameters, EndpointV2, Provider } from "@smithy/types";
2
+ /**
3
+ * @public
4
+ */
2
5
  export interface ClientInputEndpointParameters {
3
6
  region?: string | Provider<string>;
4
7
  useDualstackEndpoint?: boolean | Provider<boolean>;
@@ -25,6 +25,7 @@
25
25
  */
26
26
  export * from "./EMRServerlessClient";
27
27
  export * from "./EMRServerless";
28
+ export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
28
29
  export * from "./commands";
29
30
  export * from "./pagination";
30
31
  export * from "./models";
@@ -18,6 +18,7 @@ export type Architecture = (typeof Architecture)[keyof typeof Architecture];
18
18
  */
19
19
  export interface AutoStartConfig {
20
20
  /**
21
+ * @public
21
22
  * <p>Enables the application to automatically start on job submission. Defaults to
22
23
  * true.</p>
23
24
  */
@@ -30,11 +31,13 @@ export interface AutoStartConfig {
30
31
  */
31
32
  export interface AutoStopConfig {
32
33
  /**
34
+ * @public
33
35
  * <p>Enables the application to automatically stop after a certain amount of time being idle.
34
36
  * Defaults to true.</p>
35
37
  */
36
38
  enabled?: boolean;
37
39
  /**
40
+ * @public
38
41
  * <p>The amount of idle time in minutes after which your application will automatically stop.
39
42
  * Defaults to 15 minutes.</p>
40
43
  */
@@ -46,10 +49,12 @@ export interface AutoStopConfig {
46
49
  */
47
50
  export interface ImageConfiguration {
48
51
  /**
52
+ * @public
49
53
  * <p>The image URI.</p>
50
54
  */
51
55
  imageUri: string | undefined;
52
56
  /**
57
+ * @public
53
58
  * <p>The SHA256 digest of the image URI. This indicates which specific image the application
54
59
  * is configured for. The image digest doesn't exist until an application has started.</p>
55
60
  */
@@ -62,14 +67,17 @@ export interface ImageConfiguration {
62
67
  */
63
68
  export interface WorkerResourceConfig {
64
69
  /**
70
+ * @public
65
71
  * <p>The CPU requirements for every worker instance of the worker type.</p>
66
72
  */
67
73
  cpu: string | undefined;
68
74
  /**
75
+ * @public
69
76
  * <p>The memory requirements for every worker instance of the worker type.</p>
70
77
  */
71
78
  memory: string | undefined;
72
79
  /**
80
+ * @public
73
81
  * <p>The disk requirements for every worker instance of the worker type.</p>
74
82
  */
75
83
  disk?: string;
@@ -80,10 +88,12 @@ export interface WorkerResourceConfig {
80
88
  */
81
89
  export interface InitialCapacityConfig {
82
90
  /**
91
+ * @public
83
92
  * <p>The number of workers in the initial capacity configuration.</p>
84
93
  */
85
94
  workerCount: number | undefined;
86
95
  /**
96
+ * @public
87
97
  * <p>The resource configuration of the initial capacity configuration.</p>
88
98
  */
89
99
  workerConfiguration?: WorkerResourceConfig;
@@ -95,14 +105,17 @@ export interface InitialCapacityConfig {
95
105
  */
96
106
  export interface MaximumAllowedResources {
97
107
  /**
108
+ * @public
98
109
  * <p>The maximum allowed CPU for an application.</p>
99
110
  */
100
111
  cpu: string | undefined;
101
112
  /**
113
+ * @public
102
114
  * <p>The maximum allowed resources for an application.</p>
103
115
  */
104
116
  memory: string | undefined;
105
117
  /**
118
+ * @public
106
119
  * <p>The maximum allowed disk for an application.</p>
107
120
  */
108
121
  disk?: string;
@@ -113,10 +126,12 @@ export interface MaximumAllowedResources {
113
126
  */
114
127
  export interface NetworkConfiguration {
115
128
  /**
129
+ * @public
116
130
  * <p>The array of subnet Ids for customer VPC connectivity.</p>
117
131
  */
118
132
  subnetIds?: string[];
119
133
  /**
134
+ * @public
120
135
  * <p>The array of security group Ids for customer VPC connectivity.</p>
121
136
  */
122
137
  securityGroupIds?: string[];
@@ -144,6 +159,7 @@ export type ApplicationState = (typeof ApplicationState)[keyof typeof Applicatio
144
159
  */
145
160
  export interface WorkerTypeSpecification {
146
161
  /**
162
+ * @public
147
163
  * <p>The image configuration for a worker type.</p>
148
164
  */
149
165
  imageConfiguration?: ImageConfiguration;
@@ -155,77 +171,95 @@ export interface WorkerTypeSpecification {
155
171
  */
156
172
  export interface Application {
157
173
  /**
174
+ * @public
158
175
  * <p>The ID of the application.</p>
159
176
  */
160
177
  applicationId: string | undefined;
161
178
  /**
179
+ * @public
162
180
  * <p>The name of the application.</p>
163
181
  */
164
182
  name?: string;
165
183
  /**
184
+ * @public
166
185
  * <p>The ARN of the application.</p>
167
186
  */
168
187
  arn: string | undefined;
169
188
  /**
189
+ * @public
170
190
  * <p>The Amazon EMR release associated with the application.</p>
171
191
  */
172
192
  releaseLabel: string | undefined;
173
193
  /**
194
+ * @public
174
195
  * <p>The type of application, such as Spark or Hive.</p>
175
196
  */
176
197
  type: string | undefined;
177
198
  /**
199
+ * @public
178
200
  * <p>The state of the application.</p>
179
201
  */
180
202
  state: ApplicationState | string | undefined;
181
203
  /**
204
+ * @public
182
205
  * <p>The state details of the application.</p>
183
206
  */
184
207
  stateDetails?: string;
185
208
  /**
209
+ * @public
186
210
  * <p>The initial capacity of the application.</p>
187
211
  */
188
212
  initialCapacity?: Record<string, InitialCapacityConfig>;
189
213
  /**
214
+ * @public
190
215
  * <p>The maximum capacity of the application. This is cumulative across all workers at any
191
216
  * given point in time during the lifespan of the application is created. No new resources
192
217
  * will be created once any one of the defined limits is hit.</p>
193
218
  */
194
219
  maximumCapacity?: MaximumAllowedResources;
195
220
  /**
221
+ * @public
196
222
  * <p>The date and time when the application run was created.</p>
197
223
  */
198
224
  createdAt: Date | undefined;
199
225
  /**
226
+ * @public
200
227
  * <p>The date and time when the application run was last updated.</p>
201
228
  */
202
229
  updatedAt: Date | undefined;
203
230
  /**
231
+ * @public
204
232
  * <p>The tags assigned to the application.</p>
205
233
  */
206
234
  tags?: Record<string, string>;
207
235
  /**
236
+ * @public
208
237
  * <p>The configuration for an application to automatically start on job submission.</p>
209
238
  */
210
239
  autoStartConfiguration?: AutoStartConfig;
211
240
  /**
241
+ * @public
212
242
  * <p>The configuration for an application to automatically stop after a certain amount of
213
243
  * time being idle.</p>
214
244
  */
215
245
  autoStopConfiguration?: AutoStopConfig;
216
246
  /**
247
+ * @public
217
248
  * <p>The network configuration for customer VPC connectivity for the application.</p>
218
249
  */
219
250
  networkConfiguration?: NetworkConfiguration;
220
251
  /**
252
+ * @public
221
253
  * <p>The CPU architecture of an application.</p>
222
254
  */
223
255
  architecture?: Architecture | string;
224
256
  /**
257
+ * @public
225
258
  * <p>The image configuration applied to all worker types.</p>
226
259
  */
227
260
  imageConfiguration?: ImageConfiguration;
228
261
  /**
262
+ * @public
229
263
  * <p>The specification applied to each worker type.</p>
230
264
  */
231
265
  workerTypeSpecifications?: Record<string, WorkerTypeSpecification>;
@@ -236,42 +270,52 @@ export interface Application {
236
270
  */
237
271
  export interface ApplicationSummary {
238
272
  /**
273
+ * @public
239
274
  * <p>The ID of the application.</p>
240
275
  */
241
276
  id: string | undefined;
242
277
  /**
278
+ * @public
243
279
  * <p>The name of the application.</p>
244
280
  */
245
281
  name?: string;
246
282
  /**
283
+ * @public
247
284
  * <p>The ARN of the application.</p>
248
285
  */
249
286
  arn: string | undefined;
250
287
  /**
288
+ * @public
251
289
  * <p>The Amazon EMR release associated with the application.</p>
252
290
  */
253
291
  releaseLabel: string | undefined;
254
292
  /**
293
+ * @public
255
294
  * <p>The type of application, such as Spark or Hive.</p>
256
295
  */
257
296
  type: string | undefined;
258
297
  /**
298
+ * @public
259
299
  * <p>The state of the application.</p>
260
300
  */
261
301
  state: ApplicationState | string | undefined;
262
302
  /**
303
+ * @public
263
304
  * <p>The state details of the application.</p>
264
305
  */
265
306
  stateDetails?: string;
266
307
  /**
308
+ * @public
267
309
  * <p>The date and time when the application was created.</p>
268
310
  */
269
311
  createdAt: Date | undefined;
270
312
  /**
313
+ * @public
271
314
  * <p>The date and time when the application was last updated.</p>
272
315
  */
273
316
  updatedAt: Date | undefined;
274
317
  /**
318
+ * @public
275
319
  * <p>The CPU architecture of an application.</p>
276
320
  */
277
321
  architecture?: Architecture | string;
@@ -295,6 +339,7 @@ export declare class ConflictException extends __BaseException {
295
339
  */
296
340
  export interface ImageConfigurationInput {
297
341
  /**
342
+ * @public
298
343
  * <p>The URI of an image in the Amazon ECR registry. This field is required when you create a
299
344
  * new application. If you leave this field blank in an update, Amazon EMR will remove
300
345
  * the image configuration.</p>
@@ -307,6 +352,7 @@ export interface ImageConfigurationInput {
307
352
  */
308
353
  export interface WorkerTypeSpecificationInput {
309
354
  /**
355
+ * @public
310
356
  * <p>The image configuration for a worker type.</p>
311
357
  */
312
358
  imageConfiguration?: ImageConfigurationInput;
@@ -316,60 +362,73 @@ export interface WorkerTypeSpecificationInput {
316
362
  */
317
363
  export interface CreateApplicationRequest {
318
364
  /**
365
+ * @public
319
366
  * <p>The name of the application.</p>
320
367
  */
321
368
  name?: string;
322
369
  /**
370
+ * @public
323
371
  * <p>The Amazon EMR release associated with the application.</p>
324
372
  */
325
373
  releaseLabel: string | undefined;
326
374
  /**
375
+ * @public
327
376
  * <p>The type of application you want to start, such as Spark or Hive.</p>
328
377
  */
329
378
  type: string | undefined;
330
379
  /**
380
+ * @public
331
381
  * <p>The client idempotency token of the application to create. Its value must be unique for
332
382
  * each request.</p>
333
383
  */
334
384
  clientToken?: string;
335
385
  /**
386
+ * @public
336
387
  * <p>The capacity to initialize when the application is created.</p>
337
388
  */
338
389
  initialCapacity?: Record<string, InitialCapacityConfig>;
339
390
  /**
391
+ * @public
340
392
  * <p>The maximum capacity to allocate when the application is created. This is cumulative
341
393
  * across all workers at any given point in time, not just when an application is created. No
342
394
  * new resources will be created once any one of the defined limits is hit.</p>
343
395
  */
344
396
  maximumCapacity?: MaximumAllowedResources;
345
397
  /**
398
+ * @public
346
399
  * <p>The tags assigned to the application.</p>
347
400
  */
348
401
  tags?: Record<string, string>;
349
402
  /**
403
+ * @public
350
404
  * <p>The configuration for an application to automatically start on job submission.</p>
351
405
  */
352
406
  autoStartConfiguration?: AutoStartConfig;
353
407
  /**
408
+ * @public
354
409
  * <p>The configuration for an application to automatically stop after a certain amount of
355
410
  * time being idle.</p>
356
411
  */
357
412
  autoStopConfiguration?: AutoStopConfig;
358
413
  /**
414
+ * @public
359
415
  * <p>The network configuration for customer VPC connectivity.</p>
360
416
  */
361
417
  networkConfiguration?: NetworkConfiguration;
362
418
  /**
419
+ * @public
363
420
  * <p>The CPU architecture of an application.</p>
364
421
  */
365
422
  architecture?: Architecture | string;
366
423
  /**
424
+ * @public
367
425
  * <p>The image configuration for all worker types. You can either set this parameter or
368
426
  * <code>imageConfiguration</code> for each worker type in
369
427
  * <code>workerTypeSpecifications</code>.</p>
370
428
  */
371
429
  imageConfiguration?: ImageConfigurationInput;
372
430
  /**
431
+ * @public
373
432
  * <p>The key-value pairs that specify worker type to
374
433
  * <code>WorkerTypeSpecificationInput</code>. This parameter must contain all valid worker
375
434
  * types for a Spark or Hive application. Valid worker types include <code>Driver</code> and
@@ -385,14 +444,17 @@ export interface CreateApplicationRequest {
385
444
  */
386
445
  export interface CreateApplicationResponse {
387
446
  /**
447
+ * @public
388
448
  * <p>The output contains the application ID.</p>
389
449
  */
390
450
  applicationId: string | undefined;
391
451
  /**
452
+ * @public
392
453
  * <p>The output contains the name of the application.</p>
393
454
  */
394
455
  name?: string;
395
456
  /**
457
+ * @public
396
458
  * <p>The output contains the ARN of the application.</p>
397
459
  */
398
460
  arn: string | undefined;
@@ -439,6 +501,7 @@ export declare class ValidationException extends __BaseException {
439
501
  */
440
502
  export interface DeleteApplicationRequest {
441
503
  /**
504
+ * @public
442
505
  * <p>The ID of the application that will be deleted.</p>
443
506
  */
444
507
  applicationId: string | undefined;
@@ -453,6 +516,7 @@ export interface DeleteApplicationResponse {
453
516
  */
454
517
  export interface GetApplicationRequest {
455
518
  /**
519
+ * @public
456
520
  * <p>The ID of the application that will be described.</p>
457
521
  */
458
522
  applicationId: string | undefined;
@@ -462,6 +526,7 @@ export interface GetApplicationRequest {
462
526
  */
463
527
  export interface GetApplicationResponse {
464
528
  /**
529
+ * @public
465
530
  * <p>The output displays information about the specified application.</p>
466
531
  */
467
532
  application: Application | undefined;
@@ -471,14 +536,17 @@ export interface GetApplicationResponse {
471
536
  */
472
537
  export interface ListApplicationsRequest {
473
538
  /**
539
+ * @public
474
540
  * <p>The token for the next set of application results.</p>
475
541
  */
476
542
  nextToken?: string;
477
543
  /**
544
+ * @public
478
545
  * <p>The maximum number of applications that can be listed.</p>
479
546
  */
480
547
  maxResults?: number;
481
548
  /**
549
+ * @public
482
550
  * <p>An optional filter for application states. Note that if this filter contains multiple
483
551
  * states, the resulting list will be grouped by the state.</p>
484
552
  */
@@ -489,10 +557,12 @@ export interface ListApplicationsRequest {
489
557
  */
490
558
  export interface ListApplicationsResponse {
491
559
  /**
560
+ * @public
492
561
  * <p>The output lists the specified applications.</p>
493
562
  */
494
563
  applications: ApplicationSummary[] | undefined;
495
564
  /**
565
+ * @public
496
566
  * <p>The output displays the token for the next set of application results. This is required
497
567
  * for pagination and is available as a response of the previous request.</p>
498
568
  */
@@ -515,6 +585,7 @@ export declare class ServiceQuotaExceededException extends __BaseException {
515
585
  */
516
586
  export interface StartApplicationRequest {
517
587
  /**
588
+ * @public
518
589
  * <p>The ID of the application to start.</p>
519
590
  */
520
591
  applicationId: string | undefined;
@@ -529,6 +600,7 @@ export interface StartApplicationResponse {
529
600
  */
530
601
  export interface StopApplicationRequest {
531
602
  /**
603
+ * @public
532
604
  * <p>The ID of the application to stop.</p>
533
605
  */
534
606
  applicationId: string | undefined;
@@ -543,48 +615,58 @@ export interface StopApplicationResponse {
543
615
  */
544
616
  export interface UpdateApplicationRequest {
545
617
  /**
618
+ * @public
546
619
  * <p>The ID of the application to update.</p>
547
620
  */
548
621
  applicationId: string | undefined;
549
622
  /**
623
+ * @public
550
624
  * <p>The client idempotency token of the application to update. Its value must be unique for
551
625
  * each request.</p>
552
626
  */
553
627
  clientToken?: string;
554
628
  /**
629
+ * @public
555
630
  * <p>The capacity to initialize when the application is updated.</p>
556
631
  */
557
632
  initialCapacity?: Record<string, InitialCapacityConfig>;
558
633
  /**
634
+ * @public
559
635
  * <p>The maximum capacity to allocate when the application is updated. This is cumulative
560
636
  * across all workers at any given point in time during the lifespan of the application. No
561
637
  * new resources will be created once any one of the defined limits is hit.</p>
562
638
  */
563
639
  maximumCapacity?: MaximumAllowedResources;
564
640
  /**
641
+ * @public
565
642
  * <p>The configuration for an application to automatically start on job submission.</p>
566
643
  */
567
644
  autoStartConfiguration?: AutoStartConfig;
568
645
  /**
646
+ * @public
569
647
  * <p>The configuration for an application to automatically stop after a certain amount of
570
648
  * time being idle.</p>
571
649
  */
572
650
  autoStopConfiguration?: AutoStopConfig;
573
651
  /**
652
+ * @public
574
653
  * <p>The network configuration for customer VPC connectivity.</p>
575
654
  */
576
655
  networkConfiguration?: NetworkConfiguration;
577
656
  /**
657
+ * @public
578
658
  * <p>The CPU architecture of an application.</p>
579
659
  */
580
660
  architecture?: Architecture | string;
581
661
  /**
662
+ * @public
582
663
  * <p>The image configuration to be used for all worker types. You can either set this
583
664
  * parameter or <code>imageConfiguration</code> for each worker type in
584
665
  * <code>WorkerTypeSpecificationInput</code>.</p>
585
666
  */
586
667
  imageConfiguration?: ImageConfigurationInput;
587
668
  /**
669
+ * @public
588
670
  * <p>The key-value pairs that specify worker type to
589
671
  * <code>WorkerTypeSpecificationInput</code>. This parameter must contain all valid worker
590
672
  * types for a Spark or Hive application. Valid worker types include <code>Driver</code> and
@@ -595,6 +677,7 @@ export interface UpdateApplicationRequest {
595
677
  */
596
678
  workerTypeSpecifications?: Record<string, WorkerTypeSpecificationInput>;
597
679
  /**
680
+ * @public
598
681
  * <p>The Amazon EMR release label for the application. You can change the release
599
682
  * label to use a different release of Amazon EMR.</p>
600
683
  */
@@ -605,6 +688,7 @@ export interface UpdateApplicationRequest {
605
688
  */
606
689
  export interface UpdateApplicationResponse {
607
690
  /**
691
+ * @public
608
692
  * <p>Information about the updated application.</p>
609
693
  */
610
694
  application: Application | undefined;
@@ -614,10 +698,12 @@ export interface UpdateApplicationResponse {
614
698
  */
615
699
  export interface CancelJobRunRequest {
616
700
  /**
701
+ * @public
617
702
  * <p>The ID of the application on which the job run will be canceled.</p>
618
703
  */
619
704
  applicationId: string | undefined;
620
705
  /**
706
+ * @public
621
707
  * <p>The ID of the job run to cancel.</p>
622
708
  */
623
709
  jobRunId: string | undefined;
@@ -627,10 +713,12 @@ export interface CancelJobRunRequest {
627
713
  */
628
714
  export interface CancelJobRunResponse {
629
715
  /**
716
+ * @public
630
717
  * <p>The output contains the application ID on which the job run is cancelled.</p>
631
718
  */
632
719
  applicationId: string | undefined;
633
720
  /**
721
+ * @public
634
722
  * <p>The output contains the ID of the cancelled job run.</p>
635
723
  */
636
724
  jobRunId: string | undefined;
@@ -640,10 +728,12 @@ export interface CancelJobRunResponse {
640
728
  */
641
729
  export interface GetDashboardForJobRunRequest {
642
730
  /**
731
+ * @public
643
732
  * <p>The ID of the application.</p>
644
733
  */
645
734
  applicationId: string | undefined;
646
735
  /**
736
+ * @public
647
737
  * <p>The ID of the job run.</p>
648
738
  */
649
739
  jobRunId: string | undefined;
@@ -653,6 +743,7 @@ export interface GetDashboardForJobRunRequest {
653
743
  */
654
744
  export interface GetDashboardForJobRunResponse {
655
745
  /**
746
+ * @public
656
747
  * <p>The URL to view job run's dashboard.</p>
657
748
  */
658
749
  url?: string;
@@ -662,10 +753,12 @@ export interface GetDashboardForJobRunResponse {
662
753
  */
663
754
  export interface GetJobRunRequest {
664
755
  /**
756
+ * @public
665
757
  * <p>The ID of the application on which the job run is submitted.</p>
666
758
  */
667
759
  applicationId: string | undefined;
668
760
  /**
761
+ * @public
669
762
  * <p>The ID of the job run.</p>
670
763
  */
671
764
  jobRunId: string | undefined;
@@ -676,16 +769,19 @@ export interface GetJobRunRequest {
676
769
  */
677
770
  export interface ResourceUtilization {
678
771
  /**
772
+ * @public
679
773
  * <p>The aggregated vCPU used per hour from the time the job starts executing until the job
680
774
  * is terminated.</p>
681
775
  */
682
776
  vCPUHour?: number;
683
777
  /**
778
+ * @public
684
779
  * <p>The aggregated memory used per hour from the time the job starts executing until the job
685
780
  * is terminated.</p>
686
781
  */
687
782
  memoryGBHour?: number;
688
783
  /**
784
+ * @public
689
785
  * <p>The aggregated storage used per hour from the time the job starts executing until the
690
786
  * job is terminated.</p>
691
787
  */
@@ -698,23 +794,28 @@ export interface ResourceUtilization {
698
794
  */
699
795
  export interface CloudWatchLoggingConfiguration {
700
796
  /**
797
+ * @public
701
798
  * <p>Enables CloudWatch logging.</p>
702
799
  */
703
800
  enabled: boolean | undefined;
704
801
  /**
802
+ * @public
705
803
  * <p>The name of the log group in Amazon CloudWatch Logs where you want to publish your
706
804
  * logs.</p>
707
805
  */
708
806
  logGroupName?: string;
709
807
  /**
808
+ * @public
710
809
  * <p>Prefix for the CloudWatch log stream name.</p>
711
810
  */
712
811
  logStreamNamePrefix?: string;
713
812
  /**
813
+ * @public
714
814
  * <p>The Key Management Service (KMS) key ARN to encrypt the logs that you store in CloudWatch Logs.</p>
715
815
  */
716
816
  encryptionKeyArn?: string;
717
817
  /**
818
+ * @public
718
819
  * <p>The types of logs that you want to publish to CloudWatch. If you don't specify
719
820
  * any log types, driver STDOUT and STDERR logs will be published to CloudWatch Logs by
720
821
  * default. For more information including the supported worker types for Hive and Spark, see
@@ -745,11 +846,13 @@ export interface CloudWatchLoggingConfiguration {
745
846
  */
746
847
  export interface ManagedPersistenceMonitoringConfiguration {
747
848
  /**
849
+ * @public
748
850
  * <p>Enables managed logging and defaults to true. If set to false, managed logging will be
749
851
  * turned off.</p>
750
852
  */
751
853
  enabled?: boolean;
752
854
  /**
855
+ * @public
753
856
  * <p>The KMS key ARN to encrypt the logs stored in managed log persistence.</p>
754
857
  */
755
858
  encryptionKeyArn?: string;
@@ -761,10 +864,12 @@ export interface ManagedPersistenceMonitoringConfiguration {
761
864
  */
762
865
  export interface S3MonitoringConfiguration {
763
866
  /**
867
+ * @public
764
868
  * <p>The Amazon S3 destination URI for log publishing.</p>
765
869
  */
766
870
  logUri?: string;
767
871
  /**
872
+ * @public
768
873
  * <p>The KMS key ARN to encrypt the logs published to the given Amazon S3 destination.</p>
769
874
  */
770
875
  encryptionKeyArn?: string;
@@ -775,14 +880,17 @@ export interface S3MonitoringConfiguration {
775
880
  */
776
881
  export interface MonitoringConfiguration {
777
882
  /**
883
+ * @public
778
884
  * <p>The Amazon S3 configuration for monitoring log publishing.</p>
779
885
  */
780
886
  s3MonitoringConfiguration?: S3MonitoringConfiguration;
781
887
  /**
888
+ * @public
782
889
  * <p>The managed log persistence configuration for a job run.</p>
783
890
  */
784
891
  managedPersistenceMonitoringConfiguration?: ManagedPersistenceMonitoringConfiguration;
785
892
  /**
893
+ * @public
786
894
  * <p>The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs
787
895
  * to send log information to CloudWatch.</p>
788
896
  */
@@ -794,14 +902,17 @@ export interface MonitoringConfiguration {
794
902
  */
795
903
  export interface Hive {
796
904
  /**
905
+ * @public
797
906
  * <p>The query for the Hive job run.</p>
798
907
  */
799
908
  query: string | undefined;
800
909
  /**
910
+ * @public
801
911
  * <p>The query file for the Hive job run.</p>
802
912
  */
803
913
  initQueryFile?: string;
804
914
  /**
915
+ * @public
805
916
  * <p>The parameters for the Hive job run.</p>
806
917
  */
807
918
  parameters?: string;
@@ -812,14 +923,17 @@ export interface Hive {
812
923
  */
813
924
  export interface SparkSubmit {
814
925
  /**
926
+ * @public
815
927
  * <p>The entry point for the Spark submit job run.</p>
816
928
  */
817
929
  entryPoint: string | undefined;
818
930
  /**
931
+ * @public
819
932
  * <p>The arguments for the Spark submit job run.</p>
820
933
  */
821
934
  entryPointArguments?: string[];
822
935
  /**
936
+ * @public
823
937
  * <p>The parameters for the Spark submit job run.</p>
824
938
  */
825
939
  sparkSubmitParameters?: string;
@@ -834,6 +948,7 @@ export type JobDriver = JobDriver.HiveMember | JobDriver.SparkSubmitMember | Job
834
948
  */
835
949
  export declare namespace JobDriver {
836
950
  /**
951
+ * @public
837
952
  * <p>The job driver parameters specified for Spark.</p>
838
953
  */
839
954
  interface SparkSubmitMember {
@@ -842,6 +957,7 @@ export declare namespace JobDriver {
842
957
  $unknown?: never;
843
958
  }
844
959
  /**
960
+ * @public
845
961
  * <p>The job driver parameters specified for Hive.</p>
846
962
  */
847
963
  interface HiveMember {
@@ -849,6 +965,9 @@ export declare namespace JobDriver {
849
965
  hive: Hive;
850
966
  $unknown?: never;
851
967
  }
968
+ /**
969
+ * @public
970
+ */
852
971
  interface $UnknownMember {
853
972
  sparkSubmit?: never;
854
973
  hive?: never;
@@ -886,16 +1005,19 @@ export type JobRunState = (typeof JobRunState)[keyof typeof JobRunState];
886
1005
  */
887
1006
  export interface TotalResourceUtilization {
888
1007
  /**
1008
+ * @public
889
1009
  * <p>The aggregated vCPU used per hour from the time job start executing till the time job is
890
1010
  * terminated.</p>
891
1011
  */
892
1012
  vCPUHour?: number;
893
1013
  /**
1014
+ * @public
894
1015
  * <p>The aggregated memory used per hour from the time job start executing till the time job
895
1016
  * is terminated.</p>
896
1017
  */
897
1018
  memoryGBHour?: number;
898
1019
  /**
1020
+ * @public
899
1021
  * <p>The aggregated storage used per hour from the time job start executing till the time job
900
1022
  * is terminated.</p>
901
1023
  */
@@ -906,26 +1028,32 @@ export interface TotalResourceUtilization {
906
1028
  */
907
1029
  export interface ListJobRunsRequest {
908
1030
  /**
1031
+ * @public
909
1032
  * <p>The ID of the application for which to list the job run.</p>
910
1033
  */
911
1034
  applicationId: string | undefined;
912
1035
  /**
1036
+ * @public
913
1037
  * <p>The token for the next set of job run results.</p>
914
1038
  */
915
1039
  nextToken?: string;
916
1040
  /**
1041
+ * @public
917
1042
  * <p>The maximum number of job runs that can be listed.</p>
918
1043
  */
919
1044
  maxResults?: number;
920
1045
  /**
1046
+ * @public
921
1047
  * <p>The lower bound of the option to filter by creation date and time.</p>
922
1048
  */
923
1049
  createdAtAfter?: Date;
924
1050
  /**
1051
+ * @public
925
1052
  * <p>The upper bound of the option to filter by creation date and time.</p>
926
1053
  */
927
1054
  createdAtBefore?: Date;
928
1055
  /**
1056
+ * @public
929
1057
  * <p>An optional filter for job run states. Note that if this filter contains multiple
930
1058
  * states, the resulting list will be grouped by the state.</p>
931
1059
  */
@@ -937,51 +1065,63 @@ export interface ListJobRunsRequest {
937
1065
  */
938
1066
  export interface JobRunSummary {
939
1067
  /**
1068
+ * @public
940
1069
  * <p>The ID of the application the job is running on.</p>
941
1070
  */
942
1071
  applicationId: string | undefined;
943
1072
  /**
1073
+ * @public
944
1074
  * <p>The ID of the job run.</p>
945
1075
  */
946
1076
  id: string | undefined;
947
1077
  /**
1078
+ * @public
948
1079
  * <p>The optional job run name. This doesn't have to be unique.</p>
949
1080
  */
950
1081
  name?: string;
951
1082
  /**
1083
+ * @public
952
1084
  * <p>The ARN of the job run.</p>
953
1085
  */
954
1086
  arn: string | undefined;
955
1087
  /**
1088
+ * @public
956
1089
  * <p>The user who created the job run.</p>
957
1090
  */
958
1091
  createdBy: string | undefined;
959
1092
  /**
1093
+ * @public
960
1094
  * <p>The date and time when the job run was created.</p>
961
1095
  */
962
1096
  createdAt: Date | undefined;
963
1097
  /**
1098
+ * @public
964
1099
  * <p>The date and time when the job run was last updated.</p>
965
1100
  */
966
1101
  updatedAt: Date | undefined;
967
1102
  /**
1103
+ * @public
968
1104
  * <p>The execution role ARN of the job run.</p>
969
1105
  */
970
1106
  executionRole: string | undefined;
971
1107
  /**
1108
+ * @public
972
1109
  * <p>The state of the job run.</p>
973
1110
  */
974
1111
  state: JobRunState | string | undefined;
975
1112
  /**
1113
+ * @public
976
1114
  * <p>The state details of the job run.</p>
977
1115
  */
978
1116
  stateDetails: string | undefined;
979
1117
  /**
1118
+ * @public
980
1119
  * <p>The Amazon EMR release associated with the application your job is running
981
1120
  * on.</p>
982
1121
  */
983
1122
  releaseLabel: string | undefined;
984
1123
  /**
1124
+ * @public
985
1125
  * <p>The type of job run, such as Spark or Hive.</p>
986
1126
  */
987
1127
  type?: string;
@@ -991,10 +1131,12 @@ export interface JobRunSummary {
991
1131
  */
992
1132
  export interface ListJobRunsResponse {
993
1133
  /**
1134
+ * @public
994
1135
  * <p>The output lists information about the specified job runs.</p>
995
1136
  */
996
1137
  jobRuns: JobRunSummary[] | undefined;
997
1138
  /**
1139
+ * @public
998
1140
  * <p>The output displays the token for the next set of job run results. This is required for
999
1141
  * pagination and is available as a response of the previous request.</p>
1000
1142
  */
@@ -1005,14 +1147,17 @@ export interface ListJobRunsResponse {
1005
1147
  */
1006
1148
  export interface StartJobRunResponse {
1007
1149
  /**
1150
+ * @public
1008
1151
  * <p>This output displays the application ID on which the job run was submitted.</p>
1009
1152
  */
1010
1153
  applicationId: string | undefined;
1011
1154
  /**
1155
+ * @public
1012
1156
  * <p>The output contains the ID of the started job run.</p>
1013
1157
  */
1014
1158
  jobRunId: string | undefined;
1015
1159
  /**
1160
+ * @public
1016
1161
  * <p>This output displays the ARN of the job run..</p>
1017
1162
  */
1018
1163
  arn: string | undefined;
@@ -1022,6 +1167,7 @@ export interface StartJobRunResponse {
1022
1167
  */
1023
1168
  export interface ListTagsForResourceRequest {
1024
1169
  /**
1170
+ * @public
1025
1171
  * <p>The Amazon Resource Name (ARN) that identifies the resource to list the tags for.
1026
1172
  * Currently, the supported resources are Amazon EMR Serverless applications and job
1027
1173
  * runs.</p>
@@ -1033,6 +1179,7 @@ export interface ListTagsForResourceRequest {
1033
1179
  */
1034
1180
  export interface ListTagsForResourceResponse {
1035
1181
  /**
1182
+ * @public
1036
1183
  * <p>The tags for the resource.</p>
1037
1184
  */
1038
1185
  tags?: Record<string, string>;
@@ -1042,12 +1189,14 @@ export interface ListTagsForResourceResponse {
1042
1189
  */
1043
1190
  export interface TagResourceRequest {
1044
1191
  /**
1192
+ * @public
1045
1193
  * <p>The Amazon Resource Name (ARN) that identifies the resource to list the tags for.
1046
1194
  * Currently, the supported resources are Amazon EMR Serverless applications and job
1047
1195
  * runs.</p>
1048
1196
  */
1049
1197
  resourceArn: string | undefined;
1050
1198
  /**
1199
+ * @public
1051
1200
  * <p>The tags to add to the resource. A tag is an array of key-value pairs.</p>
1052
1201
  */
1053
1202
  tags: Record<string, string> | undefined;
@@ -1062,12 +1211,14 @@ export interface TagResourceResponse {
1062
1211
  */
1063
1212
  export interface UntagResourceRequest {
1064
1213
  /**
1214
+ * @public
1065
1215
  * <p>The Amazon Resource Name (ARN) that identifies the resource to list the tags for.
1066
1216
  * Currently, the supported resources are Amazon EMR Serverless applications and job
1067
1217
  * runs.</p>
1068
1218
  */
1069
1219
  resourceArn: string | undefined;
1070
1220
  /**
1221
+ * @public
1071
1222
  * <p>The keys of the tags to be removed.</p>
1072
1223
  */
1073
1224
  tagKeys: string[] | undefined;
@@ -1086,14 +1237,17 @@ export interface UntagResourceResponse {
1086
1237
  */
1087
1238
  export interface Configuration {
1088
1239
  /**
1240
+ * @public
1089
1241
  * <p>The classification within a configuration.</p>
1090
1242
  */
1091
1243
  classification: string | undefined;
1092
1244
  /**
1245
+ * @public
1093
1246
  * <p>A set of properties specified within a configuration classification.</p>
1094
1247
  */
1095
1248
  properties?: Record<string, string>;
1096
1249
  /**
1250
+ * @public
1097
1251
  * <p>A list of additional configurations to apply within a configuration object.</p>
1098
1252
  */
1099
1253
  configurations?: Configuration[];
@@ -1104,10 +1258,12 @@ export interface Configuration {
1104
1258
  */
1105
1259
  export interface ConfigurationOverrides {
1106
1260
  /**
1261
+ * @public
1107
1262
  * <p>The override configurations for the application.</p>
1108
1263
  */
1109
1264
  applicationConfiguration?: Configuration[];
1110
1265
  /**
1266
+ * @public
1111
1267
  * <p>The override configurations for monitoring.</p>
1112
1268
  */
1113
1269
  monitoringConfiguration?: MonitoringConfiguration;
@@ -1120,83 +1276,102 @@ export interface ConfigurationOverrides {
1120
1276
  */
1121
1277
  export interface JobRun {
1122
1278
  /**
1279
+ * @public
1123
1280
  * <p>The ID of the application the job is running on.</p>
1124
1281
  */
1125
1282
  applicationId: string | undefined;
1126
1283
  /**
1284
+ * @public
1127
1285
  * <p>The ID of the job run.</p>
1128
1286
  */
1129
1287
  jobRunId: string | undefined;
1130
1288
  /**
1289
+ * @public
1131
1290
  * <p>The optional job run name. This doesn't have to be unique.</p>
1132
1291
  */
1133
1292
  name?: string;
1134
1293
  /**
1294
+ * @public
1135
1295
  * <p>The execution role ARN of the job run.</p>
1136
1296
  */
1137
1297
  arn: string | undefined;
1138
1298
  /**
1299
+ * @public
1139
1300
  * <p>The user who created the job run.</p>
1140
1301
  */
1141
1302
  createdBy: string | undefined;
1142
1303
  /**
1304
+ * @public
1143
1305
  * <p>The date and time when the job run was created.</p>
1144
1306
  */
1145
1307
  createdAt: Date | undefined;
1146
1308
  /**
1309
+ * @public
1147
1310
  * <p>The date and time when the job run was updated.</p>
1148
1311
  */
1149
1312
  updatedAt: Date | undefined;
1150
1313
  /**
1314
+ * @public
1151
1315
  * <p>The execution role ARN of the job run.</p>
1152
1316
  */
1153
1317
  executionRole: string | undefined;
1154
1318
  /**
1319
+ * @public
1155
1320
  * <p>The state of the job run.</p>
1156
1321
  */
1157
1322
  state: JobRunState | string | undefined;
1158
1323
  /**
1324
+ * @public
1159
1325
  * <p>The state details of the job run.</p>
1160
1326
  */
1161
1327
  stateDetails: string | undefined;
1162
1328
  /**
1329
+ * @public
1163
1330
  * <p>The Amazon EMR release associated with the application your job is running
1164
1331
  * on.</p>
1165
1332
  */
1166
1333
  releaseLabel: string | undefined;
1167
1334
  /**
1335
+ * @public
1168
1336
  * <p>The configuration settings that are used to override default configuration.</p>
1169
1337
  */
1170
1338
  configurationOverrides?: ConfigurationOverrides;
1171
1339
  /**
1340
+ * @public
1172
1341
  * <p>The job driver for the job run.</p>
1173
1342
  */
1174
1343
  jobDriver: JobDriver | undefined;
1175
1344
  /**
1345
+ * @public
1176
1346
  * <p>The tags assigned to the job run.</p>
1177
1347
  */
1178
1348
  tags?: Record<string, string>;
1179
1349
  /**
1350
+ * @public
1180
1351
  * <p>The aggregate vCPU, memory, and storage resources used from the time the job starts to
1181
1352
  * execute, until the time the job terminates, rounded up to the nearest second.</p>
1182
1353
  */
1183
1354
  totalResourceUtilization?: TotalResourceUtilization;
1184
1355
  /**
1356
+ * @public
1185
1357
  * <p>The network configuration for customer VPC connectivity.</p>
1186
1358
  */
1187
1359
  networkConfiguration?: NetworkConfiguration;
1188
1360
  /**
1361
+ * @public
1189
1362
  * <p>The job run total execution duration in seconds. This field is only available for job
1190
1363
  * runs in a <code>COMPLETED</code>, <code>FAILED</code>, or <code>CANCELLED</code>
1191
1364
  * state.</p>
1192
1365
  */
1193
1366
  totalExecutionDurationSeconds?: number;
1194
1367
  /**
1368
+ * @public
1195
1369
  * <p>Returns the job run timeout value from the <code>StartJobRun</code> call. If no timeout
1196
1370
  * was specified, then it returns the default timeout of 720 minutes.</p>
1197
1371
  */
1198
1372
  executionTimeoutMinutes?: number;
1199
1373
  /**
1374
+ * @public
1200
1375
  * <p>The aggregate vCPU, memory, and storage that Amazon Web Services has billed for the job
1201
1376
  * run. The billed resources include a 1-minute minimum usage for workers, plus additional
1202
1377
  * storage over 20 GB per worker. Note that billed resources do not include usage for idle
@@ -1209,36 +1384,44 @@ export interface JobRun {
1209
1384
  */
1210
1385
  export interface StartJobRunRequest {
1211
1386
  /**
1387
+ * @public
1212
1388
  * <p>The ID of the application on which to run the job.</p>
1213
1389
  */
1214
1390
  applicationId: string | undefined;
1215
1391
  /**
1392
+ * @public
1216
1393
  * <p>The client idempotency token of the job run to start. Its value must be unique for each
1217
1394
  * request.</p>
1218
1395
  */
1219
1396
  clientToken?: string;
1220
1397
  /**
1398
+ * @public
1221
1399
  * <p>The execution role ARN for the job run.</p>
1222
1400
  */
1223
1401
  executionRoleArn: string | undefined;
1224
1402
  /**
1403
+ * @public
1225
1404
  * <p>The job driver for the job run.</p>
1226
1405
  */
1227
1406
  jobDriver?: JobDriver;
1228
1407
  /**
1408
+ * @public
1229
1409
  * <p>The configuration overrides for the job run.</p>
1230
1410
  */
1231
1411
  configurationOverrides?: ConfigurationOverrides;
1232
1412
  /**
1413
+ * @public
1233
1414
  * <p>The tags assigned to the job run.</p>
1234
1415
  */
1235
1416
  tags?: Record<string, string>;
1236
1417
  /**
1418
+ * @public
1237
1419
  * <p>The maximum duration for the job run to run. If the job run runs beyond this duration,
1238
1420
  * it will be automatically cancelled.</p>
1239
1421
  */
1240
1422
  executionTimeoutMinutes?: number;
1241
1423
  /**
1424
+ * @public
1242
1425
  * <p>The optional job run name. This doesn't have to be unique.</p>
1243
1426
  */
1244
1427
  name?: string;
@@ -1248,6 +1431,7 @@ export interface StartJobRunRequest {
1248
1431
  */
1249
1432
  export interface GetJobRunResponse {
1250
1433
  /**
1434
+ * @public
1251
1435
  * <p>The output displays information about the job run.</p>
1252
1436
  */
1253
1437
  jobRun: JobRun | undefined;
@@ -1,5 +1,6 @@
1
1
  export * from "./EMRServerlessClient";
2
2
  export * from "./EMRServerless";
3
+ export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
3
4
  export * from "./commands";
4
5
  export * from "./pagination";
5
6
  export * from "./models";
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-emr-serverless",
3
3
  "description": "AWS SDK for JavaScript Emr Serverless Client for Node.js, Browser and React Native",
4
- "version": "3.378.0",
4
+ "version": "3.382.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,15 +21,15 @@
21
21
  "dependencies": {
22
22
  "@aws-crypto/sha256-browser": "3.0.0",
23
23
  "@aws-crypto/sha256-js": "3.0.0",
24
- "@aws-sdk/client-sts": "3.378.0",
25
- "@aws-sdk/credential-provider-node": "3.378.0",
26
- "@aws-sdk/middleware-host-header": "3.378.0",
24
+ "@aws-sdk/client-sts": "3.382.0",
25
+ "@aws-sdk/credential-provider-node": "3.382.0",
26
+ "@aws-sdk/middleware-host-header": "3.379.1",
27
27
  "@aws-sdk/middleware-logger": "3.378.0",
28
28
  "@aws-sdk/middleware-recursion-detection": "3.378.0",
29
- "@aws-sdk/middleware-signing": "3.378.0",
30
- "@aws-sdk/middleware-user-agent": "3.378.0",
29
+ "@aws-sdk/middleware-signing": "3.379.1",
30
+ "@aws-sdk/middleware-user-agent": "3.382.0",
31
31
  "@aws-sdk/types": "3.378.0",
32
- "@aws-sdk/util-endpoints": "3.378.0",
32
+ "@aws-sdk/util-endpoints": "3.382.0",
33
33
  "@aws-sdk/util-user-agent-browser": "3.378.0",
34
34
  "@aws-sdk/util-user-agent-node": "3.378.0",
35
35
  "@smithy/config-resolver": "^2.0.1",