Release v1.44.60 (2022-07-21) (#4488)

Release v1.44.60 (2022-07-21) === ### Service Client Updates * `service/athena`: Updates service API, documentation, and paginators * This feature allows customers to retrieve runtime statistics for completed queries * `service/dms`: Updates service documentation * Documentation updates for Database Migration Service (DMS). * `service/docdb`: Updates service API and documentation * Enable copy-on-write restore type * `service/ec2-instance-connect`: Updates service API and documentation * `service/frauddetector`: Updates service API and documentation * `service/iotsitewise`: Updates service API, documentation, and paginators * `service/kendra`: Updates service API and documentation * Amazon Kendra now provides Oauth2 support for SharePoint Online. For more information, see https://docs.aws.amazon.com/kendra/latest/dg/data-source-sharepoint.html * `service/monitoring`: Updates service API and documentation * Adding support for the suppression of Composite Alarm actions * `service/network-firewall`: Updates service API and documentation * `service/rds`: Updates service API, documentation, waiters, paginators, and examples * Adds support for creating an RDS Proxy for an RDS for MariaDB database.
aws · Jul 21, 2022 · 694be87 · 694be87
1 parent 5a5fc7b
commit 694be87
Show file tree

Hide file tree

Showing 36 changed files with 4,926 additions and 436 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,24 @@
+Release v1.44.60 (2022-07-21)
+===
+
+### Service Client Updates
+* `service/athena`: Updates service API, documentation, and paginators
+  * This feature allows customers to retrieve runtime statistics for completed queries
+* `service/dms`: Updates service documentation
+  * Documentation updates for Database Migration Service (DMS).
+* `service/docdb`: Updates service API and documentation
+  * Enable copy-on-write restore type
+* `service/ec2-instance-connect`: Updates service API and documentation
+* `service/frauddetector`: Updates service API and documentation
+* `service/iotsitewise`: Updates service API, documentation, and paginators
+* `service/kendra`: Updates service API and documentation
+  * Amazon Kendra now provides Oauth2 support for SharePoint Online. For more information, see https://docs.aws.amazon.com/kendra/latest/dg/data-source-sharepoint.html
+* `service/monitoring`: Updates service API and documentation
+  * Adding support for the suppression of Composite Alarm actions
+* `service/network-firewall`: Updates service API and documentation
+* `service/rds`: Updates service API, documentation, waiters, paginators, and examples
+  * Adds support for creating an RDS Proxy for an RDS for MariaDB database.
+
 Release v1.44.59 (2022-07-20)
 ===
 

diff --git a/aws/version.go b/aws/version.go
@@ -5,4 +5,4 @@ package aws
 const SDKName = "aws-sdk-go"
 
 // SDKVersion is the version of this SDK
-const SDKVersion = "1.44.59"
+const SDKVersion = "1.44.60"
diff --git a/models/apis/athena/2017-05-18/api-2.json b/models/apis/athena/2017-05-18/api-2.json
@@ -239,6 +239,19 @@
         {"shape":"InvalidRequestException"}
       ]
     },
+    "GetQueryRuntimeStatistics":{
+      "name":"GetQueryRuntimeStatistics",
+      "http":{
+        "method":"POST",
+        "requestUri":"/"
+      },
+      "input":{"shape":"GetQueryRuntimeStatisticsInput"},
+      "output":{"shape":"GetQueryRuntimeStatisticsOutput"},
+      "errors":[
+        {"shape":"InternalServerException"},
+        {"shape":"InvalidRequestException"}
+      ]
+    },
     "GetTableMetadata":{
       "name":"GetTableMetadata",
       "http":{
@@ -982,6 +995,19 @@
         "NextToken":{"shape":"Token"}
       }
     },
+    "GetQueryRuntimeStatisticsInput":{
+      "type":"structure",
+      "required":["QueryExecutionId"],
+      "members":{
+        "QueryExecutionId":{"shape":"QueryExecutionId"}
+      }
+    },
+    "GetQueryRuntimeStatisticsOutput":{
+      "type":"structure",
+      "members":{
+        "QueryRuntimeStatistics":{"shape":"QueryRuntimeStatistics"}
+      }
+    },
     "GetTableMetadataInput":{
       "type":"structure",
       "required":[
@@ -1402,6 +1428,64 @@
         "AthenaError":{"shape":"AthenaError"}
       }
     },
