@aws-sdk/client-emr 3.1061.0 → 3.1063.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.
Files changed (45) hide show
  1. package/README.md +35 -0
  2. package/dist-cjs/index.js +85 -0
  3. package/dist-cjs/schemas/schemas_0.js +178 -32
  4. package/dist-es/EMR.js +12 -0
  5. package/dist-es/commands/GetSessionCommand.js +16 -0
  6. package/dist-es/commands/GetSessionEndpointCommand.js +16 -0
  7. package/dist-es/commands/ListSessionsCommand.js +16 -0
  8. package/dist-es/commands/StartSessionCommand.js +16 -0
  9. package/dist-es/commands/TerminateSessionCommand.js +16 -0
  10. package/dist-es/commands/index.js +5 -0
  11. package/dist-es/models/enums.js +10 -0
  12. package/dist-es/pagination/ListSessionsPaginator.js +4 -0
  13. package/dist-es/pagination/index.js +1 -0
  14. package/dist-es/schemas/schemas_0.js +171 -26
  15. package/dist-types/EMR.d.ts +42 -0
  16. package/dist-types/EMRClient.d.ts +7 -2
  17. package/dist-types/commands/AddTagsCommand.d.ts +1 -0
  18. package/dist-types/commands/DescribeClusterCommand.d.ts +1 -0
  19. package/dist-types/commands/GetSessionCommand.d.ts +155 -0
  20. package/dist-types/commands/GetSessionEndpointCommand.d.ts +92 -0
  21. package/dist-types/commands/ListSessionsCommand.d.ts +162 -0
  22. package/dist-types/commands/RemoveTagsCommand.d.ts +1 -0
  23. package/dist-types/commands/RunJobFlowCommand.d.ts +1 -0
  24. package/dist-types/commands/StartSessionCommand.d.ts +141 -0
  25. package/dist-types/commands/TerminateSessionCommand.d.ts +86 -0
  26. package/dist-types/commands/index.d.ts +5 -0
  27. package/dist-types/models/enums.d.ts +18 -0
  28. package/dist-types/models/models_0.d.ts +473 -7
  29. package/dist-types/pagination/ListSessionsPaginator.d.ts +7 -0
  30. package/dist-types/pagination/index.d.ts +1 -0
  31. package/dist-types/schemas/schemas_0.d.ts +21 -0
  32. package/dist-types/ts3.4/EMR.d.ts +92 -0
  33. package/dist-types/ts3.4/EMRClient.d.ts +30 -0
  34. package/dist-types/ts3.4/commands/GetSessionCommand.d.ts +49 -0
  35. package/dist-types/ts3.4/commands/GetSessionEndpointCommand.d.ts +53 -0
  36. package/dist-types/ts3.4/commands/ListSessionsCommand.d.ts +49 -0
  37. package/dist-types/ts3.4/commands/StartSessionCommand.d.ts +49 -0
  38. package/dist-types/ts3.4/commands/TerminateSessionCommand.d.ts +52 -0
  39. package/dist-types/ts3.4/commands/index.d.ts +5 -0
  40. package/dist-types/ts3.4/models/enums.d.ts +11 -0
  41. package/dist-types/ts3.4/models/models_0.d.ts +108 -0
  42. package/dist-types/ts3.4/pagination/ListSessionsPaginator.d.ts +11 -0
  43. package/dist-types/ts3.4/pagination/index.d.ts +1 -0
  44. package/dist-types/ts3.4/schemas/schemas_0.d.ts +21 -0
  45. package/package.json +5 -5
