Skip to content

Commit e886e87

Browse files
author
awstools
committed
feat(client-emr-serverless): This release adds the capability for users to specify an optional Execution IAM policy in the StartJobRun action. The resulting permissions assumed by the job run is the intersection of the permissions in the Execution Role and the specified Execution IAM Policy.
1 parent 4ffd36f commit e886e87

23 files changed

+251
-380
lines changed

‎clients/client-emr-serverless/README.md

Lines changed: 1 addition & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -6,27 +6,7 @@
66

77
AWS SDK for JavaScript EMRServerless Client for Node.js, Browser and React Native.
88

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>
3010

3111
## Installing
3212

‎clients/client-emr-serverless/src/EMRServerless.ts

Lines changed: 1 addition & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -321,27 +321,7 @@ export interface EMRServerless {
321321
}
322322

323323
/**
324-
* <p>Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running
325-
* analytics applications using the latest open source frameworks such as Apache Spark and
326-
* Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize,
327-
* secure, or operate clusters to run applications with these frameworks.</p>
328-
* <p>The API reference to Amazon EMR Serverless is <code>emr-serverless</code>. The
329-
* <code>emr-serverless</code> prefix is used in the following scenarios: </p>
330-
* <ul>
331-
* <li>
332-
* <p>It is the prefix in the CLI commands for Amazon EMR Serverless. For
333-
* example, <code>aws emr-serverless start-job-run</code>.</p>
334-
* </li>
335-
* <li>
336-
* <p>It is the prefix before IAM policy actions for Amazon EMR Serverless. For
337-
* example, <code>"Action": ["emr-serverless:StartJobRun"]</code>. For more information,
338-
* 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>
339-
* </li>
340-
* <li>
341-
* <p>It is the prefix used in Amazon EMR Serverless service endpoints. For
342-
* example, <code>emr-serverless.us-east-2.amazonaws.com</code>.</p>
343-
* </li>
344-
* </ul>
324+
* <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>
345325
* @public
346326
*/
347327
export class EMRServerless extends EMRServerlessClient implements EMRServerless {}

‎clients/client-emr-serverless/src/EMRServerlessClient.ts

Lines changed: 1 addition & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -319,27 +319,7 @@ export type EMRServerlessClientResolvedConfigType = __SmithyResolvedConfiguratio
319319
export interface EMRServerlessClientResolvedConfig extends EMRServerlessClientResolvedConfigType {}
320320

321321
/**
322-
* <p>Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running
323-
* analytics applications using the latest open source frameworks such as Apache Spark and
324-
* Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize,
325-
* secure, or operate clusters to run applications with these frameworks.</p>
326-
* <p>The API reference to Amazon EMR Serverless is <code>emr-serverless</code>. The
327-
* <code>emr-serverless</code> prefix is used in the following scenarios: </p>
328-
* <ul>
329-
* <li>
330-
* <p>It is the prefix in the CLI commands for Amazon EMR Serverless. For
331-
* example, <code>aws emr-serverless start-job-run</code>.</p>
332-
* </li>
333-
* <li>
334-
* <p>It is the prefix before IAM policy actions for Amazon EMR Serverless. For
335-
* example, <code>"Action": ["emr-serverless:StartJobRun"]</code>. For more information,
336-
* 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>
337-
* </li>
338-
* <li>
339-
* <p>It is the prefix used in Amazon EMR Serverless service endpoints. For
340-
* example, <code>emr-serverless.us-east-2.amazonaws.com</code>.</p>
341-
* </li>
342-
* </ul>
322+
* <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>
343323
* @public
344324
*/
345325
export class EMRServerlessClient extends __Client<

‎clients/client-emr-serverless/src/commands/CancelJobRunCommand.ts

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,8 +61,7 @@ export interface CancelJobRunCommandOutput extends CancelJobRunResponse, __Metad
6161
* <p>The specified resource was not found.</p>
6262
*
6363
* @throws {@link ValidationException} (client fault)
64-
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services
65-
* service.</p>
64+
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
6665
*
6766
* @throws {@link EMRServerlessServiceException}
6867
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