+    "QueryRuntimeStatistics":{
+      "type":"structure",
+      "members":{
+        "Timeline":{"shape":"QueryRuntimeStatisticsTimeline"},
+        "Rows":{"shape":"QueryRuntimeStatisticsRows"},
+        "OutputStage":{"shape":"QueryStage"}
+      }
+    },
+    "QueryRuntimeStatisticsRows":{
+      "type":"structure",
+      "members":{
+        "InputRows":{"shape":"Long"},
+        "InputBytes":{"shape":"Long"},
+        "OutputBytes":{"shape":"Long"},
+        "OutputRows":{"shape":"Long"}
+      }
+    },
+    "QueryRuntimeStatisticsTimeline":{
+      "type":"structure",
+      "members":{
+        "QueryQueueTimeInMillis":{"shape":"Long"},
+        "QueryPlanningTimeInMillis":{"shape":"Long"},
+        "EngineExecutionTimeInMillis":{"shape":"Long"},
+        "ServiceProcessingTimeInMillis":{"shape":"Long"},
+        "TotalExecutionTimeInMillis":{"shape":"Long"}
+      }
+    },
+    "QueryStage":{
+      "type":"structure",
+      "members":{
+        "StageId":{"shape":"Long"},
+        "State":{"shape":"String"},
+        "OutputBytes":{"shape":"Long"},
+        "OutputRows":{"shape":"Long"},
+        "InputBytes":{"shape":"Long"},
+        "InputRows":{"shape":"Long"},
+        "ExecutionTime":{"shape":"Long"},
+        "QueryStagePlan":{"shape":"QueryStagePlanNode"},
+        "SubStages":{"shape":"QueryStages"}
+      }
+    },
+    "QueryStagePlanNode":{
+      "type":"structure",
+      "members":{
+        "Name":{"shape":"String"},
+        "Identifier":{"shape":"String"},
+        "Children":{"shape":"QueryStagePlanNodes"},
+        "RemoteSources":{"shape":"StringList"}
+      }
+    },
+    "QueryStagePlanNodes":{
+      "type":"list",
+      "member":{"shape":"QueryStagePlanNode"}
+    },
+    "QueryStages":{
+      "type":"list",
+      "member":{"shape":"QueryStage"}
+    },
     "QueryString":{
       "type":"string",
       "max":262144,
@@ -1516,6 +1600,10 @@
       }
     },
     "String":{"type":"string"},
+    "StringList":{
+      "type":"list",
+      "member":{"shape":"String"}
+    },
     "TableMetadata":{
       "type":"structure",
       "required":["Name"],

diff --git a/models/apis/athena/2017-05-18/docs-2.json b/models/apis/athena/2017-05-18/docs-2.json
@@ -19,6 +19,7 @@
     "GetPreparedStatement": "<p>Retrieves the prepared statement with the specified name from the specified workgroup.</p>",
     "GetQueryExecution": "<p>Returns information about a single execution of a query if you have access to the workgroup in which the query ran. Each time a query executes, information about the query execution is saved with a unique ID.</p>",
     "GetQueryResults": "<p>Streams the results of a single query execution specified by <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>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> <important> <p>IAM principals with permission to the Amazon S3 <code>GetObject</code> action for the query results location are able to retrieve query results from Amazon S3 even if permission to the <code>GetQueryResults</code> action is denied. To restrict user or role access, ensure that Amazon S3 permissions to the Athena query location are denied.</p> </important>",
+    "GetQueryRuntimeStatistics": "<p>Returns query execution runtime statistics related to a single execution of a query if you have access to the workgroup in which the query ran. The query execution runtime statistics is returned only when <a>QueryExecutionStatus$State</a> is in a SUCCEEDED or FAILED state.</p>",
     "GetTableMetadata": "<p>Returns table metadata for the specified catalog, database, and table.</p>",
     "GetWorkGroup": "<p>Returns information about the workgroup with the specified name.</p>",
     "ListDataCatalogs": "<p>Lists the data catalogs in the current Amazon Web Services account.</p>",
@@ -484,6 +485,16 @@
       "refs": {
       }
     },