@@ -1,4 +1,4 @@
1
- import type { ActionOnFailure, AdjustmentType, AuthMode, AutoScalingPolicyState, AutoScalingPolicyStateChangeReasonCode, CancelStepsRequestStatus, ClusterState, ClusterStateChangeReasonCode, ComparisonOperator, ComputeLimitsUnitType, ExecutionEngineType, IdcUserAssignment, IdentityType, InstanceCollectionType, InstanceFleetState, InstanceFleetStateChangeReasonCode, InstanceFleetType, InstanceGroupState, InstanceGroupStateChangeReasonCode, InstanceGroupType, InstanceRoleType, InstanceState, InstanceStateChangeReasonCode, JobFlowExecutionState, LogType, LogUploadPolicyValue, MarketType, NotebookExecutionStatus, OnClusterAppUIType, OnDemandCapacityReservationPreference, OnDemandCapacityReservationUsageStrategy, OnDemandProvisioningAllocationStrategy, OutputNotebookFormat, PersistentAppUIType, PlacementGroupStrategy, ProfilerType, ReconfigurationType, RepoUpgradeOnBoot, ScaleDownBehavior, ScalingStrategy, SpotProvisioningAllocationStrategy, SpotProvisioningTimeoutAction, Statistic, StepCancellationOption, StepExecutionState, StepState, StepStateChangeReasonCode, Unit } from "./enums";
1
+ import type { ActionOnFailure, AdjustmentType, AuthMode, AutoScalingPolicyState, AutoScalingPolicyStateChangeReasonCode, CancelStepsRequestStatus, ClusterState, ClusterStateChangeReasonCode, ComparisonOperator, ComputeLimitsUnitType, ExecutionEngineType, IdcUserAssignment, IdentityType, InstanceCollectionType, InstanceFleetState, InstanceFleetStateChangeReasonCode, InstanceFleetType, InstanceGroupState, InstanceGroupStateChangeReasonCode, InstanceGroupType, InstanceRoleType, InstanceState, InstanceStateChangeReasonCode, JobFlowExecutionState, LogType, LogUploadPolicyValue, MarketType, NotebookExecutionStatus, OnClusterAppUIType, OnDemandCapacityReservationPreference, OnDemandCapacityReservationUsageStrategy, OnDemandProvisioningAllocationStrategy, OutputNotebookFormat, PersistentAppUIType, PlacementGroupStrategy, ProfilerType, ReconfigurationType, RepoUpgradeOnBoot, ScaleDownBehavior, ScalingStrategy, SessionState, SpotProvisioningAllocationStrategy, SpotProvisioningTimeoutAction, Statistic, StepCancellationOption, StepExecutionState, StepState, StepStateChangeReasonCode, Unit } from "./enums";
2
2
  /**
3
3
  * <p>EBS volume specifications such as volume type, IOPS, size (GiB) and throughput (MiB/s)
4
4
  * that are requested for the EBS volume attached to an Amazon EC2 instance in the
@@ -786,6 +786,11 @@ export interface AddTagsInput {
786
786
  * @public
787
787
  */
788
788
  Tags: Tag[] | undefined;
789
+ /**
790
+ * <p>The ID of the cluster that scopes the tag operation. Required when the resource being tagged is a session-scoped resource.</p>
791
+ * @public
792
+ */
793
+ ClusterId?: string | undefined;
789
794
  }
790
795
  /**
791
796
  * <p>This output indicates the result of adding tags to a resource.</p>
@@ -1043,6 +1048,22 @@ export interface CancelStepsOutput {
1043
1048
  */
1044
1049
  CancelStepsInfoList?: CancelStepsInfo[] | undefined;
1045
1050
  }
1051
+ /**
1052
+ * <p>Describes the certificate authority used to establish an mTLS connection to the Spark Connect server when connecting directly over VPC peering.</p>
1053
+ * @public
1054
+ */
1055
+ export interface CertificateAuthority {
1056
+ /**
1057
+ * <p>The Amazon Resource Name (ARN) of the certificate authority in Amazon Web Services Private CA that issued the Spark Connect server certificate.</p>
1058
+ * @public
1059
+ */
1060
+ CertificateArn?: string | undefined;
1061
+ /**
1062
+ * <p>The PEM-encoded root CA certificate data. Provide this certificate to your client's trust store when connecting directly to the Spark Connect server over VPC peering.</p>
1063
+ * @public
1064
+ */
1065
+ CertificateData?: string | undefined;
1066
+ }
1046
1067
  /**
1047
1068
  * <p>Holds CloudWatch log configuration settings and metadata that specify settings like log files to monitor and where to send them.</p>
1048
1069
  * @public
@@ -1210,30 +1231,35 @@ export interface S3LoggingConfiguration {
1210
1231
  * <ul>
1211
1232
  * <li>
1212
1233
  * <p>
1213
- * <code>system-logs</code>: System-level logs including daemon logs, bootstrap logs, and other infrastructure logs.</p>
1234
+ * <code>system-logs</code>: EMR Daemon logs.</p>
1214
1235
  * </li>
1215
1236
  * <li>
1216
1237
  * <p>
1217
- * <code>application-logs</code>: Application-level logs from frameworks like Hadoop, Spark, Hive, etc.</p>
1238
+ * <code>application-logs</code>: Framework logs from Hadoop, Spark, Hive and other applications running on the cluster.</p>
1218
1239
  * </li>
1219
1240
  * <li>
1220
1241
  * <p>
1221
- * <code>persistent-ui-logs</code>: Logs for persistent application UIs like Spark History Server.</p>
1242
+ * <code>persistent-ui-logs</code>: Logs required for persistent application UIs such as Spark History Server and Tez UI.</p>
1222
1243
  * </li>
1223
1244
  * </ul>
1224
1245
  * <p>Valid upload policies:</p>
1225
1246
  * <ul>
1226
1247
  * <li>
1227
1248
  * <p>
1228
- * <code>emr-managed</code>: Logs are uploaded to both the EMR-managed S3 bucket and the customer-specified S3 bucket (if LogUri is provided).</p>
1249
+ * <code>emr-managed</code>: Standard behavior. Logs are uploaded to S3 bucket as configured in your
1250
+ * LogUri, with certain logs retained by the service for operational
1251
+ * support and troubleshooting purposes.</p>
1229
1252
  * </li>
1230
1253
  * <li>
1231
1254
  * <p>
1232
- * <code>on-customer-s3only</code>: Logs are uploaded only to the customer-specified S3 bucket. Requires LogUri to be specified in the cluster configuration.</p>
1255
+ * <code>on-customer-s3only</code>: Logs are uploaded only to the customer-specified S3 bucket. This requires you to specify a LogUri
1256
+ * when creating the cluster. Persistent-ui-logs cannot have
1257
+ * on-customer-s3only policy. Allowed policies for persistent-ui-logs
1258
+ * are emr-managed and disabled.</p>
1233
1259
  * </li>
1234
1260
  * <li>
1235
1261
  * <p>
1236
- * <code>disabled</code>: Log upload is disabled for this log type.</p>
1262
+ * <code>disabled</code>: No S3 upload for this log type.</p>
1237
1263
  * </li>
1238
1264
  * </ul>
1239
1265
  * @public
@@ -3293,6 +3319,158 @@ export interface GetPersistentAppUIPresignedURLOutput {
3293
3319
  */
