Merge branch 'release-1.27.35' into develop

* release-1.27.35:
  Bumping version to 1.27.35
  Update to latest models

.changes/1.27.35.json

@@ -0,0 +1,52 @@
+[
+  {
+    "category": "``athena``",
+    "description": "This feature allows customers to retrieve runtime statistics for completed queries",
+    "type": "api-change"
+  },
+  {
+    "category": "``cloudwatch``",
+    "description": "Update cloudwatch client to latest version",
+    "type": "api-change"
+  },
+  {
+    "category": "``dms``",
+    "description": "Documentation updates for Database Migration Service (DMS).",
+    "type": "api-change"
+  },
+  {
+    "category": "``docdb``",
+    "description": "Enable copy-on-write restore type",
+    "type": "api-change"
+  },
+  {
+    "category": "``ec2-instance-connect``",
+    "description": "This release includes a new exception type \"EC2InstanceUnavailableException\" for SendSSHPublicKey and SendSerialConsoleSSHPublicKey APIs.",
+    "type": "api-change"
+  },
+  {
+    "category": "``frauddetector``",
+    "description": "The release introduces Account Takeover Insights (ATI) model. The ATI model detects fraud relating to account takeover. This release also adds support for new variable types: ARE_CREDENTIALS_VALID and SESSION_ID and adds new structures to Model Version APIs.",
+    "type": "api-change"
+  },
+  {
+    "category": "``iotsitewise``",
+    "description": "Added asynchronous API to ingest bulk historical and current data into IoT SiteWise.",
+    "type": "api-change"
+  },
+  {
+    "category": "``kendra``",
+    "description": "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",
+    "type": "api-change"
+  },
+  {
+    "category": "``network-firewall``",
+    "description": "Network Firewall now supports referencing dynamic IP sets from stateful rule groups, for IP sets stored in Amazon VPC prefix lists.",
+    "type": "api-change"
+  },
+  {
+    "category": "``rds``",
+    "description": "Adds support for creating an RDS Proxy for an RDS for MariaDB database.",
+    "type": "api-change"
+  }
+]

CHANGELOG.rst

@@ -2,6 +2,21 @@
 CHANGELOG
 =========
 
+1.27.35
+=======
+
+* api-change:``athena``: This feature allows customers to retrieve runtime statistics for completed queries
+* api-change:``cloudwatch``: Update cloudwatch client to latest version
+* api-change:``dms``: Documentation updates for Database Migration Service (DMS).
+* api-change:``docdb``: Enable copy-on-write restore type
+* api-change:``ec2-instance-connect``: This release includes a new exception type "EC2InstanceUnavailableException" for SendSSHPublicKey and SendSerialConsoleSSHPublicKey APIs.
+* api-change:``frauddetector``: The release introduces Account Takeover Insights (ATI) model. The ATI model detects fraud relating to account takeover. This release also adds support for new variable types: ARE_CREDENTIALS_VALID and SESSION_ID and adds new structures to Model Version APIs.
+* api-change:``iotsitewise``: Added asynchronous API to ingest bulk historical and current data into IoT SiteWise.
+* api-change:``kendra``: 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
+* api-change:``network-firewall``: Network Firewall now supports referencing dynamic IP sets from stateful rule groups, for IP sets stored in Amazon VPC prefix lists.
+* api-change:``rds``: Adds support for creating an RDS Proxy for an RDS for MariaDB database.
+
+
 1.27.34
 =======
 

botocore/__init__.py

@@ -16,7 +16,7 @@
 import os
 import re
 
-__version__ = '1.27.34'
+__version__ = '1.27.35'
 
 
 class NullHandler(logging.Handler):

botocore/data/athena/2017-05-18/service-2.json

@@ -256,6 +256,20 @@
       ],
       "documentation":"<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":{
+      "name":"GetQueryRuntimeStatistics",
+      "http":{
+        "method":"POST",
+        "requestUri":"/"
+      },
+      "input":{"shape":"GetQueryRuntimeStatisticsInput"},
+      "output":{"shape":"GetQueryRuntimeStatisticsOutput"},
+      "errors":[
+        {"shape":"InternalServerException"},
+        {"shape":"InvalidRequestException"}
+      ],
+      "documentation":"<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":{
       "name":"GetTableMetadata",
       "http":{
@@ -1285,6 +1299,25 @@
         }
       }
     },
