@aws-sdk/client-emr-serverless 3.817.0 → 3.821.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.
package/README.md CHANGED
@@ -6,27 +6,7 @@
6
6
 
7
7
  AWS SDK for JavaScript EMRServerless Client for Node.js, Browser and React Native.
8
8
 
9
- <p>Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running
10
- analytics applications using the latest open source frameworks such as Apache Spark and
11
- Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize,
12
- secure, or operate clusters to run applications with these frameworks.</p>
13
- <p>The API reference to Amazon EMR Serverless is <code>emr-serverless</code>. The
14
- <code>emr-serverless</code> prefix is used in the following scenarios: </p>
15
- <ul>
16
- <li>
17
- <p>It is the prefix in the CLI commands for Amazon EMR Serverless. For
18
- example, <code>aws emr-serverless start-job-run</code>.</p>
19
- </li>
20
- <li>
21
- <p>It is the prefix before IAM policy actions for Amazon EMR Serverless. For
22
- example, <code>"Action": ["emr-serverless:StartJobRun"]</code>. For more information,
23
- see <a href="https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-actions">Policy actions for Amazon EMR Serverless</a>.</p>
24
- </li>
25
- <li>
26
- <p>It is the prefix used in Amazon EMR Serverless service endpoints. For
27
- example, <code>emr-serverless.us-east-2.amazonaws.com</code>.</p>
28
- </li>
29
- </ul>
9
+ <p>Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running analytics applications using the latest open source frameworks such as Apache Spark and Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize, secure, or operate clusters to run applications with these frameworks.</p> <p>The API reference to Amazon EMR Serverless is <code>emr-serverless</code>. The <code>emr-serverless</code> prefix is used in the following scenarios: </p> <ul> <li> <p>It is the prefix in the CLI commands for Amazon EMR Serverless. For example, <code>aws emr-serverless start-job-run</code>.</p> </li> <li> <p>It is the prefix before IAM policy actions for Amazon EMR Serverless. For example, <code>"Action": ["emr-serverless:StartJobRun"]</code>. For more information, see <a href="https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-actions">Policy actions for Amazon EMR Serverless</a>.</p> </li> <li> <p>It is the prefix used in Amazon EMR Serverless service endpoints. For example, <code>emr-serverless.us-east-2.amazonaws.com</code>.</p> </li> </ul>
30
10
 
31
11
  ## Installing
32
12
 
