From 70cb5f7828eb86e07e720507769b03ccaf633dae Mon Sep 17 00:00:00 2001 From: awstools Date: Tue, 25 Jul 2023 20:10:55 +0000 Subject: [PATCH] feat(client-emr-serverless): This release adds support for publishing application logs to CloudWatch. --- clients/client-emr-serverless/README.md | 25 ++-- .../src/EMRServerless.ts | 25 ++-- .../src/EMRServerlessClient.ts | 25 ++-- .../commands/GetDashboardForJobRunCommand.ts | 11 +- .../src/commands/GetJobRunCommand.ts | 11 ++ .../src/commands/StartJobRunCommand.ts | 11 ++ clients/client-emr-serverless/src/index.ts | 25 ++-- .../src/models/models_0.ts | 92 +++++++++++-- .../src/protocols/Aws_restJson1.ts | 13 ++ .../aws-models/emr-serverless.json | 128 ++++++++++++++++-- 10 files changed, 286 insertions(+), 80 deletions(-) diff --git a/clients/client-emr-serverless/README.md b/clients/client-emr-serverless/README.md index c527fae7ce54d..449f3f7f19145 100644 --- a/clients/client-emr-serverless/README.md +++ b/clients/client-emr-serverless/README.md @@ -6,26 +6,25 @@ AWS SDK for JavaScript EMRServerless Client for Node.js, Browser and React Native. -

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.

-

The API reference to Amazon EMR Serverless is emr-serverless. The +

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.

+

The API reference to Amazon EMR Serverless is emr-serverless. The emr-serverless prefix is used in the following scenarios:

diff --git a/clients/client-emr-serverless/src/EMRServerless.ts b/clients/client-emr-serverless/src/EMRServerless.ts index 11afd7833d515..7f0c7d53f1849 100644 --- a/clients/client-emr-serverless/src/EMRServerless.ts +++ b/clients/client-emr-serverless/src/EMRServerless.ts @@ -298,26 +298,25 @@ export interface EMRServerless { /** * @public - *

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.

- *

The API reference to Amazon EMR Serverless is emr-serverless. The + *

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.

+ *

The API reference to Amazon EMR Serverless is emr-serverless. The * emr-serverless prefix is used in the following scenarios:

* */ diff --git a/clients/client-emr-serverless/src/EMRServerlessClient.ts b/clients/client-emr-serverless/src/EMRServerlessClient.ts index 3655fc9474e22..75d9cdbe404d3 100644 --- a/clients/client-emr-serverless/src/EMRServerlessClient.ts +++ b/clients/client-emr-serverless/src/EMRServerlessClient.ts @@ -284,26 +284,25 @@ export interface EMRServerlessClientResolvedConfig extends EMRServerlessClientRe /** * @public - *

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.

- *

The API reference to Amazon EMR Serverless is emr-serverless. The + *

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.

+ *

The API reference to Amazon EMR Serverless is emr-serverless. The * emr-serverless prefix is used in the following scenarios:

* */ diff --git a/clients/client-emr-serverless/src/commands/GetDashboardForJobRunCommand.ts b/clients/client-emr-serverless/src/commands/GetDashboardForJobRunCommand.ts index 8b94c2f8ec02f..585c1b691b1b3 100644 --- a/clients/client-emr-serverless/src/commands/GetDashboardForJobRunCommand.ts +++ b/clients/client-emr-serverless/src/commands/GetDashboardForJobRunCommand.ts @@ -36,8 +36,15 @@ export interface GetDashboardForJobRunCommandOutput extends GetDashboardForJobRu /** * @public - *

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.

+ *

Creates and returns a URL that you can use to access the application UIs for a job + * run.

+ *

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.

+ * + *

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.

+ * * @example * Use a bare-bones client and the command you need to make an API call. * ```javascript diff --git a/clients/client-emr-serverless/src/commands/GetJobRunCommand.ts b/clients/client-emr-serverless/src/commands/GetJobRunCommand.ts index 324c28de0cf7a..ad298c2e3ea27 100644 --- a/clients/client-emr-serverless/src/commands/GetJobRunCommand.ts +++ b/clients/client-emr-serverless/src/commands/GetJobRunCommand.ts @@ -89,6 +89,17 @@ export interface GetJobRunCommandOutput extends GetJobRunResponse, __MetadataBea * // enabled: true || false, * // encryptionKeyArn: "STRING_VALUE", * // }, + * // cloudWatchLoggingConfiguration: { // CloudWatchLoggingConfiguration + * // enabled: true || false, // required + * // logGroupName: "STRING_VALUE", + * // logStreamNamePrefix: "STRING_VALUE", + * // encryptionKeyArn: "STRING_VALUE", + * // logTypes: { // LogTypeMap + * // "": [ // LogTypeList + * // "STRING_VALUE", + * // ], + * // }, + * // }, * // }, * // }, * // jobDriver: { // JobDriver Union: only one key present diff --git a/clients/client-emr-serverless/src/commands/StartJobRunCommand.ts b/clients/client-emr-serverless/src/commands/StartJobRunCommand.ts index 21ca9ff6a040b..5f82c63f3ceb5 100644 --- a/clients/client-emr-serverless/src/commands/StartJobRunCommand.ts +++ b/clients/client-emr-serverless/src/commands/StartJobRunCommand.ts @@ -88,6 +88,17 @@ export interface StartJobRunCommandOutput extends StartJobRunResponse, __Metadat * enabled: true || false, * encryptionKeyArn: "STRING_VALUE", * }, + * cloudWatchLoggingConfiguration: { // CloudWatchLoggingConfiguration + * enabled: true || false, // required + * logGroupName: "STRING_VALUE", + * logStreamNamePrefix: "STRING_VALUE", + * encryptionKeyArn: "STRING_VALUE", + * logTypes: { // LogTypeMap + * "": [ // LogTypeList + * "STRING_VALUE", + * ], + * }, + * }, * }, * }, * tags: { // TagMap diff --git a/clients/client-emr-serverless/src/index.ts b/clients/client-emr-serverless/src/index.ts index 673430d2f50b4..0921ea79afcc2 100644 --- a/clients/client-emr-serverless/src/index.ts +++ b/clients/client-emr-serverless/src/index.ts @@ -1,26 +1,25 @@ // smithy-typescript generated code /* eslint-disable */ /** - *

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.

- *

The API reference to Amazon EMR Serverless is emr-serverless. The + *

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.

+ *

The API reference to Amazon EMR Serverless is emr-serverless. The * emr-serverless prefix is used in the following scenarios:

*
    *
  • - *

    It is the prefix in the CLI commands for Amazon EMR Serverless. For example, - * aws emr-serverless start-job-run.

    + *

    It is the prefix in the CLI commands for Amazon EMR Serverless. For + * example, aws emr-serverless start-job-run.

    *
    • *
  • - *

    It is the prefix before IAM policy actions for Amazon EMR Serverless. For example, - * "Action": ["emr-serverless:StartJobRun"]. For more information, see - * Policy actions for Amazon EMR Serverless.

    + *

    It is the prefix before IAM policy actions for Amazon EMR Serverless. For + * example, "Action": ["emr-serverless:StartJobRun"]. For more information, + * see Policy actions for Amazon EMR Serverless.

    *
    • *
  • - *

    It is the prefix used in Amazon EMR Serverless service endpoints. For example, - * emr-serverless.us-east-2.amazonaws.com.

    + *

    It is the prefix used in Amazon EMR Serverless service endpoints. For + * example, emr-serverless.us-east-2.amazonaws.com.

    *
    • *
* diff --git a/clients/client-emr-serverless/src/models/models_0.ts b/clients/client-emr-serverless/src/models/models_0.ts index 17dbf77e72d52..d713592971b60 100644 --- a/clients/client-emr-serverless/src/models/models_0.ts +++ b/clients/client-emr-serverless/src/models/models_0.ts @@ -173,7 +173,8 @@ export interface WorkerTypeSpecification { /** * @public - *

Information about an application. Amazon EMR Serverless uses applications to run jobs.

+ *

Information about an application. Amazon EMR Serverless uses applications to run + * jobs.

*/ export interface Application { /** @@ -354,8 +355,8 @@ export class ConflictException extends __BaseException { export interface ImageConfigurationInput { /** *

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.

+ * new application. If you leave this field blank in an update, Amazon EMR will remove + * the image configuration.

*/ imageUri?: string; } @@ -723,7 +724,8 @@ export interface UpdateApplicationRequest { workerTypeSpecifications?: Record; /** - *

The Amazon EMR release label for the application. You can change the release label to use a different release of Amazon EMR.

+ *

The Amazon EMR release label for the application. You can change the release + * label to use a different release of Amazon EMR.

*/ releaseLabel?: string; } @@ -832,6 +834,59 @@ export interface ResourceUtilization { storageGBHour?: number; } +/** + * @public + *

The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs + * to send log information to CloudWatch.

+ */ +export interface CloudWatchLoggingConfiguration { + /** + *

Enables CloudWatch logging.

+ */ + enabled: boolean | undefined; + + /** + *

The name of the log group in Amazon CloudWatch Logs where you want to publish your + * logs.

+ */ + logGroupName?: string; + + /** + *

Prefix for the CloudWatch log stream name.

+ */ + logStreamNamePrefix?: string; + + /** + *

The Key Management Service (KMS) key ARN to encrypt the logs that you store in CloudWatch Logs.

+ */ + encryptionKeyArn?: string; + + /** + *

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 + * Logging for + * EMR Serverless with CloudWatch.

+ *
    + *
  • + *

    + * Key Valid Values: SPARK_DRIVER, + * SPARK_EXECUTOR, HIVE_DRIVER, + * TEZ_TASK + *

    + *
    • + *
  • + *

    + * Array Members Valid Values: STDOUT, + * STDERR, HIVE_LOG, TEZ_AM, + * SYSTEM_LOGS + *

    + *
    • + *
+ */ + logTypes?: Record; +} + /** * @public *

The managed log persistence configuration for a job run.

@@ -880,6 +935,12 @@ export interface MonitoringConfiguration { *

The managed log persistence configuration for a job run.

*/ managedPersistenceMonitoringConfiguration?: ManagedPersistenceMonitoringConfiguration; + + /** + *

The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs + * to send log information to CloudWatch.

+ */ + cloudWatchLoggingConfiguration?: CloudWatchLoggingConfiguration; } /** @@ -1108,7 +1169,8 @@ export interface JobRunSummary { stateDetails: string | undefined; /** - *

The Amazon EMR release associated with the application your job is running on.

+ *

The Amazon EMR release associated with the application your job is running + * on.

*/ releaseLabel: string | undefined; @@ -1160,7 +1222,7 @@ export interface StartJobRunResponse { export interface ListTagsForResourceRequest { /** *

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 + * Currently, the supported resources are Amazon EMR Serverless applications and job * runs.

*/ resourceArn: string | undefined; @@ -1182,7 +1244,7 @@ export interface ListTagsForResourceResponse { export interface TagResourceRequest { /** *

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 + * Currently, the supported resources are Amazon EMR Serverless applications and job * runs.

*/ resourceArn: string | undefined; @@ -1204,7 +1266,7 @@ export interface TagResourceResponse {} export interface UntagResourceRequest { /** *

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 + * Currently, the supported resources are Amazon EMR Serverless applications and job * runs.

*/ resourceArn: string | undefined; @@ -1263,7 +1325,8 @@ export interface ConfigurationOverrides { /** * @public *

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.

+ * query, or SparkSQL query, that you submit to an Amazon EMR Serverless + * application.

*/ export interface JobRun { /** @@ -1317,7 +1380,8 @@ export interface JobRun { stateDetails: string | undefined; /** - *

The Amazon EMR release associated with the application your job is running on.

+ *

The Amazon EMR release associated with the application your job is running + * on.

*/ releaseLabel: string | undefined; @@ -1361,10 +1425,10 @@ export interface JobRun { executionTimeoutMinutes?: number; /** - *

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.

+ *

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.

*/ 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 7cbab3241d1f8..14f2be4f81343 100644 --- a/clients/client-emr-serverless/src/protocols/Aws_restJson1.ts +++ b/clients/client-emr-serverless/src/protocols/Aws_restJson1.ts @@ -53,6 +53,7 @@ import { ApplicationSummary, AutoStartConfig, AutoStopConfig, + CloudWatchLoggingConfiguration, Configuration, ConfigurationOverrides, ConflictException, @@ -1473,6 +1474,8 @@ const de_ValidationExceptionRes = async (parsedOutput: any, context: __SerdeCont // se_AutoStopConfig omitted. +// se_CloudWatchLoggingConfiguration omitted. + /** * serializeAws_restJson1Configuration */ @@ -1517,6 +1520,10 @@ const se_ConfigurationOverrides = (input: ConfigurationOverrides, context: __Ser // se_JobDriver omitted. +// se_LogTypeList omitted. + +// se_LogTypeMap omitted. + // se_ManagedPersistenceMonitoringConfiguration omitted. // se_MaximumAllowedResources omitted. @@ -1603,6 +1610,8 @@ const de_ApplicationSummary = (output: any, context: __SerdeContext): Applicatio // de_AutoStopConfig omitted. +// de_CloudWatchLoggingConfiguration omitted. + /** * deserializeAws_restJson1Configuration */ @@ -1707,6 +1716,10 @@ const de_JobRunSummary = (output: any, context: __SerdeContext): JobRunSummary = }) as any; }; +// de_LogTypeList omitted. + +// de_LogTypeMap omitted. + // de_ManagedPersistenceMonitoringConfiguration omitted. // de_MaximumAllowedResources omitted. diff --git a/codegen/sdk-codegen/aws-models/emr-serverless.json b/codegen/sdk-codegen/aws-models/emr-serverless.json index a10a8ad4b5308..4b43e0477fd7a 100644 --- a/codegen/sdk-codegen/aws-models/emr-serverless.json +++ b/codegen/sdk-codegen/aws-models/emr-serverless.json @@ -122,7 +122,7 @@ } }, "traits": { - "smithy.api#documentation": "

Information about an application. Amazon EMR Serverless uses applications to run jobs.

" + "smithy.api#documentation": "

Information about an application. Amazon EMR Serverless uses applications to run\n jobs.

" } }, "com.amazonaws.emrserverless#ApplicationArn": { @@ -423,7 +423,7 @@ ], "additionalExposedHeaders": ["x-amzn-errortype", "x-amzn-requestid", "x-amzn-trace-id", "x-amz-apigw-id"] }, - "smithy.api#documentation": "

Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides\n a serverless runtime environment that simplifies running analytics applications using the\n latest open source frameworks such as Apache Spark and Apache Hive. With Amazon EMR Serverless,\n you don’t have to configure, optimize, secure, or operate clusters to run applications with\n these frameworks.

\n

The API reference to Amazon EMR Serverless is emr-serverless. The\n emr-serverless prefix is used in the following scenarios:

\n
    \n
  • \n

    It is the prefix in the CLI commands for Amazon EMR Serverless. For example,\n aws emr-serverless start-job-run.

    \n
    • \n
  • \n

    It is the prefix before IAM policy actions for Amazon EMR Serverless. For example,\n \"Action\": [\"emr-serverless:StartJobRun\"]. For more information, see\n Policy actions for Amazon EMR Serverless.

    \n
    • \n
  • \n

    It is the prefix used in Amazon EMR Serverless service endpoints. For example,\n emr-serverless.us-east-2.amazonaws.com.

    \n
    • \n
", + "smithy.api#documentation": "

Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running\n analytics applications using the latest open source frameworks such as Apache Spark and\n Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize,\n secure, or operate clusters to run applications with these frameworks.

\n

The API reference to Amazon EMR Serverless is emr-serverless. The\n emr-serverless prefix is used in the following scenarios:

\n
    \n
  • \n

    It is the prefix in the CLI commands for Amazon EMR Serverless. For\n example, aws emr-serverless start-job-run.

    \n
    • \n
  • \n

    It is the prefix before IAM policy actions for Amazon EMR Serverless. For\n example, \"Action\": [\"emr-serverless:StartJobRun\"]. For more information,\n see Policy actions for Amazon EMR Serverless.

    \n
    • \n
  • \n

    It is the prefix used in Amazon EMR Serverless service endpoints. For\n example, emr-serverless.us-east-2.amazonaws.com.

    \n
    • \n
", "smithy.api#title": "EMR Serverless", "smithy.rules#endpointRuleSet": { "version": "1.0", @@ -1225,6 +1225,45 @@ "smithy.api#pattern": "^[A-Za-z0-9._-]+$" } }, + "com.amazonaws.emrserverless#CloudWatchLoggingConfiguration": { + "type": "structure", + "members": { + "enabled": { + "target": "smithy.api#Boolean", + "traits": { + "smithy.api#documentation": "

Enables CloudWatch logging.

", + "smithy.api#required": {} + } + }, + "logGroupName": { + "target": "com.amazonaws.emrserverless#LogGroupName", + "traits": { + "smithy.api#documentation": "

The name of the log group in Amazon CloudWatch Logs where you want to publish your\n logs.

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

Prefix for the CloudWatch log stream name.

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

The Key Management Service (KMS) key ARN to encrypt the logs that you store in CloudWatch Logs.

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

The types of logs that you want to publish to CloudWatch. If you don't specify\n any log types, driver STDOUT and STDERR logs will be published to CloudWatch Logs by\n default. For more information including the supported worker types for Hive and Spark, see\n Logging for\n EMR Serverless with CloudWatch.

\n
    \n
  • \n

    \n Key Valid Values: SPARK_DRIVER,\n SPARK_EXECUTOR, HIVE_DRIVER,\n TEZ_TASK\n

    \n
    • \n
  • \n

    \n Array Members Valid Values: STDOUT,\n STDERR, HIVE_LOG, TEZ_AM,\n SYSTEM_LOGS\n

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

The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs\n to send log information to CloudWatch.

" + } + }, "com.amazonaws.emrserverless#Configuration": { "type": "structure", "members": { @@ -1645,7 +1684,7 @@ } ], "traits": { - "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#documentation": "

Creates and returns a URL that you can use to access the application UIs for a job\n run.

\n

For jobs in a running state, the application UI is a live user interface such as the\n Spark or Tez web UI. For completed jobs, the application UI is a persistent application\n user interface such as the Spark History Server or persistent Tez UI.

\n \n

The URL is valid for one hour after you generate it. To access the application UI\n after that hour elapses, you must invoke the API again to generate a new URL.

\n ", "smithy.api#http": { "method": "GET", "uri": "/applications/{applicationId}/jobruns/{jobRunId}/dashboard" @@ -1827,7 +1866,7 @@ "imageUri": { "target": "com.amazonaws.emrserverless#ImageUri", "traits": { - "smithy.api#documentation": "

The URI of an image in the Amazon ECR registry. This field is required when you create a\n new application. If you leave this field blank in an update, Amazon EMR will remove the\n image configuration.

" + "smithy.api#documentation": "

The URI of an image in the Amazon ECR registry. This field is required when you create a\n new application. If you leave this field blank in an update, Amazon EMR will remove\n the image configuration.

" } } }, @@ -2023,7 +2062,7 @@ "releaseLabel": { "target": "com.amazonaws.emrserverless#ReleaseLabel", "traits": { - "smithy.api#documentation": "

The Amazon EMR release associated with the application your job is running on.

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

The Amazon EMR release associated with the application your job is running\n on.

", "smithy.api#required": {} } }, @@ -2071,12 +2110,12 @@ "billedResourceUtilization": { "target": "com.amazonaws.emrserverless#ResourceUtilization", "traits": { - "smithy.api#documentation": "

The aggregate vCPU, memory, and storage that Amazon Web Services 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.

" + "smithy.api#documentation": "

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

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

Information about a job run. A job run is a unit of work, such as a Spark JAR, Hive\n query, or SparkSQL query, that you submit to an Amazon EMR Serverless application.

" + "smithy.api#documentation": "

Information about a job run. A job run is a unit of work, such as a Spark JAR, Hive\n query, or SparkSQL query, that you submit to an Amazon EMR Serverless\n application.

" } }, "com.amazonaws.emrserverless#JobRunId": { @@ -2246,7 +2285,7 @@ "releaseLabel": { "target": "com.amazonaws.emrserverless#ReleaseLabel", "traits": { - "smithy.api#documentation": "

The Amazon EMR release associated with the application your job is running on.

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

The Amazon EMR release associated with the application your job is running\n on.

", "smithy.api#required": {} } }, @@ -2487,7 +2526,7 @@ "resourceArn": { "target": "com.amazonaws.emrserverless#ResourceArn", "traits": { - "smithy.api#documentation": "

The Amazon Resource Name (ARN) that identifies the resource to list the tags for.\n Currently, the supported resources are Amazon EMR Serverless applications and job\n runs.

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

The Amazon Resource Name (ARN) that identifies the resource to list the tags for.\n Currently, the supported resources are Amazon EMR Serverless applications and job\n runs.

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } @@ -2505,6 +2544,64 @@ } } }, + "com.amazonaws.emrserverless#LogGroupName": { + "type": "string", + "traits": { + "smithy.api#length": { + "min": 1, + "max": 512 + }, + "smithy.api#pattern": "^[\\.\\-_/#A-Za-z0-9]+$" + } + }, + "com.amazonaws.emrserverless#LogStreamNamePrefix": { + "type": "string", + "traits": { + "smithy.api#length": { + "min": 1, + "max": 512 + }, + "smithy.api#pattern": "^[^:*]*$" + } + }, + "com.amazonaws.emrserverless#LogTypeList": { + "type": "list", + "member": { + "target": "com.amazonaws.emrserverless#LogTypeString" + }, + "traits": { + "smithy.api#length": { + "min": 1, + "max": 5 + } + } + }, + "com.amazonaws.emrserverless#LogTypeMap": { + "type": "map", + "key": { + "target": "com.amazonaws.emrserverless#WorkerTypeString" + }, + "value": { + "target": "com.amazonaws.emrserverless#LogTypeList" + }, + "traits": { + "smithy.api#length": { + "min": 1, + "max": 4 + } + } + }, + "com.amazonaws.emrserverless#LogTypeString": { + "type": "string", + "traits": { + "smithy.api#documentation": "Log type for a Spark/Hive job-run.", + "smithy.api#length": { + "min": 1, + "max": 50 + }, + "smithy.api#pattern": "^[a-zA-Z]+[-_]*[a-zA-Z]+$" + } + }, "com.amazonaws.emrserverless#ManagedPersistenceMonitoringConfiguration": { "type": "structure", "members": { @@ -2577,6 +2674,12 @@ "traits": { "smithy.api#documentation": "

The managed log persistence configuration for a job run.

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

The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs\n to send log information to CloudWatch.

" + } } }, "traits": { @@ -3134,7 +3237,7 @@ "resourceArn": { "target": "com.amazonaws.emrserverless#ResourceArn", "traits": { - "smithy.api#documentation": "

The Amazon Resource Name (ARN) that identifies the resource to list the tags for.\n Currently, the supported resources are Amazon EMR Serverless applications and job\n runs.

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

The Amazon Resource Name (ARN) that identifies the resource to list the tags for.\n Currently, the supported resources are Amazon EMR Serverless applications and job\n runs.

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } @@ -3222,7 +3325,7 @@ "resourceArn": { "target": "com.amazonaws.emrserverless#ResourceArn", "traits": { - "smithy.api#documentation": "

The Amazon Resource Name (ARN) that identifies the resource to list the tags for.\n Currently, the supported resources are Amazon EMR Serverless applications and job\n runs.

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

The Amazon Resource Name (ARN) that identifies the resource to list the tags for.\n Currently, the supported resources are Amazon EMR Serverless applications and job\n runs.

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } @@ -3336,7 +3439,7 @@ "releaseLabel": { "target": "com.amazonaws.emrserverless#ReleaseLabel", "traits": { - "smithy.api#documentation": "

The Amazon EMR release label for the application. You can change the release label to use a different release of Amazon EMR.

" + "smithy.api#documentation": "

The Amazon EMR release label for the application. You can change the release\n label to use a different release of Amazon EMR.

" } } } @@ -3475,6 +3578,7 @@ "com.amazonaws.emrserverless#WorkerTypeString": { "type": "string", "traits": { + "smithy.api#documentation": "Worker type for an analytics framework.", "smithy.api#length": { "min": 1, "max": 50