+    "GetQueryRuntimeStatisticsInput":{
+      "type":"structure",
+      "required":["QueryExecutionId"],
+      "members":{
+        "QueryExecutionId":{
+          "shape":"QueryExecutionId",
+          "documentation":"<p>The unique ID of the query execution.</p>"
+        }
+      }
+    },
+    "GetQueryRuntimeStatisticsOutput":{
+      "type":"structure",
+      "members":{
+        "QueryRuntimeStatistics":{
+          "shape":"QueryRuntimeStatistics",
+          "documentation":"<p>Runtime statistics about the query execution.</p>"
+        }
+      }
+    },
     "GetTableMetadataInput":{
       "type":"structure",
       "required":[
@@ -1976,6 +2009,138 @@
       },
       "documentation":"<p>The completion date, current state, submission time, and state change reason (if applicable) for the query execution.</p>"
     },
+    "QueryRuntimeStatistics":{
+      "type":"structure",
+      "members":{
+        "Timeline":{"shape":"QueryRuntimeStatisticsTimeline"},
+        "Rows":{"shape":"QueryRuntimeStatisticsRows"},
+        "OutputStage":{
+          "shape":"QueryStage",
+          "documentation":"<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>"
+        }
+      },
+      "documentation":"<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>"
+    },
+    "QueryRuntimeStatisticsRows":{
+      "type":"structure",
+      "members":{
+        "InputRows":{
+          "shape":"Long",
+          "documentation":"<p>The number of rows read to execute the query.</p>"
+        },
+        "InputBytes":{
+          "shape":"Long",
+          "documentation":"<p>The number of bytes read to execute the query.</p>"
+        },
+        "OutputBytes":{
+          "shape":"Long",
+          "documentation":"<p>The number of bytes returned by the query.</p>"
+        },
+        "OutputRows":{
+          "shape":"Long",
+          "documentation":"<p>The number of rows returned by the query.</p>"
+        }
+      },
+      "documentation":"<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>"
+    },
+    "QueryRuntimeStatisticsTimeline":{
+      "type":"structure",
+      "members":{
+        "QueryQueueTimeInMillis":{
+          "shape":"Long",
+          "documentation":"<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>"
+        },
+        "QueryPlanningTimeInMillis":{
+          "shape":"Long",
+          "documentation":"<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>"
+        },
+        "EngineExecutionTimeInMillis":{
+          "shape":"Long",
+          "documentation":"<p>The number of milliseconds that the query took to execute.</p>"
+        },
+        "ServiceProcessingTimeInMillis":{
+          "shape":"Long",
+          "documentation":"<p>The number of milliseconds that Athena took to finalize and publish the query results after the query engine finished running the query.</p>"
+        },
+        "TotalExecutionTimeInMillis":{
+          "shape":"Long",
+          "documentation":"<p>The number of milliseconds that Athena took to run the query.</p>"
+        }
+      },
+      "documentation":"<p>Timeline statistics such as query queue time, planning time, execution time, service processing time, and total execution time.</p>"
+    },
+    "QueryStage":{
+      "type":"structure",
+      "members":{
+        "StageId":{
+          "shape":"Long",
+          "documentation":"<p>The identifier for a stage.</p>"
+        },
+        "State":{
+          "shape":"String",
+          "documentation":"<p>State of the stage after query execution.</p>"
+        },
+        "OutputBytes":{
+          "shape":"Long",
+          "documentation":"<p>The number of bytes output from the stage after execution.</p>"
+        },
+        "OutputRows":{
+          "shape":"Long",
+          "documentation":"<p>The number of rows output from the stage after execution.</p>"
+        },
+        "InputBytes":{
+          "shape":"Long",
+          "documentation":"<p>The number of bytes input into the stage for execution.</p>"
+        },
+        "InputRows":{
+          "shape":"Long",
+          "documentation":"<p>The number of rows input into the stage for execution.</p>"
+        },
+        "ExecutionTime":{
+          "shape":"Long",
+          "documentation":"<p>Time taken to execute this stage.</p>"
+        },
+        "QueryStagePlan":{
+          "shape":"QueryStagePlanNode",
+          "documentation":"<p>Stage plan information such as name, identifier, sub plans, and source stages.</p>"
+        },
+        "SubStages":{
+          "shape":"QueryStages",
+          "documentation":"<p>List of sub query stages that form this stage execution plan.</p>"
+        }
+      },
+      "documentation":"<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>"
+    },
+    "QueryStagePlanNode":{
+      "type":"structure",
+      "members":{
+        "Name":{
+          "shape":"String",
+          "documentation":"<p>Name of the query stage plan that describes the operation this stage is performing as part of query execution.</p>"
+        },
+        "Identifier":{
+          "shape":"String",
+          "documentation":"<p>Information about the operation this query stage plan node is performing.</p>"
+        },
+        "Children":{
+          "shape":"QueryStagePlanNodes",
+          "documentation":"<p>Stage plan information such as name, identifier, sub plans, and remote sources of child plan nodes/</p>"
+        },
+        "RemoteSources":{
+          "shape":"StringList",
+          "documentation":"<p>Source plan node IDs.</p>"
+        }
+      },
+      "documentation":"<p>Stage plan information such as name, identifier, sub plans, and remote sources.</p>"
+    },
+    "QueryStagePlanNodes":{
+      "type":"list",
+      "member":{"shape":"QueryStagePlanNode"}
+    },
+    "QueryStages":{
+      "type":"list",
+      "member":{"shape":"QueryStage"}
+    },
     "QueryString":{
       "type":"string",
       "max":262144,
@@ -2167,6 +2332,10 @@
       }
     },
     "String":{"type":"string"},