package/dist-cjs/index.js CHANGED
@@ -604,6 +604,7 @@ var se_StartJobRunCommand = /* @__PURE__ */ __name(async (input, context) => {
604
604
  (0, import_smithy_client.take)(input, {
605
605
  clientToken: [true, (_) => _ ?? (0, import_uuid.v4)()],
606
606
  configurationOverrides: /* @__PURE__ */ __name((_) => se_ConfigurationOverrides(_, context), "configurationOverrides"),
607
+ executionIamPolicy: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "executionIamPolicy"),
607
608
  executionRoleArn: [],
608
609
  executionTimeoutMinutes: [],
609
610
  jobDriver: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "jobDriver"),
@@ -161,6 +161,7 @@ export const se_StartJobRunCommand = async (input, context) => {
161
161
  body = JSON.stringify(take(input, {
162
162
  clientToken: [true, (_) => _ ?? generateIdempotencyToken()],
163
163
  configurationOverrides: (_) => se_ConfigurationOverrides(_, context),
164
+ executionIamPolicy: (_) => _json(_),
164
165
  executionRoleArn: [],
165
166
  executionTimeoutMinutes: [],
166
167
  jobDriver: (_) => _json(_),
@@ -116,27 +116,7 @@ export interface EMRServerless {
116
116
  updateApplication(args: UpdateApplicationCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateApplicationCommandOutput) => void): void;
117
117
  }
118
118
  /**
119
- * <p>Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running
120
- * analytics applications using the latest open source frameworks such as Apache Spark and
121
- * Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize,
122
- * secure, or operate clusters to run applications with these frameworks.</p>
123
- * <p>The API reference to Amazon EMR Serverless is <code>emr-serverless</code>. The
124
- * <code>emr-serverless</code> prefix is used in the following scenarios: </p>
125
- * <ul>
126
- * <li>
127
- * <p>It is the prefix in the CLI commands for Amazon EMR Serverless. For
128
- * example, <code>aws emr-serverless start-job-run</code>.</p>
129
- * </li>
130
- * <li>
131
- * <p>It is the prefix before IAM policy actions for Amazon EMR Serverless. For
132
- * example, <code>"Action": ["emr-serverless:StartJobRun"]</code>. For more information,
133
- * see <a href="https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-actions">Policy actions for Amazon EMR Serverless</a>.</p>
134
- * </li>
135
- * <li>
136
- * <p>It is the prefix used in Amazon EMR Serverless service endpoints. For
137
- * example, <code>emr-serverless.us-east-2.amazonaws.com</code>.</p>
138
- * </li>
139
- * </ul>
119
+ * <p>Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running analytics applications using the latest open source frameworks such as Apache Spark and Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize, secure, or operate clusters to run applications with these frameworks.</p> <p>The API reference to Amazon EMR Serverless is <code>emr-serverless</code>. The <code>emr-serverless</code> prefix is used in the following scenarios: </p> <ul> <li> <p>It is the prefix in the CLI commands for Amazon EMR Serverless. For example, <code>aws emr-serverless start-job-run</code>.</p> </li> <li> <p>It is the prefix before IAM policy actions for Amazon EMR Serverless. For example, <code>"Action": ["emr-serverless:StartJobRun"]</code>. For more information, see <a href="https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-actions">Policy actions for Amazon EMR Serverless</a>.</p> </li> <li> <p>It is the prefix used in Amazon EMR Serverless service endpoints. For example, <code>emr-serverless.us-east-2.amazonaws.com</code>.</p> </li> </ul>
140
120
  * @public
141
121
  */
142
122
  export declare class EMRServerless extends EMRServerlessClient implements EMRServerless {
@@ -185,27 +185,7 @@ export type EMRServerlessClientResolvedConfigType = __SmithyResolvedConfiguratio
185
185
  export interface EMRServerlessClientResolvedConfig extends EMRServerlessClientResolvedConfigType {
186
186
  }
187
187
  /**
188
- * <p>Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running
189
- * analytics applications using the latest open source frameworks such as Apache Spark and
190
- * Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize,
191
- * secure, or operate clusters to run applications with these frameworks.</p>
192
- * <p>The API reference to Amazon EMR Serverless is <code>emr-serverless</code>. The
193
- * <code>emr-serverless</code> prefix is used in the following scenarios: </p>
194
- * <ul>
195
- * <li>
196
- * <p>It is the prefix in the CLI commands for Amazon EMR Serverless. For
197
- * example, <code>aws emr-serverless start-job-run</code>.</p>
198
- * </li>
199
- * <li>
200
- * <p>It is the prefix before IAM policy actions for Amazon EMR Serverless. For
201
- * example, <code>"Action": ["emr-serverless:StartJobRun"]</code>. For more information,
202
- * see <a href="https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-actions">Policy actions for Amazon EMR Serverless</a>.</p>
203
- * </li>
204
- * <li>
205
- * <p>It is the prefix used in Amazon EMR Serverless service endpoints. For
206
- * example, <code>emr-serverless.us-east-2.amazonaws.com</code>.</p>
207
- * </li>
208
- * </ul>
188
+ * <p>Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running analytics applications using the latest open source frameworks such as Apache Spark and Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize, secure, or operate clusters to run applications with these frameworks.</p> <p>The API reference to Amazon EMR Serverless is <code>emr-serverless</code>. The <code>emr-serverless</code> prefix is used in the following scenarios: </p> <ul> <li> <p>It is the prefix in the CLI commands for Amazon EMR Serverless. For example, <code>aws emr-serverless start-job-run</code>.</p> </li> <li> <p>It is the prefix before IAM policy actions for Amazon EMR Serverless. For example, <code>"Action": ["emr-serverless:StartJobRun"]</code>. For more information, see <a href="https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-actions">Policy actions for Amazon EMR Serverless</a>.</p> </li> <li> <p>It is the prefix used in Amazon EMR Serverless service endpoints. For example, <code>emr-serverless.us-east-2.amazonaws.com</code>.</p> </li> </ul>
209
189
  * @public
210
190
  */
211
191
  export declare class EMRServerlessClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, EMRServerlessClientResolvedConfig> {
@@ -60,8 +60,7 @@ declare const CancelJobRunCommand_base: {
60
60
  * <p>The specified resource was not found.</p>
61
61
  *
62
62
  * @throws {@link ValidationException} (client fault)
63
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
64
- * service.</p>
63
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
65
64
  *
66
65
  * @throws {@link EMRServerlessServiceException}
67
66
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -151,8 +151,7 @@ declare const CreateApplicationCommand_base: {
151
151
  * @see {@link EMRServerlessClientResolvedConfig | config} for EMRServerlessClient's `config` shape.
152
152
  *
153
153
  * @throws {@link ConflictException} (client fault)
154
- * <p>The request could not be processed because of conflict in the current state of the
155
- * resource.</p>
154
+ * <p>The request could not be processed because of conflict in the current state of the resource.</p>
156
155
  *
157
156
  * @throws {@link InternalServerException} (server fault)
158
157
  * <p>Request processing failed because of an error or failure with the service.</p>
@@ -161,8 +160,7 @@ declare const CreateApplicationCommand_base: {
161
160
  * <p>The specified resource was not found.</p>
162
161
  *
163
162
  * @throws {@link ValidationException} (client fault)
164
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
165
- * service.</p>
163
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
166
164
  *
167
165
  * @throws {@link EMRServerlessServiceException}
168
166
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -27,8 +27,7 @@ declare const DeleteApplicationCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Deletes an application. An application has to be in a stopped or created state in order
31
- * to be deleted.</p>
30
+ * <p>Deletes an application. An application has to be in a stopped or created state in order to be deleted.</p>
32
31
  * @example
33
32
  * Use a bare-bones client and the command you need to make an API call.
34
33
  * ```javascript
@@ -57,8 +56,7 @@ declare const DeleteApplicationCommand_base: {
57
56
  * <p>The specified resource was not found.</p>
58
57
  *
59
58
  * @throws {@link ValidationException} (client fault)
60
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
61
- * service.</p>
59
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
62
60
  *
63
61
  * @throws {@link EMRServerlessServiceException}
64
62
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -164,8 +164,7 @@ declare const GetApplicationCommand_base: {
164
164
  * <p>The specified resource was not found.</p>
165
165
  *
166
166
  * @throws {@link ValidationException} (client fault)
167
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
168
- * service.</p>
167
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
169
168
  *
170
169
  * @throws {@link EMRServerlessServiceException}
171
170
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -27,15 +27,7 @@ declare const GetDashboardForJobRunCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Creates and returns a URL that you can use to access the application UIs for a job
31
- * run.</p>
32
- * <p>For jobs in a running state, the application UI is a live user interface such as the
33
- * Spark or Tez web UI. For completed jobs, the application UI is a persistent application
34
- * user interface such as the Spark History Server or persistent Tez UI.</p>
35
- * <note>
36
- * <p>The URL is valid for one hour after you generate it. To access the application UI
37
- * after that hour elapses, you must invoke the API again to generate a new URL.</p>
38
- * </note>
30
+ * <p>Creates and returns a URL that you can use to access the application UIs for a job run.</p> <p>For jobs in a running state, the application UI is a live user interface such as the Spark or Tez web UI. For completed jobs, the application UI is a persistent application user interface such as the Spark History Server or persistent Tez UI.</p> <note> <p>The URL is valid for one hour after you generate it. To access the application UI after that hour elapses, you must invoke the API again to generate a new URL.</p> </note>
39
31
  * @example
40
32
  * Use a bare-bones client and the command you need to make an API call.
41
33
  * ```javascript
@@ -69,8 +61,7 @@ declare const GetDashboardForJobRunCommand_base: {
69
61
  * <p>The specified resource was not found.</p>
70
62
  *
71
63
  * @throws {@link ValidationException} (client fault)
72
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
73
- * service.</p>
64
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
74
65
  *
75
66
  * @throws {@link EMRServerlessServiceException}
76
67
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -163,8 +163,7 @@ declare const GetJobRunCommand_base: {
163
163
  * <p>The specified resource was not found.</p>
164
164
  *
165
165
  * @throws {@link ValidationException} (client fault)
166
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
167
- * service.</p>
166
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
168
167
  *
169
168
  * @throws {@link EMRServerlessServiceException}
170
169
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -73,8 +73,7 @@ declare const ListApplicationsCommand_base: {
73
73
  * <p>Request processing failed because of an error or failure with the service.</p>
74
74
  *
75
75
  * @throws {@link ValidationException} (client fault)
76
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
77
- * service.</p>
76
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
78
77
  *
79
78
  * @throws {@link EMRServerlessServiceException}
80
79
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -80,8 +80,7 @@ declare const ListJobRunAttemptsCommand_base: {
80
80
  * <p>The specified resource was not found.</p>
81
81
  *
82
82
  * @throws {@link ValidationException} (client fault)
83
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
84
- * service.</p>
83
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
85
84
  *
86
85
  * @throws {@link EMRServerlessServiceException}
87
86
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -83,8 +83,7 @@ declare const ListJobRunsCommand_base: {
83
83
  * <p>Request processing failed because of an error or failure with the service.</p>
84
84
  *
85
85
  * @throws {@link ValidationException} (client fault)
86
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
87
- * service.</p>
86
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
88
87
  *
89
88
  * @throws {@link EMRServerlessServiceException}
90
89
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -60,8 +60,7 @@ declare const ListTagsForResourceCommand_base: {
60
60
  * <p>The specified resource was not found.</p>
61
61
  *
62
62
  * @throws {@link ValidationException} (client fault)
63
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
64
- * service.</p>
63
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
65
64
  *
66
65
  * @throws {@link EMRServerlessServiceException}
67
66
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -59,8 +59,7 @@ declare const StartApplicationCommand_base: {
59
59
  * <p>The maximum number of resources per account has been reached.</p>
60
60
  *
61
61
  * @throws {@link ValidationException} (client fault)
62
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
63
- * service.</p>
62
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
64
63
  *
65
64
  * @throws {@link EMRServerlessServiceException}
66
65
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -38,6 +38,12 @@ declare const StartJobRunCommand_base: {
38
38
  * applicationId: "STRING_VALUE", // required
39
39
  * clientToken: "STRING_VALUE", // required
40
40
  * executionRoleArn: "STRING_VALUE", // required
41
+ * executionIamPolicy: { // JobRunExecutionIamPolicy
42
+ * policy: "STRING_VALUE",
43
+ * policyArns: [ // PolicyArnList
44
+ * "STRING_VALUE",
45
+ * ],
46
+ * },
41
47
  * jobDriver: { // JobDriver Union: only one key present
42
48
  * sparkSubmit: { // SparkSubmit
43
49
  * entryPoint: "STRING_VALUE", // required
@@ -123,8 +129,7 @@ declare const StartJobRunCommand_base: {
123
129
  * @see {@link EMRServerlessClientResolvedConfig | config} for EMRServerlessClient's `config` shape.
124
130
  *
125
131
  * @throws {@link ConflictException} (client fault)
126
- * <p>The request could not be processed because of conflict in the current state of the
127
- * resource.</p>
132
+ * <p>The request could not be processed because of conflict in the current state of the resource.</p>
128
133
  *
129
134
  * @throws {@link InternalServerException} (server fault)
130
135
  * <p>Request processing failed because of an error or failure with the service.</p>
@@ -133,8 +138,7 @@ declare const StartJobRunCommand_base: {
133
138
  * <p>The specified resource was not found.</p>
134
139
  *
135
140
  * @throws {@link ValidationException} (client fault)
136
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
137
- * service.</p>
141
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
138
142
  *
139
143
  * @throws {@link EMRServerlessServiceException}
140
144
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -27,8 +27,7 @@ declare const StopApplicationCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Stops a specified application and releases initial capacity if configured. All scheduled
31
- * and running jobs must be completed or cancelled before stopping an application.</p>
30
+ * <p>Stops a specified application and releases initial capacity if configured. All scheduled and running jobs must be completed or cancelled before stopping an application.</p>
32
31
  * @example
33
32
  * Use a bare-bones client and the command you need to make an API call.
34
33
  * ```javascript
@@ -57,8 +56,7 @@ declare const StopApplicationCommand_base: {
57
56
  * <p>The specified resource was not found.</p>
58
57
  *
59
58
  * @throws {@link ValidationException} (client fault)
60
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
61
- * service.</p>
59
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
62
60
  *
63
61
  * @throws {@link EMRServerlessServiceException}
64
62
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -27,11 +27,7 @@ declare const TagResourceCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Assigns tags to resources. A tag is a label that you assign to an Amazon Web Services
31
- * resource. Each tag consists of a key and an optional value, both of which you define. Tags
32
- * enable you to categorize your Amazon Web Services resources by attributes such as purpose,
33
- * owner, or environment. When you have many resources of the same type, you can quickly
34
- * identify a specific resource based on the tags you've assigned to it. </p>
30
+ * <p>Assigns tags to resources. A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value, both of which you define. Tags enable you to categorize your Amazon Web Services resources by attributes such as purpose, owner, or environment. When you have many resources of the same type, you can quickly identify a specific resource based on the tags you've assigned to it. </p>
35
31
  * @example
36
32
  * Use a bare-bones client and the command you need to make an API call.
37
33
  * ```javascript
@@ -63,8 +59,7 @@ declare const TagResourceCommand_base: {
63
59
  * <p>The specified resource was not found.</p>
64
60
  *
65
61
  * @throws {@link ValidationException} (client fault)
66
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
67
- * service.</p>
62
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
68
63
  *
69
64
  * @throws {@link EMRServerlessServiceException}
70
65
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -59,8 +59,7 @@ declare const UntagResourceCommand_base: {
59
59
  * <p>The specified resource was not found.</p>
60
60
  *
61
61
  * @throws {@link ValidationException} (client fault)
62
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
63
- * service.</p>
62
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
64
63
  *
65
64
  * @throws {@link EMRServerlessServiceException}
66
65
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -27,8 +27,7 @@ declare const UpdateApplicationCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Updates a specified application. An application has to be in a stopped or created state
31
- * in order to be updated.</p>
30
+ * <p>Updates a specified application. An application has to be in a stopped or created state in order to be updated.</p>
32
31
  * @example
33
32
  * Use a bare-bones client and the command you need to make an API call.
34
33
  * ```javascript
@@ -258,8 +257,7 @@ declare const UpdateApplicationCommand_base: {
258
257
  * <p>The specified resource was not found.</p>
259
258
  *
260
259
  * @throws {@link ValidationException} (client fault)
261
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
262
- * service.</p>
260
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
263
261
  *
264
262
  * @throws {@link EMRServerlessServiceException}
265
263
  * <p>Base exception class for all service exceptions from EMRServerless service.</p>
@@ -1,25 +1,5 @@
1
1
  /**
2
- * <p>Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running
3
- * analytics applications using the latest open source frameworks such as Apache Spark and
4
- * Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize,
5
- * secure, or operate clusters to run applications with these frameworks.</p>
6
- * <p>The API reference to Amazon EMR Serverless is <code>emr-serverless</code>. The
7
- * <code>emr-serverless</code> prefix is used in the following scenarios: </p>
8
- * <ul>
9
- * <li>
10
- * <p>It is the prefix in the CLI commands for Amazon EMR Serverless. For
11
- * example, <code>aws emr-serverless start-job-run</code>.</p>
12
- * </li>
13
- * <li>
14
- * <p>It is the prefix before IAM policy actions for Amazon EMR Serverless. For
15
- * example, <code>"Action": ["emr-serverless:StartJobRun"]</code>. For more information,
16
- * see <a href="https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-actions">Policy actions for Amazon EMR Serverless</a>.</p>
17
- * </li>
18
- * <li>
19
- * <p>It is the prefix used in Amazon EMR Serverless service endpoints. For
20
- * example, <code>emr-serverless.us-east-2.amazonaws.com</code>.</p>
21
- * </li>
22
- * </ul>
2
+ * <p>Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running analytics applications using the latest open source frameworks such as Apache Spark and Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize, secure, or operate clusters to run applications with these frameworks.</p> <p>The API reference to Amazon EMR Serverless is <code>emr-serverless</code>. The <code>emr-serverless</code> prefix is used in the following scenarios: </p> <ul> <li> <p>It is the prefix in the CLI commands for Amazon EMR Serverless. For example, <code>aws emr-serverless start-job-run</code>.</p> </li> <li> <p>It is the prefix before IAM policy actions for Amazon EMR Serverless. For example, <code>"Action": ["emr-serverless:StartJobRun"]</code>. For more information, see <a href="https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-actions">Policy actions for Amazon EMR Serverless</a>.</p> </li> <li> <p>It is the prefix used in Amazon EMR Serverless service endpoints. For example, <code>emr-serverless.us-east-2.amazonaws.com</code>.</p> </li> </ul>
23
3
  *
24
4
  * @packageDocumentation
25
5
  */
@@ -18,27 +18,23 @@ export type Architecture = (typeof Architecture)[keyof typeof Architecture];
18
18
  */
19
19
  export interface AutoStartConfig {
20
20
  /**
21
- * <p>Enables the application to automatically start on job submission. Defaults to
22
- * true.</p>
21
+ * <p>Enables the application to automatically start on job submission. Defaults to true.</p>
23
22
  * @public
24
23
  */
25
24
  enabled?: boolean | undefined;
26
25
  }
27
26
  /**
28
- * <p>The configuration for an application to automatically stop after a certain amount of
29
- * time being idle.</p>
27
+ * <p>The configuration for an application to automatically stop after a certain amount of time being idle.</p>
30
28
  * @public
31
29
  */
32
30
  export interface AutoStopConfig {
33
31
  /**
34
- * <p>Enables the application to automatically stop after a certain amount of time being idle.
35
- * Defaults to true.</p>
32
+ * <p>Enables the application to automatically stop after a certain amount of time being idle. Defaults to true.</p>
36
33
  * @public
37
34
  */
38
35
  enabled?: boolean | undefined;
39
36
  /**
40
- * <p>The amount of idle time in minutes after which your application will automatically stop.
41
- * Defaults to 15 minutes.</p>
37
+ * <p>The amount of idle time in minutes after which your application will automatically stop. Defaults to 15 minutes.</p>
42
38
  * @public
43
39
  */
44
40
  idleTimeoutMinutes?: number | undefined;
@@ -54,15 +50,13 @@ export interface ImageConfiguration {
54
50
  */
55
51
  imageUri: string | undefined;
56
52
  /**
57
- * <p>The SHA256 digest of the image URI. This indicates which specific image the application
58
- * is configured for. The image digest doesn't exist until an application has started.</p>
53
+ * <p>The SHA256 digest of the image URI. This indicates which specific image the application is configured for. The image digest doesn't exist until an application has started.</p>
59
54
  * @public
60
55
  */
61
56
  resolvedImageDigest?: string | undefined;
62
57
  }
63
58
  /**
64
- * <p>The cumulative configuration requirements for every worker instance of the worker
65
- * type.</p>
59
+ * <p>The cumulative configuration requirements for every worker instance of the worker type.</p>
66
60
  * @public
67
61
  */
68
62
  export interface WorkerResourceConfig {
@@ -82,8 +76,7 @@ export interface WorkerResourceConfig {
82
76
  */
83
77
  disk?: string | undefined;
84
78
  /**
85
- * <p>The disk type for every worker instance of the work type. Shuffle optimized disks have higher performance
86
- * characteristics and are better for shuffle heavy workloads. Default is <code>STANDARD</code>.</p>
79
+ * <p>The disk type for every worker instance of the work type. Shuffle optimized disks have higher performance characteristics and are better for shuffle heavy workloads. Default is <code>STANDARD</code>.</p>
87
80
  * @public
88
81
  */
89
82
  diskType?: string | undefined;
@@ -142,8 +135,7 @@ export interface MaximumAllowedResources {
142
135
  disk?: string | undefined;
143
136
  }
144
137
  /**
145
- * <p>The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs
146
- * to send log information to CloudWatch.</p>
138
+ * <p>The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs to send log information to CloudWatch.</p>
147
139
  * @public
148
140
  */
149
141
  export interface CloudWatchLoggingConfiguration {
@@ -153,8 +145,7 @@ export interface CloudWatchLoggingConfiguration {
153
145
  */
154
146
  enabled: boolean | undefined;
155
147
  /**
156
- * <p>The name of the log group in Amazon CloudWatch Logs where you want to publish your
157
- * logs.</p>
148
+ * <p>The name of the log group in Amazon CloudWatch Logs where you want to publish your logs.</p>
158
149
  * @public
159
150
  */
160
151
  logGroupName?: string | undefined;
@@ -169,27 +160,7 @@ export interface CloudWatchLoggingConfiguration {
169
160
  */
170
161
  encryptionKeyArn?: string | undefined;
171
162
  /**
172
- * <p>The types of logs that you want to publish to CloudWatch. If you don't specify
173
- * any log types, driver STDOUT and STDERR logs will be published to CloudWatch Logs by
174
- * default. For more information including the supported worker types for Hive and Spark, see
175
- * <a href="https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/logging.html#jobs-log-storage-cw">Logging for
176
- * EMR Serverless with CloudWatch</a>.</p>
177
- * <ul>
178
- * <li>
179
- * <p>
180
- * <b>Key Valid Values</b>: <code>SPARK_DRIVER</code>,
181
- * <code>SPARK_EXECUTOR</code>, <code>HIVE_DRIVER</code>,
182
- * <code>TEZ_TASK</code>
183
- * </p>
184
- * </li>
185
- * <li>
186
- * <p>
187
- * <b>Array Members Valid Values</b>: <code>STDOUT</code>,
188
- * <code>STDERR</code>, <code>HIVE_LOG</code>, <code>TEZ_AM</code>,
189
- * <code>SYSTEM_LOGS</code>
190
- * </p>
191
- * </li>
192
- * </ul>
163
+ * <p>The types of logs that you want to publish to CloudWatch. If you don't specify any log types, driver STDOUT and STDERR logs will be published to CloudWatch Logs by default. For more information including the supported worker types for Hive and Spark, see <a href="https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/logging.html#jobs-log-storage-cw">Logging for EMR Serverless with CloudWatch</a>.</p> <ul> <li> <p> <b>Key Valid Values</b>: <code>SPARK_DRIVER</code>, <code>SPARK_EXECUTOR</code>, <code>HIVE_DRIVER</code>, <code>TEZ_TASK</code> </p> </li> <li> <p> <b>Array Members Valid Values</b>: <code>STDOUT</code>, <code>STDERR</code>, <code>HIVE_LOG</code>, <code>TEZ_AM</code>, <code>SYSTEM_LOGS</code> </p> </li> </ul>
193
164
  * @public
194
165
  */
195
166
  logTypes?: Record<string, string[]> | undefined;
@@ -200,8 +171,7 @@ export interface CloudWatchLoggingConfiguration {
200
171
  */
201
172
  export interface ManagedPersistenceMonitoringConfiguration {
202
173
  /**
203
- * <p>Enables managed logging and defaults to true. If set to false, managed logging will be
204
- * turned off.</p>
174
+ * <p>Enables managed logging and defaults to true. If set to false, managed logging will be turned off.</p>
205
175
  * @public
206
176
  */
207
177
  enabled?: boolean | undefined;
@@ -223,8 +193,7 @@ export interface PrometheusMonitoringConfiguration {
223
193
  remoteWriteUrl?: string | undefined;
224
194
  }
225
195
  /**
226
- * <p>The Amazon S3 configuration for monitoring log publishing. You can configure your jobs
227
- * to send log information to Amazon S3.</p>
196
+ * <p>The Amazon S3 configuration for monitoring log publishing. You can configure your jobs to send log information to Amazon S3.</p>
228
197
  * @public
229
198
  */
230
199
  export interface S3MonitoringConfiguration {
@@ -255,8 +224,7 @@ export interface MonitoringConfiguration {
255
224
  */
256
225
  managedPersistenceMonitoringConfiguration?: ManagedPersistenceMonitoringConfiguration | undefined;
257
226
  /**
258
- * <p>The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs
259
- * to send log information to CloudWatch.</p>
227
+ * <p>The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs to send log information to CloudWatch.</p>
260
228
  * @public
261
229
  */
262
230
  cloudWatchLoggingConfiguration?: CloudWatchLoggingConfiguration | undefined;
@@ -383,8 +351,7 @@ export interface ApplicationSummary {
383
351
  architecture?: Architecture | undefined;
384
352
  }
385
353
  /**
386
- * <p>The request could not be processed because of conflict in the current state of the
387
- * resource.</p>
354
+ * <p>The request could not be processed because of conflict in the current state of the resource.</p>
388
355
  * @public
389
356
  */
390
357
  export declare class ConflictException extends __BaseException {
@@ -401,9 +368,7 @@ export declare class ConflictException extends __BaseException {
401
368
  */
402
369
  export interface ImageConfigurationInput {
403
370
  /**
404
- * <p>The URI of an image in the Amazon ECR registry. This field is required when you create a
405
- * new application. If you leave this field blank in an update, Amazon EMR will remove
406
- * the image configuration.</p>
371
+ * <p>The URI of an image in the Amazon ECR registry. This field is required when you create a new application. If you leave this field blank in an update, Amazon EMR will remove the image configuration.</p>
407
372
  * @public
408
373
  */
409
374
  imageUri?: string | undefined;
@@ -464,8 +429,7 @@ export declare class ResourceNotFoundException extends __BaseException {
464
429
  constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
465
430
  }
466
431
  /**
467
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
468
- * service.</p>
432
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
469
433
  * @public
470
434
  */
471
435
  export declare class ValidationException extends __BaseException {
@@ -516,8 +480,7 @@ export interface ListApplicationsRequest {
516
480
  */
517
481
  maxResults?: number | undefined;
518
482
  /**
519
- * <p>An optional filter for application states. Note that if this filter contains multiple
520
- * states, the resulting list will be grouped by the state.</p>
483
+ * <p>An optional filter for application states. Note that if this filter contains multiple states, the resulting list will be grouped by the state.</p>
521
484
  * @public
522
485
  */
523
486
  states?: ApplicationState[] | undefined;
@@ -532,8 +495,7 @@ export interface ListApplicationsResponse {
532
495
  */
533
496
  applications: ApplicationSummary[] | undefined;
534
497
  /**
535
- * <p>The output displays the token for the next set of application results. This is required
536
- * for pagination and is available as a response of the previous request.</p>
498
+ * <p>The output displays the token for the next set of application results. This is required for pagination and is available as a response of the previous request.</p>
537
499
  * @public
538
500
  */
539
501
  nextToken?: string | undefined;
@@ -625,8 +587,7 @@ export interface GetDashboardForJobRunRequest {
625
587
  */
626
588
  jobRunId: string | undefined;
627
589
  /**
628
- * <p>An optimal parameter that indicates the amount of attempts for the job. If not specified,
629
- * this value defaults to the attempt of the latest job.</p>
590
+ * <p>An optimal parameter that indicates the amount of attempts for the job. If not specified, this value defaults to the attempt of the latest job.</p>
630
591
  * @public
631
592
  */
632
593
  attempt?: number | undefined;
@@ -661,8 +622,7 @@ export interface GetJobRunRequest {
661
622
  */
662
623
  jobRunId: string | undefined;
663
624
  /**
664
- * <p>An optimal parameter that indicates the amount of attempts for the job. If not specified,
665
- * this value defaults to the attempt of the latest job.</p>
625
+ * <p>An optimal parameter that indicates the amount of attempts for the job. If not specified, this value defaults to the attempt of the latest job.</p>
666
626
  * @public
667
627
  */
668
628
  attempt?: number | undefined;
@@ -673,20 +633,17 @@ export interface GetJobRunRequest {
673
633
  */
674
634
  export interface ResourceUtilization {
675
635
  /**
676
- * <p>The aggregated vCPU used per hour from the time the job starts executing until the job
677
- * is terminated.</p>
636
+ * <p>The aggregated vCPU used per hour from the time the job starts executing until the job is terminated.</p>
678
637
  * @public
679
638
  */
680
639
  vCPUHour?: number | undefined;
681
640
  /**
682
- * <p>The aggregated memory used per hour from the time the job starts executing until the job
683
- * is terminated.</p>
641
+ * <p>The aggregated memory used per hour from the time the job starts executing until the job is terminated.</p>
684
642
  * @public
685
643
  */
686
644
  memoryGBHour?: number | undefined;
687
645
  /**
688
- * <p>The aggregated storage used per hour from the time the job starts executing until the
689
- * job is terminated.</p>
646
+ * <p>The aggregated storage used per hour from the time the job starts executing until the job is terminated.</p>
690
647
  * @public
691
648
  */
692
649
  storageGBHour?: number | undefined;
@@ -823,26 +780,22 @@ export declare const JobRunState: {
823
780
  */
824
781
  export type JobRunState = (typeof JobRunState)[keyof typeof JobRunState];
825
782
  /**
826
- * <p>The aggregate vCPU, memory, and storage resources used from the time job start executing
827
- * till the time job is terminated, rounded up to the nearest second.</p>
783
+ * <p>The aggregate vCPU, memory, and storage resources used from the time job start executing till the time job is terminated, rounded up to the nearest second.</p>
828
784
  * @public
829
785
  */
830
786
  export interface TotalResourceUtilization {
831
787
  /**
832
- * <p>The aggregated vCPU used per hour from the time job start executing till the time job is
833
- * terminated.</p>
788
+ * <p>The aggregated vCPU used per hour from the time job start executing till the time job is terminated.</p>
834
789
  * @public
835
790
  */
836
791
  vCPUHour?: number | undefined;
837
792
  /**
838
- * <p>The aggregated memory used per hour from the time job start executing till the time job
839
- * is terminated.</p>
793
+ * <p>The aggregated memory used per hour from the time job start executing till the time job is terminated.</p>
840
794
  * @public
841
795
  */
842
796
  memoryGBHour?: number | undefined;
843
797
  /**
844
- * <p>The aggregated storage used per hour from the time job start executing till the time job
845
- * is terminated.</p>
798
+ * <p>The aggregated storage used per hour from the time job start executing till the time job is terminated.</p>
846
799
  * @public
847
800
  */
848
801
  storageGBHour?: number | undefined;
@@ -963,8 +916,7 @@ export interface ListJobRunAttemptsResponse {
963
916
  */
964
917
  jobRunAttempts: JobRunAttemptSummary[] | undefined;
965
918
  /**
966
- * <p>The output displays the token for the next set of application results.
967
- * This is required for pagination and is available as a response of the previous request.</p>
919
+ * <p>The output displays the token for the next set of application results. This is required for pagination and is available as a response of the previous request.</p>
968
920
  * @public
969
921
  */
970
922
  nextToken?: string | undefined;
@@ -999,8 +951,7 @@ export interface ListJobRunsRequest {
999
951
  */
1000
952
  createdAtBefore?: Date | undefined;
1001
953
  /**
1002
- * <p>An optional filter for job run states. Note that if this filter contains multiple
1003
- * states, the resulting list will be grouped by the state.</p>
954
+ * <p>An optional filter for job run states. Note that if this filter contains multiple states, the resulting list will be grouped by the state.</p>
1004
955
  * @public
1005
956
  */
1006
957
  states?: JobRunState[] | undefined;
@@ -1071,8 +1022,7 @@ export interface JobRunSummary {
1071
1022
  */
1072
1023
  stateDetails: string | undefined;
1073
1024
  /**
1074
- * <p>The Amazon EMR release associated with the application your job is running
1075
- * on.</p>
1025
+ * <p>The Amazon EMR release associated with the application your job is running on.</p>
1076
1026
  * @public
1077
1027
  */
1078
1028
  releaseLabel: string | undefined;
@@ -1107,12 +1057,27 @@ export interface ListJobRunsResponse {
1107
1057
  */
1108
1058
  jobRuns: JobRunSummary[] | undefined;
1109
1059
  /**
1110
- * <p>The output displays the token for the next set of job run results. This is required for
1111
- * pagination and is available as a response of the previous request.</p>
1060
+ * <p>The output displays the token for the next set of job run results. This is required for pagination and is available as a response of the previous request.</p>
1112
1061
  * @public
1113
1062
  */
1114
1063
  nextToken?: string | undefined;
1115
1064
  }
1065
+ /**
1066
+ * <p>Optional IAM policy. The resulting job IAM role permissions will be an intersection of the policies passed and the policy associated with your job execution role.</p>
1067
+ * @public
1068
+ */
1069
+ export interface JobRunExecutionIamPolicy {
1070
+ /**
1071
+ * <p>An IAM inline policy to use as an execution IAM policy.</p>
1072
+ * @public
1073
+ */
1074
+ policy?: string | undefined;
1075
+ /**
1076
+ * <p>A list of Amazon Resource Names (ARNs) to use as an execution IAM policy.</p>
1077
+ * @public
1078
+ */
1079
+ policyArns?: string[] | undefined;
1080
+ }
1116
1081
  /**
1117
1082
  * @public
1118
1083
  */
@@ -1138,9 +1103,7 @@ export interface StartJobRunResponse {
1138
1103
  */
1139
1104
  export interface ListTagsForResourceRequest {
1140
1105
  /**
1141
- * <p>The Amazon Resource Name (ARN) that identifies the resource to list the tags for.
1142
- * Currently, the supported resources are Amazon EMR Serverless applications and job
1143
- * runs.</p>
1106
+ * <p>The Amazon Resource Name (ARN) that identifies the resource to list the tags for. Currently, the supported resources are Amazon EMR Serverless applications and job runs.</p>
1144
1107
  * @public
1145
1108
  */
1146
1109
  resourceArn: string | undefined;
@@ -1160,9 +1123,7 @@ export interface ListTagsForResourceResponse {
1160
1123
  */
1161
1124
  export interface TagResourceRequest {
1162
1125
  /**
1163
- * <p>The Amazon Resource Name (ARN) that identifies the resource to list the tags for.
1164
- * Currently, the supported resources are Amazon EMR Serverless applications and job
1165
- * runs.</p>
1126
+ * <p>The Amazon Resource Name (ARN) that identifies the resource to list the tags for. Currently, the supported resources are Amazon EMR Serverless applications and job runs.</p>
1166
1127
  * @public
1167
1128
  */
1168
1129
  resourceArn: string | undefined;
@@ -1182,9 +1143,7 @@ export interface TagResourceResponse {
1182
1143
  */
1183
1144
  export interface UntagResourceRequest {
1184
1145
  /**
1185
- * <p>The Amazon Resource Name (ARN) that identifies the resource to list the tags for.
1186
- * Currently, the supported resources are Amazon EMR Serverless applications and job
1187
- * runs.</p>
1146
+ * <p>The Amazon Resource Name (ARN) that identifies the resource to list the tags for. Currently, the supported resources are Amazon EMR Serverless applications and job runs.</p>
1188
1147
  * @public
1189
1148
  */
1190
1149
  resourceArn: string | undefined;
@@ -1200,10 +1159,7 @@ export interface UntagResourceRequest {
1200
1159
  export interface UntagResourceResponse {
1201
1160
  }
1202
1161
  /**
1203
- * <p>A configuration specification to be used when provisioning an application. A
1204
- * configuration consists of a classification, properties, and optional nested configurations.
1205
- * A classification refers to an application-specific configuration file. Properties are the
1206
- * settings you want to change in that file.</p>
1162
+ * <p>A configuration specification to be used when provisioning an application. A configuration consists of a classification, properties, and optional nested configurations. A classification refers to an application-specific configuration file. Properties are the settings you want to change in that file.</p>
1207
1163
  * @public
1208
1164
  */
1209
1165
  export interface Configuration {
@@ -1224,8 +1180,7 @@ export interface Configuration {
1224
1180
  configurations?: Configuration[] | undefined;
1225
1181
  }
1226
1182
  /**
1227
- * <p>Information about an application. Amazon EMR Serverless uses applications to run
1228
- * jobs.</p>
1183
+ * <p>Information about an application. Amazon EMR Serverless uses applications to run jobs.</p>
1229
1184
  * @public
1230
1185
  */
1231
1186
  export interface Application {
@@ -1270,9 +1225,7 @@ export interface Application {
1270
1225
  */
1271
1226
  initialCapacity?: Record<string, InitialCapacityConfig> | undefined;
1272
1227
  /**
1273
- * <p>The maximum capacity of the application. This is cumulative across all workers at any
1274
- * given point in time during the lifespan of the application is created. No new resources
1275
- * will be created once any one of the defined limits is hit.</p>
1228
+ * <p>The maximum capacity of the application. This is cumulative across all workers at any given point in time during the lifespan of the application is created. No new resources will be created once any one of the defined limits is hit.</p>
1276
1229
  * @public
1277
1230
  */
1278
1231
  maximumCapacity?: MaximumAllowedResources | undefined;
@@ -1297,8 +1250,7 @@ export interface Application {
1297
1250
  */
1298
1251
  autoStartConfiguration?: AutoStartConfig | undefined;
1299
1252
  /**
1300
- * <p>The configuration for an application to automatically stop after a certain amount of
1301
- * time being idle.</p>
1253
+ * <p>The configuration for an application to automatically stop after a certain amount of time being idle.</p>
1302
1254
  * @public
1303
1255
  */
1304
1256
  autoStopConfiguration?: AutoStopConfig | undefined;
@@ -1323,10 +1275,7 @@ export interface Application {
1323
1275
  */
1324
1276
  workerTypeSpecifications?: Record<string, WorkerTypeSpecification> | undefined;
1325
1277
  /**
1326
- * <p>The <a href="https://docs.aws.amazon.com/emr-serverless/latest/APIReference/API_Configuration.html">Configuration</a>
1327
- * specifications of an application. Each configuration consists of a classification and properties. You use this
1328
- * parameter when creating or updating an application. To see the runtimeConfiguration object of an application,
1329
- * run the <a href="https://docs.aws.amazon.com/emr-serverless/latest/APIReference/API_GetApplication.html">GetApplication</a> API operation.</p>
1278
+ * <p>The <a href="https://docs.aws.amazon.com/emr-serverless/latest/APIReference/API_Configuration.html">Configuration</a> specifications of an application. Each configuration consists of a classification and properties. You use this parameter when creating or updating an application. To see the runtimeConfiguration object of an application, run the <a href="https://docs.aws.amazon.com/emr-serverless/latest/APIReference/API_GetApplication.html">GetApplication</a> API operation.</p>
1330
1279
  * @public
1331
1280
  */
1332
1281
  runtimeConfiguration?: Configuration[] | undefined;
@@ -1382,8 +1331,7 @@ export interface CreateApplicationRequest {
1382
1331
  */
1383
1332
  type: string | undefined;
1384
1333
  /**
1385
- * <p>The client idempotency token of the application to create. Its value must be unique for
1386
- * each request.</p>
1334
+ * <p>The client idempotency token of the application to create. Its value must be unique for each request.</p>
1387
1335
  * @public
1388
1336
  */
1389
1337
  clientToken?: string | undefined;
@@ -1393,9 +1341,7 @@ export interface CreateApplicationRequest {
1393
1341
  */
1394
1342
  initialCapacity?: Record<string, InitialCapacityConfig> | undefined;
1395
1343
  /**
1396
- * <p>The maximum capacity to allocate when the application is created. This is cumulative
1397
- * across all workers at any given point in time, not just when an application is created. No
1398
- * new resources will be created once any one of the defined limits is hit.</p>
1344
+ * <p>The maximum capacity to allocate when the application is created. This is cumulative across all workers at any given point in time, not just when an application is created. No new resources will be created once any one of the defined limits is hit.</p>
1399
1345
  * @public
1400
1346
  */
1401
1347
  maximumCapacity?: MaximumAllowedResources | undefined;
@@ -1410,8 +1356,7 @@ export interface CreateApplicationRequest {
1410
1356
  */
1411
1357
  autoStartConfiguration?: AutoStartConfig | undefined;
1412
1358
  /**
1413
- * <p>The configuration for an application to automatically stop after a certain amount of
1414
- * time being idle.</p>
1359
+ * <p>The configuration for an application to automatically stop after a certain amount of time being idle.</p>
1415
1360
  * @public
1416
1361
  */
1417
1362
  autoStopConfiguration?: AutoStopConfig | undefined;
@@ -1426,27 +1371,17 @@ export interface CreateApplicationRequest {
1426
1371
  */
1427
1372
  architecture?: Architecture | undefined;
1428
1373
  /**
1429
- * <p>The image configuration for all worker types. You can either set this parameter or
1430
- * <code>imageConfiguration</code> for each worker type in
1431
- * <code>workerTypeSpecifications</code>.</p>
1374
+ * <p>The image configuration for all worker types. You can either set this parameter or <code>imageConfiguration</code> for each worker type in <code>workerTypeSpecifications</code>.</p>
1432
1375
  * @public
1433
1376
  */
1434
1377
  imageConfiguration?: ImageConfigurationInput | undefined;
1435
1378
  /**
1436
- * <p>The key-value pairs that specify worker type to
1437
- * <code>WorkerTypeSpecificationInput</code>. This parameter must contain all valid worker
1438
- * types for a Spark or Hive application. Valid worker types include <code>Driver</code> and
1439
- * <code>Executor</code> for Spark applications and <code>HiveDriver</code> and
1440
- * <code>TezTask</code> for Hive applications. You can either set image details in this
1441
- * parameter for each worker type, or in <code>imageConfiguration</code> for all worker
1442
- * types.</p>
1379
+ * <p>The key-value pairs that specify worker type to <code>WorkerTypeSpecificationInput</code>. This parameter must contain all valid worker types for a Spark or Hive application. Valid worker types include <code>Driver</code> and <code>Executor</code> for Spark applications and <code>HiveDriver</code> and <code>TezTask</code> for Hive applications. You can either set image details in this parameter for each worker type, or in <code>imageConfiguration</code> for all worker types.</p>
1443
1380
  * @public
1444
1381
  */
1445
1382
  workerTypeSpecifications?: Record<string, WorkerTypeSpecificationInput> | undefined;
1446
1383
  /**
1447
- * <p>The <a href="https://docs.aws.amazon.com/emr-serverless/latest/APIReference/API_Configuration.html">Configuration</a>
1448
- * specifications to use when creating an application. Each configuration consists of a classification and properties.
1449
- * This configuration is applied to all the job runs submitted under the application.</p>
1384
+ * <p>The <a href="https://docs.aws.amazon.com/emr-serverless/latest/APIReference/API_Configuration.html">Configuration</a> specifications to use when creating an application. Each configuration consists of a classification and properties. This configuration is applied to all the job runs submitted under the application.</p>
1450
1385
  * @public
1451
1386
  */
1452
1387
  runtimeConfiguration?: Configuration[] | undefined;
@@ -1456,8 +1391,7 @@ export interface CreateApplicationRequest {
1456
1391
  */
1457
1392
  monitoringConfiguration?: MonitoringConfiguration | undefined;
1458
1393
  /**
1459
- * <p>The interactive configuration object that enables the interactive use cases
1460
- * to use when running an application.</p>
1394
+ * <p>The interactive configuration object that enables the interactive use cases to use when running an application.</p>
1461
1395
  * @public
1462
1396
  */
1463
1397
  interactiveConfiguration?: InteractiveConfiguration | undefined;
@@ -1477,8 +1411,7 @@ export interface UpdateApplicationRequest {
1477
1411
  */
1478
1412
  applicationId: string | undefined;
1479
1413
  /**
1480
- * <p>The client idempotency token of the application to update. Its value must be unique for
1481
- * each request.</p>
1414
+ * <p>The client idempotency token of the application to update. Its value must be unique for each request.</p>
1482
1415
  * @public
1483
1416
  */
1484
1417
  clientToken?: string | undefined;
@@ -1488,9 +1421,7 @@ export interface UpdateApplicationRequest {
1488
1421
  */
1489
1422
  initialCapacity?: Record<string, InitialCapacityConfig> | undefined;
1490
1423
  /**
1491
- * <p>The maximum capacity to allocate when the application is updated. This is cumulative
1492
- * across all workers at any given point in time during the lifespan of the application. No
1493
- * new resources will be created once any one of the defined limits is hit.</p>
1424
+ * <p>The maximum capacity to allocate when the application is updated. This is cumulative across all workers at any given point in time during the lifespan of the application. No new resources will be created once any one of the defined limits is hit.</p>
1494
1425
  * @public
1495
1426
  */
1496
1427
  maximumCapacity?: MaximumAllowedResources | undefined;
@@ -1500,8 +1431,7 @@ export interface UpdateApplicationRequest {
1500
1431
  */
1501
1432
  autoStartConfiguration?: AutoStartConfig | undefined;
1502
1433
  /**
1503
- * <p>The configuration for an application to automatically stop after a certain amount of
1504
- * time being idle.</p>
1434
+ * <p>The configuration for an application to automatically stop after a certain amount of time being idle.</p>
1505
1435
  * @public
1506
1436
  */
1507
1437
  autoStopConfiguration?: AutoStopConfig | undefined;
@@ -1516,39 +1446,27 @@ export interface UpdateApplicationRequest {
1516
1446
  */
1517
1447
  architecture?: Architecture | undefined;
1518
1448
  /**
1519
- * <p>The image configuration to be used for all worker types. You can either set this
1520
- * parameter or <code>imageConfiguration</code> for each worker type in
1521
- * <code>WorkerTypeSpecificationInput</code>.</p>
1449
+ * <p>The image configuration to be used for all worker types. You can either set this parameter or <code>imageConfiguration</code> for each worker type in <code>WorkerTypeSpecificationInput</code>.</p>
1522
1450
  * @public
1523
1451
  */
1524
1452
  imageConfiguration?: ImageConfigurationInput | undefined;
1525
1453
  /**
1526
- * <p>The key-value pairs that specify worker type to
1527
- * <code>WorkerTypeSpecificationInput</code>. This parameter must contain all valid worker
1528
- * types for a Spark or Hive application. Valid worker types include <code>Driver</code> and
1529
- * <code>Executor</code> for Spark applications and <code>HiveDriver</code> and
1530
- * <code>TezTask</code> for Hive applications. You can either set image details in this
1531
- * parameter for each worker type, or in <code>imageConfiguration</code> for all worker
1532
- * types.</p>
1454
+ * <p>The key-value pairs that specify worker type to <code>WorkerTypeSpecificationInput</code>. This parameter must contain all valid worker types for a Spark or Hive application. Valid worker types include <code>Driver</code> and <code>Executor</code> for Spark applications and <code>HiveDriver</code> and <code>TezTask</code> for Hive applications. You can either set image details in this parameter for each worker type, or in <code>imageConfiguration</code> for all worker types.</p>
1533
1455
  * @public
1534
1456
  */
1535
1457
  workerTypeSpecifications?: Record<string, WorkerTypeSpecificationInput> | undefined;
1536
1458
  /**
1537
- * <p>The interactive configuration object that contains new interactive use cases
1538
- * when the application is updated.</p>
1459
+ * <p>The interactive configuration object that contains new interactive use cases when the application is updated.</p>
1539
1460
  * @public
1540
1461
  */
1541
1462
  interactiveConfiguration?: InteractiveConfiguration | undefined;
1542
1463
  /**
1543
- * <p>The Amazon EMR release label for the application. You can change the release
1544
- * label to use a different release of Amazon EMR.</p>
1464
+ * <p>The Amazon EMR release label for the application. You can change the release label to use a different release of Amazon EMR.</p>
1545
1465
  * @public
1546
1466
  */
1547
1467
  releaseLabel?: string | undefined;
1548
1468
  /**
1549
- * <p>The <a href="https://docs.aws.amazon.com/emr-serverless/latest/APIReference/API_Configuration.html">Configuration</a>
1550
- * specifications to use when updating an application. Each configuration consists of a classification and properties.
1551
- * This configuration is applied across all the job runs submitted under the application.</p>
1469
+ * <p>The <a href="https://docs.aws.amazon.com/emr-serverless/latest/APIReference/API_Configuration.html">Configuration</a> specifications to use when updating an application. Each configuration consists of a classification and properties. This configuration is applied across all the job runs submitted under the application.</p>
1552
1470
  * @public
1553
1471
  */
1554
1472
  runtimeConfiguration?: Configuration[] | undefined;
@@ -1574,9 +1492,7 @@ export interface GetApplicationResponse {
1574
1492
  application: Application | undefined;
1575
1493
  }
1576
1494
  /**
1577
- * <p>Information about a job run. A job run is a unit of work, such as a Spark JAR, Hive
1578
- * query, or SparkSQL query, that you submit to an Amazon EMR Serverless
1579
- * application.</p>
1495
+ * <p>Information about a job run. A job run is a unit of work, such as a Spark JAR, Hive query, or SparkSQL query, that you submit to an Amazon EMR Serverless application.</p>
1580
1496
  * @public
1581
1497
  */
1582
1498
  export interface JobRun {
@@ -1631,8 +1547,7 @@ export interface JobRun {
1631
1547
  */
1632
1548
  stateDetails: string | undefined;
1633
1549
  /**
1634
- * <p>The Amazon EMR release associated with the application your job is running
1635
- * on.</p>
1550
+ * <p>The Amazon EMR release associated with the application your job is running on.</p>
1636
1551
  * @public
1637
1552
  */
1638
1553
  releaseLabel: string | undefined;
@@ -1652,8 +1567,7 @@ export interface JobRun {
1652
1567
  */
1653
1568
  tags?: Record<string, string> | undefined;
1654
1569
  /**
1655
- * <p>The aggregate vCPU, memory, and storage resources used from the time the job starts to
1656
- * execute, until the time the job terminates, rounded up to the nearest second.</p>
1570
+ * <p>The aggregate vCPU, memory, and storage resources used from the time the job starts to execute, until the time the job terminates, rounded up to the nearest second.</p>
1657
1571
  * @public
1658
1572
  */
1659
1573
  totalResourceUtilization?: TotalResourceUtilization | undefined;
@@ -1663,23 +1577,17 @@ export interface JobRun {
1663
1577
  */
1664
1578
  networkConfiguration?: NetworkConfiguration | undefined;
1665
1579
  /**
1666
- * <p>The job run total execution duration in seconds. This field is only available for job
1667
- * runs in a <code>COMPLETED</code>, <code>FAILED</code>, or <code>CANCELLED</code>
1668
- * state.</p>
1580
+ * <p>The job run total execution duration in seconds. This field is only available for job runs in a <code>COMPLETED</code>, <code>FAILED</code>, or <code>CANCELLED</code> state.</p>
1669
1581
  * @public
1670
1582
  */
1671
1583
  totalExecutionDurationSeconds?: number | undefined;
1672
1584
  /**
1673
- * <p>Returns the job run timeout value from the <code>StartJobRun</code> call. If no timeout
1674
- * was specified, then it returns the default timeout of 720 minutes.</p>
1585
+ * <p>Returns the job run timeout value from the <code>StartJobRun</code> call. If no timeout was specified, then it returns the default timeout of 720 minutes.</p>
1675
1586
  * @public
1676
1587
  */
1677
1588
  executionTimeoutMinutes?: number | undefined;
1678
1589
  /**
1679
- * <p>The aggregate vCPU, memory, and storage that Amazon Web Services has billed for the job
1680
- * run. The billed resources include a 1-minute minimum usage for workers, plus additional
1681
- * storage over 20 GB per worker. Note that billed resources do not include usage for idle
1682
- * pre-initialized workers.</p>
1590
+ * <p>The aggregate vCPU, memory, and storage that Amazon Web Services has billed for the job run. The billed resources include a 1-minute minimum usage for workers, plus additional storage over 20 GB per worker. Note that billed resources do not include usage for idle pre-initialized workers.</p>
1683
1591
  * @public
1684
1592
  */
1685
1593
  billedResourceUtilization?: ResourceUtilization | undefined;
@@ -1734,8 +1642,7 @@ export interface StartJobRunRequest {
1734
1642
  */
1735
1643
  applicationId: string | undefined;
1736
1644
  /**
1737
- * <p>The client idempotency token of the job run to start. Its value must be unique for each
1738
- * request.</p>
1645
+ * <p>The client idempotency token of the job run to start. Its value must be unique for each request.</p>
1739
1646
  * @public
1740
1647
  */
1741
1648
  clientToken?: string | undefined;
@@ -1744,6 +1651,11 @@ export interface StartJobRunRequest {
1744
1651
  * @public
1745
1652
  */
1746
1653
  executionRoleArn: string | undefined;
1654
+ /**
1655
+ * <p>You can pass an optional IAM policy. The resulting job IAM role permissions will be an intersection of this policy and the policy associated with your job execution role.</p>
1656
+ * @public
1657
+ */
1658
+ executionIamPolicy?: JobRunExecutionIamPolicy | undefined;
1747
1659
  /**
1748
1660
  * <p>The job driver for the job run.</p>
1749
1661
  * @public
@@ -1760,8 +1672,7 @@ export interface StartJobRunRequest {
1760
1672
  */
1761
1673
  tags?: Record<string, string> | undefined;
1762
1674
  /**
1763
- * <p>The maximum duration for the job run to run. If the job run runs beyond this duration,
1764
- * it will be automatically cancelled.</p>
1675
+ * <p>The maximum duration for the job run to run. If the job run runs beyond this duration, it will be automatically cancelled.</p>
1765
1676
  * @public
1766
1677
  */
1767
1678
  executionTimeoutMinutes?: number | undefined;
@@ -313,6 +313,10 @@ export interface ListJobRunsResponse {
313
313
  jobRuns: JobRunSummary[] | undefined;
314
314
  nextToken?: string | undefined;
315
315
  }
316
+ export interface JobRunExecutionIamPolicy {
317
+ policy?: string | undefined;
318
+ policyArns?: string[] | undefined;
319
+ }
316
320
  export interface StartJobRunResponse {
317
321
  applicationId: string | undefined;
318
322
  jobRunId: string | undefined;
@@ -445,6 +449,7 @@ export interface StartJobRunRequest {
445
449
  applicationId: string | undefined;
446
450
  clientToken?: string | undefined;
447
451
  executionRoleArn: string | undefined;
452
+ executionIamPolicy?: JobRunExecutionIamPolicy | undefined;
448
453
  jobDriver?: JobDriver | undefined;
449
454
  configurationOverrides?: ConfigurationOverrides | undefined;
450
455
  tags?: Record<string, string> | undefined;
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.817.0",
4
+ "version": "3.821.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-emr-serverless",
@@ -20,41 +20,41 @@
20
20
  "dependencies": {
21
21
  "@aws-crypto/sha256-browser": "5.2.0",
22
22
  "@aws-crypto/sha256-js": "5.2.0",
23
- "@aws-sdk/core": "3.816.0",
24
- "@aws-sdk/credential-provider-node": "3.817.0",
25
- "@aws-sdk/middleware-host-header": "3.804.0",
26
- "@aws-sdk/middleware-logger": "3.804.0",
27
- "@aws-sdk/middleware-recursion-detection": "3.804.0",
28
- "@aws-sdk/middleware-user-agent": "3.816.0",
29
- "@aws-sdk/region-config-resolver": "3.808.0",
30
- "@aws-sdk/types": "3.804.0",
31
- "@aws-sdk/util-endpoints": "3.808.0",
32
- "@aws-sdk/util-user-agent-browser": "3.804.0",
33
- "@aws-sdk/util-user-agent-node": "3.816.0",
34
- "@smithy/config-resolver": "^4.1.2",
35
- "@smithy/core": "^3.3.3",
36
- "@smithy/fetch-http-handler": "^5.0.2",
37
- "@smithy/hash-node": "^4.0.2",
38
- "@smithy/invalid-dependency": "^4.0.2",
39
- "@smithy/middleware-content-length": "^4.0.2",
40
- "@smithy/middleware-endpoint": "^4.1.6",
41
- "@smithy/middleware-retry": "^4.1.7",
42
- "@smithy/middleware-serde": "^4.0.5",
43
- "@smithy/middleware-stack": "^4.0.2",
44
- "@smithy/node-config-provider": "^4.1.1",
45
- "@smithy/node-http-handler": "^4.0.4",
46
- "@smithy/protocol-http": "^5.1.0",
47
- "@smithy/smithy-client": "^4.2.6",
48
- "@smithy/types": "^4.2.0",
49
- "@smithy/url-parser": "^4.0.2",
23
+ "@aws-sdk/core": "3.821.0",
24
+ "@aws-sdk/credential-provider-node": "3.821.0",
25
+ "@aws-sdk/middleware-host-header": "3.821.0",
26
+ "@aws-sdk/middleware-logger": "3.821.0",
27
+ "@aws-sdk/middleware-recursion-detection": "3.821.0",
28
+ "@aws-sdk/middleware-user-agent": "3.821.0",
29
+ "@aws-sdk/region-config-resolver": "3.821.0",
30
+ "@aws-sdk/types": "3.821.0",
31
+ "@aws-sdk/util-endpoints": "3.821.0",
32
+ "@aws-sdk/util-user-agent-browser": "3.821.0",
33
+ "@aws-sdk/util-user-agent-node": "3.821.0",
34
+ "@smithy/config-resolver": "^4.1.4",
35
+ "@smithy/core": "^3.5.1",
36
+ "@smithy/fetch-http-handler": "^5.0.4",
37
+ "@smithy/hash-node": "^4.0.4",
38
+ "@smithy/invalid-dependency": "^4.0.4",
39
+ "@smithy/middleware-content-length": "^4.0.4",
40
+ "@smithy/middleware-endpoint": "^4.1.9",
41
+ "@smithy/middleware-retry": "^4.1.10",
42
+ "@smithy/middleware-serde": "^4.0.8",
43
+ "@smithy/middleware-stack": "^4.0.4",
44
+ "@smithy/node-config-provider": "^4.1.3",
45
+ "@smithy/node-http-handler": "^4.0.6",
46
+ "@smithy/protocol-http": "^5.1.2",
47
+ "@smithy/smithy-client": "^4.4.1",
48
+ "@smithy/types": "^4.3.1",
49
+ "@smithy/url-parser": "^4.0.4",
50
50
  "@smithy/util-base64": "^4.0.0",
51
51
  "@smithy/util-body-length-browser": "^4.0.0",
52
52
  "@smithy/util-body-length-node": "^4.0.0",
53
- "@smithy/util-defaults-mode-browser": "^4.0.14",
54
- "@smithy/util-defaults-mode-node": "^4.0.14",
55
- "@smithy/util-endpoints": "^3.0.4",
56
- "@smithy/util-middleware": "^4.0.2",
57
- "@smithy/util-retry": "^4.0.3",
53
+ "@smithy/util-defaults-mode-browser": "^4.0.17",
54
+ "@smithy/util-defaults-mode-node": "^4.0.17",
55
+ "@smithy/util-endpoints": "^3.0.6",
56
+ "@smithy/util-middleware": "^4.0.4",
57
+ "@smithy/util-retry": "^4.0.5",
58
58
  "@smithy/util-utf8": "^4.0.0",
59
59
  "@types/uuid": "^9.0.1",
60
60
  "tslib": "^2.6.2",