+    "GetQueryRuntimeStatisticsInput": {
+      "base": null,
+      "refs": {
+      }
+    },
+    "GetQueryRuntimeStatisticsOutput": {
+      "base": null,
+      "refs": {
+      }
+    },
     "GetTableMetadataInput": {
       "base": null,
       "refs": {
@@ -633,7 +644,22 @@
         "QueryExecutionStatistics$TotalExecutionTimeInMillis": "<p>The number of milliseconds that Athena took to run the query.</p>",
         "QueryExecutionStatistics$QueryQueueTimeInMillis": "<p>The number of milliseconds that the query was in your query queue waiting for resources. Note that if transient errors occur, Athena might automatically add the query back to the queue.</p>",
         "QueryExecutionStatistics$QueryPlanningTimeInMillis": "<p>The number of milliseconds that Athena took to plan the query processing flow. This includes the time spent retrieving table partitions from the data source. Note that because the query engine performs the query planning, query planning time is a subset of engine processing time.</p>",
-        "QueryExecutionStatistics$ServiceProcessingTimeInMillis": "<p>The number of milliseconds that Athena took to finalize and publish the query results after the query engine finished running the query.</p>"
+        "QueryExecutionStatistics$ServiceProcessingTimeInMillis": "<p>The number of milliseconds that Athena took to finalize and publish the query results after the query engine finished running the query.</p>",
+        "QueryRuntimeStatisticsRows$InputRows": "<p>The number of rows read to execute the query.</p>",
+        "QueryRuntimeStatisticsRows$InputBytes": "<p>The number of bytes read to execute the query.</p>",
+        "QueryRuntimeStatisticsRows$OutputBytes": "<p>The number of bytes returned by the query.</p>",
+        "QueryRuntimeStatisticsRows$OutputRows": "<p>The number of rows returned by the query.</p>",
+        "QueryRuntimeStatisticsTimeline$QueryQueueTimeInMillis": "<p>The number of milliseconds that the query was in your query queue waiting for resources. Note that if transient errors occur, Athena might automatically add the query back to the queue.</p>",
+        "QueryRuntimeStatisticsTimeline$QueryPlanningTimeInMillis": "<p>The number of milliseconds that Athena took to plan the query processing flow. This includes the time spent retrieving table partitions from the data source. Note that because the query engine performs the query planning, query planning time is a subset of engine processing time.</p>",
+        "QueryRuntimeStatisticsTimeline$EngineExecutionTimeInMillis": "<p>The number of milliseconds that the query took to execute.</p>",
+        "QueryRuntimeStatisticsTimeline$ServiceProcessingTimeInMillis": "<p>The number of milliseconds that Athena took to finalize and publish the query results after the query engine finished running the query.</p>",
+        "QueryRuntimeStatisticsTimeline$TotalExecutionTimeInMillis": "<p>The number of milliseconds that Athena took to run the query.</p>",
+        "QueryStage$StageId": "<p>The identifier for a stage.</p>",
+        "QueryStage$OutputBytes": "<p>The number of bytes output from the stage after execution.</p>",
+        "QueryStage$OutputRows": "<p>The number of rows output from the stage after execution.</p>",
+        "QueryStage$InputBytes": "<p>The number of bytes input into the stage for execution.</p>",
+        "QueryStage$InputRows": "<p>The number of rows input into the stage for execution.</p>",
+        "QueryStage$ExecutionTime": "<p>Time taken to execute this stage.</p>"
       }
     },
     "MaxDataCatalogsCount": {
@@ -822,6 +848,7 @@
       "refs": {
         "GetQueryExecutionInput$QueryExecutionId": "<p>The unique ID of the query execution.</p>",
         "GetQueryResultsInput$QueryExecutionId": "<p>The unique ID of the query execution.</p>",
+        "GetQueryRuntimeStatisticsInput$QueryExecutionId": "<p>The unique ID of the query execution.</p>",
         "QueryExecution$QueryExecutionId": "<p>The unique identifier for each query execution.</p>",
         "QueryExecutionIdList$member": null,
         "StartQueryExecutionOutput$QueryExecutionId": "<p>The unique ID of the query that ran as a result of this request.</p>",
@@ -860,6 +887,50 @@
         "QueryExecution$Status": "<p>The completion date, current state, submission time, and state change reason (if applicable) for the query execution.</p>"
       }
     },