+    "StringList":{
+      "type":"list",
+      "member":{"shape":"String"}
+    },
     "TableMetadata":{
       "type":"structure",
       "required":["Name"],

botocore/data/cloudwatch/2010-08-01/service-2.json

@@ -619,6 +619,19 @@
       "min":1
     },
     "ActionsEnabled":{"type":"boolean"},
+    "ActionsSuppressedBy":{
+      "type":"string",
+      "enum":[
+        "WaitPeriod",
+        "ExtensionPeriod",
+        "Alarm"
+      ]
+    },
+    "ActionsSuppressedReason":{
+      "type":"string",
+      "max":1024,
+      "min":0
+    },
     "AlarmArn":{
       "type":"string",
       "max":1600,
@@ -863,11 +876,35 @@
         },
         "StateUpdatedTimestamp":{
           "shape":"Timestamp",
-          "documentation":"<p>The time stamp of the last update to the alarm state.</p>"
+          "documentation":"<p>Tracks the timestamp of any state update, even if <code>StateValue</code> doesn't change.</p>"
         },
         "StateValue":{
           "shape":"StateValue",
           "documentation":"<p>The state value for the alarm.</p>"
+        },
+        "StateTransitionedTimestamp":{
+          "shape":"Timestamp",
+          "documentation":"<p> The timestamp of the last change to the alarm's <code>StateValue</code>. </p>"
+        },
+        "ActionsSuppressedBy":{
+          "shape":"ActionsSuppressedBy",
+          "documentation":"<p> When the value is <code>ALARM</code>, it means that the actions are suppressed because the suppressor alarm is in <code>ALARM</code> When the value is <code>WaitPeriod</code>, it means that the actions are suppressed because the composite alarm is waiting for the suppressor alarm to go into into the <code>ALARM</code> state. The maximum waiting time is as specified in <code>ActionsSuppressorWaitPeriod</code>. After this time, the composite alarm performs its actions. When the value is <code>ExtensionPeriod</code>, it means that the actions are suppressed because the composite alarm is waiting after the suppressor alarm went out of the <code>ALARM</code> state. The maximum waiting time is as specified in <code>ActionsSuppressorExtensionPeriod</code>. After this time, the composite alarm performs its actions. </p>"
+        },
+        "ActionsSuppressedReason":{
+          "shape":"ActionsSuppressedReason",
+          "documentation":"<p> Captures the reason for action suppression. </p>"
+        },
+        "ActionsSuppressor":{
+          "shape":"AlarmArn",
+          "documentation":"<p> Actions will be suppressed if the suppressor alarm is in the <code>ALARM</code> state. <code>ActionsSuppressor</code> can be an AlarmName or an Amazon Resource Name (ARN) from an existing alarm. </p>"
+        },
+        "ActionsSuppressorWaitPeriod":{
+          "shape":"SuppressorPeriod",
+          "documentation":"<p> The maximum time in seconds that the composite alarm waits for the suppressor alarm to go into the <code>ALARM</code> state. After this time, the composite alarm performs its actions. </p> <important> <p> <code>WaitPeriod</code> is required only when <code>ActionsSuppressor</code> is specified. </p> </important>"
+        },
+        "ActionsSuppressorExtensionPeriod":{
+          "shape":"SuppressorPeriod",
+          "documentation":"<p> The maximum time in seconds that the composite alarm waits after suppressor alarm goes out of the <code>ALARM</code> state. After this time, the composite alarm performs its actions. </p> <important> <p> <code>ExtensionPeriod</code> is required only when <code>ActionsSuppressor</code> is specified. </p> </important>"
         }
       },
       "documentation":"<p>The details about a composite alarm.</p>",
