From 6f369a93f2d645c6217c31aabb38fc25d23c14ea Mon Sep 17 00:00:00 2001 From: awstools Date: Mon, 17 Apr 2023 18:16:20 +0000 Subject: [PATCH] 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. --- .../src/EMRServerless.ts | 13 +- .../src/commands/CancelJobRunCommand.ts | 3 +- .../src/commands/CreateApplicationCommand.ts | 3 +- .../src/commands/DeleteApplicationCommand.ts | 3 +- .../src/commands/GetApplicationCommand.ts | 3 +- .../commands/GetDashboardForJobRunCommand.ts | 6 +- .../src/commands/GetJobRunCommand.ts | 3 +- .../src/commands/ListApplicationsCommand.ts | 3 +- .../src/commands/ListJobRunsCommand.ts | 3 +- .../commands/ListTagsForResourceCommand.ts | 3 +- .../src/commands/StartApplicationCommand.ts | 3 +- .../src/commands/StartJobRunCommand.ts | 3 +- .../src/commands/StopApplicationCommand.ts | 3 +- .../src/commands/TagResourceCommand.ts | 13 +- .../src/commands/UntagResourceCommand.ts | 3 +- .../src/commands/UpdateApplicationCommand.ts | 3 +- .../src/models/models_0.ts | 42 ++++- .../src/protocols/Aws_restJson1.ts | 13 ++ .../aws-models/emr-serverless.json | 148 +++++++++++------- 19 files changed, 184 insertions(+), 90 deletions(-) diff --git a/clients/client-emr-serverless/src/EMRServerless.ts b/clients/client-emr-serverless/src/EMRServerless.ts index 30f0977b7316..97c0e2c882c7 100644 --- 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 - *

Returns a URL to access the job run dashboard.

+ *

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.