+    "QueryRuntimeStatistics": {
+      "base": "<p>The query execution timeline, statistics on input and output rows and bytes, and the different query stages that form the query execution plan.</p>",
+      "refs": {
+        "GetQueryRuntimeStatisticsOutput$QueryRuntimeStatistics": "<p>Runtime statistics about the query execution.</p>"
+      }
+    },
+    "QueryRuntimeStatisticsRows": {
+      "base": "<p>Statistics such as input rows and bytes read by the query, rows and bytes output by the query, and the number of rows written by the query.</p>",
+      "refs": {
+        "QueryRuntimeStatistics$Rows": null
+      }
+    },
+    "QueryRuntimeStatisticsTimeline": {
+      "base": "<p>Timeline statistics such as query queue time, planning time, execution time, service processing time, and total execution time.</p>",
+      "refs": {
+        "QueryRuntimeStatistics$Timeline": null
+      }
+    },
+    "QueryStage": {
+      "base": "<p>Stage statistics such as input and output rows and bytes, execution time and stage state. This information also includes substages and the query stage plan.</p>",
+      "refs": {
+        "QueryRuntimeStatistics$OutputStage": "<p>Stage statistics such as input and output rows and bytes, execution time, and stage state. This information also includes substages and the query stage plan.</p>",
+        "QueryStages$member": null
+      }
+    },
+    "QueryStagePlanNode": {
+      "base": "<p>Stage plan information such as name, identifier, sub plans, and remote sources.</p>",
+      "refs": {
+        "QueryStage$QueryStagePlan": "<p>Stage plan information such as name, identifier, sub plans, and source stages.</p>",
+        "QueryStagePlanNodes$member": null
+      }
+    },
+    "QueryStagePlanNodes": {
+      "base": null,
+      "refs": {
+        "QueryStagePlanNode$Children": "<p>Stage plan information such as name, identifier, sub plans, and remote sources of child plan nodes/</p>"
+      }
+    },
+    "QueryStages": {
+      "base": null,
+      "refs": {
+        "QueryStage$SubStages": "<p>List of sub query stages that form this stage execution plan.</p>"
+      }
+    },
     "QueryString": {
       "base": null,
       "refs": {
@@ -980,7 +1051,17 @@
         "ColumnInfo$Type": "<p>The data type of the column.</p>",
         "EncryptionConfiguration$KmsKey": "<p>For <code>SSE_KMS</code> and <code>CSE_KMS</code>, this is the KMS key ARN or ID.</p>",
         "QueryExecutionStatistics$DataManifestLocation": "<p>The location and file name of a data manifest file. The manifest file is saved to the Athena query results location in Amazon S3. The manifest file tracks files that the query wrote to Amazon S3. If the query fails, the manifest file also tracks files that the query intended to write. The manifest is useful for identifying orphaned files resulting from a failed query. For more information, see <a href=\"https://docs.aws.amazon.com/athena/latest/ug/querying.html\">Working with Query Results, Output Files, and Query History</a> in the <i>Amazon Athena User Guide</i>.</p>",
-        "QueryExecutionStatus$StateChangeReason": "<p>Further detail about the status of the query.</p>"
+        "QueryExecutionStatus$StateChangeReason": "<p>Further detail about the status of the query.</p>",
+        "QueryStage$State": "<p>State of the stage after query execution.</p>",
+        "QueryStagePlanNode$Name": "<p>Name of the query stage plan that describes the operation this stage is performing as part of query execution.</p>",
+        "QueryStagePlanNode$Identifier": "<p>Information about the operation this query stage plan node is performing.</p>",
+        "StringList$member": null
+      }
+    },
+    "StringList": {
+      "base": null,
+      "refs": {
+        "QueryStagePlanNode$RemoteSources": "<p>Source plan node IDs.</p>"
       }
     },
     "TableMetadata": {

diff --git a/models/apis/athena/2017-05-18/paginators-1.json b/models/apis/athena/2017-05-18/paginators-1.json
@@ -17,6 +17,11 @@
       "output_token": "NextToken",
       "result_key": "DatabaseList"
     },