3294
3320
  PresignedURL?: string | undefined;
3295
3321
  }
3322
+ /**
3323
+ * <p>Input to the <code>GetSession</code> operation.</p>
3324
+ * @public
3325
+ */
3326
+ export interface GetSessionInput {
3327
+ /**
3328
+ * <p>The ID of the cluster that the session belongs to.</p>
3329
+ * @public
3330
+ */
3331
+ ClusterId: string | undefined;
3332
+ /**
3333
+ * <p>The ID of the session.</p>
3334
+ * @public
3335
+ */
3336
+ SessionId: string | undefined;
3337
+ }
3338
+ /**
3339
+ * <p>The CloudWatch Logs configuration for a session.</p>
3340
+ * @public
3341
+ */
3342
+ export interface SessionCloudWatchLoggingConfiguration {
3343
+ /**
3344
+ * <p>Whether CloudWatch Logs is enabled for the session.</p>
3345
+ * @public
3346
+ */
3347
+ Enabled?: boolean | undefined;
3348
+ /**
3349
+ * <p>The name of the log group where session logs are published.</p>
3350
+ * @public
3351
+ */
3352
+ LogGroup?: string | undefined;
3353
+ /**
3354
+ * <p>The prefix applied to the log stream name where session logs are published.</p>
3355
+ * @public
3356
+ */
3357
+ LogStreamNamePrefix?: string | undefined;
3358
+ /**
3359
+ * <p>The Amazon Resource Name (ARN) of the KMS key used to encrypt the logs published to CloudWatch Logs.</p>
3360
+ * @public
3361
+ */
3362
+ EncryptionKeyArn?: string | undefined;
3363
+ /**
3364
+ * <p>A map of log component names (for example, <code>SPARK_DRIVER</code>, <code>SPARK_EXECUTOR</code>) to the list of log types to publish for that component (for example, <code>stdout</code>, <code>stderr</code>).</p>
3365
+ * @public
3366
+ */
3367
+ LogTypes?: Record<string, string[]> | undefined;
3368
+ }
3369
+ /**
3370
+ * <p>The Amazon EMR-managed logging configuration for a session.</p>
3371
+ * @public
3372
+ */
3373
+ export interface SessionManagedLoggingConfiguration {
3374
+ /**
3375
+ * <p>Whether Amazon EMR-managed logging is enabled for the session.</p>
3376
+ * @public
3377
+ */
3378
+ Enabled?: boolean | undefined;
3379
+ /**
3380
+ * <p>The Amazon Resource Name (ARN) of the KMS key used to encrypt the managed logs.</p>
3381
+ * @public
3382
+ */
3383
+ EncryptionKeyArn?: string | undefined;
3384
+ }
3385
+ /**
3386
+ * <p>The Amazon S3 logging configuration for a session.</p>
3387
+ * @public
3388
+ */
3389
+ export interface SessionS3LoggingConfiguration {
3390
+ /**
3391
+ * <p>Whether Amazon S3 logging is enabled for the session.</p>
3392
+ * @public
3393
+ */
3394
+ Enabled?: boolean | undefined;
3395
+ /**
3396
+ * <p>The Amazon S3 destination URI where session logs are published.</p>
3397
+ * @public
3398
+ */
3399
+ LogUri?: string | undefined;
3400
+ /**
3401
+ * <p>The Amazon Resource Name (ARN) of the KMS key used to encrypt logs published to Amazon S3.</p>
3402
+ * @public
3403
+ */
3404
+ EncryptionKeyArn?: string | undefined;
3405
+ /**
3406
+ * <p>A map of log component names (for example, <code>SPARK_DRIVER</code>, <code>SPARK_EXECUTOR</code>) to the list of log types to publish for that component (for example, <code>stdout</code>, <code>stderr</code>).</p>
3407
+ * @public
3408
+ */
3409
+ LogTypes?: Record<string, string[]> | undefined;
3410
+ }
3411
+ /**
3412
+ * <p>The monitoring configuration for a session. Controls where session logs are published.</p>
3413
+ * @public
3414
+ */
3415
+ export interface SessionMonitoringConfiguration {
3416
+ /**
3417
+ * <p>The CloudWatch Logs configuration for the session.</p>
3418
+ * @public
3419
+ */
3420
+ CloudWatchLoggingConfiguration?: SessionCloudWatchLoggingConfiguration | undefined;
3421
+ /**
3422
+ * <p>The Amazon EMR-managed logging configuration for the session.</p>
3423
+ * @public
3424
+ */
3425
+ ManagedLoggingConfiguration?: SessionManagedLoggingConfiguration | undefined;
3426
+ /**
3427
+ * <p>The Amazon S3 logging configuration for the session.</p>
3428
+ * @public
3429
+ */
3430
+ S3LoggingConfiguration?: SessionS3LoggingConfiguration | undefined;
3431
+ }
3432
+ /**
3433
+ * <p>Input to the <code>GetSessionEndpoint</code> operation.</p>
3434
+ * @public
3435
+ */
3436
+ export interface GetSessionEndpointInput {
3437
+ /**
3438
+ * <p>The ID of the cluster that the session belongs to.</p>
3439
+ * @public
3440
+ */
3441
+ ClusterId: string | undefined;
3442
+ /**
3443
+ * <p>The ID of the session.</p>
3444
+ * @public
3445
+ */
3446
+ SessionId: string | undefined;
3447
+ }
3448
+ /**
3449
+ * <p>Output of the <code>GetSessionEndpoint</code> operation.</p>
3450
+ * @public
3451
+ */
3452
+ export interface GetSessionEndpointOutput {
3453
+ /**
3454
+ * <p>The Spark Connect endpoint URL to use in the PySpark client.</p>
3455
+ * @public
3456
+ */
3457
+ Endpoint: string | undefined;
3458
+ /**
3459
+ * <p>A time-limited authentication token used to connect to the Spark Connect endpoint.</p>
3460
+ * @public
3461
+ */
3462
+ AuthToken?: string | undefined;
3463
+ /**
3464
+ * <p>The time at which the authentication token expires. After this time, call <code>GetSessionEndpoint</code> again to obtain a new token.</p>
3465
+ * @public
3466
+ */
3467
+ AuthTokenExpirationTime?: Date | undefined;
3468
+ /**
3469
+ * <p>Username and password used to authenticate with the Spark Connect server when connecting directly over VPC peering.</p>
3470
+ * @public
3471
+ */
3472
+ Credentials?: Credentials | undefined;
3473
+ }
3296
3474
  /**
3297
3475
  * @public
3298
3476
  */