*/ public getDashboardForJobRun( args: GetDashboardForJobRunCommandInput, @@ -467,11 +468,11 @@ export class EMRServerless extends EMRServerlessClient { /** * @public - *

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.

+ *

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.

*/ public tagResource(args: TagResourceCommandInput, options?: __HttpHandlerOptions): Promise; 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 index e7805f07b812..140e117ec6a2 100644 --- 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 *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/CreateApplicationCommand.ts b/clients/client-emr-serverless/src/commands/CreateApplicationCommand.ts index 84e54874b7d4..e95060204c74 100644 --- 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 *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/DeleteApplicationCommand.ts b/clients/client-emr-serverless/src/commands/DeleteApplicationCommand.ts index a80b729a6174..6c8b52410ec4 100644 --- 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 *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/GetApplicationCommand.ts b/clients/client-emr-serverless/src/commands/GetApplicationCommand.ts index 610c887a406a..d5c64f7dea6f 100644 --- 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 *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/GetDashboardForJobRunCommand.ts b/clients/client-emr-serverless/src/commands/GetDashboardForJobRunCommand.ts index cfcc5a351236..f5355bacb5b6 100644 --- 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 - *

Returns a URL to access the job run dashboard.

+ *

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.

* @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 *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/GetJobRunCommand.ts b/clients/client-emr-serverless/src/commands/GetJobRunCommand.ts index 0c75fcf65a83..57fb383c6724 100644 --- 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 *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/ListApplicationsCommand.ts b/clients/client-emr-serverless/src/commands/ListApplicationsCommand.ts index 67f9d8f6a67f..c415472738ed 100644 --- 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, *

Request processing failed because of an error or failure with the service.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/ListJobRunsCommand.ts b/clients/client-emr-serverless/src/commands/ListJobRunsCommand.ts index e665c4584d8c..76a42bdfae0e 100644 --- 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 *

Request processing failed because of an error or failure with the service.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/ListTagsForResourceCommand.ts b/clients/client-emr-serverless/src/commands/ListTagsForResourceCommand.ts index a3c77d6cfda0..d3b17c24a28b 100644 --- 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 *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/StartApplicationCommand.ts b/clients/client-emr-serverless/src/commands/StartApplicationCommand.ts index 3a0707d6f2d9..d145804fd7c4 100644 --- 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, *

The maximum number of resources per account has been reached.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/StartJobRunCommand.ts b/clients/client-emr-serverless/src/commands/StartJobRunCommand.ts index 294e3dd070ab..57123f4a47d7 100644 --- 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 *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/StopApplicationCommand.ts b/clients/client-emr-serverless/src/commands/StopApplicationCommand.ts index 7cf2a7497736..cd4e3dc8e911 100644 --- 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, _ *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/TagResourceCommand.ts b/clients/client-emr-serverless/src/commands/TagResourceCommand.ts index 62fbd8d3b209..773a9758a5c0 100644 --- 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 - *

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.

+ *

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.

* @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 *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/UntagResourceCommand.ts b/clients/client-emr-serverless/src/commands/UntagResourceCommand.ts index 337c43be7b0b..ef8f72d634a6 100644 --- 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 *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/commands/UpdateApplicationCommand.ts b/clients/client-emr-serverless/src/commands/UpdateApplicationCommand.ts index 7d637e56ff8f..8d44efc724e0 100644 --- 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 *

The specified resource was not found.

* * @throws {@link ValidationException} (client fault) - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

* * */ diff --git a/clients/client-emr-serverless/src/models/models_0.ts b/clients/client-emr-serverless/src/models/models_0.ts index e647f77620ae..c7a3ca640f4a 100644 --- 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 - *

The input fails to satisfy the constraints specified by an Amazon Web Services service.

+ *

The input fails to satisfy the constraints specified by an Amazon Web Services + * service.

*/ export class ValidationException extends __BaseException { readonly name: "ValidationException" = "ValidationException"; @@ -802,6 +803,30 @@ export interface GetJobRunRequest { jobRunId: string | undefined; } +/** + * @public + *

The resource utilization for memory, storage, and vCPU for jobs.

+ */ +export interface ResourceUtilization { + /** + *

The aggregated vCPU used per hour from the time the job starts executing until the job + * is terminated.

+ */ + vCPUHour?: number; + + /** + *

The aggregated memory used per hour from the time the job starts executing until the job + * is terminated.

+ */ + memoryGBHour?: number; + + /** + *

The aggregated storage used per hour from the time the job starts executing until the + * job is terminated.

+ */ + storageGBHour?: number; +} + /** * @public *

The managed log persistence configuration for a job run.

@@ -1307,8 +1332,8 @@ export interface JobRun { tags?: Record; /** - *

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.

+ *

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.

*/ 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. + *

Returns the job run timeout value from the StartJobRun call. If no timeout + * was specified, then it returns the default timeout of 720 minutes.

*/ executionTimeoutMinutes?: number; + + /** + *

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.

+ */ + billedResourceUtilization?: ResourceUtilization; } /** diff --git a/clients/client-emr-serverless/src/protocols/Aws_restJson1.ts b/clients/client-emr-serverless/src/protocols/Aws_restJson1.ts index cca3049774d6..695ebd942b13 100644 --- 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 index 70814398730c..59f823374713 100644 --- a/codegen/sdk-codegen/aws-models/emr-serverless.json +++ b/codegen/sdk-codegen/aws-models/emr-serverless.json @@ -786,8 +786,8 @@ }, "params": { "Region": "ap-northeast-1", - "UseDualStack": false, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -799,8 +799,8 @@ }, "params": { "Region": "eu-west-1", - "UseDualStack": false, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -812,8 +812,8 @@ }, "params": { "Region": "us-east-1", - "UseDualStack": false, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -825,8 +825,8 @@ }, "params": { "Region": "us-east-1", - "UseDualStack": false, - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -838,8 +838,8 @@ }, "params": { "Region": "us-west-2", - "UseDualStack": false, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -851,8 +851,8 @@ }, "params": { "Region": "us-west-2", - "UseDualStack": false, - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -864,8 +864,8 @@ }, "params": { "Region": "us-east-1", - "UseDualStack": true, - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": true } }, { @@ -877,8 +877,8 @@ }, "params": { "Region": "us-east-1", - "UseDualStack": true, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": true } }, { @@ -890,8 +890,8 @@ }, "params": { "Region": "cn-north-1", - "UseDualStack": true, - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": true } }, { @@ -903,8 +903,8 @@ }, "params": { "Region": "cn-north-1", - "UseDualStack": false, - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -916,8 +916,8 @@ }, "params": { "Region": "cn-north-1", - "UseDualStack": true, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": true } }, { @@ -929,8 +929,8 @@ }, "params": { "Region": "cn-north-1", - "UseDualStack": false, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -942,8 +942,8 @@ }, "params": { "Region": "us-gov-east-1", - "UseDualStack": true, - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": true } }, { @@ -955,8 +955,8 @@ }, "params": { "Region": "us-gov-east-1", - "UseDualStack": false, - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -968,8 +968,8 @@ }, "params": { "Region": "us-gov-east-1", - "UseDualStack": true, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": true } }, { @@ -981,8 +981,8 @@ }, "params": { "Region": "us-gov-east-1", - "UseDualStack": false, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -992,8 +992,8 @@ }, "params": { "Region": "us-iso-east-1", - "UseDualStack": true, - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": true } }, { @@ -1005,8 +1005,8 @@ }, "params": { "Region": "us-iso-east-1", - "UseDualStack": false, - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -1016,8 +1016,8 @@ }, "params": { "Region": "us-iso-east-1", - "UseDualStack": true, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": true } }, { @@ -1029,8 +1029,8 @@ }, "params": { "Region": "us-iso-east-1", - "UseDualStack": false, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -1040,8 +1040,8 @@ }, "params": { "Region": "us-isob-east-1", - "UseDualStack": true, - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": true } }, { @@ -1053,8 +1053,8 @@ }, "params": { "Region": "us-isob-east-1", - "UseDualStack": false, - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -1064,8 +1064,8 @@ }, "params": { "Region": "us-isob-east-1", - "UseDualStack": true, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": true } }, { @@ -1077,8 +1077,8 @@ }, "params": { "Region": "us-isob-east-1", - "UseDualStack": false, - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -1090,8 +1090,8 @@ }, "params": { "Region": "us-east-1", - "UseDualStack": false, "UseFIPS": false, + "UseDualStack": false, "Endpoint": "https://example.com" } }, @@ -1103,8 +1103,8 @@ } }, "params": { - "UseDualStack": false, "UseFIPS": false, + "UseDualStack": false, "Endpoint": "https://example.com" } }, @@ -1115,8 +1115,8 @@ }, "params": { "Region": "us-east-1", - "UseDualStack": false, "UseFIPS": true, + "UseDualStack": false, "Endpoint": "https://example.com" } }, @@ -1127,8 +1127,8 @@ }, "params": { "Region": "us-east-1", - "UseDualStack": true, "UseFIPS": false, + "UseDualStack": true, "Endpoint": "https://example.com" } }, @@ -1645,7 +1645,7 @@ } ], "traits": { - "smithy.api#documentation": "

Returns a URL to access the job run dashboard.

", + "smithy.api#documentation": "

Returns a URL to access the job run dashboard. The generated URL is valid for one hour,\n after which you must invoke the API again to generate a new URL.

", "smithy.api#http": { "method": "GET", "uri": "/applications/{applicationId}/jobruns/{jobRunId}/dashboard" @@ -1838,14 +1838,12 @@ "com.amazonaws.emrserverless#ImageDigest": { "type": "string", "traits": { - "smithy.api#documentation": "Image Digest", "smithy.api#pattern": "^sha256:[0-9a-f]{64}$" } }, "com.amazonaws.emrserverless#ImageUri": { "type": "string", "traits": { - "smithy.api#documentation": "Image URI", "smithy.api#length": { "min": 1, "max": 1024 @@ -2051,7 +2049,7 @@ "totalResourceUtilization": { "target": "com.amazonaws.emrserverless#TotalResourceUtilization", "traits": { - "smithy.api#documentation": "

The aggregate vCPU, memory, and storage resources used from the time job start executing\n till the time job is terminated, rounded up to the nearest second.

" + "smithy.api#documentation": "

The aggregate vCPU, memory, and storage resources used from the time the job starts to\n execute, until the time the job terminates, rounded up to the nearest second.

" } }, "networkConfiguration": { @@ -2067,7 +2065,13 @@ "target": "com.amazonaws.emrserverless#Duration", "traits": { "smithy.api#default": null, - "smithy.api#documentation": "Maximum duration for the job run to run. If the job run runs beyond this duration, it will be automatically cancelled." + "smithy.api#documentation": "

Returns the job run timeout value from the StartJobRun call. If no timeout\n was specified, then it returns the default timeout of 720 minutes.

" + } + }, + "billedResourceUtilization": { + "target": "com.amazonaws.emrserverless#ResourceUtilization", + "traits": { + "smithy.api#documentation": "

The aggregate vCPU, memory, and storage that AWS has billed for the job run. The billed\n resources include a 1-minute minimum usage for workers, plus additional storage over 20 GB\n per worker. Note that billed resources do not include usage for idle pre-initialized\n workers.

" } } }, @@ -2666,6 +2670,32 @@ "smithy.api#httpError": 404 } }, + "com.amazonaws.emrserverless#ResourceUtilization": { + "type": "structure", + "members": { + "vCPUHour": { + "target": "smithy.api#Double", + "traits": { + "smithy.api#documentation": "

The aggregated vCPU used per hour from the time the job starts executing until the job\n is terminated.

" + } + }, + "memoryGBHour": { + "target": "smithy.api#Double", + "traits": { + "smithy.api#documentation": "

The aggregated memory used per hour from the time the job starts executing until the job\n is terminated.

" + } + }, + "storageGBHour": { + "target": "smithy.api#Double", + "traits": { + "smithy.api#documentation": "

The aggregated storage used per hour from the time the job starts executing until the\n job is terminated.

" + } + } + }, + "traits": { + "smithy.api#documentation": "

The resource utilization for memory, storage, and vCPU for jobs.

" + } + }, "com.amazonaws.emrserverless#S3MonitoringConfiguration": { "type": "structure", "members": { @@ -3091,7 +3121,7 @@ } ], "traits": { - "smithy.api#documentation": "

Assigns tags to resources. A tag is a label that you assign to an Amazon Web Services resource. Each tag\n consists of a key and an optional value, both of which you define. Tags enable you to\n categorize your Amazon Web Services resources by attributes such as purpose, owner, or environment. When\n you have many resources of the same type, you can quickly identify a specific resource\n based on the tags you've assigned to it.

", + "smithy.api#documentation": "

Assigns tags to resources. A tag is a label that you assign to an Amazon Web Services\n resource. Each tag consists of a key and an optional value, both of which you define. Tags\n enable you to categorize your Amazon Web Services resources by attributes such as purpose,\n owner, or environment. When you have many resources of the same type, you can quickly\n identify a specific resource based on the tags you've assigned to it.

", "smithy.api#http": { "method": "POST", "uri": "/tags/{resourceArn}" @@ -3347,7 +3377,7 @@ } }, "traits": { - "smithy.api#documentation": "

The input fails to satisfy the constraints specified by an Amazon Web Services service.

", + "smithy.api#documentation": "

The input fails to satisfy the constraints specified by an Amazon Web Services\n service.

", "smithy.api#error": "client", "smithy.api#httpError": 400 }