@aws-sdk/client-athena 3.47.2 → 3.51.0

package/CHANGELOG.md

@@ -3,6 +3,44 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.51.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.50.0...v3.51.0) (2022-02-12)
+
+**Note:** Version bump only for package @aws-sdk/client-athena
+
+
+
+
+
+# [3.50.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.49.0...v3.50.0) (2022-02-08)
+
+
+### Features
+
+* **clients:** update clients as of 02/04/2022 ([#3280](https://github.com/aws/aws-sdk-js-v3/issues/3280)) ([63d7f8c](https://github.com/aws/aws-sdk-js-v3/commit/63d7f8c539e0fd782fa5bf997bd6ac2730e4bfda))
+
+
+
+
+
+# [3.49.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.48.0...v3.49.0) (2022-01-29)
+
+
+### Features
+
+* **clients:** update clients as of 01/28/2022 ([#3263](https://github.com/aws/aws-sdk-js-v3/issues/3263)) ([c207cf4](https://github.com/aws/aws-sdk-js-v3/commit/c207cf4a70ba9ef14dc5b94da7883b0889d64918))
+
+
+
+
+
+# [3.48.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.47.2...v3.48.0) (2022-01-22)
+
+**Note:** Version bump only for package @aws-sdk/client-athena
+
+
+
+
+
 ## [3.47.2](https://github.com/aws/aws-sdk-js-v3/compare/v3.47.1...v3.47.2) (2022-01-21)
 
 **Note:** Version bump only for package @aws-sdk/client-athena

package/dist-cjs/models/models_0.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetQueryResultsInput = exports.GetQueryExecutionOutput = exports.GetQueryExecutionInput = exports.GetPreparedStatementOutput = exports.PreparedStatement = exports.GetPreparedStatementInput = exports.GetNamedQueryOutput = exports.GetNamedQueryInput = exports.GetDataCatalogOutput = exports.DataCatalog = exports.GetDataCatalogInput = exports.GetDatabaseOutput = exports.Database = exports.GetDatabaseInput = exports.DeleteWorkGroupOutput = exports.DeleteWorkGroupInput = exports.DeletePreparedStatementOutput = exports.DeletePreparedStatementInput = exports.DeleteNamedQueryOutput = exports.DeleteNamedQueryInput = exports.DeleteDataCatalogOutput = exports.DeleteDataCatalogInput = exports.CreateWorkGroupOutput = exports.CreateWorkGroupInput = exports.WorkGroupConfiguration = exports.CreatePreparedStatementOutput = exports.CreatePreparedStatementInput = exports.CreateNamedQueryOutput = exports.CreateNamedQueryInput = exports.CreateDataCatalogOutput = exports.CreateDataCatalogInput = exports.DataCatalogType = exports.Tag = exports.BatchGetQueryExecutionOutput = exports.UnprocessedQueryExecutionId = exports.QueryExecution = exports.QueryExecutionStatus = exports.QueryExecutionState = exports.QueryExecutionStatistics = exports.StatementType = exports.ResultConfiguration = exports.EncryptionConfiguration = exports.EncryptionOption = exports.QueryExecutionContext = exports.EngineVersion = exports.BatchGetQueryExecutionInput = exports.BatchGetNamedQueryOutput = exports.UnprocessedNamedQueryId = exports.NamedQuery = exports.BatchGetNamedQueryInput = void 0;
-exports.ResultConfigurationUpdates = exports.UpdatePreparedStatementOutput = exports.UpdatePreparedStatementInput = exports.UpdateDataCatalogOutput = exports.UpdateDataCatalogInput = exports.UntagResourceOutput = exports.UntagResourceInput = exports.TagResourceOutput = exports.TagResourceInput = exports.StopQueryExecutionOutput = exports.StopQueryExecutionInput = exports.ThrottleReason = exports.StartQueryExecutionOutput = exports.StartQueryExecutionInput = exports.ListWorkGroupsOutput = exports.WorkGroupSummary = exports.ListWorkGroupsInput = exports.ListTagsForResourceOutput = exports.ListTagsForResourceInput = exports.ListTableMetadataOutput = exports.ListTableMetadataInput = exports.ListQueryExecutionsOutput = exports.ListQueryExecutionsInput = exports.ListPreparedStatementsOutput = exports.PreparedStatementSummary = exports.ListPreparedStatementsInput = exports.ListNamedQueriesOutput = exports.ListNamedQueriesInput = exports.ListEngineVersionsOutput = exports.ListEngineVersionsInput = exports.ListDataCatalogsOutput = exports.DataCatalogSummary = exports.ListDataCatalogsInput = exports.ListDatabasesOutput = exports.ListDatabasesInput = exports.GetWorkGroupOutput = exports.WorkGroup = exports.WorkGroupState = exports.GetWorkGroupInput = exports.GetTableMetadataOutput = exports.TableMetadata = exports.Column = exports.GetTableMetadataInput = exports.GetQueryResultsOutput = exports.ResultSet = exports.Row = exports.Datum = exports.ResultSetMetadata = exports.ColumnInfo = exports.ColumnNullable = void 0;
-exports.UpdateWorkGroupOutput = exports.UpdateWorkGroupInput = exports.WorkGroupConfigurationUpdates = void 0;
+exports.GetQueryExecutionOutput = exports.GetQueryExecutionInput = exports.GetPreparedStatementOutput = exports.PreparedStatement = exports.GetPreparedStatementInput = exports.GetNamedQueryOutput = exports.GetNamedQueryInput = exports.GetDataCatalogOutput = exports.DataCatalog = exports.GetDataCatalogInput = exports.GetDatabaseOutput = exports.Database = exports.GetDatabaseInput = exports.DeleteWorkGroupOutput = exports.DeleteWorkGroupInput = exports.DeletePreparedStatementOutput = exports.DeletePreparedStatementInput = exports.DeleteNamedQueryOutput = exports.DeleteNamedQueryInput = exports.DeleteDataCatalogOutput = exports.DeleteDataCatalogInput = exports.CreateWorkGroupOutput = exports.CreateWorkGroupInput = exports.WorkGroupConfiguration = exports.CreatePreparedStatementOutput = exports.CreatePreparedStatementInput = exports.CreateNamedQueryOutput = exports.CreateNamedQueryInput = exports.CreateDataCatalogOutput = exports.CreateDataCatalogInput = exports.DataCatalogType = exports.Tag = exports.BatchGetQueryExecutionOutput = exports.UnprocessedQueryExecutionId = exports.QueryExecution = exports.QueryExecutionStatus = exports.QueryExecutionState = exports.AthenaError = exports.QueryExecutionStatistics = exports.StatementType = exports.ResultConfiguration = exports.EncryptionConfiguration = exports.EncryptionOption = exports.QueryExecutionContext = exports.EngineVersion = exports.BatchGetQueryExecutionInput = exports.BatchGetNamedQueryOutput = exports.UnprocessedNamedQueryId = exports.NamedQuery = exports.BatchGetNamedQueryInput = void 0;
+exports.UpdatePreparedStatementOutput = exports.UpdatePreparedStatementInput = exports.UpdateDataCatalogOutput = exports.UpdateDataCatalogInput = exports.UntagResourceOutput = exports.UntagResourceInput = exports.TagResourceOutput = exports.TagResourceInput = exports.StopQueryExecutionOutput = exports.StopQueryExecutionInput = exports.ThrottleReason = exports.StartQueryExecutionOutput = exports.StartQueryExecutionInput = exports.ListWorkGroupsOutput = exports.WorkGroupSummary = exports.ListWorkGroupsInput = exports.ListTagsForResourceOutput = exports.ListTagsForResourceInput = exports.ListTableMetadataOutput = exports.ListTableMetadataInput = exports.ListQueryExecutionsOutput = exports.ListQueryExecutionsInput = exports.ListPreparedStatementsOutput = exports.PreparedStatementSummary = exports.ListPreparedStatementsInput = exports.ListNamedQueriesOutput = exports.ListNamedQueriesInput = exports.ListEngineVersionsOutput = exports.ListEngineVersionsInput = exports.ListDataCatalogsOutput = exports.DataCatalogSummary = exports.ListDataCatalogsInput = exports.ListDatabasesOutput = exports.ListDatabasesInput = exports.GetWorkGroupOutput = exports.WorkGroup = exports.WorkGroupState = exports.GetWorkGroupInput = exports.GetTableMetadataOutput = exports.TableMetadata = exports.Column = exports.GetTableMetadataInput = exports.GetQueryResultsOutput = exports.ResultSet = exports.Row = exports.Datum = exports.ResultSetMetadata = exports.ColumnInfo = exports.ColumnNullable = exports.GetQueryResultsInput = void 0;
+exports.UpdateWorkGroupOutput = exports.UpdateWorkGroupInput = exports.WorkGroupConfigurationUpdates = exports.ResultConfigurationUpdates = void 0;
 var BatchGetNamedQueryInput;
 (function (BatchGetNamedQueryInput) {
     BatchGetNamedQueryInput.filterSensitiveLog = (obj) => ({
@@ -75,6 +75,12 @@ var QueryExecutionStatistics;
         ...obj,
     });
 })(QueryExecutionStatistics = exports.QueryExecutionStatistics || (exports.QueryExecutionStatistics = {}));
+var AthenaError;
+(function (AthenaError) {
+    AthenaError.filterSensitiveLog = (obj) => ({
+        ...obj,
+    });
+})(AthenaError = exports.AthenaError || (exports.AthenaError = {}));
 var QueryExecutionState;
 (function (QueryExecutionState) {
     QueryExecutionState["CANCELLED"] = "CANCELLED";

package/dist-cjs/protocols/Aws_json1_1.js

@@ -2607,6 +2607,8 @@ const serializeAws_json1_1ResultConfiguration = (input, context) => {
             input.EncryptionConfiguration !== null && {
             EncryptionConfiguration: serializeAws_json1_1EncryptionConfiguration(input.EncryptionConfiguration, context),
         }),
+        ...(input.ExpectedBucketOwner !== undefined &&
+            input.ExpectedBucketOwner !== null && { ExpectedBucketOwner: input.ExpectedBucketOwner }),
         ...(input.OutputLocation !== undefined &&
             input.OutputLocation !== null && { OutputLocation: input.OutputLocation }),
     };
@@ -2617,12 +2619,16 @@ const serializeAws_json1_1ResultConfigurationUpdates = (input, context) => {
             input.EncryptionConfiguration !== null && {
             EncryptionConfiguration: serializeAws_json1_1EncryptionConfiguration(input.EncryptionConfiguration, context),
         }),
+        ...(input.ExpectedBucketOwner !== undefined &&
+            input.ExpectedBucketOwner !== null && { ExpectedBucketOwner: input.ExpectedBucketOwner }),
         ...(input.OutputLocation !== undefined &&
             input.OutputLocation !== null && { OutputLocation: input.OutputLocation }),
         ...(input.RemoveEncryptionConfiguration !== undefined &&
             input.RemoveEncryptionConfiguration !== null && {
             RemoveEncryptionConfiguration: input.RemoveEncryptionConfiguration,
         }),
+        ...(input.RemoveExpectedBucketOwner !== undefined &&
+            input.RemoveExpectedBucketOwner !== null && { RemoveExpectedBucketOwner: input.RemoveExpectedBucketOwner }),
         ...(input.RemoveOutputLocation !== undefined &&
             input.RemoveOutputLocation !== null && { RemoveOutputLocation: input.RemoveOutputLocation }),
     };
@@ -2769,6 +2775,11 @@ const serializeAws_json1_1WorkGroupConfigurationUpdates = (input, context) => {
         }),
     };
 };
+const deserializeAws_json1_1AthenaError = (output, context) => {
+    return {
+        ErrorCategory: smithy_client_1.expectInt32(output.ErrorCategory),
+    };
+};
 const deserializeAws_json1_1BatchGetNamedQueryOutput = (output, context) => {
     return {
         NamedQueries: output.NamedQueries !== undefined && output.NamedQueries !== null
@@ -3216,6 +3227,9 @@ const deserializeAws_json1_1QueryExecutionStatistics = (output, context) => {
 };
 const deserializeAws_json1_1QueryExecutionStatus = (output, context) => {
     return {
+        AthenaError: output.AthenaError !== undefined && output.AthenaError !== null
+            ? deserializeAws_json1_1AthenaError(output.AthenaError, context)
+            : undefined,
         CompletionDateTime: output.CompletionDateTime !== undefined && output.CompletionDateTime !== null
             ? smithy_client_1.expectNonNull(smithy_client_1.parseEpochTimestamp(smithy_client_1.expectNumber(output.CompletionDateTime)))
             : undefined,
@@ -3237,6 +3251,7 @@ const deserializeAws_json1_1ResultConfiguration = (output, context) => {
         EncryptionConfiguration: output.EncryptionConfiguration !== undefined && output.EncryptionConfiguration !== null
             ? deserializeAws_json1_1EncryptionConfiguration(output.EncryptionConfiguration, context)
             : undefined,
+        ExpectedBucketOwner: smithy_client_1.expectString(output.ExpectedBucketOwner),
         OutputLocation: smithy_client_1.expectString(output.OutputLocation),
     };
 };

package/dist-es/models/models_0.js

@@ -51,6 +51,10 @@ export var QueryExecutionStatistics;
 (function (QueryExecutionStatistics) {
     QueryExecutionStatistics.filterSensitiveLog = function (obj) { return (__assign({}, obj)); };
 })(QueryExecutionStatistics || (QueryExecutionStatistics = {}));
+export var AthenaError;
+(function (AthenaError) {
+    AthenaError.filterSensitiveLog = function (obj) { return (__assign({}, obj)); };
+})(AthenaError || (AthenaError = {}));
 export var QueryExecutionState;
 (function (QueryExecutionState) {
     QueryExecutionState["CANCELLED"] = "CANCELLED";

package/dist-es/protocols/Aws_json1_1.js

@@ -2827,21 +2827,24 @@ var serializeAws_json1_1QueryExecutionIdList = function (input, context) {
     });
 };
 var serializeAws_json1_1ResultConfiguration = function (input, context) {
-    return __assign(__assign({}, (input.EncryptionConfiguration !== undefined &&
+    return __assign(__assign(__assign({}, (input.EncryptionConfiguration !== undefined &&
         input.EncryptionConfiguration !== null && {
         EncryptionConfiguration: serializeAws_json1_1EncryptionConfiguration(input.EncryptionConfiguration, context),
-    })), (input.OutputLocation !== undefined &&
+    })), (input.ExpectedBucketOwner !== undefined &&
+        input.ExpectedBucketOwner !== null && { ExpectedBucketOwner: input.ExpectedBucketOwner })), (input.OutputLocation !== undefined &&
         input.OutputLocation !== null && { OutputLocation: input.OutputLocation }));
 };
 var serializeAws_json1_1ResultConfigurationUpdates = function (input, context) {
-    return __assign(__assign(__assign(__assign({}, (input.EncryptionConfiguration !== undefined &&
+    return __assign(__assign(__assign(__assign(__assign(__assign({}, (input.EncryptionConfiguration !== undefined &&
         input.EncryptionConfiguration !== null && {
         EncryptionConfiguration: serializeAws_json1_1EncryptionConfiguration(input.EncryptionConfiguration, context),
-    })), (input.OutputLocation !== undefined &&
+    })), (input.ExpectedBucketOwner !== undefined &&
+        input.ExpectedBucketOwner !== null && { ExpectedBucketOwner: input.ExpectedBucketOwner })), (input.OutputLocation !== undefined &&
         input.OutputLocation !== null && { OutputLocation: input.OutputLocation })), (input.RemoveEncryptionConfiguration !== undefined &&
         input.RemoveEncryptionConfiguration !== null && {
         RemoveEncryptionConfiguration: input.RemoveEncryptionConfiguration,
-    })), (input.RemoveOutputLocation !== undefined &&
+    })), (input.RemoveExpectedBucketOwner !== undefined &&
+        input.RemoveExpectedBucketOwner !== null && { RemoveExpectedBucketOwner: input.RemoveExpectedBucketOwner })), (input.RemoveOutputLocation !== undefined &&
         input.RemoveOutputLocation !== null && { RemoveOutputLocation: input.RemoveOutputLocation }));
 };
 var serializeAws_json1_1StartQueryExecutionInput = function (input, context) {
@@ -2941,6 +2944,11 @@ var serializeAws_json1_1WorkGroupConfigurationUpdates = function (input, context
         ResultConfigurationUpdates: serializeAws_json1_1ResultConfigurationUpdates(input.ResultConfigurationUpdates, context),
     }));
 };
+var deserializeAws_json1_1AthenaError = function (output, context) {
+    return {
+        ErrorCategory: __expectInt32(output.ErrorCategory),
+    };
+};
 var deserializeAws_json1_1BatchGetNamedQueryOutput = function (output, context) {
     return {
         NamedQueries: output.NamedQueries !== undefined && output.NamedQueries !== null
@@ -3387,6 +3395,9 @@ var deserializeAws_json1_1QueryExecutionStatistics = function (output, context)
 };
 var deserializeAws_json1_1QueryExecutionStatus = function (output, context) {
     return {
+        AthenaError: output.AthenaError !== undefined && output.AthenaError !== null
+            ? deserializeAws_json1_1AthenaError(output.AthenaError, context)
+            : undefined,
         CompletionDateTime: output.CompletionDateTime !== undefined && output.CompletionDateTime !== null
             ? __expectNonNull(__parseEpochTimestamp(__expectNumber(output.CompletionDateTime)))
             : undefined,
@@ -3408,6 +3419,7 @@ var deserializeAws_json1_1ResultConfiguration = function (output, context) {
         EncryptionConfiguration: output.EncryptionConfiguration !== undefined && output.EncryptionConfiguration !== null
             ? deserializeAws_json1_1EncryptionConfiguration(output.EncryptionConfiguration, context)
             : undefined,
+        ExpectedBucketOwner: __expectString(output.ExpectedBucketOwner),
         OutputLocation: __expectString(output.OutputLocation),
     };
 };

package/dist-types/Athena.d.ts

@@ -174,6 +174,12 @@ export declare class Athena extends AthenaClient {
      *                 <code>QueryExecutionId</code> from the Athena query results location in
      *                 Amazon S3. For more information, see <a href="https://docs.aws.amazon.com/athena/latest/ug/querying.html">Query Results</a> in the <i>Amazon Athena User Guide</i>. This request does not execute the query
      *             but returns results. Use <a>StartQueryExecution</a> to run a query.</p>
+     *         <p>If the original query execution ran using an <a>ResultConfiguration$ExpectedBucketOwner</a> setting, the setting also
+     *             applies to Amazon S3 read operations when <code>GetQueryResults</code> is
+     *             called. If an expected bucket owner has been specified and the query results are in an
+     *                 Amazon S3 bucket whose owner account ID is different from the expected
+     *             bucket owner, the <code>GetQueryResults</code> call fails with an Amazon S3
+     *             permissions error.</p>
      *         <p>To stream query results successfully, the IAM principal with permission to call
      *                 <code>GetQueryResults</code> also must have permissions to the Amazon S3
      *             <code>GetObject</code> action for the Athena query results location.</p>

package/dist-types/commands/GetQueryResultsCommand.d.ts

@@ -11,6 +11,12 @@ export interface GetQueryResultsCommandOutput extends GetQueryResultsOutput, __M
  *                 <code>QueryExecutionId</code> from the Athena query results location in
  *                 Amazon S3. For more information, see <a href="https://docs.aws.amazon.com/athena/latest/ug/querying.html">Query Results</a> in the <i>Amazon Athena User Guide</i>. This request does not execute the query
  *             but returns results. Use <a>StartQueryExecution</a> to run a query.</p>
+ *         <p>If the original query execution ran using an <a>ResultConfiguration$ExpectedBucketOwner</a> setting, the setting also
+ *             applies to Amazon S3 read operations when <code>GetQueryResults</code> is
+ *             called. If an expected bucket owner has been specified and the query results are in an
+ *                 Amazon S3 bucket whose owner account ID is different from the expected
+ *             bucket owner, the <code>GetQueryResults</code> call fails with an Amazon S3
+ *             permissions error.</p>
  *         <p>To stream query results successfully, the IAM principal with permission to call
  *                 <code>GetQueryResults</code> also must have permissions to the Amazon S3
  *             <code>GetObject</code> action for the Athena query results location.</p>

package/dist-types/models/models_0.d.ts

@@ -153,7 +153,8 @@ export declare namespace EngineVersion {
  */
 export interface QueryExecutionContext {
     /**
-     * <p>The name of the database used in the query execution. The database must exist in the catalog.</p>
+     * <p>The name of the database used in the query execution. The database must exist in the
+     *             catalog.</p>
      */
     Database?: string;
     /**
@@ -224,6 +225,20 @@ export interface ResultConfiguration {
      *             also uses the location for storing query results specified in the workgroup. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a> and <a href="https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html">Workgroup Settings Override Client-Side Settings</a>.</p>
      */
     EncryptionConfiguration?: EncryptionConfiguration;
+    /**
+     * <p>The Amazon Web Services account ID that you expect to be the owner of the Amazon S3 bucket specified by <a>ResultConfiguration$OutputLocation</a>.
+     *             If set, Athena uses the value for <code>ExpectedBucketOwner</code> when it
+     *             makes Amazon S3 calls to your specified output location. If the
+     *                 <code>ExpectedBucketOwner</code>
+     *             Amazon Web Services account ID does not match the actual owner of the Amazon S3
+     *             bucket, the call fails with a permissions error.</p>
+     *         <p>This is a client-side setting. If workgroup settings override client-side settings,
+     *             then the query uses the <code>ExpectedBucketOwner</code> setting that is specified for
+     *             the workgroup, and also uses the location for storing query results specified in the
+     *             workgroup. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a>
+     *             and <a href="https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html">Workgroup Settings Override Client-Side Settings</a>.</p>
+     */
+    ExpectedBucketOwner?: string;
 }
 export declare namespace ResultConfiguration {
     /**
@@ -288,6 +303,33 @@ export declare namespace QueryExecutionStatistics {
      */
     const filterSensitiveLog: (obj: QueryExecutionStatistics) => any;
 }
+/**
+ * <p>Provides information about an Athena query error. The
+ *                 <code>AthenaError</code> feature provides standardized error information to help you
+ *             understand failed queries and take steps after a query failure occurs.
+ *                 <code>AthenaError</code> includes an <code>ErrorCategory</code> field that specifies
+ *             whether the cause of the failed query is due to system error, user error, or unknown
+ *             error.</p>
+ */
+export interface AthenaError {
+    /**
+     * <p>An integer value that specifies the category of a query failure error. The following
+     *             list shows the category for each integer value.</p>
+     *         <p>
+     *             <b>1</b> - System</p>
+     *         <p>
+     *             <b>2</b> - User</p>
+     *         <p>
+     *             <b>3</b> - Unknown</p>
+     */
+    ErrorCategory?: number;
+}
+export declare namespace AthenaError {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: AthenaError) => any;
+}
 export declare enum QueryExecutionState {
     CANCELLED = "CANCELLED",
     FAILED = "FAILED",
@@ -327,6 +369,10 @@ export interface QueryExecutionStatus {
      * <p>The date and time that the query completed.</p>
      */
     CompletionDateTime?: Date;
+    /**
+     * <p>Provides information about an Athena query error.</p>
+     */
+    AthenaError?: AthenaError;
 }
 export declare namespace QueryExecutionStatus {
     /**
@@ -472,8 +518,9 @@ export declare enum DataCatalogType {
 export interface CreateDataCatalogInput {
     /**
      * <p>The name of the data catalog to create. The catalog name must be unique for the
-     *                 Amazon Web Services account and can use a maximum of 128 alphanumeric, underscore, at
-     *             sign, or hyphen characters.</p>
+     *                 Amazon Web Services account and can use a maximum of 127 alphanumeric, underscore, at
+     *             sign, or hyphen characters. The remainder of the length constraint of 256 is reserved
+     *             for use by Athena.</p>
      */
     Name: string | undefined;
     /**
@@ -703,7 +750,7 @@ export interface WorkGroupConfiguration {
      *             workgroup members cannot query data from Requester Pays buckets, and queries that
      *             retrieve data from Requester Pays buckets cause an error. The default is
      *                 <code>false</code>. For more information about Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html">Requester
-     *                     Pays Buckets</a> in the <i>Amazon Simple Storage Service Developer
+     *                 Pays Buckets</a> in the <i>Amazon Simple Storage Service Developer
      *                 Guide</i>.</p>
      */
     RequesterPaysEnabled?: boolean;
@@ -939,8 +986,9 @@ export declare namespace GetDataCatalogInput {
  */
 export interface DataCatalog {
     /**
-     * <p>The name of the data catalog. The catalog name must be unique for the Amazon Web Services account and can use a maximum of 128 alphanumeric, underscore, at sign,
-     *             or hyphen characters.</p>
+     * <p>The name of the data catalog. The catalog name must be unique for the Amazon Web Services account and can use a maximum of 127 alphanumeric, underscore, at sign,
+     *             or hyphen characters. The remainder of the length constraint of 256 is reserved for use
+     *             by Athena.</p>
      */
     Name: string | undefined;
     /**
@@ -1551,7 +1599,9 @@ export declare namespace ListDataCatalogsInput {
  */
 export interface DataCatalogSummary {
     /**
-     * <p>The name of the data catalog.</p>
+     * <p>The name of the data catalog. The catalog name is unique for the Amazon Web Services account and can use a maximum of 127 alphanumeric, underscore, at sign,
+     *             or hyphen characters. The remainder of the length constraint of 256 is reserved for use
+     *             by Athena.</p>
      */
     CatalogName?: string;
     /**
@@ -2060,8 +2110,9 @@ export declare namespace UntagResourceOutput {
 export interface UpdateDataCatalogInput {
     /**
      * <p>The name of the data catalog to update. The catalog name must be unique for the
-     *                 Amazon Web Services account and can use a maximum of 128 alphanumeric, underscore, at
-     *             sign, or hyphen characters.</p>
+     *                 Amazon Web Services account and can use a maximum of 127 alphanumeric, underscore, at
+     *             sign, or hyphen characters. The remainder of the length constraint of 256 is reserved
+     *             for use by Athena.</p>
      */
     Name: string | undefined;
     /**
@@ -2186,7 +2237,7 @@ export interface ResultConfigurationUpdates {
      *             to null. If set to "false" or not set, and a value is present in the
      *                 <code>OutputLocation</code> in <code>ResultConfigurationUpdates</code> (the
      *             client-side setting), the <code>OutputLocation</code> in the workgroup's
-     *                 <code>ResultConfiguration</code> will be updated with the new value. For more
+     *                 <code>ResultConfiguration</code> is updated with the new value. For more
      *             information, see <a href="https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html">Workgroup Settings Override
      *                 Client-Side Settings</a>.</p>
      */
@@ -2201,11 +2252,34 @@ export interface ResultConfigurationUpdates {
      *             and set to null. If set to "false" or not set, and a value is present in the
      *                 <code>EncryptionConfiguration</code> in <code>ResultConfigurationUpdates</code> (the
      *             client-side setting), the <code>EncryptionConfiguration</code> in the workgroup's
-     *                 <code>ResultConfiguration</code> will be updated with the new value. For more
+     *                 <code>ResultConfiguration</code> is updated with the new value. For more
      *             information, see <a href="https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html">Workgroup Settings Override
      *                 Client-Side Settings</a>.</p>
      */
     RemoveEncryptionConfiguration?: boolean;
+    /**
+     * <p>The Amazon Web Services account ID that you expect to be the owner of the Amazon S3 bucket specified by <a>ResultConfiguration$OutputLocation</a>.
+     *             If set, Athena uses the value for <code>ExpectedBucketOwner</code> when it
+     *             makes Amazon S3 calls to your specified output location. If the
+     *                 <code>ExpectedBucketOwner</code>
+     *             Amazon Web Services account ID does not match the actual owner of the Amazon S3
+     *             bucket, the call fails with a permissions error.</p>
+     *
+     *         <p>If workgroup settings override client-side settings, then the query uses the
+     *                 <code>ExpectedBucketOwner</code> setting that is specified for the workgroup, and
+     *             also uses the location for storing query results specified in the workgroup. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a> and <a href="https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html">Workgroup Settings Override Client-Side Settings</a>.</p>
+     */
+    ExpectedBucketOwner?: string;
+    /**
+     * <p>If set to "true", removes the Amazon Web Services account ID previously specified for
+     *                 <a>ResultConfiguration$ExpectedBucketOwner</a>. If set to "false" or not
+     *             set, and a value is present in the <code>ExpectedBucketOwner</code> in
+     *                 <code>ResultConfigurationUpdates</code> (the client-side setting), the
+     *                 <code>ExpectedBucketOwner</code> in the workgroup's <code>ResultConfiguration</code>
+     *             is updated with the new value. For more information, see <a href="https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html">Workgroup Settings Override
+     *                 Client-Side Settings</a>.</p>
+     */
+    RemoveExpectedBucketOwner?: boolean;
 }
 export declare namespace ResultConfigurationUpdates {
     /**

package/dist-types/ts3.4/models/models_0.d.ts

@@ -115,6 +115,8 @@ export interface ResultConfiguration {
     OutputLocation?: string;
     
     EncryptionConfiguration?: EncryptionConfiguration;
+    
+    ExpectedBucketOwner?: string;
 }
 export declare namespace ResultConfiguration {
     
@@ -146,6 +148,15 @@ export declare namespace QueryExecutionStatistics {
     
     const filterSensitiveLog: (obj: QueryExecutionStatistics) => any;
 }
+
+export interface AthenaError {
+    
+    ErrorCategory?: number;
+}
+export declare namespace AthenaError {
+    
+    const filterSensitiveLog: (obj: AthenaError) => any;
+}
 export declare enum QueryExecutionState {
     CANCELLED = "CANCELLED",
     FAILED = "FAILED",
@@ -163,6 +174,8 @@ export interface QueryExecutionStatus {
     SubmissionDateTime?: Date;
     
     CompletionDateTime?: Date;
+    
+    AthenaError?: AthenaError;
 }
 export declare namespace QueryExecutionStatus {
     
@@ -1102,6 +1115,10 @@ export interface ResultConfigurationUpdates {
     EncryptionConfiguration?: EncryptionConfiguration;
     
     RemoveEncryptionConfiguration?: boolean;
+    
+    ExpectedBucketOwner?: string;
+    
+    RemoveExpectedBucketOwner?: boolean;
 }
 export declare namespace ResultConfigurationUpdates {
     

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-athena",
   "description": "AWS SDK for JavaScript Athena Client for Node.js, Browser and React Native",
-  "version": "3.47.2",
+  "version": "3.51.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -18,43 +18,49 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "2.0.0",
     "@aws-crypto/sha256-js": "2.0.0",
-    "@aws-sdk/client-sts": "3.47.2",
-    "@aws-sdk/config-resolver": "3.47.2",
-    "@aws-sdk/credential-provider-node": "3.47.2",
-    "@aws-sdk/fetch-http-handler": "3.47.2",
-    "@aws-sdk/hash-node": "3.47.2",
-    "@aws-sdk/invalid-dependency": "3.47.2",
-    "@aws-sdk/middleware-content-length": "3.47.2",
-    "@aws-sdk/middleware-host-header": "3.47.2",
-    "@aws-sdk/middleware-logger": "3.47.2",
-    "@aws-sdk/middleware-retry": "3.47.2",
-    "@aws-sdk/middleware-serde": "3.47.2",
-    "@aws-sdk/middleware-signing": "3.47.2",
-    "@aws-sdk/middleware-stack": "3.47.2",
-    "@aws-sdk/middleware-user-agent": "3.47.2",
-    "@aws-sdk/node-config-provider": "3.47.2",
-    "@aws-sdk/node-http-handler": "3.47.2",
-    "@aws-sdk/protocol-http": "3.47.2",
-    "@aws-sdk/smithy-client": "3.47.2",
-    "@aws-sdk/types": "3.47.1",
-    "@aws-sdk/url-parser": "3.47.2",
-    "@aws-sdk/util-base64-browser": "3.47.1",
-    "@aws-sdk/util-base64-node": "3.47.2",
-    "@aws-sdk/util-body-length-browser": "3.47.1",
-    "@aws-sdk/util-body-length-node": "3.47.1",
-    "@aws-sdk/util-defaults-mode-browser": "3.47.2",
-    "@aws-sdk/util-defaults-mode-node": "3.47.2",
-    "@aws-sdk/util-user-agent-browser": "3.47.2",
-    "@aws-sdk/util-user-agent-node": "3.47.2",
-    "@aws-sdk/util-utf8-browser": "3.47.1",
-    "@aws-sdk/util-utf8-node": "3.47.2",
+    "@aws-sdk/client-sts": "3.51.0",
+    "@aws-sdk/config-resolver": "3.51.0",
+    "@aws-sdk/credential-provider-node": "3.51.0",
+    "@aws-sdk/fetch-http-handler": "3.50.0",
+    "@aws-sdk/hash-node": "3.50.0",
+    "@aws-sdk/invalid-dependency": "3.50.0",
+    "@aws-sdk/middleware-content-length": "3.50.0",
+    "@aws-sdk/middleware-host-header": "3.50.0",
+    "@aws-sdk/middleware-logger": "3.50.0",
+    "@aws-sdk/middleware-retry": "3.51.0",
+    "@aws-sdk/middleware-serde": "3.50.0",
+    "@aws-sdk/middleware-signing": "3.50.0",
+    "@aws-sdk/middleware-stack": "3.50.0",
+    "@aws-sdk/middleware-user-agent": "3.50.0",
+    "@aws-sdk/node-config-provider": "3.51.0",
+    "@aws-sdk/node-http-handler": "3.50.0",
+    "@aws-sdk/protocol-http": "3.50.0",
+    "@aws-sdk/smithy-client": "3.50.0",
+    "@aws-sdk/types": "3.50.0",
+    "@aws-sdk/url-parser": "3.50.0",
+    "@aws-sdk/util-base64-browser": "3.49.0",
+    "@aws-sdk/util-base64-node": "3.49.0",
+    "@aws-sdk/util-body-length-browser": "3.49.0",
+    "@aws-sdk/util-body-length-node": "3.49.0",
+    "@aws-sdk/util-defaults-mode-browser": "3.50.0",
+    "@aws-sdk/util-defaults-mode-node": "3.51.0",
+    "@aws-sdk/util-user-agent-browser": "3.50.0",
+    "@aws-sdk/util-user-agent-node": "3.51.0",
+    "@aws-sdk/util-utf8-browser": "3.49.0",
+    "@aws-sdk/util-utf8-node": "3.49.0",
     "tslib": "^2.3.0",
     "uuid": "^8.3.2"
   },
   "devDependencies": {
-    "@aws-sdk/service-client-documentation-generator": "3.47.1",
+    "@aws-sdk/service-client-documentation-generator": "3.49.0",
+    "@tsconfig/recommended": "1.0.1",
     "@types/node": "^12.7.5",
-    "@types/uuid": "^8.3.0"
+    "@types/uuid": "^8.3.0",
+    "concurrently": "7.0.0",
+    "downlevel-dts": "0.7.0",
+    "rimraf": "3.0.2",
+    "typedoc": "0.19.2",
+    "typescript": "~4.3.5"
   },
   "engines": {
     "node": ">=12.0.0"