@@ -4186,6 +4364,32 @@ export interface ListSecurityConfigurationsOutput {
4186
4364
  */
4187
4365
  Marker?: string | undefined;
4188
4366
  }
4367
+ /**
4368
+ * <p>Input to the <code>ListSessions</code> operation.</p>
4369
+ * @public
4370
+ */
4371
+ export interface ListSessionsInput {
4372
+ /**
4373
+ * <p>The ID of the cluster to list sessions for.</p>
4374
+ * @public
4375
+ */
4376
+ ClusterId: string | undefined;
4377
+ /**
4378
+ * <p>An optional filter that limits the results to sessions in the specified states.</p>
4379
+ * @public
4380
+ */
4381
+ SessionStates?: SessionState[] | undefined;
4382
+ /**
4383
+ * <p>The pagination token returned by a previous <code>ListSessions</code> call. Use it to retrieve the next page of results.</p>
4384
+ * @public
4385
+ */
4386
+ NextToken?: string | undefined;
4387
+ /**
4388
+ * <p>The maximum number of sessions to return in each page of results.</p>
4389
+ * @public
4390
+ */
4391
+ MaxResults?: number | undefined;
4392
+ }
4189
4393
  /**
4190
4394
  * <p>This input determines which steps to list.</p>
4191
4395
  * @public
@@ -4739,6 +4943,11 @@ export interface RemoveTagsInput {
4739
4943
  * @public
4740
4944
  */
4741
4945
  TagKeys: string[] | undefined;
4946
+ /**
4947
+ * <p>The ID of the cluster that scopes the tag operation. Required when the resource being untagged is a session-scoped resource.</p>
4948
+ * @public
4949
+ */
4950
+ ClusterId?: string | undefined;
4742
4951
  }
4743
4952
  /**
4744
4953
  * <p>This output indicates the result of removing tags from the resource.</p>
@@ -4974,6 +5183,37 @@ export interface StartNotebookExecutionOutput {
4974
5183
  */
4975
5184
  NotebookExecutionId?: string | undefined;
4976
5185
  }