‎clients/client-emr-serverless/src/commands/CreateApplicationCommand.ts

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -156,8 +156,7 @@ export interface CreateApplicationCommandOutput extends CreateApplicationRespons
156156
* @see {@link EMRServerlessClientResolvedConfig | config} for EMRServerlessClient's `config` shape.
157157
*
158158
* @throws {@link ConflictException} (client fault)
159-
* <p>The request could not be processed because of conflict in the current state of the
160-
* resource.</p>
159+
* <p>The request could not be processed because of conflict in the current state of the resource.</p>
161160
*
162161
* @throws {@link InternalServerException} (server fault)
163162
* <p>Request processing failed because of an error or failure with the service.</p>
@@ -166,8 +165,7 @@ export interface CreateApplicationCommandOutput extends CreateApplicationRespons
166165
* <p>The specified resource was not found.</p>
167166
*
168167
* @throws {@link ValidationException} (client fault)
169-
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services
170-
* service.</p>
168+
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
171169
*
172170
* @throws {@link EMRServerlessServiceException}
173171
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

‎clients/client-emr-serverless/src/commands/DeleteApplicationCommand.ts

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,7 @@ export interface DeleteApplicationCommandInput extends DeleteApplicationRequest
2828
export interface DeleteApplicationCommandOutput extends DeleteApplicationResponse, __MetadataBearer {}
2929