+    "ListEngineVersions": {
+      "input_token": "NextToken",
+      "limit_key": "MaxResults",
+      "output_token": "NextToken"
+    },
     "ListNamedQueries": {
       "input_token": "NextToken",
       "limit_key": "MaxResults",

diff --git a/models/apis/dms/2016-01-01/docs-2.json b/models/apis/dms/2016-01-01/docs-2.json
@@ -1968,7 +1968,7 @@
         "Connection$EndpointIdentifier": "<p>The identifier of the endpoint. Identifiers must begin with a letter and must contain only ASCII letters, digits, and hyphens. They can't end with a hyphen or contain two consecutive hyphens.</p>",
         "Connection$ReplicationInstanceIdentifier": "<p>The replication instance identifier. This parameter is stored as a lowercase string.</p>",
         "CreateEndpointMessage$EndpointIdentifier": "<p>The database endpoint identifier. Identifiers must begin with a letter and must contain only ASCII letters, digits, and hyphens. They can't end with a hyphen, or contain two consecutive hyphens.</p>",
-        "CreateEndpointMessage$EngineName": "<p>The type of engine for the endpoint. Valid values, depending on the <code>EndpointType</code> value, include <code>\"mysql\"</code>, <code>\"oracle\"</code>, <code>\"postgres\"</code>, <code>\"mariadb\"</code>, <code>\"aurora\"</code>, <code>\"aurora-postgresql\"</code>, <code>\"opensearch\"</code>, <code>\"redshift\"</code>, <code>\"s3\"</code>, <code>\"db2\"</code>, <code>\"azuredb\"</code>, <code>\"sybase\"</code>, <code>\"dynamodb\"</code>, <code>\"mongodb\"</code>, <code>\"kinesis\"</code>, <code>\"kafka\"</code>, <code>\"elasticsearch\"</code>, <code>\"docdb\"</code>, <code>\"sqlserver\"</code>, and <code>\"neptune\"</code>.</p>",
+        "CreateEndpointMessage$EngineName": "<p>The type of engine for the endpoint. Valid values, depending on the <code>EndpointType</code> value, include <code>\"mysql\"</code>, <code>\"oracle\"</code>, <code>\"postgres\"</code>, <code>\"mariadb\"</code>, <code>\"aurora\"</code>, <code>\"aurora-postgresql\"</code>, <code>\"opensearch\"</code>, <code>\"redshift\"</code>, <code>\"s3\"</code>, <code>\"db2\"</code>, <code>db2-zos</code>, <code>\"azuredb\"</code>, <code>\"sybase\"</code>, <code>\"dynamodb\"</code>, <code>\"mongodb\"</code>, <code>\"kinesis\"</code>, <code>\"kafka\"</code>, <code>\"elasticsearch\"</code>, <code>\"docdb\"</code>, <code>\"sqlserver\"</code>, <code>\"neptune\"</code>, and <code>babelfish</code>.</p>",
         "CreateEndpointMessage$Username": "<p>The user name to be used to log in to the endpoint database.</p>",
         "CreateEndpointMessage$ServerName": "<p>The name of the server where the endpoint database resides.</p>",
         "CreateEndpointMessage$DatabaseName": "<p>The name of the endpoint database. For a MySQL source or target endpoint, do not specify DatabaseName. To migrate to a specific database, use this setting and <code>targetDbType</code>.</p>",
@@ -2393,7 +2393,7 @@
         "SybaseSettings$SecretsManagerSecretId": "<p>The full ARN, partial ARN, or friendly name of the <code>SecretsManagerSecret</code> that contains the SAP SAE endpoint connection details.</p>",
         "TableStatistics$SchemaName": "<p>The schema name.</p>",
         "TableStatistics$TableName": "<p>The name of the table.</p>",
-        "TableStatistics$TableState": "<p>The state of the tables described.</p> <p>Valid states: Table does not exist | Before load | Full load | Table completed | Table cancelled | Table error | Table all | Table updates | Table is being reloaded</p>",
+        "TableStatistics$TableState": "<p>The state of the tables described.</p> <p>Valid states: Table does not exist | Before load | Full load | Table completed | Table cancelled | Table error | Table is being reloaded</p>",
         "TableStatistics$ValidationState": "<p>The validation state of the table.</p> <p>This parameter can have the following values:</p> <ul> <li> <p>Not enabled – Validation isn't enabled for the table in the migration task.</p> </li> <li> <p>Pending records – Some records in the table are waiting for validation.</p> </li> <li> <p>Mismatched records – Some records in the table don't match between the source and target.</p> </li> <li> <p>Suspended records – Some records in the table couldn't be validated.</p> </li> <li> <p>No primary key –The table couldn't be validated because it has no primary key.</p> </li> <li> <p>Table error – The table wasn't validated because it's in an error state and some data wasn't migrated.</p> </li> <li> <p>Validated – All rows in the table are validated. If the table is updated, the status can change from Validated.</p> </li> <li> <p>Error – The table couldn't be validated because of an unexpected error.</p> </li> <li> <p>Pending validation – The table is waiting validation.</p> </li> <li> <p>Preparing table – Preparing the table enabled in the migration task for validation.</p> </li> <li> <p>Pending revalidation – All rows in the table are pending validation after the table was updated.</p> </li> </ul>",
         "TableStatistics$ValidationStateDetails": "<p>Additional details about the state of validation.</p>",
         "TableToReload$SchemaName": "<p>The schema name of the table to be reloaded.</p>",