5186
+ /**
5187
+ * <p>Output of the <code>StartSession</code> operation.</p>
5188
+ * @public
5189
+ */
5190
+ export interface StartSessionOutput {
5191
+ /**
5192
+ * <p>The output contains the ID of the session.</p>
5193
+ * @public
5194
+ */
5195
+ Id: string | undefined;
5196
+ /**
5197
+ * <p>The ID of the cluster that the session was started on.</p>
5198
+ * @public
5199
+ */
5200
+ ClusterId?: string | undefined;
5201
+ /**
5202
+ * <p>The output contains the ARN of the session.</p>
5203
+ * @public
5204
+ */
5205
+ Arn?: string | undefined;
5206
+ /**
5207
+ * <p>The Amazon Web Services account ID that owns the session.</p>
5208
+ * @public
5209
+ */
5210
+ AccountId?: string | undefined;
5211
+ /**
5212
+ * <p>The state of the session at the time the request returned. When a session is first created, it enters the <code>SUBMITTED</code> state.</p>
5213
+ * @public
5214
+ */
5215
+ State?: SessionState | undefined;
5216
+ }
4977
5217
  /**
4978
5218
  * @public
4979
5219
  */
@@ -4995,6 +5235,43 @@ export interface TerminateJobFlowsInput {
4995
5235
  */
4996
5236
  JobFlowIds: string[] | undefined;
4997
5237
  }
5238
+ /**
5239
+ * <p>Input to the <code>TerminateSession</code> operation.</p>
5240
+ * @public
5241
+ */
5242
+ export interface TerminateSessionInput {
5243
+ /**
5244
+ * <p>The ID of the cluster that the session belongs to.</p>
5245
+ * @public
5246
+ */
5247
+ ClusterId: string | undefined;
5248
+ /**
5249
+ * <p>The ID of the session to terminate.</p>
5250
+ * @public
5251
+ */
5252
+ SessionId: string | undefined;
5253
+ }
5254
+ /**
5255
+ * <p>Output of the <code>TerminateSession</code> operation.</p>
5256
+ * @public
5257
+ */
5258
+ export interface TerminateSessionOutput {
5259
+ /**
5260
+ * <p>The ID of the cluster that the session belonged to.</p>
5261
+ * @public
5262
+ */
5263
+ ClusterId: string | undefined;
5264
+ /**
5265
+ * <p>The ID of the terminated session.</p>
5266
+ * @public
5267
+ */
5268
+ SessionId: string | undefined;
5269
+ /**
5270
+ * <p>The state of the session after the terminate request has been accepted.</p>
5271
+ * @public
5272
+ */
5273
+ State: SessionState | undefined;
5274
+ }
4998
5275
  /**
4999
5276
  * @public
5000
5277
  */
@@ -5382,6 +5659,11 @@ export interface Cluster {
5382
5659
  * @public
5383
5660
  */
5384
5661
  MonitoringConfiguration?: MonitoringConfiguration | undefined;
5662
+ /**
5663
+ * <p>Indicates whether Spark Connect sessions are enabled on the cluster.</p>
5664
+ * @public
5665
+ */
5666
+ SessionEnabled?: boolean | undefined;
5385
5667
  }
5386
5668
  /**
5387
5669
  * <p>Configuration defining a new instance group.</p>
@@ -5624,6 +5906,158 @@ export interface InstanceTypeSpecification {
5624
5906
  */
5625
5907
  Priority?: number | undefined;
5626
5908
  }