3030
/**
31-
* <p>Deletes an application. An application has to be in a stopped or created state in order
32-
* to be deleted.</p>
31+
* <p>Deletes an application. An application has to be in a stopped or created state in order to be deleted.</p>
3332
* @example
3433
* Use a bare-bones client and the command you need to make an API call.
3534
* ```javascript
@@ -58,8 +57,7 @@ export interface DeleteApplicationCommandOutput extends DeleteApplicationRespons
5857
* <p>The specified resource was not found.</p>
5958
*
6059
* @throws {@link ValidationException} (client fault)
61-
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services
62-
* service.</p>
60+
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
6361
*
6462
* @throws {@link EMRServerlessServiceException}
6563
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

‎clients/client-emr-serverless/src/commands/GetApplicationCommand.ts

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -169,8 +169,7 @@ export interface GetApplicationCommandOutput extends GetApplicationResponse, __M
169169
* <p>The specified resource was not found.</p>
170170
*
171171
* @throws {@link ValidationException} (client fault)
172-
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services
173-
* service.</p>
172+
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
174173
*
175174
* @throws {@link EMRServerlessServiceException}
176175
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

‎clients/client-emr-serverless/src/commands/GetDashboardForJobRunCommand.ts

Lines changed: 2 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -28,15 +28,7 @@ export interface GetDashboardForJobRunCommandInput extends GetDashboardForJobRun
2828
export interface GetDashboardForJobRunCommandOutput extends GetDashboardForJobRunResponse, __MetadataBearer {}
2929

3030
/**
31-
* <p>Creates and returns a URL that you can use to access the application UIs for a job
32-
* run.</p>
33-
* <p>For jobs in a running state, the application UI is a live user interface such as the
34-
* Spark or Tez web UI. For completed jobs, the application UI is a persistent application
35-
* user interface such as the Spark History Server or persistent Tez UI.</p>
36-
* <note>
37-
* <p>The URL is valid for one hour after you generate it. To access the application UI
38-
* after that hour elapses, you must invoke the API again to generate a new URL.</p>
39-
* </note>
31+
* <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>
4032
* @example
4133
* Use a bare-bones client and the command you need to make an API call.
4234
* ```javascript
@@ -70,8 +62,7 @@ export interface GetDashboardForJobRunCommandOutput extends GetDashboardForJobRu
7062
* <p>The specified resource was not found.</p>
7163
*
7264
* @throws {@link ValidationException} (client fault)
73-
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services
74-
* service.</p>
65+
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
7566
*
7667
* @throws {@link EMRServerlessServiceException}
7768
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

‎clients/client-emr-serverless/src/commands/GetJobRunCommand.ts

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -164,8 +164,7 @@ export interface GetJobRunCommandOutput extends GetJobRunResponse, __MetadataBea
164164
* <p>The specified resource was not found.</p>
165165
*
166166
* @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>
169168
*
170169
* @throws {@link EMRServerlessServiceException}
171170
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

‎clients/client-emr-serverless/src/commands/ListApplicationsCommand.ts

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -74,8 +74,7 @@ export interface ListApplicationsCommandOutput extends ListApplicationsResponse,
7474
* <p>Request processing failed because of an error or failure with the service.</p>
7575
*
7676
* @throws {@link ValidationException} (client fault)
77-
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services
78-
* service.</p>
77+
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
7978
*
8079
* @throws {@link EMRServerlessServiceException}
8180
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

‎clients/client-emr-serverless/src/commands/ListJobRunAttemptsCommand.ts

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -81,8 +81,7 @@ export interface ListJobRunAttemptsCommandOutput extends ListJobRunAttemptsRespo
8181
* <p>The specified resource was not found.</p>
8282
*
8383
* @throws {@link ValidationException} (client fault)
84-
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services
85-
* service.</p>
84+
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
8685
*
8786
* @throws {@link EMRServerlessServiceException}
8887
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

‎clients/client-emr-serverless/src/commands/ListJobRunsCommand.ts

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,8 +84,7 @@ export interface ListJobRunsCommandOutput extends ListJobRunsResponse, __Metadat
8484
* <p>Request processing failed because of an error or failure with the service.</p>
8585
*
8686
* @throws {@link ValidationException} (client fault)
87-
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services
88-
* service.</p>
87+
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
8988
*
9089
* @throws {@link EMRServerlessServiceException}
9190
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

‎clients/client-emr-serverless/src/commands/ListTagsForResourceCommand.ts

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,8 +61,7 @@ export interface ListTagsForResourceCommandOutput extends ListTagsForResourceRes
6161
* <p>The specified resource was not found.</p>
6262
*
6363
* @throws {@link ValidationException} (client fault)
64-
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services
65-
* service.</p>
64+
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
6665
*
6766
* @throws {@link EMRServerlessServiceException}
6867
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

‎clients/client-emr-serverless/src/commands/StartApplicationCommand.ts

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,8 +60,7 @@ export interface StartApplicationCommandOutput extends StartApplicationResponse,
6060
* <p>The maximum number of resources per account has been reached.</p>
6161
*
6262
* @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>
6564
*
6665
* @throws {@link EMRServerlessServiceException}
6766
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

‎clients/client-emr-serverless/src/commands/StartJobRunCommand.ts

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,12 @@ export interface StartJobRunCommandOutput extends StartJobRunResponse, __Metadat
3939
* applicationId: "STRING_VALUE", // required
4040
* clientToken: "STRING_VALUE", // required
4141
* executionRoleArn: "STRING_VALUE", // required
42+
* executionIamPolicy: { // JobRunExecutionIamPolicy
43+
* policy: "STRING_VALUE",
44+
* policyArns: [ // PolicyArnList
45+
* "STRING_VALUE",
46+
* ],
47+
* },
4248
* jobDriver: { // JobDriver Union: only one key present
4349
* sparkSubmit: { // SparkSubmit
4450
* entryPoint: "STRING_VALUE", // required
@@ -124,8 +130,7 @@ export interface StartJobRunCommandOutput extends StartJobRunResponse, __Metadat
124130
* @see {@link EMRServerlessClientResolvedConfig | config} for EMRServerlessClient's `config` shape.
125131
*
126132
* @throws {@link ConflictException} (client fault)
127-
* <p>The request could not be processed because of conflict in the current state of the
128-
* resource.</p>
133+
* <p>The request could not be processed because of conflict in the current state of the resource.</p>
129134
*
130135
* @throws {@link InternalServerException} (server fault)
131136
* <p>Request processing failed because of an error or failure with the service.</p>
@@ -134,8 +139,7 @@ export interface StartJobRunCommandOutput extends StartJobRunResponse, __Metadat
134139
* <p>The specified resource was not found.</p>
135140
*
136141
* @throws {@link ValidationException} (client fault)
137-
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services
138-
* service.</p>
142+
* <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
139143
*
140144
* @throws {@link EMRServerlessServiceException}
141145
* <p>Base exception class for all service exceptions from EMRServerless service.</p>

0 commit comments

Comments
 (0)