feat(client-emr-serverless): This release adds support for publishing…

… application logs to CloudWatch.
aws · Jul 25, 2023 · 70cb5f7 · 70cb5f7
1 parent 691ecdb
commit 70cb5f7
Show file tree

Hide file tree

Showing 10 changed files with 286 additions and 80 deletions.
diff --git 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.
 
-<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
+<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>
+<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>
+<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>
+<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>
 

diff --git a/clients/client-emr-serverless/src/EMRServerless.ts b/clients/client-emr-serverless/src/EMRServerless.ts
@@ -298,26 +298,25 @@ export interface EMRServerless {
 
 /**
  * @public
- * <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
+ * <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>
+ *                <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>
+ *                <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>
+ *                <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>
  */

diff --git 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
- * <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
+ * <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>
+ *                <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>
+ *                <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>
+ *                <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>
  */

diff --git 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
- * <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>
+ * <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>
  * @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
@@ -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
+ * //             "<keys>": [ // 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
@@ -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
+ *           "<keys>": [ // LogTypeList
+ *             "STRING_VALUE",
+ *           ],
+ *         },
+ *       },
  *     },
  *   },
  *   tags: { // TagMap

diff --git 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 */
 /**
- * <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
+ * <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>
+ *                <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>
+ *                <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>
+ *                <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>
  *