5909
+ /**
5910
+ * <p>Detailed information about a Spark Connect session.</p>
5911
+ * @public
5912
+ */
5913
+ export interface Session {
5914
+ /**
5915
+ * <p>The ID of the session.</p>
5916
+ * @public
5917
+ */
5918
+ Id: string | undefined;
5919
+ /**
5920
+ * <p>The ID of the cluster that the session belongs to.</p>
5921
+ * @public
5922
+ */
5923
+ ClusterId: string | undefined;
5924
+ /**
5925
+ * <p>The name of the session, if one was provided at creation time.</p>
5926
+ * @public
5927
+ */
5928
+ Name?: string | undefined;
5929
+ /**
5930
+ * <p>The Amazon Resource Name (ARN) of the session.</p>
5931
+ * @public
5932
+ */
5933
+ Arn: string | undefined;
5934
+ /**
5935
+ * <p>The current state of the session. Valid values are <code>SUBMITTED</code>, <code>STARTING</code>, <code>STARTED</code>, <code>IDLE</code>, <code>BUSY</code>, <code>TERMINATING</code>, <code>TERMINATED</code>, and <code>FAILED</code>.</p>
5936
+ * @public
5937
+ */
5938
+ State: SessionState | undefined;
5939
+ /**
5940
+ * <p>A human-readable message describing the most recent state change.</p>
5941
+ * @public
5942
+ */
5943
+ StateChangeReason?: string | undefined;
5944
+ /**
5945
+ * <p>The Amazon EMR release label of the cluster that the session is running on.</p>
5946
+ * @public
5947
+ */
5948
+ ReleaseLabel?: string | undefined;
5949
+ /**
5950
+ * <p>The execution role ARN for the session. Amazon EMR uses this role to access Amazon Web Services resources on your behalf during session execution.</p>
5951
+ * @public
5952
+ */
5953
+ ExecutionRoleArn?: string | undefined;
5954
+ /**
5955
+ * <p>The Amazon Web Services account ID that owns the session.</p>
5956
+ * @public
5957
+ */
5958
+ AccountId?: string | undefined;
5959
+ /**
5960
+ * <p>The date and time that the session was created.</p>
5961
+ * @public
5962
+ */
5963
+ CreatedAt?: Date | undefined;
5964
+ /**
5965
+ * <p>The date and time that the session was last updated.</p>
5966
+ * @public
5967
+ */
5968
+ UpdatedAt?: Date | undefined;
5969
+ /**
5970
+ * <p>The date and time that the session entered the <code>STARTED</code> state.</p>
5971
+ * @public
5972
+ */
5973
+ StartedAt?: Date | undefined;
5974
+ /**
5975
+ * <p>The date and time that the session was terminated or failed.</p>
5976
+ * @public
5977
+ */
5978
+ EndedAt?: Date | undefined;
5979
+ /**
5980
+ * <p>The date and time that the session last entered the <code>IDLE</code> state.</p>
5981
+ * @public
5982
+ */
5983
+ IdleSince?: Date | undefined;
5984
+ /**
5985
+ * <p>The configuration overrides for the session. Only runtime configuration overrides are supported.</p>
5986
+ * @public
5987
+ */
5988
+ EngineConfigurations?: Configuration[] | undefined;
5989
+ /**
5990
+ * <p>The monitoring configuration for the session.</p>
5991
+ * @public
5992
+ */
5993
+ MonitoringConfiguration?: SessionMonitoringConfiguration | undefined;
5994
+ /**
5995
+ * <p>The idle timeout, in minutes. If the session is idle for this duration, Amazon EMR automatically terminates it.</p>
5996
+ * @public
5997
+ */
5998
+ SessionIdleTimeoutInMinutes?: number | undefined;
5999
+ /**
6000
+ * <p>The certificate authority used to establish an mTLS connection to the Spark Connect server when connecting directly over VPC peering.</p>
6001
+ * @public
6002
+ */
6003
+ CertificateAuthority?: CertificateAuthority | undefined;
6004
+ /**
6005
+ * <p>The Spark Connect server URL for the session. Use this URL with the <code>Credentials</code> returned by <code>GetSessionEndpoint</code> to connect directly to the session over VPC peering.</p>
6006
+ * @public
6007
+ */
6008
+ ServerUrl?: string | undefined;
6009
+ /**
6010
+ * <p>The tags associated with the session.</p>
6011
+ * @public
6012
+ */
6013
+ Tags?: Tag[] | undefined;
6014
+ }
6015
+ /**
6016
+ * <p>Input to the <code>StartSession</code> operation.</p>
6017
+ * @public
6018
+ */
6019
+ export interface StartSessionInput {
6020
+ /**
6021
+ * <p>An optional name for the session.</p>
6022
+ * @public
6023
+ */
6024
+ Name?: string | undefined;
6025
+ /**
6026
+ * <p>The ID of the cluster on which to start the session.</p>
6027
+ * @public
6028
+ */
6029
+ ClusterId: string | undefined;
6030
+ /**
6031
+ * <p>The execution role ARN for the session. Amazon EMR uses this role to access Amazon Web Services resources on your behalf during session execution.</p>
6032
+ * @public
6033
+ */
6034
+ ExecutionRoleArn?: string | undefined;
6035
+ /**
6036
+ * <p>The configuration overrides for the session. Only runtime configuration overrides are supported.</p>
6037
+ * @public
6038
+ */
6039
+ EngineConfigurations?: Configuration[] | undefined;
6040
+ /**
6041
+ * <p>The monitoring configuration that controls where session logs are published, such as Amazon S3, CloudWatch, or managed logging.</p>
6042
+ * @public
6043
+ */
6044
+ MonitoringConfiguration?: SessionMonitoringConfiguration | undefined;
6045
+ /**
6046
+ * <p>The idle timeout, in minutes. If the session is idle for this duration, Amazon EMR EC2 automatically terminates it.</p>
6047
+ * @public
6048
+ */
6049
+ SessionIdleTimeoutInMinutes?: number | undefined;
6050
+ /**
6051
+ * <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you retry a request that completed successfully using the same client request token, the service returns the original response without performing the operation again.</p>
6052
+ * @public
6053
+ */
6054
+ ClientRequestToken?: string | undefined;
6055
+ /**
6056
+ * <p>The tags to assign to the session.</p>
6057
+ * @public
6058
+ */
6059
+ Tags?: Tag[] | undefined;
6060
+ }
5627
6061
  /**
5628
6062
  * <p>This output contains the description of the cluster.</p>
5629
6063
  * @public
@@ -5669,6 +6103,17 @@ export interface GetBlockPublicAccessConfigurationOutput {
5669
6103
  */
5670
6104
  BlockPublicAccessConfigurationMetadata: BlockPublicAccessConfigurationMetadata | undefined;
5671
6105
  }
6106
+ /**
6107
+ * <p>Output of the <code>GetSession</code> operation.</p>
6108
+ * @public
6109
+ */
6110
+ export interface GetSessionOutput {
6111
+ /**
6112
+ * <p>The output displays information about the session.</p>
6113
+ * @public
6114
+ */
6115
+ Session: Session | undefined;
6116
+ }
5672
6117
  /**
5673
6118
  * @public
5674
6119
  */