@@ -884,7 +921,13 @@
         "StateReason",
         "StateReasonData",
         "StateUpdatedTimestamp",
-        "StateValue"
+        "StateValue",
+        "StateTransitionedTimestamp",
+        "ActionsSuppressedBy",
+        "ActionsSuppressedReason",
+        "ActionsSuppressor",
+        "ActionsSuppressorWaitPeriod",
+        "ActionsSuppressorExtensionPeriod"
       ]
     },
     "CompositeAlarms":{
@@ -2889,6 +2932,18 @@
         "Tags":{
           "shape":"TagList",
           "documentation":"<p>A list of key-value pairs to associate with the composite alarm. You can associate as many as 50 tags with an alarm.</p> <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions, by granting a user permission to access or change only resources with certain tag values.</p>"
+        },
+        "ActionsSuppressor":{
+          "shape":"AlarmArn",
+          "documentation":"<p> Actions will be suppressed if the suppressor alarm is in the <code>ALARM</code> state. <code>ActionsSuppressor</code> can be an AlarmName or an Amazon Resource Name (ARN) from an existing alarm. </p>"
+        },
+        "ActionsSuppressorWaitPeriod":{
+          "shape":"SuppressorPeriod",
+          "documentation":"<p> The maximum time in seconds that the composite alarm waits for the suppressor alarm to go into the <code>ALARM</code> state. After this time, the composite alarm performs its actions. </p> <important> <p> <code>WaitPeriod</code> is required only when <code>ActionsSuppressor</code> is specified. </p> </important>"
+        },
+        "ActionsSuppressorExtensionPeriod":{
+          "shape":"SuppressorPeriod",
+          "documentation":"<p> The maximum time in seconds that the composite alarm waits after suppressor alarm goes out of the <code>ALARM</code> state. After this time, the composite alarm performs its actions. </p> <important> <p> <code>ExtensionPeriod</code> is required only when <code>ActionsSuppressor</code> is specified. </p> </important>"
         }
       }
     },
@@ -3377,6 +3432,7 @@
       "type":"integer",
       "min":1
     },
+    "SuppressorPeriod":{"type":"integer"},
     "Tag":{
       "type":"structure",
       "required":[

botocore/data/dms/2016-01-01/service-2.json

@@ -1343,7 +1343,7 @@
         },
         "EngineName":{
           "shape":"String",
-          "documentation":"<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>"
+          "documentation":"<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>"
         },
         "Username":{
           "shape":"String",
@@ -6393,7 +6393,7 @@
         },
         "TableState":{
           "shape":"String",
-          "documentation":"<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>"
+          "documentation":"<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>"
         },
         "ValidationPendingRecords":{
           "shape":"Long",