feat(client-emr-serverless): The GetJobRun API has been updated to include the job's billed resource utilization. This utilization shows the aggregate vCPU, memory and storage that AWS 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.

awstools · awstools · commit 6f369a93f2d6 · 2023-04-17T18:16:20.000Z
diff --git a/clients/client-emr-serverless/src/EMRServerless.ts b/clients/client-emr-serverless/src/EMRServerless.ts
@@ -220,7 +220,8 @@ export class EMRServerless extends EMRServerlessClient {
 
   /**
    * @public
-   * <p>Returns a URL to access the job run dashboard.</p>
+   * <p>Returns a URL to access the job run dashboard. The generated URL is valid for one hour,
+   *          after which you must invoke the API again to generate a new URL.</p>
    */
   public getDashboardForJobRun(
     args: GetDashboardForJobRunCommandInput,
@@ -467,11 +468,11 @@ export class EMRServerless extends EMRServerlessClient {
 
   /**
    * @public
-   * <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>
+   * <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>
    */
   public tagResource(args: TagResourceCommandInput, options?: __HttpHandlerOptions): Promise<TagResourceCommandOutput>;
   public tagResource(args: TagResourceCommandInput, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
diff --git a/clients/client-emr-serverless/src/commands/CancelJobRunCommand.ts b/clients/client-emr-serverless/src/commands/CancelJobRunCommand.ts
@@ -60,7 +60,8 @@ export interface CancelJobRunCommandOutput extends CancelJobRunResponse, __Metad
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/CreateApplicationCommand.ts b/clients/client-emr-serverless/src/commands/CreateApplicationCommand.ts
@@ -110,7 +110,8 @@ export interface CreateApplicationCommandOutput extends CreateApplicationRespons
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/DeleteApplicationCommand.ts b/clients/client-emr-serverless/src/commands/DeleteApplicationCommand.ts
@@ -60,7 +60,8 @@ export interface DeleteApplicationCommandOutput extends DeleteApplicationRespons
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/GetApplicationCommand.ts b/clients/client-emr-serverless/src/commands/GetApplicationCommand.ts
@@ -59,7 +59,8 @@ export interface GetApplicationCommandOutput extends GetApplicationResponse, __M
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/GetDashboardForJobRunCommand.ts b/clients/client-emr-serverless/src/commands/GetDashboardForJobRunCommand.ts
@@ -32,7 +32,8 @@ export interface GetDashboardForJobRunCommandOutput extends GetDashboardForJobRu
 
 /**
  * @public
- * <p>Returns a URL to access the job run dashboard.</p>
+ * <p>Returns a URL to access the job run dashboard. The generated URL is valid for one hour,
+ *          after which you must invoke the API again to generate a new URL.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -60,7 +61,8 @@ export interface GetDashboardForJobRunCommandOutput extends GetDashboardForJobRu
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/GetJobRunCommand.ts b/clients/client-emr-serverless/src/commands/GetJobRunCommand.ts
@@ -60,7 +60,8 @@ export interface GetJobRunCommandOutput extends GetJobRunResponse, __MetadataBea
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/ListApplicationsCommand.ts b/clients/client-emr-serverless/src/commands/ListApplicationsCommand.ts
@@ -60,7 +60,8 @@ export interface ListApplicationsCommandOutput extends ListApplicationsResponse,
  *  <p>Request processing failed because of an error or failure with the service.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/ListJobRunsCommand.ts b/clients/client-emr-serverless/src/commands/ListJobRunsCommand.ts
@@ -63,7 +63,8 @@ export interface ListJobRunsCommandOutput extends ListJobRunsResponse, __Metadat
  *  <p>Request processing failed because of an error or failure with the service.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/ListTagsForResourceCommand.ts b/clients/client-emr-serverless/src/commands/ListTagsForResourceCommand.ts
@@ -59,7 +59,8 @@ export interface ListTagsForResourceCommandOutput extends ListTagsForResourceRes
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/StartApplicationCommand.ts b/clients/client-emr-serverless/src/commands/StartApplicationCommand.ts
@@ -62,7 +62,8 @@ export interface StartApplicationCommandOutput extends StartApplicationResponse,
  *  <p>The maximum number of resources per account has been reached.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/StartJobRunCommand.ts b/clients/client-emr-serverless/src/commands/StartJobRunCommand.ts
@@ -113,7 +113,8 @@ export interface StartJobRunCommandOutput extends StartJobRunResponse, __Metadat
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/StopApplicationCommand.ts b/clients/client-emr-serverless/src/commands/StopApplicationCommand.ts
@@ -60,7 +60,8 @@ export interface StopApplicationCommandOutput extends StopApplicationResponse, _
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/TagResourceCommand.ts b/clients/client-emr-serverless/src/commands/TagResourceCommand.ts
@@ -32,11 +32,11 @@ export interface TagResourceCommandOutput extends TagResourceResponse, __Metadat
 
 /**
  * @public
- * <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>
+ * <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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -66,7 +66,8 @@ export interface TagResourceCommandOutput extends TagResourceResponse, __Metadat
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/UntagResourceCommand.ts b/clients/client-emr-serverless/src/commands/UntagResourceCommand.ts
@@ -62,7 +62,8 @@ export interface UntagResourceCommandOutput extends UntagResourceResponse, __Met
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/commands/UpdateApplicationCommand.ts b/clients/client-emr-serverless/src/commands/UpdateApplicationCommand.ts
@@ -102,7 +102,8 @@ export interface UpdateApplicationCommandOutput extends UpdateApplicationRespons
  *  <p>The specified resource was not found.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  *
  *
  */
diff --git a/clients/client-emr-serverless/src/models/models_0.ts b/clients/client-emr-serverless/src/models/models_0.ts
@@ -515,7 +515,8 @@ export class ResourceNotFoundException extends __BaseException {
 
 /**
  * @public
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
+ *          service.</p>
  */
 export class ValidationException extends __BaseException {
   readonly name: "ValidationException" = "ValidationException";
@@ -802,6 +803,30 @@ export interface GetJobRunRequest {
   jobRunId: string | undefined;
 }
 
+/**
+ * @public
+ * <p>The resource utilization for memory, storage, and vCPU for jobs.</p>
+ */
+export interface ResourceUtilization {
+  /**
+   * <p>The aggregated vCPU used per hour from the time the job starts executing until the job
+   *          is terminated.</p>
+   */
+  vCPUHour?: number;
+
+  /**
+   * <p>The aggregated memory used per hour from the time the job starts executing until the job
+   *          is terminated.</p>
+   */
+  memoryGBHour?: number;
+
+  /**
+   * <p>The aggregated storage used per hour from the time the job starts executing until the
+   *          job is terminated.</p>
+   */
+  storageGBHour?: number;
+}
+
 /**
  * @public
  * <p>The managed log persistence configuration for a job run.</p>
@@ -1307,8 +1332,8 @@ export interface JobRun {
   tags?: Record<string, string>;
 
   /**
-   * <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>
+   * <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>
    */
   totalResourceUtilization?: TotalResourceUtilization;
 
@@ -1325,9 +1350,18 @@ export interface JobRun {
   totalExecutionDurationSeconds?: number;
 
   /**
-   * Maximum duration for the job run to run. If the job run runs beyond this duration, it will be automatically cancelled.
+   * <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>
    */
   executionTimeoutMinutes?: number;
+
+  /**
+   * <p>The aggregate vCPU, memory, and storage that AWS 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>
+   */
+  billedResourceUtilization?: ResourceUtilization;
 }
 
 /**
diff --git a/clients/client-emr-serverless/src/protocols/Aws_restJson1.ts b/clients/client-emr-serverless/src/protocols/Aws_restJson1.ts
@@ -67,6 +67,7 @@ import {
   MonitoringConfiguration,
   NetworkConfiguration,
   ResourceNotFoundException,
+  ResourceUtilization,
   S3MonitoringConfiguration,
   ServiceQuotaExceededException,
   SparkSubmit,
@@ -1652,6 +1653,7 @@ const de_JobRun = (output: any, context: __SerdeContext): JobRun => {
   return take(output, {
     applicationId: __expectString,
     arn: __expectString,
+    billedResourceUtilization: (_: any) => de_ResourceUtilization(_, context),
     configurationOverrides: (_: any) => de_ConfigurationOverrides(_, context),
     createdAt: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
     createdBy: __expectString,
@@ -1711,6 +1713,17 @@ const de_JobRunSummary = (output: any, context: __SerdeContext): JobRunSummary =
 
 // de_NetworkConfiguration omitted.
 
+/**
+ * deserializeAws_restJson1ResourceUtilization
+ */
+const de_ResourceUtilization = (output: any, context: __SerdeContext): ResourceUtilization => {
+  return take(output, {
+    memoryGBHour: __limitedParseDouble,
+    storageGBHour: __limitedParseDouble,
+    vCPUHour: __limitedParseDouble,
+  }) as any;
+};
+
 // de_S3MonitoringConfiguration omitted.
 
 // de_SecurityGroupIds omitted.
diff --git a/codegen/sdk-codegen/aws-models/emr-serverless.json b/codegen/sdk-codegen/aws-models/emr-serverless.json

Original file line number	Diff line number	Diff line change
`@@ -60,7 +60,8 @@ export interface CancelJobRunCommandOutput extends CancelJobRunResponse, __Metad`
`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 service.</p>`
	`63`	`+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services`
	`64`	`+ * service.</p>`
`64`	`65`	`*`
`65`	`66`	`*`
`66`	`67`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -110,7 +110,8 @@ export interface CreateApplicationCommandOutput extends CreateApplicationRespons`
`110`	`110`	`* <p>The specified resource was not found.</p>`
`111`	`111`	`*`
`112`	`112`	`* @throws {@link ValidationException} (client fault)`
`113`		`- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>`
	`113`	`+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services`
	`114`	`+ * service.</p>`
`114`	`115`	`*`
`115`	`116`	`*`
`116`	`117`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -60,7 +60,8 @@ export interface DeleteApplicationCommandOutput extends DeleteApplicationRespons`
`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 service.</p>`
	`63`	`+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services`
	`64`	`+ * service.</p>`
`64`	`65`	`*`
`65`	`66`	`*`
`66`	`67`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -59,7 +59,8 @@ export interface GetApplicationCommandOutput extends GetApplicationResponse, __M`
`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 service.</p>`
	`62`	`+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services`
	`63`	`+ * service.</p>`
`63`	`64`	`*`
`64`	`65`	`*`
`65`	`66`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -32,7 +32,8 @@ export interface GetDashboardForJobRunCommandOutput extends GetDashboardForJobRu`
`32`	`32`
`33`	`33`	`/**`
`34`	`34`	`* @public`
`35`		`- * <p>Returns a URL to access the job run dashboard.</p>`
	`35`	`+ * <p>Returns a URL to access the job run dashboard. The generated URL is valid for one hour,`
	`36`	`+ * after which you must invoke the API again to generate a new URL.</p>`
`36`	`37`	`* @example`
`37`	`38`	`* Use a bare-bones client and the command you need to make an API call.`
`38`	`39`	* ```javascript
`@@ -60,7 +61,8 @@ export interface GetDashboardForJobRunCommandOutput extends GetDashboardForJobRu`
`60`	`61`	`* <p>The specified resource was not found.</p>`
`61`	`62`	`*`
`62`	`63`	`* @throws {@link ValidationException} (client fault)`
`63`		`- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>`
	`64`	`+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services`
	`65`	`+ * service.</p>`
`64`	`66`	`*`
`65`	`67`	`*`
`66`	`68`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -60,7 +60,8 @@ export interface GetJobRunCommandOutput extends GetJobRunResponse, __MetadataBea`
`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 service.</p>`
	`63`	`+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services`
	`64`	`+ * service.</p>`
`64`	`65`	`*`
`65`	`66`	`*`
`66`	`67`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -60,7 +60,8 @@ export interface ListApplicationsCommandOutput extends ListApplicationsResponse,`
`60`	`60`	`* <p>Request processing failed because of an error or failure with the service.</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 service.</p>`
	`63`	`+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services`
	`64`	`+ * service.</p>`
`64`	`65`	`*`
`65`	`66`	`*`
`66`	`67`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -63,7 +63,8 @@ export interface ListJobRunsCommandOutput extends ListJobRunsResponse, __Metadat`
`63`	`63`	`* <p>Request processing failed because of an error or failure with the service.</p>`
`64`	`64`	`*`
`65`	`65`	`* @throws {@link ValidationException} (client fault)`
`66`		`- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>`
	`66`	`+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services`
	`67`	`+ * service.</p>`
`67`	`68`	`*`
`68`	`69`	`*`
`69`	`70`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -59,7 +59,8 @@ export interface ListTagsForResourceCommandOutput extends ListTagsForResourceRes`
`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 service.</p>`
	`62`	`+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services`
	`63`	`+ * service.</p>`
`63`	`64`	`*`
`64`	`65`	`*`
`65`	`66`	`*/`