@@ -5950,6 +6395,22 @@ export interface InstanceFleetModifyConfig {
5950
6395
  */
5951
6396
  Context?: string | undefined;
5952
6397
  }
6398
+ /**
6399
+ * <p>Output of the <code>ListSessions</code> operation.</p>
6400
+ * @public
6401
+ */
6402
+ export interface ListSessionsOutput {
6403
+ /**
6404
+ * <p>The sessions that match the request.</p>
6405
+ * @public
6406
+ */
6407
+ Sessions?: Session[] | undefined;
6408
+ /**
6409
+ * <p>The pagination token to use in a subsequent <code>ListSessions</code> call to retrieve the next page of results. This field is absent when there are no more results.</p>
6410
+ * @public
6411
+ */
6412
+ NextToken?: string | undefined;
6413
+ }
5953
6414
  /**
5954
6415
  * <p>Change the size of some instance groups.</p>
5955
6416
  * @public
@@ -6572,4 +7033,9 @@ export interface RunJobFlowInput {
6572
7033
  * @public
6573
7034
  */
6574
7035
  MonitoringConfiguration?: MonitoringConfiguration | undefined;
7036
+ /**
7037
+ * <p>Indicates whether Spark Connect sessions are enabled on the cluster. When set to <code>true</code>, you can start Spark Connect sessions using the <code>StartSession</code> operation.</p>
7038
+ * @public
7039
+ */
7040
+ SessionEnabled?: boolean | undefined;
6575
7041
  }
@@ -0,0 +1,7 @@
1
+ import type { Paginator } from "@smithy/types";
2
+ import { ListSessionsCommandInput, ListSessionsCommandOutput } from "../commands/ListSessionsCommand";
3
+ import type { EMRPaginationConfiguration } from "./Interfaces";
4
+ /**
5
+ * @public
6
+ */
7
+ export declare const paginateListSessions: (config: EMRPaginationConfiguration, input: ListSessionsCommandInput, ...rest: any[]) => Paginator<ListSessionsCommandOutput>;
@@ -7,6 +7,7 @@ export * from "./ListInstancesPaginator";
7
7
  export * from "./ListNotebookExecutionsPaginator";
8
8
  export * from "./ListReleaseLabelsPaginator";
9
9
  export * from "./ListSecurityConfigurationsPaginator";
10
+ export * from "./ListSessionsPaginator";
10
11
  export * from "./ListStepsPaginator";
11
12
  export * from "./ListStudiosPaginator";
12
13
  export * from "./ListStudioSessionMappingsPaginator";
@@ -31,6 +31,7 @@ export declare var BootstrapActionDetail$: StaticStructureSchema;
31
31
  export declare var CancelStepsInfo$: StaticStructureSchema;
32
32
  export declare var CancelStepsInput$: StaticStructureSchema;
33
33
  export declare var CancelStepsOutput$: StaticStructureSchema;
34
+ export declare var CertificateAuthority$: StaticStructureSchema;
34
35
  export declare var CloudWatchAlarmDefinition$: StaticStructureSchema;
35
36
  export declare var CloudWatchLogConfiguration$: StaticStructureSchema;
36
37
  export declare var Cluster$: StaticStructureSchema;
@@ -89,6 +90,10 @@ export declare var GetOnClusterAppUIPresignedURLInput$: StaticStructureSchema;
89
90
  export declare var GetOnClusterAppUIPresignedURLOutput$: StaticStructureSchema;
90
91
  export declare var GetPersistentAppUIPresignedURLInput$: StaticStructureSchema;
91
92
  export declare var GetPersistentAppUIPresignedURLOutput$: StaticStructureSchema;
93
+ export declare var GetSessionEndpointInput$: StaticStructureSchema;
94
+ export declare var GetSessionEndpointOutput$: StaticStructureSchema;
95
+ export declare var GetSessionInput$: StaticStructureSchema;
96
+ export declare var GetSessionOutput$: StaticStructureSchema;
92
97
  export declare var GetStudioSessionMappingInput$: StaticStructureSchema;
93
98
  export declare var GetStudioSessionMappingOutput$: StaticStructureSchema;
94
99
  export declare var HadoopJarStepConfig$: StaticStructureSchema;
@@ -137,6 +142,8 @@ export declare var ListReleaseLabelsInput$: StaticStructureSchema;
137
142
  export declare var ListReleaseLabelsOutput$: StaticStructureSchema;
138
143
  export declare var ListSecurityConfigurationsInput$: StaticStructureSchema;
139
144
  export declare var ListSecurityConfigurationsOutput$: StaticStructureSchema;
145
+ export declare var ListSessionsInput$: StaticStructureSchema;
146
+ export declare var ListSessionsOutput$: StaticStructureSchema;
140
147
  export declare var ListStepsInput$: StaticStructureSchema;
141
148
  export declare var ListStepsOutput$: StaticStructureSchema;
142
149
  export declare var ListStudioSessionMappingsInput$: StaticStructureSchema;
@@ -193,8 +200,13 @@ export declare var ScalingRule$: StaticStructureSchema;
193
200
  export declare var ScalingTrigger$: StaticStructureSchema;
194
201
  export declare var ScriptBootstrapActionConfig$: StaticStructureSchema;
195
202
  export declare var SecurityConfigurationSummary$: StaticStructureSchema;
203
+ export declare var Session$: StaticStructureSchema;
204
+ export declare var SessionCloudWatchLoggingConfiguration$: StaticStructureSchema;
205
+ export declare var SessionManagedLoggingConfiguration$: StaticStructureSchema;
196
206
  export declare var SessionMappingDetail$: StaticStructureSchema;
197
207
  export declare var SessionMappingSummary$: StaticStructureSchema;
208
+ export declare var SessionMonitoringConfiguration$: StaticStructureSchema;
209
+ export declare var SessionS3LoggingConfiguration$: StaticStructureSchema;
198
210
  export declare var SetKeepJobFlowAliveWhenNoStepsInput$: StaticStructureSchema;
199
211
  export declare var SetTerminationProtectionInput$: StaticStructureSchema;
200
212
  export declare var SetUnhealthyNodeReplacementInput$: StaticStructureSchema;
@@ -206,6 +218,8 @@ export declare var SpotProvisioningSpecification$: StaticStructureSchema;
206
218
  export declare var SpotResizingSpecification$: StaticStructureSchema;
207
219
  export declare var StartNotebookExecutionInput$: StaticStructureSchema;
208
220
  export declare var StartNotebookExecutionOutput$: StaticStructureSchema;
221
+ export declare var StartSessionInput$: StaticStructureSchema;
222
+ export declare var StartSessionOutput$: StaticStructureSchema;
209
223
  export declare var Step$: StaticStructureSchema;
210
224
  export declare var StepConfig$: StaticStructureSchema;
211
225
  export declare var StepDetail$: StaticStructureSchema;
@@ -222,6 +236,8 @@ export declare var SupportedInstanceType$: StaticStructureSchema;
222
236
  export declare var SupportedProductConfig$: StaticStructureSchema;
223
237
  export declare var Tag$: StaticStructureSchema;
224
238
  export declare var TerminateJobFlowsInput$: StaticStructureSchema;
239
+ export declare var TerminateSessionInput$: StaticStructureSchema;
240
+ export declare var TerminateSessionOutput$: StaticStructureSchema;
225
241
  export declare var UpdateStudioInput$: StaticStructureSchema;
226
242
  export declare var UpdateStudioSessionMappingInput$: StaticStructureSchema;
227
243
  export declare var UsernamePassword$: StaticStructureSchema;
@@ -253,6 +269,8 @@ export declare var GetClusterSessionCredentials$: StaticOperationSchema;
253
269
  export declare var GetManagedScalingPolicy$: StaticOperationSchema;
254
270
  export declare var GetOnClusterAppUIPresignedURL$: StaticOperationSchema;
255
271
  export declare var GetPersistentAppUIPresignedURL$: StaticOperationSchema;
272
+ export declare var GetSession$: StaticOperationSchema;
273
+ export declare var GetSessionEndpoint$: StaticOperationSchema;
256
274
  export declare var GetStudioSessionMapping$: StaticOperationSchema;
257
275
  export declare var ListBootstrapActions$: StaticOperationSchema;
258
276
  export declare var ListClusters$: StaticOperationSchema;
@@ -262,6 +280,7 @@ export declare var ListInstances$: StaticOperationSchema;
262
280
  export declare var ListNotebookExecutions$: StaticOperationSchema;
263
281
  export declare var ListReleaseLabels$: StaticOperationSchema;
264
282
  export declare var ListSecurityConfigurations$: StaticOperationSchema;
283
+ export declare var ListSessions$: StaticOperationSchema;
265
284
  export declare var ListSteps$: StaticOperationSchema;
266
285
  export declare var ListStudios$: StaticOperationSchema;
267
286
  export declare var ListStudioSessionMappings$: StaticOperationSchema;
@@ -283,7 +302,9 @@ export declare var SetTerminationProtection$: StaticOperationSchema;
283
302
  export declare var SetUnhealthyNodeReplacement$: StaticOperationSchema;
284
303
  export declare var SetVisibleToAllUsers$: StaticOperationSchema;
285
304
  export declare var StartNotebookExecution$: StaticOperationSchema;
305
+ export declare var StartSession$: StaticOperationSchema;
286
306
  export declare var StopNotebookExecution$: StaticOperationSchema;
287
307
  export declare var TerminateJobFlows$: StaticOperationSchema;
308
+ export declare var TerminateSession$: StaticOperationSchema;
288
309
  export declare var UpdateStudio$: StaticOperationSchema;
289
310
  export declare var UpdateStudioSessionMapping$: StaticOperationSchema;