From 413f14012d0a3c30a7e3ef173716f018f6805d6e Mon Sep 17 00:00:00 2001 From: jonathan343 <43360731+jonathan343@users.noreply.github.com> Date: Tue, 16 Jul 2024 14:05:47 -0700 Subject: [PATCH 1/4] Update waiters to handle expected boolean values when matching errors (#3220) * Handle expected boolean values for waiter error matcher * Add changes entry --- .../next-release/bugfix-Waiter-88466.json | 5 +++ botocore/waiter.py | 10 +++++- tests/unit/test_waiters.py | 32 +++++++++++++++++++ 3 files changed, 46 insertions(+), 1 deletion(-) create mode 100644 .changes/next-release/bugfix-Waiter-88466.json diff --git a/.changes/next-release/bugfix-Waiter-88466.json b/.changes/next-release/bugfix-Waiter-88466.json new file mode 100644 index 0000000000..35e969b4cb --- /dev/null +++ b/.changes/next-release/bugfix-Waiter-88466.json @@ -0,0 +1,5 @@ +{ + "type": "bugfix", + "category": "Waiter", + "description": "Update waiters to handle expected boolean values when matching errors (`boto/botocore#3220 `__)" +} diff --git a/botocore/waiter.py b/botocore/waiter.py index 2362eebeda..47f71886d4 100644 --- a/botocore/waiter.py +++ b/botocore/waiter.py @@ -302,7 +302,15 @@ def acceptor_matches(response): # response. So response is still a dictionary, and in the case # of an error response will contain the "Error" and # "ResponseMetadata" key. - return response.get("Error", {}).get("Code", "") == expected + # When expected is True, accept any error code. + # When expected is False, check if any errors were encountered. + # Otherwise, check for a specific AWS error code. + if expected is True: + return "Error" in response and "Code" in response["Error"] + elif expected is False: + return "Error" not in response + else: + return response.get("Error", {}).get("Code", "") == expected return acceptor_matches diff --git a/tests/unit/test_waiters.py b/tests/unit/test_waiters.py index 62544e180a..7ec9b23e5c 100644 --- a/tests/unit/test_waiters.py +++ b/tests/unit/test_waiters.py @@ -189,6 +189,38 @@ def test_single_waiter_supports_error(self): success_acceptor({'Error': {'Code': 'DoesNotExistErorr'}}) ) + def test_single_waiter_supports_no_error(self): + single_waiter = { + 'acceptors': [ + { + 'state': 'success', + 'matcher': 'error', + 'expected': False, + } + ], + } + single_waiter.update(self.boiler_plate_config) + config = SingleWaiterConfig(single_waiter) + success_acceptor = config.acceptors[0].matcher_func + self.assertTrue(success_acceptor({})) + self.assertFalse(success_acceptor({'Error': {'Code': 'ExampleError'}})) + + def test_single_waiter_supports_any_error(self): + single_waiter = { + 'acceptors': [ + { + 'state': 'success', + 'matcher': 'error', + 'expected': True, + } + ], + } + single_waiter.update(self.boiler_plate_config) + config = SingleWaiterConfig(single_waiter) + success_acceptor = config.acceptors[0].matcher_func + self.assertTrue(success_acceptor({'Error': {'Code': 'ExampleError1'}})) + self.assertTrue(success_acceptor({'Error': {'Code': 'ExampleError2'}})) + def test_unknown_matcher(self): unknown_type = 'arbitrary_type' single_waiter = { From 6338ae19776debba138d7bd89612ef9405bd523a Mon Sep 17 00:00:00 2001 From: aws-sdk-python-automation Date: Thu, 18 Jul 2024 19:21:37 +0000 Subject: [PATCH 2/4] Update to latest models --- .../next-release/api-change-acmpca-8983.json | 5 + .../api-change-connect-24816.json | 5 + .../next-release/api-change-ec2-38874.json | 5 + .../api-change-firehose-44210.json | 5 + .../api-change-ivschat-68235.json | 5 + .../api-change-medialive-2443.json | 5 + .../next-release/api-change-rds-60841.json | 5 + .../api-change-sagemaker-39890.json | 5 + .../api-change-secretsmanager-33190.json | 5 + .../api-change-taxsettings-33097.json | 5 + .../api-change-timestreamquery-6736.json | 5 + ...api-change-workspacesthinclient-53210.json | 5 + .../data/acm-pca/2017-08-22/waiters-2.json | 136 ++--- .../data/connect/2017-08-08/paginators-1.json | 18 + .../data/connect/2017-08-08/service-2.json | 306 +++++++++++- botocore/data/ec2/2016-11-15/service-2.json | 263 +++++++++- .../data/firehose/2015-08-04/service-2.json | 196 ++++++++ .../data/ivschat/2020-07-14/service-2.json | 471 +++++++++--------- .../data/ivschat/2020-07-14/waiters-2.json | 5 + .../data/medialive/2017-10-14/service-2.json | 207 +++++++- botocore/data/rds/2014-10-31/service-2.json | 16 +- .../data/sagemaker/2017-07-24/service-2.json | 40 +- .../secretsmanager/2017-10-17/service-2.json | 8 +- .../2018-05-10/endpoint-rule-set-1.json | 130 +++-- .../taxsettings/2018-05-10/service-2.json | 3 +- .../2018-11-01/service-2.json | 5 +- .../2023-08-22/service-2.json | 3 +- .../taxsettings/endpoint-tests-1.json | 324 ++++++++++-- 28 files changed, 1741 insertions(+), 450 deletions(-) create mode 100644 .changes/next-release/api-change-acmpca-8983.json create mode 100644 .changes/next-release/api-change-connect-24816.json create mode 100644 .changes/next-release/api-change-ec2-38874.json create mode 100644 .changes/next-release/api-change-firehose-44210.json create mode 100644 .changes/next-release/api-change-ivschat-68235.json create mode 100644 .changes/next-release/api-change-medialive-2443.json create mode 100644 .changes/next-release/api-change-rds-60841.json create mode 100644 .changes/next-release/api-change-sagemaker-39890.json create mode 100644 .changes/next-release/api-change-secretsmanager-33190.json create mode 100644 .changes/next-release/api-change-taxsettings-33097.json create mode 100644 .changes/next-release/api-change-timestreamquery-6736.json create mode 100644 .changes/next-release/api-change-workspacesthinclient-53210.json create mode 100644 botocore/data/ivschat/2020-07-14/waiters-2.json diff --git a/.changes/next-release/api-change-acmpca-8983.json b/.changes/next-release/api-change-acmpca-8983.json new file mode 100644 index 0000000000..8f3e29022c --- /dev/null +++ b/.changes/next-release/api-change-acmpca-8983.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``acm-pca``", + "description": "Fix broken waiters for the acm-pca client. Waiters broke in version 1.13.144 of the Boto3 SDK." +} diff --git a/.changes/next-release/api-change-connect-24816.json b/.changes/next-release/api-change-connect-24816.json new file mode 100644 index 0000000000..75dc961761 --- /dev/null +++ b/.changes/next-release/api-change-connect-24816.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``connect``", + "description": "Amazon Connect expands search API coverage for additional resources. Search for hierarchy groups by name, ID, tag, or other criteria (new endpoint). Search for agent statuses by name, ID, tag, or other criteria (new endpoint). Search for users by their assigned proficiencies (enhanced endpoint)" +} diff --git a/.changes/next-release/api-change-ec2-38874.json b/.changes/next-release/api-change-ec2-38874.json new file mode 100644 index 0000000000..0985d3a431 --- /dev/null +++ b/.changes/next-release/api-change-ec2-38874.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``ec2``", + "description": "Amazon VPC IP Address Manager (IPAM) now supports Bring-Your-Own-IP (BYOIP) for IP addresses registered with any Internet Registry. This feature uses DNS TXT records to validate ownership of a public IP address range." +} diff --git a/.changes/next-release/api-change-firehose-44210.json b/.changes/next-release/api-change-firehose-44210.json new file mode 100644 index 0000000000..9f594be5ff --- /dev/null +++ b/.changes/next-release/api-change-firehose-44210.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``firehose``", + "description": "This release 1) Add configurable buffering hints for Snowflake as destination. 2) Add ReadFromTimestamp for MSK As Source. Firehose will start reading data from MSK Cluster using offset associated with this timestamp. 3) Gated public beta release to add Apache Iceberg tables as destination." +} diff --git a/.changes/next-release/api-change-ivschat-68235.json b/.changes/next-release/api-change-ivschat-68235.json new file mode 100644 index 0000000000..ec1afdcfa3 --- /dev/null +++ b/.changes/next-release/api-change-ivschat-68235.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``ivschat``", + "description": "Documentation update for IVS Chat API Reference." +} diff --git a/.changes/next-release/api-change-medialive-2443.json b/.changes/next-release/api-change-medialive-2443.json new file mode 100644 index 0000000000..c10f3a88b2 --- /dev/null +++ b/.changes/next-release/api-change-medialive-2443.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``medialive``", + "description": "AWS Elemental MediaLive now supports the SRT protocol via the new SRT Caller input type." +} diff --git a/.changes/next-release/api-change-rds-60841.json b/.changes/next-release/api-change-rds-60841.json new file mode 100644 index 0000000000..e8522a49b2 --- /dev/null +++ b/.changes/next-release/api-change-rds-60841.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``rds``", + "description": "Updates Amazon RDS documentation to specify an eventual consistency model for DescribePendingMaintenanceActions." +} diff --git a/.changes/next-release/api-change-sagemaker-39890.json b/.changes/next-release/api-change-sagemaker-39890.json new file mode 100644 index 0000000000..43a7aacf4b --- /dev/null +++ b/.changes/next-release/api-change-sagemaker-39890.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``sagemaker``", + "description": "SageMaker Training supports R5, T3 and R5D instances family. And SageMaker Processing supports G5 and R5D instances family." +} diff --git a/.changes/next-release/api-change-secretsmanager-33190.json b/.changes/next-release/api-change-secretsmanager-33190.json new file mode 100644 index 0000000000..32e0eb5f7c --- /dev/null +++ b/.changes/next-release/api-change-secretsmanager-33190.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``secretsmanager``", + "description": "Doc only update for Secrets Manager" +} diff --git a/.changes/next-release/api-change-taxsettings-33097.json b/.changes/next-release/api-change-taxsettings-33097.json new file mode 100644 index 0000000000..bb31ac0e21 --- /dev/null +++ b/.changes/next-release/api-change-taxsettings-33097.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``taxsettings``", + "description": "Set default endpoint for aws partition. Requests from all regions in aws partition will be forward to us-east-1 endpoint." +} diff --git a/.changes/next-release/api-change-timestreamquery-6736.json b/.changes/next-release/api-change-timestreamquery-6736.json new file mode 100644 index 0000000000..35c8830020 --- /dev/null +++ b/.changes/next-release/api-change-timestreamquery-6736.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``timestream-query``", + "description": "Doc-only update for TimestreamQuery. Added guidance about the accepted valid value for the QueryPricingModel parameter." +} diff --git a/.changes/next-release/api-change-workspacesthinclient-53210.json b/.changes/next-release/api-change-workspacesthinclient-53210.json new file mode 100644 index 0000000000..e1e662a357 --- /dev/null +++ b/.changes/next-release/api-change-workspacesthinclient-53210.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``workspaces-thin-client``", + "description": "Documentation update for WorkSpaces Thin Client." +} diff --git a/botocore/data/acm-pca/2017-08-22/waiters-2.json b/botocore/data/acm-pca/2017-08-22/waiters-2.json index 3e8a70a392..6da2171132 100644 --- a/botocore/data/acm-pca/2017-08-22/waiters-2.json +++ b/botocore/data/acm-pca/2017-08-22/waiters-2.json @@ -1,64 +1,76 @@ { - "version" : 2, - "waiters" : { - "AuditReportCreated" : { - "description" : "Wait until a Audit Report is created", - "delay" : 3, - "maxAttempts" : 40, - "operation" : "DescribeCertificateAuthorityAuditReport", - "acceptors" : [ { - "matcher" : "path", - "argument" : "AuditReportStatus", - "state" : "success", - "expected" : "SUCCESS" - }, { - "matcher" : "path", - "argument" : "AuditReportStatus", - "state" : "failure", - "expected" : "FAILED" - }, { - "matcher" : "error", - "state" : "failure", - "expected" : "AccessDeniedException" - } ] - }, - "CertificateAuthorityCSRCreated" : { - "description" : "Wait until a Certificate Authority CSR is created", - "delay" : 3, - "maxAttempts" : 40, - "operation" : "GetCertificateAuthorityCsr", - "acceptors" : [ { - "matcher" : "error", - "state" : "success", - "expected" : false - }, { - "matcher" : "error", - "state" : "retry", - "expected" : "RequestInProgressException" - }, { - "matcher" : "error", - "state" : "failure", - "expected" : "AccessDeniedException" - } ] - }, - "CertificateIssued" : { - "description" : "Wait until a certificate is issued", - "delay" : 1, - "maxAttempts" : 120, - "operation" : "GetCertificate", - "acceptors" : [ { - "matcher" : "error", - "state" : "success", - "expected" : false - }, { - "matcher" : "error", - "state" : "retry", - "expected" : "RequestInProgressException" - }, { - "matcher" : "error", - "state" : "failure", - "expected" : "AccessDeniedException" - } ] + "version": 2, + "waiters": { + "CertificateAuthorityCSRCreated": { + "description": "Wait until a Certificate Authority CSR is created", + "operation": "GetCertificateAuthorityCsr", + "delay": 3, + "maxAttempts": 60, + "acceptors": [ + { + "state": "success", + "matcher": "status", + "expected": 200 + }, + { + "state": "retry", + "matcher": "error", + "expected": "RequestInProgressException" + }, + { + "state": "failure", + "matcher": "error", + "expected": "AccessDeniedException" + } + ] + }, + "CertificateIssued": { + "description": "Wait until a certificate is issued", + "operation": "GetCertificate", + "delay": 1, + "maxAttempts": 60, + "acceptors": [ + { + "state": "success", + "matcher": "status", + "expected": 200 + }, + { + "state": "retry", + "matcher": "error", + "expected": "RequestInProgressException" + }, + { + "state": "failure", + "matcher": "error", + "expected": "AccessDeniedException" + } + ] + }, + "AuditReportCreated": { + "description": "Wait until a Audit Report is created", + "operation": "DescribeCertificateAuthorityAuditReport", + "delay": 3, + "maxAttempts": 60, + "acceptors": [ + { + "state": "success", + "matcher": "path", + "argument": "AuditReportStatus", + "expected": "SUCCESS" + }, + { + "state": "failure", + "matcher": "path", + "argument": "AuditReportStatus", + "expected": "FAILED" + }, + { + "state": "failure", + "matcher": "error", + "expected": "AccessDeniedException" + } + ] + } } - } -} \ No newline at end of file +} diff --git a/botocore/data/connect/2017-08-08/paginators-1.json b/botocore/data/connect/2017-08-08/paginators-1.json index 8cabe70b73..4358a0eeec 100644 --- a/botocore/data/connect/2017-08-08/paginators-1.json +++ b/botocore/data/connect/2017-08-08/paginators-1.json @@ -392,6 +392,24 @@ "limit_key": "MaxResults", "output_token": "NextToken", "result_key": "AuthenticationProfileSummaryList" + }, + "SearchAgentStatuses": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "non_aggregate_keys": [ + "ApproximateTotalCount" + ], + "output_token": "NextToken", + "result_key": "AgentStatuses" + }, + "SearchUserHierarchyGroups": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "non_aggregate_keys": [ + "ApproximateTotalCount" + ], + "output_token": "NextToken", + "result_key": "UserHierarchyGroups" } } } diff --git a/botocore/data/connect/2017-08-08/service-2.json b/botocore/data/connect/2017-08-08/service-2.json index febf835fd3..800da7ec0a 100644 --- a/botocore/data/connect/2017-08-08/service-2.json +++ b/botocore/data/connect/2017-08-08/service-2.json @@ -3006,6 +3006,23 @@ ], "documentation":"

When a contact is being recorded, and the recording has been suspended using SuspendContactRecording, this API resumes recording whatever recording is selected in the flow configuration: call, screen, or both. If only call recording or only screen recording is enabled, then it would resume.

Voice and screen recordings are supported.

" }, + "SearchAgentStatuses":{ + "name":"SearchAgentStatuses", + "http":{ + "method":"POST", + "requestUri":"/search-agent-statuses" + }, + "input":{"shape":"SearchAgentStatusesRequest"}, + "output":{"shape":"SearchAgentStatusesResponse"}, + "errors":[ + {"shape":"InvalidRequestException"}, + {"shape":"InvalidParameterException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"ThrottlingException"}, + {"shape":"InternalServiceException"} + ], + "documentation":"

Searches AgentStatuses in an Amazon Connect instance, with optional filtering.

" + }, "SearchAvailablePhoneNumbers":{ "name":"SearchAvailablePhoneNumbers", "http":{ @@ -3210,6 +3227,23 @@ ], "documentation":"

Searches security profiles in an Amazon Connect instance, with optional filtering.

" }, + "SearchUserHierarchyGroups":{ + "name":"SearchUserHierarchyGroups", + "http":{ + "method":"POST", + "requestUri":"/search-user-hierarchy-groups" + }, + "input":{"shape":"SearchUserHierarchyGroupsRequest"}, + "output":{"shape":"SearchUserHierarchyGroupsResponse"}, + "errors":[ + {"shape":"InvalidRequestException"}, + {"shape":"InvalidParameterException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"ThrottlingException"}, + {"shape":"InternalServiceException"} + ], + "documentation":"

Searches UserHierarchyGroups in an Amazon Connect instance, with optional filtering.

The UserHierarchyGroup with \"LevelId\": \"0\" is the foundation for building levels on top of an instance. It is not user-definable, nor is it visible in the UI.

" + }, "SearchUsers":{ "name":"SearchUsers", "http":{ @@ -4680,6 +4714,10 @@ "min":1 }, "AgentStatusId":{"type":"string"}, + "AgentStatusList":{ + "type":"list", + "member":{"shape":"AgentStatus"} + }, "AgentStatusName":{ "type":"string", "max":127, @@ -4708,6 +4746,38 @@ }, "documentation":"

Information about the agent's status.

" }, + "AgentStatusSearchConditionList":{ + "type":"list", + "member":{"shape":"AgentStatusSearchCriteria"} + }, + "AgentStatusSearchCriteria":{ + "type":"structure", + "members":{ + "OrConditions":{ + "shape":"AgentStatusSearchConditionList", + "documentation":"

A list of conditions which would be applied together with an OR condition.

" + }, + "AndConditions":{ + "shape":"AgentStatusSearchConditionList", + "documentation":"

A leaf node condition which can be used to specify a string condition.

The currently supported values for FieldName are name,

 description, state, type, displayOrder,
 and resourceID.

" + }, + "StringCondition":{ + "shape":"StringCondition", + "documentation":"

A leaf node condition which can be used to specify a string condition.

The currently supported values for FieldName are name,

 description, state, type, displayOrder,
 and resourceID.

" + } + }, + "documentation":"

The search criteria to be used to return agent statuses.

" + }, + "AgentStatusSearchFilter":{ + "type":"structure", + "members":{ + "AttributeFilter":{ + "shape":"ControlPlaneAttributeFilter", + "documentation":"

An object that can be used to specify Tag conditions inside the SearchFilter. This accepts an OR of AND (List of List) input where:

" + } + }, + "documentation":"

Filters to be applied to search results.

" + }, "AgentStatusState":{ "type":"string", "enum":[ @@ -6078,6 +6148,20 @@ "type":"string", "max":500 }, + "CommonAttributeAndCondition":{ + "type":"structure", + "members":{ + "TagConditions":{ + "shape":"TagAndConditionList", + "documentation":"

A leaf node condition which can be used to specify a tag condition.

" + } + }, + "documentation":"

A list of conditions which would be applied together with an AND condition.

" + }, + "CommonAttributeOrConditionList":{ + "type":"list", + "member":{"shape":"CommonAttributeAndCondition"} + }, "CommonNameLength127":{ "type":"string", "max":127, @@ -6132,6 +6216,24 @@ "max":10, "min":1 }, + "Condition":{ + "type":"structure", + "members":{ + "StringCondition":{ + "shape":"StringCondition", + "documentation":"

A leaf node condition which can be used to specify a string condition.

The currently supported values for FieldName are name and
 value.

" + }, + "NumberCondition":{ + "shape":"NumberCondition", + "documentation":"

A leaf node condition which can be used to specify a numeric condition.

" + } + }, + "documentation":"

A leaf node condition which can be used to specify a ProficiencyName, ProficiencyValue and ProficiencyLimit.

" + }, + "Conditions":{ + "type":"list", + "member":{"shape":"Condition"} + }, "ConflictException":{ "type":"structure", "members":{ @@ -6812,6 +6914,21 @@ "max":255, "min":1 }, + "ControlPlaneAttributeFilter":{ + "type":"structure", + "members":{ + "OrConditions":{ + "shape":"CommonAttributeOrConditionList", + "documentation":"

A list of conditions which would be applied together with an OR condition.

" + }, + "AndCondition":{ + "shape":"CommonAttributeAndCondition", + "documentation":"

A list of conditions which would be applied together with an AND condition.

" + }, + "TagCondition":{"shape":"TagCondition"} + }, + "documentation":"

An object that can be used to specify Tag conditions inside the SearchFilter. This accepts an OR or AND (List of List) input where:

" + }, "ControlPlaneTagFilter":{ "type":"structure", "members":{ @@ -11801,7 +11918,7 @@ }, "Metrics":{ "shape":"MetricsV2", - "documentation":"

The metrics to retrieve. Specify the name, groupings, and filters for each metric. The following historical metrics are available. For a description of each metric, see Historical metrics definitions in the Amazon Connect Administrator Guide.

ABANDONMENT_RATE

Unit: Percent

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Abandonment rate

AGENT_ADHERENT_TIME

This metric is available only in Amazon Web Services Regions where Forecasting, capacity planning, and scheduling is available.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Adherent time

AGENT_ANSWER_RATE

Unit: Percent

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Agent answer rate

AGENT_NON_ADHERENT_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Non-adherent time

AGENT_NON_RESPONSE

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Agent non-response

AGENT_NON_RESPONSE_WITHOUT_CUSTOMER_ABANDONS

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

Data for this metric is available starting from October 1, 2023 0:00:00 GMT.

UI name: Agent non-response without customer abandons

AGENT_OCCUPANCY

Unit: Percentage

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Occupancy

AGENT_SCHEDULE_ADHERENCE

This metric is available only in Amazon Web Services Regions where Forecasting, capacity planning, and scheduling is available.

Unit: Percent

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Adherence

AGENT_SCHEDULED_TIME

This metric is available only in Amazon Web Services Regions where Forecasting, capacity planning, and scheduling is available.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Scheduled time

AVG_ABANDON_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average queue abandon time

AVG_ACTIVE_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Average active time

AVG_AFTER_CONTACT_WORK_TIME

Unit: Seconds

Valid metric filter key: INITIATION_METHOD

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average after contact work time

Feature is a valid filter but not a valid grouping.
AVG_AGENT_CONNECTING_TIME

Unit: Seconds

Valid metric filter key: INITIATION_METHOD. For now, this metric only supports the following as INITIATION_METHOD: INBOUND | OUTBOUND | CALLBACK | API

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Average agent API connecting time

The Negate key in Metric Level Filters is not applicable for this metric.
AVG_AGENT_PAUSE_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Average agent pause time

AVG_CASE_RELATED_CONTACTS

Unit: Count

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Average contacts per case

AVG_CASE_RESOLUTION_TIME

Unit: Seconds

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Average case resolution time

AVG_CONTACT_DURATION

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average contact duration

Feature is a valid filter but not a valid grouping.
AVG_CONVERSATION_DURATION

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average conversation duration

AVG_FLOW_TIME

Unit: Seconds

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows next resource ID, Flows next resource queue ID, Flows outcome type, Flows resource ID, Initiation method, Resource published timestamp

UI name: Average flow time

AVG_GREETING_TIME_AGENT

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent greeting time

AVG_HANDLE_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, RoutingStepExpression

UI name: Average handle time

Feature is a valid filter but not a valid grouping.
AVG_HOLD_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average customer hold time

Feature is a valid filter but not a valid grouping.
AVG_HOLD_TIME_ALL_CONTACTS

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average customer hold time all contacts

AVG_HOLDS

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average holds

Feature is a valid filter but not a valid grouping.
AVG_INTERACTION_AND_HOLD_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent interaction and customer hold time

AVG_INTERACTION_TIME

Unit: Seconds

Valid metric filter key: INITIATION_METHOD

Valid groupings and filters: Queue, Channel, Routing Profile, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent interaction time

Feature is a valid filter but not a valid grouping.
AVG_INTERRUPTIONS_AGENT

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent interruptions

AVG_INTERRUPTION_TIME_AGENT

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent interruption time

AVG_NON_TALK_TIME

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average non-talk time

AVG_QUEUE_ANSWER_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average queue answer time

Feature is a valid filter but not a valid grouping.
AVG_RESOLUTION_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average resolution time

AVG_TALK_TIME

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average talk time

AVG_TALK_TIME_AGENT

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent talk time

AVG_TALK_TIME_CUSTOMER

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average customer talk time

CASES_CREATED

Unit: Count

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Cases created

CONTACTS_CREATED

Unit: Count

Valid metric filter key: INITIATION_METHOD

Valid groupings and filters: Queue, Channel, Routing Profile, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts created

Feature is a valid filter but not a valid grouping.
CONTACTS_HANDLED

Unit: Count

Valid metric filter key: INITIATION_METHOD, DISCONNECT_REASON

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, RoutingStepExpression, Q in Connect

UI name: API contacts handled

Feature is a valid filter but not a valid grouping.
CONTACTS_HANDLED_BY_CONNECTED_TO_AGENT

Unit: Count

Valid metric filter key: INITIATION_METHOD

Valid groupings and filters: Queue, Channel, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts handled (connected to agent timestamp)

CONTACTS_HOLD_ABANDONS

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts hold disconnect

CONTACTS_ON_HOLD_AGENT_DISCONNECT

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contacts hold agent disconnect

CONTACTS_ON_HOLD_CUSTOMER_DISCONNECT

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contacts hold customer disconnect

CONTACTS_PUT_ON_HOLD

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contacts put on hold

CONTACTS_TRANSFERRED_OUT_EXTERNAL

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contacts transferred out external

CONTACTS_TRANSFERRED_OUT_INTERNAL

Unit: Percent

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contacts transferred out internal

CONTACTS_QUEUED

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts queued

CONTACTS_QUEUED_BY_ENQUEUE

Unit: Count

Valid groupings and filters: Queue, Channel, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype

UI name: Contacts queued (enqueue timestamp)

CONTACTS_REMOVED_FROM_QUEUE_IN_X

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Q in Connect

Threshold: For ThresholdValue, enter any whole number from 1 to 604800 (inclusive), in seconds. For Comparison, you must enter LT (for \"Less than\").

UI name: This metric is not available in Amazon Connect admin website.

CONTACTS_RESOLVED_IN_X

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, contact/segmentAttributes/connect:Subtype, Q in Connect

Threshold: For ThresholdValue enter any whole number from 1 to 604800 (inclusive), in seconds. For Comparison, you must enter LT (for \"Less than\").

UI name: Contacts resolved in X

CONTACTS_TRANSFERRED_OUT

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts transferred out

Feature is a valid filter but not a valid grouping.
CONTACTS_TRANSFERRED_OUT_BY_AGENT

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts transferred out by agent

CONTACTS_TRANSFERRED_OUT_FROM_QUEUE

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts transferred out queue

CURRENT_CASES

Unit: Count

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Current cases

FLOWS_OUTCOME

Unit: Count

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows next resource ID, Flows next resource queue ID, Flows outcome type, Flows resource ID, Initiation method, Resource published timestamp

UI name: Flows outcome

FLOWS_STARTED

Unit: Count

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows resource ID, Initiation method, Resource published timestamp

UI name: Flows started

MAX_FLOW_TIME

Unit: Seconds

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows next resource ID, Flows next resource queue ID, Flows outcome type, Flows resource ID, Initiation method, Resource published timestamp

UI name: Maximum flow time

MAX_QUEUED_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Maximum queued time

MIN_FLOW_TIME

Unit: Seconds

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows next resource ID, Flows next resource queue ID, Flows outcome type, Flows resource ID, Initiation method, Resource published timestamp

UI name: Minimum flow time

PERCENT_CASES_FIRST_CONTACT_RESOLVED

Unit: Percent

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Cases resolved on first contact

PERCENT_CONTACTS_STEP_EXPIRED

Unit: Percent

Valid groupings and filters: Queue, RoutingStepExpression

UI name: This metric is available in Real-time Metrics UI but not on the Historical Metrics UI.

PERCENT_CONTACTS_STEP_JOINED

Unit: Percent

Valid groupings and filters: Queue, RoutingStepExpression

UI name: This metric is available in Real-time Metrics UI but not on the Historical Metrics UI.

PERCENT_FLOWS_OUTCOME

Unit: Percent

Valid metric filter key: FLOWS_OUTCOME_TYPE

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows next resource ID, Flows next resource queue ID, Flows outcome type, Flows resource ID, Initiation method, Resource published timestamp

UI name: Flows outcome percentage.

The FLOWS_OUTCOME_TYPE is not a valid grouping.
PERCENT_NON_TALK_TIME

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Percentage

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Non-talk time percent

PERCENT_TALK_TIME

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Percentage

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Talk time percent

PERCENT_TALK_TIME_AGENT

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Percentage

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Agent talk time percent

PERCENT_TALK_TIME_CUSTOMER

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Percentage

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Customer talk time percent

REOPENED_CASE_ACTIONS

Unit: Count

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Cases reopened

RESOLVED_CASE_ACTIONS

Unit: Count

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Cases resolved

SERVICE_LEVEL

You can include up to 20 SERVICE_LEVEL metrics in a request.

Unit: Percent

Valid groupings and filters: Queue, Channel, Routing Profile, Q in Connect

Threshold: For ThresholdValue, enter any whole number from 1 to 604800 (inclusive), in seconds. For Comparison, you must enter LT (for \"Less than\").

UI name: Service level X

STEP_CONTACTS_QUEUED

Unit: Count

Valid groupings and filters: Queue, RoutingStepExpression

UI name: This metric is available in Real-time Metrics UI but not on the Historical Metrics UI.

SUM_AFTER_CONTACT_WORK_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: After contact work time

SUM_CONNECTING_TIME_AGENT

Unit: Seconds

Valid metric filter key: INITIATION_METHOD. This metric only supports the following filter keys as INITIATION_METHOD: INBOUND | OUTBOUND | CALLBACK | API

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Agent API connecting time

The Negate key in Metric Level Filters is not applicable for this metric.
SUM_CONTACTS_ABANDONED

Unit: Count

Metric filter:

  • Valid values: API| Incoming | Outbound | Transfer | Callback | Queue_Transfer| Disconnect

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, RoutingStepExpression, Q in Connect

UI name: Contact abandoned

SUM_CONTACTS_ABANDONED_IN_X

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, contact/segmentAttributes/connect:Subtype, Q in Connect

Threshold: For ThresholdValue, enter any whole number from 1 to 604800 (inclusive), in seconds. For Comparison, you must enter LT (for \"Less than\").

UI name: Contacts abandoned in X seconds

SUM_CONTACTS_ANSWERED_IN_X

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, contact/segmentAttributes/connect:Subtype, Q in Connect

Threshold: For ThresholdValue, enter any whole number from 1 to 604800 (inclusive), in seconds. For Comparison, you must enter LT (for \"Less than\").

UI name: Contacts answered in X seconds

SUM_CONTACT_FLOW_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contact flow time

SUM_CONTACT_TIME_AGENT

Unit: Seconds

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Agent on contact time

SUM_CONTACTS_DISCONNECTED

Valid metric filter key: DISCONNECT_REASON

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contact disconnected

SUM_ERROR_STATUS_TIME_AGENT

Unit: Seconds

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Error status time

SUM_HANDLE_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contact handle time

SUM_HOLD_TIME

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Customer hold time

SUM_IDLE_TIME_AGENT

Unit: Seconds

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Agent idle time

SUM_INTERACTION_AND_HOLD_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Agent interaction and hold time

SUM_INTERACTION_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Agent interaction time

SUM_NON_PRODUCTIVE_TIME_AGENT

Unit: Seconds

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Non-Productive Time

SUM_ONLINE_TIME_AGENT

Unit: Seconds

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Online time

SUM_RETRY_CALLBACK_ATTEMPTS

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Callback attempts

" + "documentation":"

The metrics to retrieve. Specify the name, groupings, and filters for each metric. The following historical metrics are available. For a description of each metric, see Historical metrics definitions in the Amazon Connect Administrator Guide.

ABANDONMENT_RATE

Unit: Percent

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Abandonment rate

AGENT_ADHERENT_TIME

This metric is available only in Amazon Web Services Regions where Forecasting, capacity planning, and scheduling is available.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Adherent time

AGENT_ANSWER_RATE

Unit: Percent

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Agent answer rate

AGENT_NON_ADHERENT_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Non-adherent time

AGENT_NON_RESPONSE

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Agent non-response

AGENT_NON_RESPONSE_WITHOUT_CUSTOMER_ABANDONS

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

Data for this metric is available starting from October 1, 2023 0:00:00 GMT.

UI name: Agent non-response without customer abandons

AGENT_OCCUPANCY

Unit: Percentage

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Occupancy

AGENT_SCHEDULE_ADHERENCE

This metric is available only in Amazon Web Services Regions where Forecasting, capacity planning, and scheduling is available.

Unit: Percent

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Adherence

AGENT_SCHEDULED_TIME

This metric is available only in Amazon Web Services Regions where Forecasting, capacity planning, and scheduling is available.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Scheduled time

AVG_ABANDON_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average queue abandon time

AVG_ACTIVE_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Average active time

AVG_AFTER_CONTACT_WORK_TIME

Unit: Seconds

Valid metric filter key: INITIATION_METHOD

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average after contact work time

Feature is a valid filter but not a valid grouping.
AVG_AGENT_CONNECTING_TIME

Unit: Seconds

Valid metric filter key: INITIATION_METHOD. For now, this metric only supports the following as INITIATION_METHOD: INBOUND | OUTBOUND | CALLBACK | API

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Average agent API connecting time

The Negate key in Metric Level Filters is not applicable for this metric.
AVG_AGENT_PAUSE_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Average agent pause time

AVG_CASE_RELATED_CONTACTS

Unit: Count

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Average contacts per case

AVG_CASE_RESOLUTION_TIME

Unit: Seconds

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Average case resolution time

AVG_CONTACT_DURATION

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average contact duration

Feature is a valid filter but not a valid grouping.
AVG_CONVERSATION_DURATION

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average conversation duration

AVG_FLOW_TIME

Unit: Seconds

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows next resource ID, Flows next resource queue ID, Flows outcome type, Flows resource ID, Initiation method, Resource published timestamp

UI name: Average flow time

AVG_GREETING_TIME_AGENT

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent greeting time

AVG_HANDLE_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, RoutingStepExpression

UI name: Average handle time

Feature is a valid filter but not a valid grouping.
AVG_HOLD_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average customer hold time

Feature is a valid filter but not a valid grouping.
AVG_HOLD_TIME_ALL_CONTACTS

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average customer hold time all contacts

AVG_HOLDS

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average holds

Feature is a valid filter but not a valid grouping.
AVG_INTERACTION_AND_HOLD_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent interaction and customer hold time

AVG_INTERACTION_TIME

Unit: Seconds

Valid metric filter key: INITIATION_METHOD

Valid groupings and filters: Queue, Channel, Routing Profile, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent interaction time

Feature is a valid filter but not a valid grouping.
AVG_INTERRUPTIONS_AGENT

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent interruptions

AVG_INTERRUPTION_TIME_AGENT

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent interruption time

AVG_NON_TALK_TIME

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average non-talk time

AVG_QUEUE_ANSWER_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average queue answer time

Feature is a valid filter but not a valid grouping.
AVG_RESOLUTION_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average resolution time

AVG_TALK_TIME

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average talk time

AVG_TALK_TIME_AGENT

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average agent talk time

AVG_TALK_TIME_CUSTOMER

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Average customer talk time

CASES_CREATED

Unit: Count

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Cases created

CONTACTS_CREATED

Unit: Count

Valid metric filter key: INITIATION_METHOD

Valid groupings and filters: Queue, Channel, Routing Profile, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts created

Feature is a valid filter but not a valid grouping.
CONTACTS_HANDLED

Unit: Count

Valid metric filter key: INITIATION_METHOD, DISCONNECT_REASON

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, RoutingStepExpression, Q in Connect

UI name: API contacts handled

Feature is a valid filter but not a valid grouping.
CONTACTS_HANDLED_BY_CONNECTED_TO_AGENT

Unit: Count

Valid metric filter key: INITIATION_METHOD

Valid groupings and filters: Queue, Channel, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts handled (connected to agent timestamp)

CONTACTS_HOLD_ABANDONS

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts hold disconnect

CONTACTS_ON_HOLD_AGENT_DISCONNECT

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contacts hold agent disconnect

CONTACTS_ON_HOLD_CUSTOMER_DISCONNECT

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contacts hold customer disconnect

CONTACTS_PUT_ON_HOLD

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contacts put on hold

CONTACTS_TRANSFERRED_OUT_EXTERNAL

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contacts transferred out external

CONTACTS_TRANSFERRED_OUT_INTERNAL

Unit: Percent

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contacts transferred out internal

CONTACTS_QUEUED

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts queued

CONTACTS_QUEUED_BY_ENQUEUE

Unit: Count

Valid groupings and filters: Queue, Channel, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype

UI name: Contacts queued (enqueue timestamp)

CONTACTS_REMOVED_FROM_QUEUE_IN_X

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Q in Connect

Threshold: For ThresholdValue, enter any whole number from 1 to 604800 (inclusive), in seconds. For Comparison, you must enter LT (for \"Less than\").

UI name: Contacts removed from queue in X seconds

CONTACTS_RESOLVED_IN_X

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, contact/segmentAttributes/connect:Subtype, Q in Connect

Threshold: For ThresholdValue enter any whole number from 1 to 604800 (inclusive), in seconds. For Comparison, you must enter LT (for \"Less than\").

UI name: Contacts resolved in X

CONTACTS_TRANSFERRED_OUT

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Feature, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts transferred out

Feature is a valid filter but not a valid grouping.
CONTACTS_TRANSFERRED_OUT_BY_AGENT

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts transferred out by agent

CONTACTS_TRANSFERRED_OUT_FROM_QUEUE

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contacts transferred out queue

CURRENT_CASES

Unit: Count

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Current cases

FLOWS_OUTCOME

Unit: Count

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows next resource ID, Flows next resource queue ID, Flows outcome type, Flows resource ID, Initiation method, Resource published timestamp

UI name: Flows outcome

FLOWS_STARTED

Unit: Count

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows resource ID, Initiation method, Resource published timestamp

UI name: Flows started

MAX_FLOW_TIME

Unit: Seconds

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows next resource ID, Flows next resource queue ID, Flows outcome type, Flows resource ID, Initiation method, Resource published timestamp

UI name: Maximum flow time

MAX_QUEUED_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Maximum queued time

MIN_FLOW_TIME

Unit: Seconds

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows next resource ID, Flows next resource queue ID, Flows outcome type, Flows resource ID, Initiation method, Resource published timestamp

UI name: Minimum flow time

PERCENT_CASES_FIRST_CONTACT_RESOLVED

Unit: Percent

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Cases resolved on first contact

PERCENT_CONTACTS_STEP_EXPIRED

Unit: Percent

Valid groupings and filters: Queue, RoutingStepExpression

UI name: This metric is available in Real-time Metrics UI but not on the Historical Metrics UI.

PERCENT_CONTACTS_STEP_JOINED

Unit: Percent

Valid groupings and filters: Queue, RoutingStepExpression

UI name: This metric is available in Real-time Metrics UI but not on the Historical Metrics UI.

PERCENT_FLOWS_OUTCOME

Unit: Percent

Valid metric filter key: FLOWS_OUTCOME_TYPE

Valid groupings and filters: Channel, contact/segmentAttributes/connect:Subtype, Flow type, Flows module resource ID, Flows next resource ID, Flows next resource queue ID, Flows outcome type, Flows resource ID, Initiation method, Resource published timestamp

UI name: Flows outcome percentage.

The FLOWS_OUTCOME_TYPE is not a valid grouping.
PERCENT_NON_TALK_TIME

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Percentage

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Non-talk time percent

PERCENT_TALK_TIME

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Percentage

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Talk time percent

PERCENT_TALK_TIME_AGENT

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Percentage

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Agent talk time percent

PERCENT_TALK_TIME_CUSTOMER

This metric is available only for contacts analyzed by Contact Lens conversational analytics.

Unit: Percentage

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Customer talk time percent

REOPENED_CASE_ACTIONS

Unit: Count

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Cases reopened

RESOLVED_CASE_ACTIONS

Unit: Count

Required filter key: CASE_TEMPLATE_ARN

Valid groupings and filters: CASE_TEMPLATE_ARN, CASE_STATUS

UI name: Cases resolved

SERVICE_LEVEL

You can include up to 20 SERVICE_LEVEL metrics in a request.

Unit: Percent

Valid groupings and filters: Queue, Channel, Routing Profile, Q in Connect

Threshold: For ThresholdValue, enter any whole number from 1 to 604800 (inclusive), in seconds. For Comparison, you must enter LT (for \"Less than\").

UI name: Service level X

STEP_CONTACTS_QUEUED

Unit: Count

Valid groupings and filters: Queue, RoutingStepExpression

UI name: This metric is available in Real-time Metrics UI but not on the Historical Metrics UI.

SUM_AFTER_CONTACT_WORK_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: After contact work time

SUM_CONNECTING_TIME_AGENT

Unit: Seconds

Valid metric filter key: INITIATION_METHOD. This metric only supports the following filter keys as INITIATION_METHOD: INBOUND | OUTBOUND | CALLBACK | API

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Agent API connecting time

The Negate key in Metric Level Filters is not applicable for this metric.
SUM_CONTACTS_ABANDONED

Unit: Count

Metric filter:

  • Valid values: API| Incoming | Outbound | Transfer | Callback | Queue_Transfer| Disconnect

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, RoutingStepExpression, Q in Connect

UI name: Contact abandoned

SUM_CONTACTS_ABANDONED_IN_X

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, contact/segmentAttributes/connect:Subtype, Q in Connect

Threshold: For ThresholdValue, enter any whole number from 1 to 604800 (inclusive), in seconds. For Comparison, you must enter LT (for \"Less than\").

UI name: Contacts abandoned in X seconds

SUM_CONTACTS_ANSWERED_IN_X

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, contact/segmentAttributes/connect:Subtype, Q in Connect

Threshold: For ThresholdValue, enter any whole number from 1 to 604800 (inclusive), in seconds. For Comparison, you must enter LT (for \"Less than\").

UI name: Contacts answered in X seconds

SUM_CONTACT_FLOW_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contact flow time

SUM_CONTACT_TIME_AGENT

Unit: Seconds

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Agent on contact time

SUM_CONTACTS_DISCONNECTED

Valid metric filter key: DISCONNECT_REASON

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Contact disconnected

SUM_ERROR_STATUS_TIME_AGENT

Unit: Seconds

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Error status time

SUM_HANDLE_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Contact handle time

SUM_HOLD_TIME

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Customer hold time

SUM_IDLE_TIME_AGENT

Unit: Seconds

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Agent idle time

SUM_INTERACTION_AND_HOLD_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy, Q in Connect

UI name: Agent interaction and hold time

SUM_INTERACTION_TIME

Unit: Seconds

Valid groupings and filters: Queue, Channel, Routing Profile, Agent, Agent Hierarchy

UI name: Agent interaction time

SUM_NON_PRODUCTIVE_TIME_AGENT

Unit: Seconds

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Non-Productive Time

SUM_ONLINE_TIME_AGENT

Unit: Seconds

Valid groupings and filters: Routing Profile, Agent, Agent Hierarchy

UI name: Online time

SUM_RETRY_CALLBACK_ATTEMPTS

Unit: Count

Valid groupings and filters: Queue, Channel, Routing Profile, contact/segmentAttributes/connect:Subtype, Q in Connect

UI name: Callback attempts

" }, "NextToken":{ "shape":"NextToken2500", @@ -13370,6 +13487,20 @@ } } }, + "ListCondition":{ + "type":"structure", + "members":{ + "TargetListType":{ + "shape":"TargetListType", + "documentation":"

The type of target list that will be used to filter the users.

" + }, + "Conditions":{ + "shape":"Conditions", + "documentation":"

A list of Condition objects which would be applied together with an AND condition.

" + } + }, + "documentation":"

A leaf node condition which can be used to specify a List condition to search users with attributes included in Lists like Proficiencies.

" + }, "ListContactEvaluationsRequest":{ "type":"structure", "required":[ @@ -15565,6 +15696,41 @@ "max":5.0, "min":1.0 }, + "NullableProficiencyLimitValue":{"type":"integer"}, + "NumberComparisonType":{ + "type":"string", + "enum":[ + "GREATER_OR_EQUAL", + "GREATER", + "LESSER_OR_EQUAL", + "LESSER", + "EQUAL", + "NOT_EQUAL", + "RANGE" + ] + }, + "NumberCondition":{ + "type":"structure", + "members":{ + "FieldName":{ + "shape":"String", + "documentation":"

The name of the field in the number condition.

" + }, + "MinValue":{ + "shape":"NullableProficiencyLimitValue", + "documentation":"

The minValue to be used while evaluating the number condition.

" + }, + "MaxValue":{ + "shape":"NullableProficiencyLimitValue", + "documentation":"

The maxValue to be used while evaluating the number condition.

" + }, + "ComparisonType":{ + "shape":"NumberComparisonType", + "documentation":"

The type of comparison to be made when evaluating the number condition.

" + } + }, + "documentation":"

A leaf node condition which can be used to specify a numeric condition.

The currently supported value for FieldName is limit.

" + }, "NumberReference":{ "type":"structure", "members":{ @@ -18218,6 +18384,50 @@ "min":1, "pattern":"s3://\\S+/.+|https://\\\\S+\\\\.s3\\\\.\\\\S+\\\\.amazonaws\\\\.com/\\\\S+" }, + "SearchAgentStatusesRequest":{ + "type":"structure", + "required":["InstanceId"], + "members":{ + "InstanceId":{ + "shape":"InstanceId", + "documentation":"

The identifier of the Amazon Connect instance. You can find the instanceId in the ARN of the instance.

" + }, + "NextToken":{ + "shape":"NextToken2500", + "documentation":"

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

" + }, + "MaxResults":{ + "shape":"MaxResult100", + "documentation":"

The maximum number of results to return per page.

", + "box":true + }, + "SearchFilter":{ + "shape":"AgentStatusSearchFilter", + "documentation":"

Filters to be applied to search results.

" + }, + "SearchCriteria":{ + "shape":"AgentStatusSearchCriteria", + "documentation":"

The search criteria to be used to return agent statuses.

" + } + } + }, + "SearchAgentStatusesResponse":{ + "type":"structure", + "members":{ + "AgentStatuses":{ + "shape":"AgentStatusList", + "documentation":"

The search criteria to be used to return agent statuses.

" + }, + "NextToken":{ + "shape":"NextToken2500", + "documentation":"

If there are additional results, this is the token for the next set of results.

" + }, + "ApproximateTotalCount":{ + "shape":"ApproximateTotalCount", + "documentation":"

The total number of agent statuses which matched your search query.

" + } + } + }, "SearchAvailablePhoneNumbersRequest":{ "type":"structure", "required":[ @@ -18708,7 +18918,7 @@ }, "ResourceTypes":{ "shape":"ResourceTypeList", - "documentation":"

The list of resource types to be used to search tags from. If not provided or if any empty list is provided, this API will search from all supported resource types.

" + "documentation":"

The list of resource types to be used to search tags from. If not provided or if any empty list is provided, this API will search from all supported resource types.

Supported resource types

" }, "NextToken":{ "shape":"NextToken2500", @@ -18837,6 +19047,50 @@ "max":100, "min":0 }, + "SearchUserHierarchyGroupsRequest":{ + "type":"structure", + "required":["InstanceId"], + "members":{ + "InstanceId":{ + "shape":"InstanceId", + "documentation":"

The identifier of the Amazon Connect instance. You can find the instanceId in the ARN of the instance.

" + }, + "NextToken":{ + "shape":"NextToken2500", + "documentation":"

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

" + }, + "MaxResults":{ + "shape":"MaxResult100", + "documentation":"

The maximum number of results to return per page.

", + "box":true + }, + "SearchFilter":{ + "shape":"UserHierarchyGroupSearchFilter", + "documentation":"

Filters to be applied to search results.

" + }, + "SearchCriteria":{ + "shape":"UserHierarchyGroupSearchCriteria", + "documentation":"

The search criteria to be used to return UserHierarchyGroups.

" + } + } + }, + "SearchUserHierarchyGroupsResponse":{ + "type":"structure", + "members":{ + "UserHierarchyGroups":{ + "shape":"UserHierarchyGroupList", + "documentation":"

Information about the userHierarchyGroups.

" + }, + "NextToken":{ + "shape":"NextToken2500", + "documentation":"

If there are additional results, this is the token for the next set of results.

" + }, + "ApproximateTotalCount":{ + "shape":"ApproximateTotalCount", + "documentation":"

The total number of userHierarchyGroups which matched your search query.

" + } + } + }, "SearchUsersRequest":{ "type":"structure", "required":["InstanceId"], @@ -20050,7 +20304,7 @@ "documentation":"

The type of comparison to be made when evaluating the string condition.

" } }, - "documentation":"

A leaf node condition which can be used to specify a string condition.

The currently supported values for FieldName are name and description.

" + "documentation":"

A leaf node condition which can be used to specify a string condition.

" }, "StringReference":{ "type":"structure", @@ -20236,7 +20490,7 @@ "type":"string", "max":128, "min":1, - "pattern":"^(?!aws:)[a-zA-Z+-=._:/]+$" + "pattern":"^(?!aws:)[\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*$" }, "TagKeyList":{ "type":"list", @@ -20336,6 +20590,10 @@ "type":"list", "member":{"shape":"TagSet"} }, + "TargetListType":{ + "type":"string", + "enum":["PROFICIENCIES"] + }, "TaskActionDefinition":{ "type":"structure", "required":[ @@ -22755,6 +23013,42 @@ "type":"list", "member":{"shape":"UserData"} }, + "UserHierarchyGroupList":{ + "type":"list", + "member":{"shape":"HierarchyGroup"} + }, + "UserHierarchyGroupSearchConditionList":{ + "type":"list", + "member":{"shape":"UserHierarchyGroupSearchCriteria"} + }, + "UserHierarchyGroupSearchCriteria":{ + "type":"structure", + "members":{ + "OrConditions":{ + "shape":"UserHierarchyGroupSearchConditionList", + "documentation":"

A list of conditions which would be applied together with an OR condition.

" + }, + "AndConditions":{ + "shape":"UserHierarchyGroupSearchConditionList", + "documentation":"

A list of conditions which would be applied together with an AND condition.

" + }, + "StringCondition":{ + "shape":"StringCondition", + "documentation":"

A leaf node condition which can be used to specify a string condition.

The currently supported values for FieldName are name,

 parentId, levelId, and resourceID.

" + } + }, + "documentation":"

The search criteria to be used to return userHierarchyGroup.

" + }, + "UserHierarchyGroupSearchFilter":{ + "type":"structure", + "members":{ + "AttributeFilter":{ + "shape":"ControlPlaneAttributeFilter", + "documentation":"

An object that can be used to specify Tag conditions inside the SearchFilter. This accepts an OR or AND (List of List) input where:

" + } + }, + "documentation":"

Filters to be applied to search results.

" + }, "UserId":{"type":"string"}, "UserIdList":{ "type":"list", @@ -22932,6 +23226,10 @@ "shape":"StringCondition", "documentation":"

A leaf node condition which can be used to specify a string condition.

The currently supported values for FieldName are Username, FirstName, LastName, RoutingProfileId, SecurityProfileId, ResourceId.

" }, + "ListCondition":{ + "shape":"ListCondition", + "documentation":"

A leaf node condition which can be used to specify a List condition to search users with attributes included in Lists like Proficiencies.

" + }, "HierarchyGroupCondition":{ "shape":"HierarchyGroupCondition", "documentation":"

A leaf node condition which can be used to specify a hierarchy group condition.

" diff --git a/botocore/data/ec2/2016-11-15/service-2.json b/botocore/data/ec2/2016-11-15/service-2.json index 25a037c10f..e3cbd3a049 100644 --- a/botocore/data/ec2/2016-11-15/service-2.json +++ b/botocore/data/ec2/2016-11-15/service-2.json @@ -770,6 +770,16 @@ "output":{"shape":"CreateIpamResult"}, "documentation":"

Create an IPAM. Amazon VPC IP Address Manager (IPAM) is a VPC feature that you can use to automate your IP address management workflows including assigning, tracking, troubleshooting, and auditing IP addresses across Amazon Web Services Regions and accounts throughout your Amazon Web Services Organization.

For more information, see Create an IPAM in the Amazon VPC IPAM User Guide.

" }, + "CreateIpamExternalResourceVerificationToken":{ + "name":"CreateIpamExternalResourceVerificationToken", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateIpamExternalResourceVerificationTokenRequest"}, + "output":{"shape":"CreateIpamExternalResourceVerificationTokenResult"}, + "documentation":"

Create a verification token. A verification token is an Amazon Web Services-generated random value that you can use to prove ownership of an external resource. For example, you can use a verification token to validate that you control a public IP address range when you bring an IP address range to Amazon Web Services (BYOIP).

" + }, "CreateIpamPool":{ "name":"CreateIpamPool", "http":{ @@ -1524,6 +1534,16 @@ "output":{"shape":"DeleteIpamResult"}, "documentation":"

Delete an IPAM. Deleting an IPAM removes all monitored data associated with the IPAM including the historical data for CIDRs.

For more information, see Delete an IPAM in the Amazon VPC IPAM User Guide.

" }, + "DeleteIpamExternalResourceVerificationToken":{ + "name":"DeleteIpamExternalResourceVerificationToken", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteIpamExternalResourceVerificationTokenRequest"}, + "output":{"shape":"DeleteIpamExternalResourceVerificationTokenResult"}, + "documentation":"

Delete a verification token. A verification token is an Amazon Web Services-generated random value that you can use to prove ownership of an external resource. For example, you can use a verification token to validate that you control a public IP address range when you bring an IP address range to Amazon Web Services (BYOIP).

" + }, "DeleteIpamPool":{ "name":"DeleteIpamPool", "http":{ @@ -2747,6 +2767,16 @@ "output":{"shape":"DescribeIpamByoasnResult"}, "documentation":"

Describes your Autonomous System Numbers (ASNs), their provisioning statuses, and the BYOIP CIDRs with which they are associated. For more information, see Tutorial: Bring your ASN to IPAM in the Amazon VPC IPAM guide.

" }, + "DescribeIpamExternalResourceVerificationTokens":{ + "name":"DescribeIpamExternalResourceVerificationTokens", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeIpamExternalResourceVerificationTokensRequest"}, + "output":{"shape":"DescribeIpamExternalResourceVerificationTokensResult"}, + "documentation":"

Describe verification tokens. A verification token is an Amazon Web Services-generated random value that you can use to prove ownership of an external resource. For example, you can use a verification token to validate that you control a public IP address range when you bring an IP address range to Amazon Web Services (BYOIP).

" + }, "DescribeIpamPools":{ "name":"DescribeIpamPools", "http":{ @@ -3035,7 +3065,7 @@ }, "input":{"shape":"DescribePlacementGroupsRequest"}, "output":{"shape":"DescribePlacementGroupsResult"}, - "documentation":"

Describes the specified placement groups or all of your placement groups. For more information, see Placement groups in the Amazon EC2 User Guide.

" + "documentation":"

Describes the specified placement groups or all of your placement groups.

To describe a specific placement group that is shared with your account, you must specify the ID of the placement group using the GroupId parameter. Specifying the name of a shared placement group using the GroupNames parameter will result in an error.

For more information, see Placement groups in the Amazon EC2 User Guide.

" }, "DescribePrefixLists":{ "name":"DescribePrefixLists", @@ -3555,7 +3585,7 @@ }, "input":{"shape":"DescribeVolumesModificationsRequest"}, "output":{"shape":"DescribeVolumesModificationsResult"}, - "documentation":"

Describes the most recent volume modification request for the specified EBS volumes.

If a volume has never been modified, some information in the output will be null. If a volume has been modified more than once, the output includes only the most recent modification request.

For more information, see Monitor the progress of volume modifications in the Amazon EBS User Guide.

" + "documentation":"

Describes the most recent volume modification request for the specified EBS volumes.

For more information, see Monitor the progress of volume modifications in the Amazon EBS User Guide.

" }, "DescribeVpcAttribute":{ "name":"DescribeVpcAttribute", @@ -4327,7 +4357,7 @@ }, "input":{"shape":"GetConsoleOutputRequest"}, "output":{"shape":"GetConsoleOutputResult"}, - "documentation":"

Gets the console output for the specified instance. For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. For Windows instances, the instance console output includes the last three system event log errors.

By default, the console output returns buffered information that was posted shortly after an instance transition state (start, stop, reboot, or terminate). This information is available for at least one hour after the most recent post. Only the most recent 64 KB of console output is available.

You can optionally retrieve the latest serial console output at any time during the instance lifecycle. This option is supported on instance types that use the Nitro hypervisor.

For more information, see Instance console output in the Amazon EC2 User Guide.

" + "documentation":"

Gets the console output for the specified instance. For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. For Windows instances, the instance console output includes the last three system event log errors.

For more information, see Instance console output in the Amazon EC2 User Guide.

" }, "GetConsoleScreenshot":{ "name":"GetConsoleScreenshot", @@ -13213,6 +13243,40 @@ } } }, + "CreateIpamExternalResourceVerificationTokenRequest":{ + "type":"structure", + "required":["IpamId"], + "members":{ + "DryRun":{ + "shape":"Boolean", + "documentation":"

A check for whether you have the required permissions for the action without actually making the request and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" + }, + "IpamId":{ + "shape":"IpamId", + "documentation":"

The ID of the IPAM that will create the token.

" + }, + "TagSpecifications":{ + "shape":"TagSpecificationList", + "documentation":"

Token tags.

", + "locationName":"TagSpecification" + }, + "ClientToken":{ + "shape":"String", + "documentation":"

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring idempotency.

", + "idempotencyToken":true + } + } + }, + "CreateIpamExternalResourceVerificationTokenResult":{ + "type":"structure", + "members":{ + "IpamExternalResourceVerificationToken":{ + "shape":"IpamExternalResourceVerificationToken", + "documentation":"

The verification token.

", + "locationName":"ipamExternalResourceVerificationToken" + } + } + }, "CreateIpamPoolRequest":{ "type":"structure", "required":[ @@ -13230,7 +13294,7 @@ }, "Locale":{ "shape":"String", - "documentation":"

In IPAM, the locale is the Amazon Web Services Region or, for IPAM IPv4 pools in the public scope, the network border group for an Amazon Web Services Local Zone where you want to make an IPAM pool available for allocations (supported Local Zones). If you do not choose a locale, resources in Regions others than the IPAM's home region cannot use CIDRs from this pool.

Possible values: Any Amazon Web Services Region, such as us-east-1.

" + "documentation":"

The locale for the pool should be one of the following:

If you do not choose a locale, resources in Regions others than the IPAM's home region cannot use CIDRs from this pool.

Possible values: Any Amazon Web Services Region or supported Amazon Web Services Local Zone.

" }, "SourceIpamPoolId":{ "shape":"IpamPoolId", @@ -17046,6 +17110,30 @@ } } }, + "DeleteIpamExternalResourceVerificationTokenRequest":{ + "type":"structure", + "required":["IpamExternalResourceVerificationTokenId"], + "members":{ + "DryRun":{ + "shape":"Boolean", + "documentation":"

A check for whether you have the required permissions for the action without actually making the request and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" + }, + "IpamExternalResourceVerificationTokenId":{ + "shape":"IpamExternalResourceVerificationTokenId", + "documentation":"

The token ID.

" + } + } + }, + "DeleteIpamExternalResourceVerificationTokenResult":{ + "type":"structure", + "members":{ + "IpamExternalResourceVerificationToken":{ + "shape":"IpamExternalResourceVerificationToken", + "documentation":"

The verification token.

", + "locationName":"ipamExternalResourceVerificationToken" + } + } + }, "DeleteIpamPoolRequest":{ "type":"structure", "required":["IpamPoolId"], @@ -21381,6 +21469,48 @@ } } }, + "DescribeIpamExternalResourceVerificationTokensRequest":{ + "type":"structure", + "members":{ + "DryRun":{ + "shape":"Boolean", + "documentation":"

A check for whether you have the required permissions for the action without actually making the request and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" + }, + "Filters":{ + "shape":"FilterList", + "documentation":"

One or more filters for the request. For more information about filtering, see Filtering CLI output.

Available filters:

", + "locationName":"Filter" + }, + "NextToken":{ + "shape":"NextToken", + "documentation":"

The token for the next page of results.

" + }, + "MaxResults":{ + "shape":"IpamMaxResults", + "documentation":"

The maximum number of tokens to return in one page of results.

" + }, + "IpamExternalResourceVerificationTokenIds":{ + "shape":"ValueStringList", + "documentation":"

Verification token IDs.

", + "locationName":"IpamExternalResourceVerificationTokenId" + } + } + }, + "DescribeIpamExternalResourceVerificationTokensResult":{ + "type":"structure", + "members":{ + "NextToken":{ + "shape":"NextToken", + "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", + "locationName":"nextToken" + }, + "IpamExternalResourceVerificationTokens":{ + "shape":"IpamExternalResourceVerificationTokenSet", + "documentation":"

Verification tokens.

", + "locationName":"ipamExternalResourceVerificationTokenSet" + } + } + }, "DescribeIpamPoolsRequest":{ "type":"structure", "members":{ @@ -22673,7 +22803,7 @@ }, "GroupNames":{ "shape":"PlacementGroupStringList", - "documentation":"

The names of the placement groups.

Default: Describes all your placement groups, or only those otherwise specified.

", + "documentation":"

The names of the placement groups.

Constraints:

", "locationName":"groupName" }, "GroupIds":{ @@ -29842,7 +29972,7 @@ }, "WeightedCapacity":{ "shape":"Double", - "documentation":"

The number of units provided by the specified instance type.

When specifying weights, the price used in the lowest-price and price-capacity-optimized allocation strategies is per unit hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested TargetCapacity, resulting in only 1 instance being launched, the price used is per instance hour.

", + "documentation":"

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O.

If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1.

When specifying weights, the price used in the lowest-price and price-capacity-optimized allocation strategies is per unit hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested TargetCapacity, resulting in only 1 instance being launched, the price used is per instance hour.

", "locationName":"weightedCapacity" }, "Priority":{ @@ -29903,7 +30033,7 @@ }, "WeightedCapacity":{ "shape":"Double", - "documentation":"

The number of units provided by the specified instance type.

When specifying weights, the price used in the lowest-price and price-capacity-optimized allocation strategies is per unit hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested TargetCapacity, resulting in only 1 instance being launched, the price used is per instance hour.

" + "documentation":"

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O.

If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1.

When specifying weights, the price used in the lowest-price and price-capacity-optimized allocation strategies is per unit hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested TargetCapacity, resulting in only 1 instance being launched, the price used is per instance hour.

" }, "Priority":{ "shape":"Double", @@ -38086,7 +38216,7 @@ }, "NetworkInterfaceAttachmentStatus":{ "shape":"IpamNetworkInterfaceAttachmentStatus", - "documentation":"

For elastic IP addresses, this is the status of an attached network interface.

", + "documentation":"

For elastic network interfaces, this is the status of whether or not the elastic network interface is attached.

", "locationName":"networkInterfaceAttachmentStatus" }, "SampleTime":{ @@ -38133,6 +38263,86 @@ }, "documentation":"

The discovery failure reason.

" }, + "IpamExternalResourceVerificationToken":{ + "type":"structure", + "members":{ + "IpamExternalResourceVerificationTokenId":{ + "shape":"IpamExternalResourceVerificationTokenId", + "documentation":"

The ID of the token.

", + "locationName":"ipamExternalResourceVerificationTokenId" + }, + "IpamExternalResourceVerificationTokenArn":{ + "shape":"ResourceArn", + "documentation":"

Token ARN.

", + "locationName":"ipamExternalResourceVerificationTokenArn" + }, + "IpamId":{ + "shape":"IpamId", + "documentation":"

The ID of the IPAM that created the token.

", + "locationName":"ipamId" + }, + "IpamArn":{ + "shape":"ResourceArn", + "documentation":"

ARN of the IPAM that created the token.

", + "locationName":"ipamArn" + }, + "IpamRegion":{ + "shape":"String", + "documentation":"

Region of the IPAM that created the token.

", + "locationName":"ipamRegion" + }, + "TokenValue":{ + "shape":"String", + "documentation":"

Token value.

", + "locationName":"tokenValue" + }, + "TokenName":{ + "shape":"String", + "documentation":"

Token name.

", + "locationName":"tokenName" + }, + "NotAfter":{ + "shape":"MillisecondDateTime", + "documentation":"

Token expiration.

", + "locationName":"notAfter" + }, + "Status":{ + "shape":"TokenState", + "documentation":"

Token status.

", + "locationName":"status" + }, + "Tags":{ + "shape":"TagList", + "documentation":"

Token tags.

", + "locationName":"tagSet" + }, + "State":{ + "shape":"IpamExternalResourceVerificationTokenState", + "documentation":"

Token state.

", + "locationName":"state" + } + }, + "documentation":"

A verification token is an Amazon Web Services-generated random value that you can use to prove ownership of an external resource. For example, you can use a verification token to validate that you control a public IP address range when you bring an IP address range to Amazon Web Services (BYOIP).

" + }, + "IpamExternalResourceVerificationTokenId":{"type":"string"}, + "IpamExternalResourceVerificationTokenSet":{ + "type":"list", + "member":{ + "shape":"IpamExternalResourceVerificationToken", + "locationName":"item" + } + }, + "IpamExternalResourceVerificationTokenState":{ + "type":"string", + "enum":[ + "create-in-progress", + "create-complete", + "create-failed", + "delete-in-progress", + "delete-complete", + "delete-failed" + ] + }, "IpamId":{"type":"string"}, "IpamManagementState":{ "type":"string", @@ -38230,7 +38440,7 @@ }, "Locale":{ "shape":"String", - "documentation":"

The locale of the IPAM pool. In IPAM, the locale is the Amazon Web Services Region or, for IPAM IPv4 pools in the public scope, the network border group for an Amazon Web Services Local Zone where you want to make an IPAM pool available for allocations (supported Local Zones). If you choose an Amazon Web Services Region for locale that has not been configured as an operating Region for the IPAM, you'll get an error.

", + "documentation":"

The locale of the IPAM pool.

The locale for the pool should be one of the following:

If you choose an Amazon Web Services Region for locale that has not been configured as an operating Region for the IPAM, you'll get an error.

", "locationName":"locale" }, "PoolDepth":{ @@ -40458,7 +40668,7 @@ }, "WeightedCapacity":{ "shape":"Double", - "documentation":"

The number of units provided by the specified instance type.

When specifying weights, the price used in the lowest-price and price-capacity-optimized allocation strategies is per unit hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested TargetCapacity, resulting in only 1 instance being launched, the price used is per instance hour.

", + "documentation":"

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O.

If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1.

When specifying weights, the price used in the lowestPrice and priceCapacityOptimized allocation strategies is per unit hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested TargetCapacity, resulting in only 1 instance being launched, the price used is per instance hour.

", "locationName":"weightedCapacity" }, "Priority":{ @@ -48141,7 +48351,7 @@ }, "CidrAuthorizationContext":{ "shape":"IpamCidrAuthorizationContext", - "documentation":"

A signed document that proves that you are authorized to bring a specified IP address range to Amazon using BYOIP. This option applies to public pools only.

" + "documentation":"

A signed document that proves that you are authorized to bring a specified IP address range to Amazon using BYOIP. This option only applies to IPv4 and IPv6 pools in the public scope.

" }, "NetmaskLength":{ "shape":"Integer", @@ -48151,6 +48361,14 @@ "shape":"String", "documentation":"

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring idempotency.

", "idempotencyToken":true + }, + "VerificationMethod":{ + "shape":"VerificationMethod", + "documentation":"

The method for verifying control of a public IP address range. Defaults to remarks-x509 if not specified. This option only applies to IPv4 and IPv6 pools in the public scope.

" + }, + "IpamExternalResourceVerificationTokenId":{ + "shape":"IpamExternalResourceVerificationTokenId", + "documentation":"

Verification token ID. This option only applies to IPv4 and IPv6 pools in the public scope.

" } } }, @@ -50978,7 +51196,8 @@ "vpc-encryption-control", "ipam-resource-discovery", "ipam-resource-discovery-association", - "instance-connect-endpoint" + "instance-connect-endpoint", + "ipam-external-resource-verification-token" ] }, "ResponseError":{ @@ -54086,7 +54305,7 @@ }, "WeightedCapacity":{ "shape":"Double", - "documentation":"

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O.

If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1.

", + "documentation":"

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O.

If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1.

When specifying weights, the price used in the lowestPrice and priceCapacityOptimized allocation strategies is per unit hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested TargetCapacity, resulting in only 1 instance being launched, the price used is per instance hour.

", "locationName":"weightedCapacity" }, "TagSpecifications":{ @@ -55995,6 +56214,13 @@ "permanent-restore-failed" ] }, + "TokenState":{ + "type":"string", + "enum":[ + "valid", + "expired" + ] + }, "TotalLocalStorageGB":{ "type":"structure", "members":{ @@ -58864,6 +59090,13 @@ "locationName":"item" } }, + "VerificationMethod":{ + "type":"string", + "enum":[ + "remarks-x509", + "dns-token" + ] + }, "VerifiedAccessEndpoint":{ "type":"structure", "members":{ @@ -59865,7 +60098,7 @@ }, "ModificationState":{ "shape":"VolumeModificationState", - "documentation":"

The current modification state. The modification state is null for unmodified volumes.

", + "documentation":"

The current modification state.

", "locationName":"modificationState" }, "StatusMessage":{ @@ -59939,7 +60172,7 @@ "locationName":"endTime" } }, - "documentation":"

Describes the modification status of an EBS volume.

If the volume has never been modified, some element values will be null.

" + "documentation":"

Describes the modification status of an EBS volume.

" }, "VolumeModificationList":{ "type":"list", diff --git a/botocore/data/firehose/2015-08-04/service-2.json b/botocore/data/firehose/2015-08-04/service-2.json index 4055ed6e6a..9c5be929eb 100644 --- a/botocore/data/firehose/2015-08-04/service-2.json +++ b/botocore/data/firehose/2015-08-04/service-2.json @@ -639,6 +639,16 @@ }, "documentation":"

Describes hints for the buffering to perform before delivering data to the destination. These options are treated as hints, and therefore Firehose might choose to use different values when it is optimal. The SizeInMBs and IntervalInSeconds parameters are optional. However, if specify a value for one of them, you must also provide a value for the other.

" }, + "CatalogConfiguration":{ + "type":"structure", + "members":{ + "CatalogARN":{ + "shape":"GlueDataCatalogARN", + "documentation":"

Specifies the Glue catalog ARN indentifier of the destination Apache Iceberg Tables. You must specify the ARN in the format arn:aws:glue:region:account-id:catalog.

Amazon Data Firehose is in preview release and is subject to change.

" + } + }, + "documentation":"

Describes the containers where the destination Apache Iceberg Tables are persisted.

Amazon Data Firehose is in preview release and is subject to change.

" + }, "CloudWatchLoggingOptions":{ "type":"structure", "members":{ @@ -789,6 +799,10 @@ "SnowflakeDestinationConfiguration":{ "shape":"SnowflakeDestinationConfiguration", "documentation":"

Configure Snowflake destination

" + }, + "IcebergDestinationConfiguration":{ + "shape":"IcebergDestinationConfiguration", + "documentation":"

Configure Apache Iceberg Tables destination.

Amazon Data Firehose is in preview release and is subject to change.

" } } }, @@ -1133,6 +1147,10 @@ "AmazonOpenSearchServerlessDestinationDescription":{ "shape":"AmazonOpenSearchServerlessDestinationDescription", "documentation":"

The destination in the Serverless offering for Amazon OpenSearch Service.

" + }, + "IcebergDestinationDescription":{ + "shape":"IcebergDestinationDescription", + "documentation":"

Describes a destination in Apache Iceberg Tables.

Amazon Data Firehose is in preview release and is subject to change.

" } }, "documentation":"

Describes the destination for a delivery stream.

" @@ -1147,6 +1165,36 @@ "min":1, "pattern":"[a-zA-Z0-9-]+" }, + "DestinationTableConfiguration":{ + "type":"structure", + "required":[ + "DestinationTableName", + "DestinationDatabaseName" + ], + "members":{ + "DestinationTableName":{ + "shape":"NonEmptyStringWithoutWhitespace", + "documentation":"

Specifies the name of the Apache Iceberg Table.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "DestinationDatabaseName":{ + "shape":"NonEmptyStringWithoutWhitespace", + "documentation":"

The name of the Apache Iceberg database.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "UniqueKeys":{ + "shape":"ListOfNonEmptyStringsWithoutWhitespace", + "documentation":"

A list of unique keys for a given Apache Iceberg table. Firehose will use these for running Create/Update/Delete operations on the given Iceberg table.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "S3ErrorOutputPrefix":{ + "shape":"ErrorOutputPrefix", + "documentation":"

The table specific S3 error output prefix. All the errors that occurred while delivering to this table will be prefixed with this value in S3 destination.

Amazon Data Firehose is in preview release and is subject to change.

" + } + }, + "documentation":"

Describes the configuration of a destination in Apache Iceberg Tables.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "DestinationTableConfigurationList":{ + "type":"list", + "member":{"shape":"DestinationTableConfiguration"} + }, "DocumentIdOptions":{ "type":"structure", "required":["DefaultDocumentIdFormat"], @@ -1690,6 +1738,12 @@ "min":0, "pattern":"^$|\\.[0-9a-z!\\-_.*'()]+" }, + "GlueDataCatalogARN":{ + "type":"string", + "max":512, + "min":1, + "pattern":"arn:.*" + }, "HECAcknowledgmentTimeoutInSeconds":{ "type":"integer", "max":600, @@ -1990,6 +2044,99 @@ "pattern":"https://.*", "sensitive":true }, + "IcebergDestinationConfiguration":{ + "type":"structure", + "required":[ + "RoleARN", + "CatalogConfiguration", + "S3Configuration" + ], + "members":{ + "DestinationTableConfigurationList":{ + "shape":"DestinationTableConfigurationList", + "documentation":"

Provides a list of DestinationTableConfigurations which Firehose uses to deliver data to Apache Iceberg tables.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "BufferingHints":{"shape":"BufferingHints"}, + "CloudWatchLoggingOptions":{"shape":"CloudWatchLoggingOptions"}, + "ProcessingConfiguration":{"shape":"ProcessingConfiguration"}, + "S3BackupMode":{ + "shape":"IcebergS3BackupMode", + "documentation":"

Describes how Firehose will backup records. Currently,Firehose only supports FailedDataOnly for preview.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "RetryOptions":{"shape":"RetryOptions"}, + "RoleARN":{ + "shape":"RoleARN", + "documentation":"

The Amazon Resource Name (ARN) of the Apache Iceberg tables role.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "CatalogConfiguration":{ + "shape":"CatalogConfiguration", + "documentation":"

Configuration describing where the destination Apache Iceberg Tables are persisted.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "S3Configuration":{"shape":"S3DestinationConfiguration"} + }, + "documentation":"

Specifies the destination configure settings for Apache Iceberg Table.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "IcebergDestinationDescription":{ + "type":"structure", + "members":{ + "DestinationTableConfigurationList":{ + "shape":"DestinationTableConfigurationList", + "documentation":"

Provides a list of DestinationTableConfigurations which Firehose uses to deliver data to Apache Iceberg tables.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "BufferingHints":{"shape":"BufferingHints"}, + "CloudWatchLoggingOptions":{"shape":"CloudWatchLoggingOptions"}, + "ProcessingConfiguration":{"shape":"ProcessingConfiguration"}, + "S3BackupMode":{ + "shape":"IcebergS3BackupMode", + "documentation":"

Describes how Firehose will backup records. Currently,Firehose only supports FailedDataOnly for preview.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "RetryOptions":{"shape":"RetryOptions"}, + "RoleARN":{ + "shape":"RoleARN", + "documentation":"

The Amazon Resource Name (ARN) of the Apache Iceberg Tables role.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "CatalogConfiguration":{ + "shape":"CatalogConfiguration", + "documentation":"

Configuration describing where the destination Iceberg tables are persisted.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "S3DestinationDescription":{"shape":"S3DestinationDescription"} + }, + "documentation":"

Describes a destination in Apache Iceberg Tables.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "IcebergDestinationUpdate":{ + "type":"structure", + "members":{ + "DestinationTableConfigurationList":{ + "shape":"DestinationTableConfigurationList", + "documentation":"

Provides a list of DestinationTableConfigurations which Firehose uses to deliver data to Apache Iceberg tables.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "BufferingHints":{"shape":"BufferingHints"}, + "CloudWatchLoggingOptions":{"shape":"CloudWatchLoggingOptions"}, + "ProcessingConfiguration":{"shape":"ProcessingConfiguration"}, + "S3BackupMode":{ + "shape":"IcebergS3BackupMode", + "documentation":"

Describes how Firehose will backup records. Currently,Firehose only supports FailedDataOnly for preview.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "RetryOptions":{"shape":"RetryOptions"}, + "RoleARN":{ + "shape":"RoleARN", + "documentation":"

The Amazon Resource Name (ARN) of the Apache Iceberg Tables role.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "CatalogConfiguration":{ + "shape":"CatalogConfiguration", + "documentation":"

Configuration describing where the destination Iceberg tables are persisted.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "S3Configuration":{"shape":"S3DestinationConfiguration"} + }, + "documentation":"

Describes an update for a destination in Apache Iceberg Tables.

Amazon Data Firehose is in preview release and is subject to change.

" + }, + "IcebergS3BackupMode":{ + "type":"string", + "enum":[ + "FailedDataOnly", + "AllData" + ] + }, "InputFormatConfiguration":{ "type":"structure", "members":{ @@ -2235,6 +2382,10 @@ "AuthenticationConfiguration":{ "shape":"AuthenticationConfiguration", "documentation":"

The authentication configuration of the Amazon MSK cluster.

" + }, + "ReadFromTimestamp":{ + "shape":"ReadFromTimestamp", + "documentation":"

The start date and time in UTC for the offset position within your MSK topic from where Firehose begins to read. By default, this is set to timestamp when Firehose becomes Active.

If you want to create a Firehose stream with Earliest start position from SDK or CLI, you need to set the ReadFromTimestamp parameter to Epoch (1970-01-01T00:00:00Z).

" } }, "documentation":"

The configuration for the Amazon MSK cluster to be used as the source for a delivery stream.

" @@ -2257,6 +2408,10 @@ "DeliveryStartTimestamp":{ "shape":"DeliveryStartTimestamp", "documentation":"

Firehose starts retrieving records from the topic within the Amazon MSK cluster starting with this timestamp.

" + }, + "ReadFromTimestamp":{ + "shape":"ReadFromTimestamp", + "documentation":"

The start date and time in UTC for the offset position within your MSK topic from where Firehose begins to read. By default, this is set to timestamp when Firehose becomes Active.

If you want to create a Firehose stream with Earliest start position from SDK or CLI, you need to set the ReadFromTimestampUTC parameter to Epoch (1970-01-01T00:00:00Z).

" } }, "documentation":"

Details about the Amazon MSK cluster used as the source for a Firehose delivery stream.

" @@ -2636,6 +2791,7 @@ "type":"string", "min":1 }, + "ReadFromTimestamp":{"type":"timestamp"}, "Record":{ "type":"structure", "required":["Data"], @@ -3113,6 +3269,30 @@ "pattern":".+?\\.snowflakecomputing\\.com", "sensitive":true }, + "SnowflakeBufferingHints":{ + "type":"structure", + "members":{ + "SizeInMBs":{ + "shape":"SnowflakeBufferingSizeInMBs", + "documentation":"

Buffer incoming data to the specified size, in MBs, before delivering it to the destination. The default value is 1.

" + }, + "IntervalInSeconds":{ + "shape":"SnowflakeBufferingIntervalInSeconds", + "documentation":"

Buffer incoming data for the specified period of time, in seconds, before delivering it to the destination. The default value is 0.

" + } + }, + "documentation":"

Describes the buffering to perform before delivering data to the Snowflake destination. If you do not specify any value, Firehose uses the default values.

" + }, + "SnowflakeBufferingIntervalInSeconds":{ + "type":"integer", + "max":900, + "min":0 + }, + "SnowflakeBufferingSizeInMBs":{ + "type":"integer", + "max":128, + "min":1 + }, "SnowflakeContentColumnName":{ "type":"string", "max":255, @@ -3210,6 +3390,10 @@ "SecretsManagerConfiguration":{ "shape":"SecretsManagerConfiguration", "documentation":"

The configuration that defines how you access secrets for Snowflake.

" + }, + "BufferingHints":{ + "shape":"SnowflakeBufferingHints", + "documentation":"

Describes the buffering to perform before delivering data to the Snowflake destination. If you do not specify any value, Firehose uses the default values.

" } }, "documentation":"

Configure Snowflake destination

" @@ -3275,6 +3459,10 @@ "SecretsManagerConfiguration":{ "shape":"SecretsManagerConfiguration", "documentation":"

The configuration that defines how you access secrets for Snowflake.

" + }, + "BufferingHints":{ + "shape":"SnowflakeBufferingHints", + "documentation":"

Describes the buffering to perform before delivering data to the Snowflake destination. If you do not specify any value, Firehose uses the default values.

" } }, "documentation":"

Optional Snowflake destination description

" @@ -3344,6 +3532,10 @@ "SecretsManagerConfiguration":{ "shape":"SecretsManagerConfiguration", "documentation":"

Describes the Secrets Manager configuration in Snowflake.

" + }, + "BufferingHints":{ + "shape":"SnowflakeBufferingHints", + "documentation":"

Describes the buffering to perform before delivering data to the Snowflake destination.

" } }, "documentation":"

Update to configuration settings

" @@ -3846,6 +4038,10 @@ "SnowflakeDestinationUpdate":{ "shape":"SnowflakeDestinationUpdate", "documentation":"

Update to the Snowflake destination configuration settings.

" + }, + "IcebergDestinationUpdate":{ + "shape":"IcebergDestinationUpdate", + "documentation":"

Describes an update for a destination in Apache Iceberg Tables.

Amazon Data Firehose is in preview release and is subject to change.

" } } }, diff --git a/botocore/data/ivschat/2020-07-14/service-2.json b/botocore/data/ivschat/2020-07-14/service-2.json index b7ec1b2ec7..0232cb940f 100644 --- a/botocore/data/ivschat/2020-07-14/service-2.json +++ b/botocore/data/ivschat/2020-07-14/service-2.json @@ -2,9 +2,10 @@ "version":"2.0", "metadata":{ "apiVersion":"2020-07-14", + "auth":["aws.auth#sigv4"], "endpointPrefix":"ivschat", - "jsonVersion":"1.1", "protocol":"rest-json", + "protocols":["rest-json"], "serviceAbbreviation":"ivschat", "serviceFullName":"Amazon Interactive Video Service Chat", "serviceId":"ivschat", @@ -321,7 +322,7 @@ "type":"string", "max":63, "min":3, - "pattern":"^[a-z0-9-.]+$" + "pattern":"[a-z0-9-.]+" }, "ChatToken":{ "type":"string", @@ -388,35 +389,31 @@ "userId" ], "members":{ - "attributes":{ - "shape":"ChatTokenAttributes", - "documentation":"

Application-provided attributes to encode into the token and attach to a chat session. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total.

" + "roomIdentifier":{ + "shape":"RoomIdentifier", + "documentation":"

Identifier of the room that the client is trying to access. Currently this must be an ARN.

" + }, + "userId":{ + "shape":"UserID", + "documentation":"

Application-provided ID that uniquely identifies the user associated with this token. This can be any UTF-8 encoded text.

" }, "capabilities":{ "shape":"ChatTokenCapabilities", "documentation":"

Set of capabilities that the user is allowed to perform in the room. Default: None (the capability to view messages is implicitly included in all requests).

" }, - "roomIdentifier":{ - "shape":"RoomIdentifier", - "documentation":"

Identifier of the room that the client is trying to access. Currently this must be an ARN.

" - }, "sessionDurationInMinutes":{ "shape":"SessionDurationInMinutes", "documentation":"

Session duration (in minutes), after which the session expires. Default: 60 (1 hour).

" }, - "userId":{ - "shape":"UserID", - "documentation":"

Application-provided ID that uniquely identifies the user associated with this token. This can be any UTF-8 encoded text.

" + "attributes":{ + "shape":"ChatTokenAttributes", + "documentation":"

Application-provided attributes to encode into the token and attach to a chat session. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total.

" } } }, "CreateChatTokenResponse":{ "type":"structure", "members":{ - "sessionExpirationTime":{ - "shape":"Time", - "documentation":"

Time after which an end user's session is no longer valid. This is an ISO 8601 timestamp; note that this is returned as a string.

" - }, "token":{ "shape":"ChatToken", "documentation":"

The issued client token, encrypted.

" @@ -424,6 +421,10 @@ "tokenExpirationTime":{ "shape":"Time", "documentation":"

Time after which the token is no longer valid and cannot be used to connect to a room. This is an ISO 8601 timestamp; note that this is returned as a string.

" + }, + "sessionExpirationTime":{ + "shape":"Time", + "documentation":"

Time after which an end user's session is no longer valid. This is an ISO 8601 timestamp; note that this is returned as a string.

" } } }, @@ -431,14 +432,14 @@ "type":"structure", "required":["destinationConfiguration"], "members":{ - "destinationConfiguration":{ - "shape":"DestinationConfiguration", - "documentation":"

A complex type that contains a destination configuration for where chat content will be logged. There can be only one type of destination (cloudWatchLogs, firehose, or s3) in a destinationConfiguration.

" - }, "name":{ "shape":"LoggingConfigurationName", "documentation":"

Logging-configuration name. The value does not need to be unique.

" }, + "destinationConfiguration":{ + "shape":"DestinationConfiguration", + "documentation":"

A complex type that contains a destination configuration for where chat content will be logged. There can be only one type of destination (cloudWatchLogs, firehose, or s3) in a destinationConfiguration.

" + }, "tags":{ "shape":"Tags", "documentation":"

Tags to attach to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS Chat has no constraints on tags beyond what is documented there.

" @@ -452,22 +453,26 @@ "shape":"LoggingConfigurationArn", "documentation":"

Logging-configuration ARN, assigned by the system.

" }, + "id":{ + "shape":"LoggingConfigurationID", + "documentation":"

Logging-configuration ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the logging configuration.

" + }, "createTime":{ "shape":"Time", "documentation":"

Time when the logging configuration was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, - "destinationConfiguration":{ - "shape":"DestinationConfiguration", - "documentation":"

A complex type that contains a destination configuration for where chat content will be logged, from the request. There is only one type of destination (cloudWatchLogs, firehose, or s3) in a destinationConfiguration.

" - }, - "id":{ - "shape":"LoggingConfigurationID", - "documentation":"

Logging-configuration ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the logging configuration.

" + "updateTime":{ + "shape":"Time", + "documentation":"

Time of the logging configuration’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, "name":{ "shape":"LoggingConfigurationName", "documentation":"

Logging-configuration name, from the request (if specified).

" }, + "destinationConfiguration":{ + "shape":"DestinationConfiguration", + "documentation":"

A complex type that contains a destination configuration for where chat content will be logged, from the request. There is only one type of destination (cloudWatchLogs, firehose, or s3) in a destinationConfiguration.

" + }, "state":{ "shape":"CreateLoggingConfigurationState", "documentation":"

The state of the logging configuration. When the state is ACTIVE, the configuration is ready to log chat content.

" @@ -475,10 +480,6 @@ "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource, from the request (if specified). Array of maps, each of the form string:string (key:value).

" - }, - "updateTime":{ - "shape":"Time", - "documentation":"

Time of the logging configuration’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" } } }, @@ -489,29 +490,29 @@ "CreateRoomRequest":{ "type":"structure", "members":{ - "loggingConfigurationIdentifiers":{ - "shape":"LoggingConfigurationIdentifierList", - "documentation":"

Array of logging-configuration identifiers attached to the room.

" - }, - "maximumMessageLength":{ - "shape":"RoomMaxMessageLength", - "documentation":"

Maximum number of characters in a single message. Messages are expected to be UTF-8 encoded and this limit applies specifically to rune/code-point count, not number of bytes. Default: 500.

" + "name":{ + "shape":"RoomName", + "documentation":"

Room name. The value does not need to be unique.

" }, "maximumMessageRatePerSecond":{ "shape":"RoomMaxMessageRatePerSecond", "documentation":"

Maximum number of messages per second that can be sent to the room (by all clients). Default: 10.

" }, + "maximumMessageLength":{ + "shape":"RoomMaxMessageLength", + "documentation":"

Maximum number of characters in a single message. Messages are expected to be UTF-8 encoded and this limit applies specifically to rune/code-point count, not number of bytes. Default: 500.

" + }, "messageReviewHandler":{ "shape":"MessageReviewHandler", "documentation":"

Configuration information for optional review of messages.

" }, - "name":{ - "shape":"RoomName", - "documentation":"

Room name. The value does not need to be unique.

" - }, "tags":{ "shape":"Tags", "documentation":"

Tags to attach to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS Chat has no constraints beyond what is documented there.

" + }, + "loggingConfigurationIdentifiers":{ + "shape":"LoggingConfigurationIdentifierList", + "documentation":"

Array of logging-configuration identifiers attached to the room.

" } } }, @@ -522,41 +523,41 @@ "shape":"RoomArn", "documentation":"

Room ARN, assigned by the system.

" }, - "createTime":{ - "shape":"Time", - "documentation":"

Time when the room was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" - }, "id":{ "shape":"RoomID", "documentation":"

Room ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the room.

" }, - "loggingConfigurationIdentifiers":{ - "shape":"LoggingConfigurationIdentifierList", - "documentation":"

Array of logging configurations attached to the room, from the request (if specified).

" + "name":{ + "shape":"RoomName", + "documentation":"

Room name, from the request (if specified).

" }, - "maximumMessageLength":{ - "shape":"RoomMaxMessageLength", - "documentation":"

Maximum number of characters in a single message, from the request (if specified).

" + "createTime":{ + "shape":"Time", + "documentation":"

Time when the room was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" + }, + "updateTime":{ + "shape":"Time", + "documentation":"

Time of the room’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, "maximumMessageRatePerSecond":{ "shape":"RoomMaxMessageRatePerSecond", "documentation":"

Maximum number of messages per second that can be sent to the room (by all clients), from the request (if specified).

" }, + "maximumMessageLength":{ + "shape":"RoomMaxMessageLength", + "documentation":"

Maximum number of characters in a single message, from the request (if specified).

" + }, "messageReviewHandler":{ "shape":"MessageReviewHandler", "documentation":"

Configuration information for optional review of messages.

" }, - "name":{ - "shape":"RoomName", - "documentation":"

Room name, from the request (if specified).

" - }, "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource, from the request (if specified).

" }, - "updateTime":{ - "shape":"Time", - "documentation":"

Time of the room’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" + "loggingConfigurationIdentifiers":{ + "shape":"LoggingConfigurationIdentifierList", + "documentation":"

Array of logging configurations attached to the room, from the request (if specified).

" } } }, @@ -573,10 +574,14 @@ "DeleteMessageRequest":{ "type":"structure", "required":[ - "id", - "roomIdentifier" + "roomIdentifier", + "id" ], "members":{ + "roomIdentifier":{ + "shape":"RoomIdentifier", + "documentation":"

Identifier of the room where the message should be deleted. Currently this must be an ARN.

" + }, "id":{ "shape":"MessageID", "documentation":"

ID of the message to be deleted. This is the Id field in the received message (see Message (Subscribe) in the Chat Messaging API).

" @@ -584,10 +589,6 @@ "reason":{ "shape":"Reason", "documentation":"

Reason for deleting the message.

" - }, - "roomIdentifier":{ - "shape":"RoomIdentifier", - "documentation":"

Identifier of the room where the message should be deleted. Currently this must be an ARN.

" } } }, @@ -614,11 +615,15 @@ "type":"string", "max":64, "min":1, - "pattern":"^[a-zA-Z0-9_.-]+$" + "pattern":"[a-zA-Z0-9_.-]+" }, "DestinationConfiguration":{ "type":"structure", "members":{ + "s3":{ + "shape":"S3DestinationConfiguration", + "documentation":"

An Amazon S3 destination configuration where chat activity will be logged.

" + }, "cloudWatchLogs":{ "shape":"CloudWatchLogsDestinationConfiguration", "documentation":"

An Amazon CloudWatch Logs destination configuration where chat activity will be logged.

" @@ -626,10 +631,6 @@ "firehose":{ "shape":"FirehoseDestinationConfiguration", "documentation":"

An Amazon Kinesis Data Firehose destination configuration where chat activity will be logged.

" - }, - "s3":{ - "shape":"S3DestinationConfiguration", - "documentation":"

An Amazon S3 destination configuration where chat activity will be logged.

" } }, "documentation":"

A complex type that describes a location where chat logs will be stored. Each member represents the configuration of one log destination. For logging, you define only one type of destination (for CloudWatch Logs, Kinesis Firehose, or S3).

", @@ -642,10 +643,6 @@ "userId" ], "members":{ - "reason":{ - "shape":"Reason", - "documentation":"

Reason for disconnecting the user.

" - }, "roomIdentifier":{ "shape":"RoomIdentifier", "documentation":"

Identifier of the room from which the user's clients should be disconnected. Currently this must be an ARN.

" @@ -653,6 +650,10 @@ "userId":{ "shape":"UserID", "documentation":"

ID of the user (connection) to disconnect from the room.

" + }, + "reason":{ + "shape":"Reason", + "documentation":"

Reason for disconnecting the user.

" } } }, @@ -708,22 +709,26 @@ "shape":"LoggingConfigurationArn", "documentation":"

Logging-configuration ARN, from the request (if identifier was an ARN).

" }, + "id":{ + "shape":"LoggingConfigurationID", + "documentation":"

Logging-configuration ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the logging configuration.

" + }, "createTime":{ "shape":"Time", "documentation":"

Time when the logging configuration was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, - "destinationConfiguration":{ - "shape":"DestinationConfiguration", - "documentation":"

A complex type that contains a destination configuration for where chat content will be logged. There is only one type of destination (cloudWatchLogs, firehose, or s3) in a destinationConfiguration.

" - }, - "id":{ - "shape":"LoggingConfigurationID", - "documentation":"

Logging-configuration ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the logging configuration.

" + "updateTime":{ + "shape":"Time", + "documentation":"

Time of the logging configuration’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, "name":{ "shape":"LoggingConfigurationName", "documentation":"

Logging-configuration name. This value does not need to be unique.

" }, + "destinationConfiguration":{ + "shape":"DestinationConfiguration", + "documentation":"

A complex type that contains a destination configuration for where chat content will be logged. There is only one type of destination (cloudWatchLogs, firehose, or s3) in a destinationConfiguration.

" + }, "state":{ "shape":"LoggingConfigurationState", "documentation":"

The state of the logging configuration. When the state is ACTIVE, the configuration is ready to log chat content.

" @@ -731,10 +736,6 @@ "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value).

" - }, - "updateTime":{ - "shape":"Time", - "documentation":"

Time of the logging configuration’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" } } }, @@ -755,41 +756,41 @@ "shape":"RoomArn", "documentation":"

Room ARN, from the request (if identifier was an ARN).

" }, - "createTime":{ - "shape":"Time", - "documentation":"

Time when the room was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" - }, "id":{ "shape":"RoomID", "documentation":"

Room ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the room.

" }, - "loggingConfigurationIdentifiers":{ - "shape":"LoggingConfigurationIdentifierList", - "documentation":"

Array of logging configurations attached to the room.

" + "name":{ + "shape":"RoomName", + "documentation":"

Room name. The value does not need to be unique.

" }, - "maximumMessageLength":{ - "shape":"RoomMaxMessageLength", - "documentation":"

Maximum number of characters in a single message. Messages are expected to be UTF-8 encoded and this limit applies specifically to rune/code-point count, not number of bytes. Default: 500.

" + "createTime":{ + "shape":"Time", + "documentation":"

Time when the room was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" + }, + "updateTime":{ + "shape":"Time", + "documentation":"

Time of the room’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, "maximumMessageRatePerSecond":{ "shape":"RoomMaxMessageRatePerSecond", "documentation":"

Maximum number of messages per second that can be sent to the room (by all clients). Default: 10.

" }, + "maximumMessageLength":{ + "shape":"RoomMaxMessageLength", + "documentation":"

Maximum number of characters in a single message. Messages are expected to be UTF-8 encoded and this limit applies specifically to rune/code-point count, not number of bytes. Default: 500.

" + }, "messageReviewHandler":{ "shape":"MessageReviewHandler", "documentation":"

Configuration information for optional review of messages.

" }, - "name":{ - "shape":"RoomName", - "documentation":"

Room name. The value does not need to be unique.

" - }, "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value).

" }, - "updateTime":{ - "shape":"Time", - "documentation":"

Time of the room’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" + "loggingConfigurationIdentifiers":{ + "shape":"LoggingConfigurationIdentifierList", + "documentation":"

Array of logging configurations attached to the room.

" } } }, @@ -797,7 +798,7 @@ "type":"string", "max":12, "min":12, - "pattern":"^[a-zA-Z0-9]+$" + "pattern":"[a-zA-Z0-9]+" }, "InternalServerException":{ "type":"structure", @@ -814,19 +815,19 @@ "type":"string", "max":170, "min":0, - "pattern":"^$|^arn:aws:lambda:[a-z0-9-]+:[0-9]{12}:function:.+" + "pattern":"$|^arn:aws:lambda:[a-z0-9-]+:[0-9]{12}:function:.+.*" }, "Limit":{"type":"integer"}, "ListLoggingConfigurationsRequest":{ "type":"structure", "members":{ - "maxResults":{ - "shape":"MaxLoggingConfigurationResults", - "documentation":"

Maximum number of logging configurations to return. Default: 50.

" - }, "nextToken":{ "shape":"PaginationToken", "documentation":"

The first logging configurations to retrieve. This is used for pagination; see the nextToken response field.

" + }, + "maxResults":{ + "shape":"MaxLoggingConfigurationResults", + "documentation":"

Maximum number of logging configurations to return. Default: 50.

" } } }, @@ -847,9 +848,13 @@ "ListRoomsRequest":{ "type":"structure", "members":{ - "loggingConfigurationIdentifier":{ - "shape":"LoggingConfigurationIdentifier", - "documentation":"

Logging-configuration identifier.

" + "name":{ + "shape":"RoomName", + "documentation":"

Filters the list to match the specified room name.

" + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

The first room to retrieve. This is used for pagination; see the nextToken response field.

" }, "maxResults":{ "shape":"MaxRoomResults", @@ -859,13 +864,9 @@ "shape":"LambdaArn", "documentation":"

Filters the list to match the specified message review handler URI.

" }, - "name":{ - "shape":"RoomName", - "documentation":"

Filters the list to match the specified room name.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The first room to retrieve. This is used for pagination; see the nextToken response field.

" + "loggingConfigurationIdentifier":{ + "shape":"LoggingConfigurationIdentifier", + "documentation":"

Logging-configuration identifier.

" } } }, @@ -873,13 +874,13 @@ "type":"structure", "required":["rooms"], "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If there are more rooms than maxResults, use nextToken in the request to get the next set.

" - }, "rooms":{ "shape":"RoomList", "documentation":"

List of the matching rooms (summary information only).

" + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

If there are more rooms than maxResults, use nextToken in the request to get the next set.

" } } }, @@ -909,25 +910,25 @@ "type":"string", "max":512, "min":1, - "pattern":"^[\\.\\-_/#A-Za-z0-9]+$" + "pattern":"[\\.\\-_/#A-Za-z0-9]+" }, "LoggingConfigurationArn":{ "type":"string", "max":128, "min":1, - "pattern":"^arn:aws:ivschat:[a-z0-9-]+:[0-9]+:logging-configuration/[a-zA-Z0-9-]+$" + "pattern":"arn:aws:ivschat:[a-z0-9-]+:[0-9]+:logging-configuration/[a-zA-Z0-9-]+" }, "LoggingConfigurationID":{ "type":"string", "max":12, "min":12, - "pattern":"^[a-zA-Z0-9]+$" + "pattern":"[a-zA-Z0-9]+" }, "LoggingConfigurationIdentifier":{ "type":"string", "max":128, "min":1, - "pattern":"^arn:aws:ivschat:[a-z0-9-]+:[0-9]+:logging-configuration/[a-zA-Z0-9-]+$" + "pattern":"arn:aws:ivschat:[a-z0-9-]+:[0-9]+:logging-configuration/[a-zA-Z0-9-]+" }, "LoggingConfigurationIdentifierList":{ "type":"list", @@ -943,7 +944,7 @@ "type":"string", "max":128, "min":0, - "pattern":"^[a-zA-Z0-9-_]*$" + "pattern":"[a-zA-Z0-9-_]*" }, "LoggingConfigurationState":{ "type":"string", @@ -964,22 +965,26 @@ "shape":"LoggingConfigurationArn", "documentation":"

Logging-configuration ARN.

" }, + "id":{ + "shape":"LoggingConfigurationID", + "documentation":"

Logging-configuration ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the room.

" + }, "createTime":{ "shape":"Time", "documentation":"

Time when the logging configuration was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, - "destinationConfiguration":{ - "shape":"DestinationConfiguration", - "documentation":"

A complex type that contains a destination configuration for where chat content will be logged.

" - }, - "id":{ - "shape":"LoggingConfigurationID", - "documentation":"

Logging-configuration ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the room.

" + "updateTime":{ + "shape":"Time", + "documentation":"

Time of the logging configuration’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, "name":{ "shape":"LoggingConfigurationName", "documentation":"

Logging-configuration name. The value does not need to be unique.

" }, + "destinationConfiguration":{ + "shape":"DestinationConfiguration", + "documentation":"

A complex type that contains a destination configuration for where chat content will be logged.

" + }, "state":{ "shape":"LoggingConfigurationState", "documentation":"

The state of the logging configuration. When this is ACTIVE, the configuration is ready for logging chat content.

" @@ -987,10 +992,6 @@ "tags":{ "shape":"Tags", "documentation":"

Tags to attach to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS Chat has no constraints on tags beyond what is documented there.

" - }, - "updateTime":{ - "shape":"Time", - "documentation":"

Time of the logging configuration’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" } }, "documentation":"

Summary information about a logging configuration.

" @@ -1011,18 +1012,18 @@ "type":"string", "max":12, "min":12, - "pattern":"^[a-zA-Z0-9]+$" + "pattern":"[a-zA-Z0-9]+" }, "MessageReviewHandler":{ "type":"structure", "members":{ - "fallbackResult":{ - "shape":"FallbackResult", - "documentation":"

Specifies the fallback behavior (whether the message is allowed or denied) if the handler does not return a valid response, encounters an error, or times out. (For the timeout period, see Service Quotas.) If allowed, the message is delivered with returned content to all users connected to the room. If denied, the message is not delivered to any user. Default: ALLOW.

" - }, "uri":{ "shape":"LambdaArn", "documentation":"

Identifier of the message review handler. Currently this must be an ARN of a lambda function.

" + }, + "fallbackResult":{ + "shape":"FallbackResult", + "documentation":"

Specifies the fallback behavior (whether the message is allowed or denied) if the handler does not return a valid response, encounters an error, or times out. (For the timeout period, see Service Quotas.) If allowed, the message is delivered with returned content to all users connected to the room. If denied, the message is not delivered to any user. Default: ALLOW.

" } }, "documentation":"

Configuration information for optional message review.

" @@ -1054,11 +1055,11 @@ "type":"string", "max":128, "min":1, - "pattern":"^arn:aws:ivschat:[a-z0-9-]+:[0-9]+:[a-z-]/[a-zA-Z0-9-]+$" + "pattern":"arn:aws:ivschat:[a-z0-9-]+:[0-9]+:[a-z-]/[a-zA-Z0-9-]+" }, "ResourceId":{ "type":"string", - "pattern":"^[a-zA-Z0-9]+$" + "pattern":"[a-zA-Z0-9]+" }, "ResourceNotFoundException":{ "type":"structure", @@ -1093,19 +1094,19 @@ "type":"string", "max":128, "min":1, - "pattern":"^arn:aws:ivschat:[a-z0-9-]+:[0-9]+:room/[a-zA-Z0-9-]+$" + "pattern":"arn:aws:ivschat:[a-z0-9-]+:[0-9]+:room/[a-zA-Z0-9-]+" }, "RoomID":{ "type":"string", "max":12, "min":12, - "pattern":"^[a-zA-Z0-9]+$" + "pattern":"[a-zA-Z0-9]+" }, "RoomIdentifier":{ "type":"string", "max":128, "min":1, - "pattern":"^arn:aws:ivschat:[a-z0-9-]+:[0-9]+:room/[a-zA-Z0-9-]+$" + "pattern":"arn:aws:ivschat:[a-z0-9-]+:[0-9]+:room/[a-zA-Z0-9-]+" }, "RoomList":{ "type":"list", @@ -1127,7 +1128,7 @@ "type":"string", "max":128, "min":0, - "pattern":"^[a-zA-Z0-9-_]*$" + "pattern":"[a-zA-Z0-9-_]*" }, "RoomSummary":{ "type":"structure", @@ -1136,33 +1137,33 @@ "shape":"RoomArn", "documentation":"

Room ARN.

" }, - "createTime":{ - "shape":"Time", - "documentation":"

Time when the room was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" - }, "id":{ "shape":"RoomID", "documentation":"

Room ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the room.

" }, - "loggingConfigurationIdentifiers":{ - "shape":"LoggingConfigurationIdentifierList", - "documentation":"

List of logging-configuration identifiers attached to the room.

" + "name":{ + "shape":"RoomName", + "documentation":"

Room name. The value does not need to be unique.

" }, "messageReviewHandler":{ "shape":"MessageReviewHandler", "documentation":"

Configuration information for optional review of messages.

" }, - "name":{ - "shape":"RoomName", - "documentation":"

Room name. The value does not need to be unique.

" + "createTime":{ + "shape":"Time", + "documentation":"

Time when the room was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" + }, + "updateTime":{ + "shape":"Time", + "documentation":"

Time of the room’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS Chat has no constraints beyond what is documented there.

" }, - "updateTime":{ - "shape":"Time", - "documentation":"

Time of the room’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" + "loggingConfigurationIdentifiers":{ + "shape":"LoggingConfigurationIdentifierList", + "documentation":"

List of logging-configuration identifiers attached to the room.

" } }, "documentation":"

Summary information about a room.

" @@ -1181,21 +1182,21 @@ "SendEventRequest":{ "type":"structure", "required":[ - "eventName", - "roomIdentifier" + "roomIdentifier", + "eventName" ], "members":{ - "attributes":{ - "shape":"EventAttributes", - "documentation":"

Application-defined metadata to attach to the event sent to clients. The maximum length of the metadata is 1 KB total.

" + "roomIdentifier":{ + "shape":"RoomIdentifier", + "documentation":"

Identifier of the room to which the event will be sent. Currently this must be an ARN.

" }, "eventName":{ "shape":"EventName", "documentation":"

Application-defined name of the event to send to clients.

" }, - "roomIdentifier":{ - "shape":"RoomIdentifier", - "documentation":"

Identifier of the room to which the event will be sent. Currently this must be an ARN.

" + "attributes":{ + "shape":"EventAttributes", + "documentation":"

Application-defined metadata to attach to the event sent to clients. The maximum length of the metadata is 1 KB total.

" } } }, @@ -1211,16 +1212,12 @@ "ServiceQuotaExceededException":{ "type":"structure", "required":[ - "limit", "message", "resourceId", - "resourceType" + "resourceType", + "limit" ], "members":{ - "limit":{ - "shape":"Limit", - "documentation":"

" - }, "message":{"shape":"ErrorMessage"}, "resourceId":{ "shape":"ResourceId", @@ -1229,6 +1226,10 @@ "resourceType":{ "shape":"ResourceType", "documentation":"

" + }, + "limit":{ + "shape":"Limit", + "documentation":"

" } }, "documentation":"

", @@ -1295,16 +1296,12 @@ "ThrottlingException":{ "type":"structure", "required":[ - "limit", "message", "resourceId", - "resourceType" + "resourceType", + "limit" ], "members":{ - "limit":{ - "shape":"Limit", - "documentation":"

" - }, "message":{"shape":"ErrorMessage"}, "resourceId":{ "shape":"ResourceId", @@ -1313,6 +1310,10 @@ "resourceType":{ "shape":"ResourceType", "documentation":"

" + }, + "limit":{ + "shape":"Limit", + "documentation":"

" } }, "documentation":"

", @@ -1356,10 +1357,6 @@ "type":"structure", "required":["identifier"], "members":{ - "destinationConfiguration":{ - "shape":"DestinationConfiguration", - "documentation":"

A complex type that contains a destination configuration for where chat content will be logged. There can be only one type of destination (cloudWatchLogs, firehose, or s3) in a destinationConfiguration.

" - }, "identifier":{ "shape":"LoggingConfigurationIdentifier", "documentation":"

Identifier of the logging configuration to be updated.

" @@ -1367,6 +1364,10 @@ "name":{ "shape":"LoggingConfigurationName", "documentation":"

Logging-configuration name. The value does not need to be unique.

" + }, + "destinationConfiguration":{ + "shape":"DestinationConfiguration", + "documentation":"

A complex type that contains a destination configuration for where chat content will be logged. There can be only one type of destination (cloudWatchLogs, firehose, or s3) in a destinationConfiguration.

" } } }, @@ -1377,22 +1378,26 @@ "shape":"LoggingConfigurationArn", "documentation":"

Logging-configuration ARN, from the request (if identifier was an ARN).

" }, + "id":{ + "shape":"LoggingConfigurationID", + "documentation":"

Logging-configuration ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the room.

" + }, "createTime":{ "shape":"Time", "documentation":"

Time when the logging configuration was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, - "destinationConfiguration":{ - "shape":"DestinationConfiguration", - "documentation":"

A complex type that contains a destination configuration for where chat content will be logged, from the request. There is only one type of destination (cloudWatchLogs, firehose, or s3) in a destinationConfiguration.

" - }, - "id":{ - "shape":"LoggingConfigurationID", - "documentation":"

Logging-configuration ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the room.

" + "updateTime":{ + "shape":"Time", + "documentation":"

Time of the logging configuration’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, "name":{ "shape":"LoggingConfigurationName", "documentation":"

Logging-configuration name, from the request (if specified).

" }, + "destinationConfiguration":{ + "shape":"DestinationConfiguration", + "documentation":"

A complex type that contains a destination configuration for where chat content will be logged, from the request. There is only one type of destination (cloudWatchLogs, firehose, or s3) in a destinationConfiguration.

" + }, "state":{ "shape":"UpdateLoggingConfigurationState", "documentation":"

The state of the logging configuration. When the state is ACTIVE, the configuration is ready to log chat content.

" @@ -1400,10 +1405,6 @@ "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value).

" - }, - "updateTime":{ - "shape":"Time", - "documentation":"

Time of the logging configuration’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" } } }, @@ -1419,25 +1420,25 @@ "shape":"RoomIdentifier", "documentation":"

Identifier of the room to be updated. Currently this must be an ARN.

" }, - "loggingConfigurationIdentifiers":{ - "shape":"LoggingConfigurationIdentifierList", - "documentation":"

Array of logging-configuration identifiers attached to the room.

" - }, - "maximumMessageLength":{ - "shape":"RoomMaxMessageLength", - "documentation":"

The maximum number of characters in a single message. Messages are expected to be UTF-8 encoded and this limit applies specifically to rune/code-point count, not number of bytes. Default: 500.

" + "name":{ + "shape":"RoomName", + "documentation":"

Room name. The value does not need to be unique.

" }, "maximumMessageRatePerSecond":{ "shape":"RoomMaxMessageRatePerSecond", "documentation":"

Maximum number of messages per second that can be sent to the room (by all clients). Default: 10.

" }, + "maximumMessageLength":{ + "shape":"RoomMaxMessageLength", + "documentation":"

The maximum number of characters in a single message. Messages are expected to be UTF-8 encoded and this limit applies specifically to rune/code-point count, not number of bytes. Default: 500.

" + }, "messageReviewHandler":{ "shape":"MessageReviewHandler", "documentation":"

Configuration information for optional review of messages. Specify an empty uri string to disassociate a message review handler from the specified room.

" }, - "name":{ - "shape":"RoomName", - "documentation":"

Room name. The value does not need to be unique.

" + "loggingConfigurationIdentifiers":{ + "shape":"LoggingConfigurationIdentifierList", + "documentation":"

Array of logging-configuration identifiers attached to the room.

" } } }, @@ -1448,41 +1449,41 @@ "shape":"RoomArn", "documentation":"

Room ARN, from the request (if identifier was an ARN).

" }, - "createTime":{ - "shape":"Time", - "documentation":"

Time when the room was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" - }, "id":{ "shape":"RoomID", "documentation":"

Room ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the room.

" }, - "loggingConfigurationIdentifiers":{ - "shape":"LoggingConfigurationIdentifierList", - "documentation":"

Array of logging configurations attached to the room, from the request (if specified).

" + "name":{ + "shape":"RoomName", + "documentation":"

Room name, from the request (if specified).

" }, - "maximumMessageLength":{ - "shape":"RoomMaxMessageLength", - "documentation":"

Maximum number of characters in a single message, from the request (if specified).

" + "createTime":{ + "shape":"Time", + "documentation":"

Time when the room was created. This is an ISO 8601 timestamp; note that this is returned as a string.

" + }, + "updateTime":{ + "shape":"Time", + "documentation":"

Time of the room’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, "maximumMessageRatePerSecond":{ "shape":"RoomMaxMessageRatePerSecond", "documentation":"

Maximum number of messages per second that can be sent to the room (by all clients), from the request (if specified).

" }, + "maximumMessageLength":{ + "shape":"RoomMaxMessageLength", + "documentation":"

Maximum number of characters in a single message, from the request (if specified).

" + }, "messageReviewHandler":{ "shape":"MessageReviewHandler", "documentation":"

Configuration information for optional review of messages.

" }, - "name":{ - "shape":"RoomName", - "documentation":"

Room name, from the request (if specified).

" - }, "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value).

" }, - "updateTime":{ - "shape":"Time", - "documentation":"

Time of the room’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

" + "loggingConfigurationIdentifiers":{ + "shape":"LoggingConfigurationIdentifierList", + "documentation":"

Array of logging configurations attached to the room, from the request (if specified).

" } } }, @@ -1499,14 +1500,14 @@ "reason" ], "members":{ - "fieldList":{ - "shape":"ValidationExceptionFieldList", - "documentation":"

" - }, "message":{"shape":"ErrorMessage"}, "reason":{ "shape":"ValidationExceptionReason", "documentation":"

" + }, + "fieldList":{ + "shape":"ValidationExceptionFieldList", + "documentation":"

" } }, "documentation":"

", @@ -1519,17 +1520,17 @@ "ValidationExceptionField":{ "type":"structure", "required":[ - "message", - "name" + "name", + "message" ], "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Explanation of the reason for the validation error.

" - }, "name":{ "shape":"FieldName", "documentation":"

Name of the field which failed validation.

" + }, + "message":{ + "shape":"ErrorMessage", + "documentation":"

Explanation of the reason for the validation error.

" } }, "documentation":"

This object is used in the ValidationException error.

" @@ -1547,5 +1548,5 @@ ] } }, - "documentation":"

Introduction

The Amazon IVS Chat control-plane API enables you to create and manage Amazon IVS Chat resources. You also need to integrate with the Amazon IVS Chat Messaging API, to enable users to interact with chat rooms in real time.

The API is an AWS regional service. For a list of supported regions and Amazon IVS Chat HTTPS service endpoints, see the Amazon IVS Chat information on the Amazon IVS page in the AWS General Reference.

Notes on terminology:

Key Concepts

Tagging

A tag is a metadata label that you assign to an AWS resource. A tag comprises a key and a value, both set by you. For example, you might set a tag as topic:nature to label a particular video category. See Tagging AWS Resources for more information, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS Chat has no service-specific constraints beyond what is documented there.

Tags can help you identify and organize your AWS resources. For example, you can use the same tag for different resources to indicate that they are related. You can also use tags to manage access (see Access Tags).

The Amazon IVS Chat API has these tag-related endpoints: TagResource, UntagResource, and ListTagsForResource. The following resource supports tagging: Room.

At most 50 tags can be applied to a resource.

API Access Security

Your Amazon IVS Chat applications (service applications and clients) must be authenticated and authorized to access Amazon IVS Chat resources. Note the differences between these concepts:

Users (viewers) connect to a room using secure access tokens that you create using the CreateChatToken endpoint through the AWS SDK. You call CreateChatToken for every user’s chat session, passing identity and authorization information about the user.

Signing API Requests

HTTP API requests must be signed with an AWS SigV4 signature using your AWS security credentials. The AWS Command Line Interface (CLI) and the AWS SDKs take care of signing the underlying API calls for you. However, if your application calls the Amazon IVS Chat HTTP API directly, it’s your responsibility to sign the requests.

You generate a signature using valid AWS credentials for an IAM role that has permission to perform the requested action. For example, DeleteMessage requests must be made using an IAM role that has the ivschat:DeleteMessage permission.

For more information:

Amazon Resource Names (ARNs)

ARNs uniquely identify AWS resources. An ARN is required when you need to specify a resource unambiguously across all of AWS, such as in IAM policies and API calls. For more information, see Amazon Resource Names in the AWS General Reference.

Messaging Endpoints

Chat Token Endpoint

Room Endpoints

Logging Configuration Endpoints

Tags Endpoints

All the above are HTTP operations. There is a separate messaging API for managing Chat resources; see the Amazon IVS Chat Messaging API Reference.

" + "documentation":"

Introduction

The Amazon IVS Chat control-plane API enables you to create and manage Amazon IVS Chat resources. You also need to integrate with the Amazon IVS Chat Messaging API, to enable users to interact with chat rooms in real time.

The API is an AWS regional service. For a list of supported regions and Amazon IVS Chat HTTPS service endpoints, see the Amazon IVS Chat information on the Amazon IVS page in the AWS General Reference.

This document describes HTTP operations. There is a separate messaging API for managing Chat resources; see the Amazon IVS Chat Messaging API Reference.

Notes on terminology:

Resources

The following resources are part of Amazon IVS Chat:

Tagging

A tag is a metadata label that you assign to an AWS resource. A tag comprises a key and a value, both set by you. For example, you might set a tag as topic:nature to label a particular video category. See Tagging AWS Resources for more information, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS Chat has no service-specific constraints beyond what is documented there.

Tags can help you identify and organize your AWS resources. For example, you can use the same tag for different resources to indicate that they are related. You can also use tags to manage access (see Access Tags).

The Amazon IVS Chat API has these tag-related endpoints: TagResource, UntagResource, and ListTagsForResource. The following resource supports tagging: Room.

At most 50 tags can be applied to a resource.

API Access Security

Your Amazon IVS Chat applications (service applications and clients) must be authenticated and authorized to access Amazon IVS Chat resources. Note the differences between these concepts:

Users (viewers) connect to a room using secure access tokens that you create using the CreateChatToken endpoint through the AWS SDK. You call CreateChatToken for every user’s chat session, passing identity and authorization information about the user.

Signing API Requests

HTTP API requests must be signed with an AWS SigV4 signature using your AWS security credentials. The AWS Command Line Interface (CLI) and the AWS SDKs take care of signing the underlying API calls for you. However, if your application calls the Amazon IVS Chat HTTP API directly, it’s your responsibility to sign the requests.

You generate a signature using valid AWS credentials for an IAM role that has permission to perform the requested action. For example, DeleteMessage requests must be made using an IAM role that has the ivschat:DeleteMessage permission.

For more information:

Amazon Resource Names (ARNs)

ARNs uniquely identify AWS resources. An ARN is required when you need to specify a resource unambiguously across all of AWS, such as in IAM policies and API calls. For more information, see Amazon Resource Names in the AWS General Reference.

" } diff --git a/botocore/data/ivschat/2020-07-14/waiters-2.json b/botocore/data/ivschat/2020-07-14/waiters-2.json new file mode 100644 index 0000000000..13f60ee66b --- /dev/null +++ b/botocore/data/ivschat/2020-07-14/waiters-2.json @@ -0,0 +1,5 @@ +{ + "version": 2, + "waiters": { + } +} diff --git a/botocore/data/medialive/2017-10-14/service-2.json b/botocore/data/medialive/2017-10-14/service-2.json index 7f9f2da0d5..f437325088 100644 --- a/botocore/data/medialive/2017-10-14/service-2.json +++ b/botocore/data/medialive/2017-10-14/service-2.json @@ -9,7 +9,10 @@ "uid": "medialive-2017-10-14", "signatureVersion": "v4", "serviceAbbreviation": "MediaLive", - "jsonVersion": "1.1" + "jsonVersion": "1.1", + "auth": [ + "aws.auth#sigv4" + ] }, "operations": { "AcceptInputDeviceTransfer": { @@ -855,7 +858,7 @@ }, { "shape": "NotFoundException", - "documentation": "The multiplex that you are trying to delete doesn\u2019t exist. Check the ID and try again." + "documentation": "The multiplex that you are trying to delete doesn’t exist. Check the ID and try again." }, { "shape": "GatewayTimeoutException", @@ -905,7 +908,7 @@ }, { "shape": "NotFoundException", - "documentation": "The program that you are trying to delete doesn\u2019t exist. Check the ID and try again." + "documentation": "The program that you are trying to delete doesn’t exist. Check the ID and try again." }, { "shape": "GatewayTimeoutException", @@ -1353,7 +1356,7 @@ }, { "shape": "NotFoundException", - "documentation": "The multiplex that you are trying to describe doesn\u2019t exist. Check the ID and try again." + "documentation": "The multiplex that you are trying to describe doesn’t exist. Check the ID and try again." }, { "shape": "GatewayTimeoutException", @@ -1399,7 +1402,7 @@ }, { "shape": "NotFoundException", - "documentation": "MediaLive can't describe the program. The multiplex or the program that you specified doesn\u2019t exist. Check the IDs and try again." + "documentation": "MediaLive can't describe the program. The multiplex or the program that you specified doesn’t exist. Check the IDs and try again." }, { "shape": "GatewayTimeoutException", @@ -1847,7 +1850,7 @@ }, { "shape": "NotFoundException", - "documentation": "MediaLive can't provide the list of programs. The multiplex that you specified doesn\u2019t exist. Check the ID and try again." + "documentation": "MediaLive can't provide the list of programs. The multiplex that you specified doesn’t exist. Check the ID and try again." }, { "shape": "GatewayTimeoutException", @@ -2118,7 +2121,7 @@ "documentation": "Request limit exceeded on reboot device calls to the input device service." } ], - "documentation": "Send a reboot command to the specified input device. The device will begin rebooting within a few seconds of sending the command. When the reboot is complete, the device\u2019s connection status will change to connected." + "documentation": "Send a reboot command to the specified input device. The device will begin rebooting within a few seconds of sending the command. When the reboot is complete, the device’s connection status will change to connected." }, "RejectInputDeviceTransfer": { "name": "RejectInputDeviceTransfer", @@ -2357,7 +2360,7 @@ }, { "shape": "NotFoundException", - "documentation": "The multiplex that you are trying to start doesn\u2019t exist. Check the ID and try again." + "documentation": "The multiplex that you are trying to start doesn’t exist. Check the ID and try again." }, { "shape": "GatewayTimeoutException", @@ -2507,7 +2510,7 @@ }, { "shape": "NotFoundException", - "documentation": "The multiplex that you are trying to stop doesn\u2019t exist. Check the ID and try again." + "documentation": "The multiplex that you are trying to stop doesn’t exist. Check the ID and try again." }, { "shape": "GatewayTimeoutException", @@ -2903,7 +2906,7 @@ }, { "shape": "NotFoundException", - "documentation": "The multiplex that you are trying to update doesn\u2019t exist. Check the ID and try again." + "documentation": "The multiplex that you are trying to update doesn’t exist. Check the ID and try again." }, { "shape": "GatewayTimeoutException", @@ -2953,7 +2956,7 @@ }, { "shape": "NotFoundException", - "documentation": "MediaLive can't update the program. The multiplex or the program that you specified doesn\u2019t exist. Check the IDs and try again." + "documentation": "MediaLive can't update the program. The multiplex or the program that you specified doesn’t exist. Check the IDs and try again." }, { "shape": "GatewayTimeoutException", @@ -4681,7 +4684,7 @@ "ProgramSelection": { "shape": "DolbyEProgramSelection", "locationName": "programSelection", - "documentation": "Applies only to Dolby E. Enter the program ID (according to the metadata in the audio) of the Dolby E program to extract from the specified track. One program extracted per audio selector. To select multiple programs, create multiple selectors with the same Track and different Program numbers. \u201cAll channels\u201d means to ignore the program IDs and include all the channels in this selector; useful if metadata is known to be incorrect." + "documentation": "Applies only to Dolby E. Enter the program ID (according to the metadata in the audio) of the Dolby E program to extract from the specified track. One program extracted per audio selector. To select multiple programs, create multiple selectors with the same Track and different Program numbers. “All channels” means to ignore the program IDs and include all the channels in this selector; useful if metadata is known to be incorrect." } }, "documentation": "Audio Dolby EDecode", @@ -6447,6 +6450,11 @@ "Vpc": { "shape": "InputVpcRequest", "locationName": "vpc" + }, + "SrtSettings": { + "shape": "SrtSettingsRequest", + "locationName": "srtSettings", + "documentation": "The settings associated with an SRT input." } }, "documentation": "Placeholder documentation for CreateInput" @@ -6507,6 +6515,11 @@ "Vpc": { "shape": "InputVpcRequest", "locationName": "vpc" + }, + "SrtSettings": { + "shape": "SrtSettingsRequest", + "locationName": "srtSettings", + "documentation": "The settings associated with an SRT input." } }, "documentation": "The name of the input" @@ -7651,6 +7664,11 @@ "Type": { "shape": "InputType", "locationName": "type" + }, + "SrtSettings": { + "shape": "SrtSettings", + "locationName": "srtSettings", + "documentation": "The settings associated with an SRT input." } }, "documentation": "Placeholder documentation for DescribeInputResponse" @@ -8439,7 +8457,7 @@ "Bitrate": { "shape": "__double", "locationName": "bitrate", - "documentation": "Average bitrate in bits/second. Valid bitrates depend on the coding mode.\n// * @affectsRightSizing true" + "documentation": "Average bitrate in bits/second. Valid bitrates depend on the coding mode." }, "CodingMode": { "shape": "Eac3AtmosCodingMode", @@ -8724,7 +8742,7 @@ "FontFamily": { "shape": "__string", "locationName": "fontFamily", - "documentation": "Specifies the font family to include in the font data attached to the EBU-TT captions. Valid only if styleControl is set to include. If you leave this field empty, the font family is set to \"monospaced\". (If styleControl is set to exclude, the font family is always set to \"monospaced\".)\n\nYou specify only the font family. All other style information (color, bold, position and so on) is copied from the input captions. The size is always set to 100% to allow the downstream player to choose the size.\n\n- Enter a list of font families, as a comma-separated list of font names, in order of preference. The name can be a font family (such as \u201cArial\u201d), or a generic font family (such as \u201cserif\u201d), or \u201cdefault\u201d (to let the downstream player choose the font).\n- Leave blank to set the family to \u201cmonospace\u201d." + "documentation": "Specifies the font family to include in the font data attached to the EBU-TT captions. Valid only if styleControl is set to include. If you leave this field empty, the font family is set to \"monospaced\". (If styleControl is set to exclude, the font family is always set to \"monospaced\".)\n\nYou specify only the font family. All other style information (color, bold, position and so on) is copied from the input captions. The size is always set to 100% to allow the downstream player to choose the size.\n\n- Enter a list of font families, as a comma-separated list of font names, in order of preference. The name can be a font family (such as “Arial”), or a generic font family (such as “serif”), or “default” (to let the downstream player choose the font).\n- Leave blank to set the family to “monospace”." }, "StyleControl": { "shape": "EbuTtDDestinationStyleControl", @@ -8900,7 +8918,7 @@ "JamSyncTime": { "shape": "__string", "locationName": "jamSyncTime", - "documentation": "Optional. Enter a time for the jam sync. The default is midnight UTC. When epoch locking is enabled, MediaLive performs a daily jam sync on every output encode to ensure timecodes don\u2019t diverge from the wall clock. The jam sync applies only to encodes with frame rate of 29.97 or 59.94 FPS. To override, enter a time in HH:MM:SS in UTC. Always set the MM:SS portion to 00:00." + "documentation": "Optional. Enter a time for the jam sync. The default is midnight UTC. When epoch locking is enabled, MediaLive performs a daily jam sync on every output encode to ensure timecodes don’t diverge from the wall clock. The jam sync applies only to encodes with frame rate of 29.97 or 59.94 FPS. To override, enter a time in HH:MM:SS in UTC. Always set the MM:SS portion to 00:00." } }, "documentation": "Epoch Locking Settings" @@ -9558,7 +9576,7 @@ "FilterSettings": { "shape": "H264FilterSettings", "locationName": "filterSettings", - "documentation": "Optional filters that you can apply to an encode." + "documentation": "Optional. Both filters reduce bandwidth by removing imperceptible details. You can enable one of the filters. We\nrecommend that you try both filters and observe the results to decide which one to use.\n\nThe Temporal Filter reduces bandwidth by removing imperceptible details in the content. It combines perceptual\nfiltering and motion compensated temporal filtering (MCTF). It operates independently of the compression level.\n\nThe Bandwidth Reduction filter is a perceptual filter located within the encoding loop. It adapts to the current\ncompression level to filter imperceptible signals. This filter works only when the resolution is 1080p or lower." }, "FixedAfd": { "shape": "FixedAfd", @@ -9952,7 +9970,7 @@ "FilterSettings": { "shape": "H265FilterSettings", "locationName": "filterSettings", - "documentation": "Optional filters that you can apply to an encode." + "documentation": "Optional. Both filters reduce bandwidth by removing imperceptible details. You can enable one of the filters. We\nrecommend that you try both filters and observe the results to decide which one to use.\n\nThe Temporal Filter reduces bandwidth by removing imperceptible details in the content. It combines perceptual\nfiltering and motion compensated temporal filtering (MCTF). It operates independently of the compression level.\n\nThe Bandwidth Reduction filter is a perceptual filter located within the encoding loop. It adapts to the current\ncompression level to filter imperceptible signals. This filter works only when the resolution is 1080p or lower." }, "FixedAfd": { "shape": "FixedAfd", @@ -10971,6 +10989,11 @@ "Type": { "shape": "InputType", "locationName": "type" + }, + "SrtSettings": { + "shape": "SrtSettings", + "locationName": "srtSettings", + "documentation": "The settings associated with an SRT input." } }, "documentation": "Placeholder documentation for Input" @@ -12079,7 +12102,8 @@ "MEDIACONNECT", "INPUT_DEVICE", "AWS_CDI", - "TS_FILE" + "TS_FILE", + "SRT_CALLER" ] }, "InputVpcRequest": { @@ -17426,6 +17450,11 @@ "shape": "__listOfInputSourceRequest", "locationName": "sources", "documentation": "The source URLs for a PULL-type input. Every PULL type input needs\nexactly two source URLs for redundancy.\nOnly specify sources for PULL type Inputs. Leave Destinations empty." + }, + "SrtSettings": { + "shape": "SrtSettingsRequest", + "locationName": "srtSettings", + "documentation": "The settings associated with an SRT input." } }, "documentation": "Placeholder documentation for UpdateInput" @@ -17620,6 +17649,11 @@ "shape": "__listOfInputSourceRequest", "locationName": "sources", "documentation": "The source URLs for a PULL-type input. Every PULL type input needs\nexactly two source URLs for redundancy.\nOnly specify sources for PULL type Inputs. Leave Destinations empty." + }, + "SrtSettings": { + "shape": "SrtSettingsRequest", + "locationName": "srtSettings", + "documentation": "The settings associated with an SRT input." } }, "documentation": "A request to update an input.", @@ -23700,7 +23734,142 @@ "ALL_OUTPUT_GROUPS", "SCTE35_ENABLED_OUTPUT_GROUPS" ] + }, + "Algorithm": { + "type": "string", + "enum": [ + "AES128", + "AES192", + "AES256" + ], + "documentation": "Placeholder documentation for Algorithm" + }, + "SrtCallerDecryption": { + "type": "structure", + "members": { + "Algorithm": { + "shape": "Algorithm", + "locationName": "algorithm", + "documentation": "The algorithm used to encrypt content." + }, + "PassphraseSecretArn": { + "shape": "__string", + "locationName": "passphraseSecretArn", + "documentation": "The ARN for the secret in Secrets Manager. Someone in your organization must create a secret and provide you with its ARN. The secret holds the passphrase that MediaLive uses to decrypt the source content." + } + }, + "documentation": "The decryption settings for the SRT caller source. Present only if the source has decryption enabled." + }, + "SrtCallerDecryptionRequest": { + "type": "structure", + "members": { + "Algorithm": { + "shape": "Algorithm", + "locationName": "algorithm", + "documentation": "The algorithm used to encrypt content." + }, + "PassphraseSecretArn": { + "shape": "__string", + "locationName": "passphraseSecretArn", + "documentation": "The ARN for the secret in Secrets Manager. Someone in your organization must create a secret and provide you with its ARN. This secret holds the passphrase that MediaLive will use to decrypt the source content." + } + }, + "documentation": "Complete these parameters only if the content is encrypted." + }, + "SrtCallerSource": { + "type": "structure", + "members": { + "Decryption": { + "shape": "SrtCallerDecryption", + "locationName": "decryption" + }, + "MinimumLatency": { + "shape": "__integer", + "locationName": "minimumLatency", + "documentation": "The preferred latency (in milliseconds) for implementing packet loss and recovery. Packet recovery is a key feature of SRT." + }, + "SrtListenerAddress": { + "shape": "__string", + "locationName": "srtListenerAddress", + "documentation": "The IP address at the upstream system (the listener) that MediaLive (the caller) connects to." + }, + "SrtListenerPort": { + "shape": "__string", + "locationName": "srtListenerPort", + "documentation": "The port at the upstream system (the listener) that MediaLive (the caller) connects to." + }, + "StreamId": { + "shape": "__string", + "locationName": "streamId", + "documentation": "The stream ID, if the upstream system uses this identifier." + } + }, + "documentation": "The configuration for a source that uses SRT as the connection protocol. In terms of establishing the connection, MediaLive is always caller and the upstream system is always the listener. In terms of transmission of the source content, MediaLive is always the receiver and the upstream system is always the sender." + }, + "SrtCallerSourceRequest": { + "type": "structure", + "members": { + "Decryption": { + "shape": "SrtCallerDecryptionRequest", + "locationName": "decryption" + }, + "MinimumLatency": { + "shape": "__integer", + "locationName": "minimumLatency", + "documentation": "The preferred latency (in milliseconds) for implementing packet loss and recovery. Packet recovery is a key feature of SRT. Obtain this value from the operator at the upstream system." + }, + "SrtListenerAddress": { + "shape": "__string", + "locationName": "srtListenerAddress", + "documentation": "The IP address at the upstream system (the listener) that MediaLive (the caller) will connect to." + }, + "SrtListenerPort": { + "shape": "__string", + "locationName": "srtListenerPort", + "documentation": "The port at the upstream system (the listener) that MediaLive (the caller) will connect to." + }, + "StreamId": { + "shape": "__string", + "locationName": "streamId", + "documentation": "This value is required if the upstream system uses this identifier because without it, the SRT handshake between MediaLive (the caller) and the upstream system (the listener) might fail." + } + }, + "documentation": "Configures the connection for a source that uses SRT as the connection protocol. In terms of establishing the connection, MediaLive is always the caller and the upstream system is always the listener. In terms of transmission of the source content, MediaLive is always the receiver and the upstream system is always the sender." + }, + "SrtSettings": { + "type": "structure", + "members": { + "SrtCallerSources": { + "shape": "__listOfSrtCallerSource", + "locationName": "srtCallerSources" + } + }, + "documentation": "The configured sources for this SRT input." + }, + "SrtSettingsRequest": { + "type": "structure", + "members": { + "SrtCallerSources": { + "shape": "__listOfSrtCallerSourceRequest", + "locationName": "srtCallerSources" + } + }, + "documentation": "Configures the sources for this SRT input. For a single-pipeline input, include one srtCallerSource in the array. For a standard-pipeline input, include two srtCallerSource." + }, + "__listOfSrtCallerSource": { + "type": "list", + "member": { + "shape": "SrtCallerSource" + }, + "documentation": "Placeholder documentation for __listOfSrtCallerSource" + }, + "__listOfSrtCallerSourceRequest": { + "type": "list", + "member": { + "shape": "SrtCallerSourceRequest" + }, + "documentation": "Placeholder documentation for __listOfSrtCallerSourceRequest" } }, "documentation": "API for AWS Elemental MediaLive" -} +} \ No newline at end of file diff --git a/botocore/data/rds/2014-10-31/service-2.json b/botocore/data/rds/2014-10-31/service-2.json index 1f6c52fcf0..cb59b6a8de 100644 --- a/botocore/data/rds/2014-10-31/service-2.json +++ b/botocore/data/rds/2014-10-31/service-2.json @@ -1684,7 +1684,7 @@ "errors":[ {"shape":"ResourceNotFoundFault"} ], - "documentation":"

Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.

" + "documentation":"

Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.

This API follows an eventual consistency model. This means that the result of the DescribePendingMaintenanceActions command might not be immediately visible to all subsequent RDS commands. Keep this in mind when you use DescribePendingMaintenanceActions immediately after using a previous API command such as ApplyPendingMaintenanceActions.

" }, "DescribeReservedDBInstances":{ "name":"DescribeReservedDBInstances", @@ -4268,7 +4268,7 @@ }, "PubliclyAccessible":{ "shape":"BooleanOptional", - "documentation":"

Specifies whether the DB cluster is publicly accessible.

When the DB cluster is publicly accessible, its Domain Name System (DNS) endpoint resolves to the private IP address from within the DB cluster's virtual private cloud (VPC). It resolves to the public IP address from outside of the DB cluster's VPC. Access to the DB cluster is ultimately controlled by the security group it uses. That public access isn't permitted if the security group assigned to the DB cluster doesn't permit it.

When the DB cluster isn't publicly accessible, it is an internal DB cluster with a DNS name that resolves to a private IP address.

Valid for Cluster Type: Multi-AZ DB clusters only

Default: The default behavior varies depending on whether DBSubnetGroupName is specified.

If DBSubnetGroupName isn't specified, and PubliclyAccessible isn't specified, the following applies:

If DBSubnetGroupName is specified, and PubliclyAccessible isn't specified, the following applies:

" + "documentation":"

Specifies whether the DB cluster is publicly accessible.

When the DB cluster is publicly accessible and you connect from outside of the DB cluster's virtual private cloud (VPC), its Domain Name System (DNS) endpoint resolves to the public IP address. When you connect from within the same VPC as the DB cluster, the endpoint resolves to the private IP address. Access to the DB cluster is ultimately controlled by the security group it uses. That public access isn't permitted if the security group assigned to the DB cluster doesn't permit it.

When the DB cluster isn't publicly accessible, it is an internal DB cluster with a DNS name that resolves to a private IP address.

Valid for Cluster Type: Multi-AZ DB clusters only

Default: The default behavior varies depending on whether DBSubnetGroupName is specified.

If DBSubnetGroupName isn't specified, and PubliclyAccessible isn't specified, the following applies:

If DBSubnetGroupName is specified, and PubliclyAccessible isn't specified, the following applies:

" }, "AutoMinorVersionUpgrade":{ "shape":"BooleanOptional", @@ -4503,7 +4503,7 @@ }, "PubliclyAccessible":{ "shape":"BooleanOptional", - "documentation":"

Specifies whether the DB instance is publicly accessible.

When the DB instance is publicly accessible, its Domain Name System (DNS) endpoint resolves to the private IP address from within the DB instance's virtual private cloud (VPC). It resolves to the public IP address from outside of the DB instance's VPC. Access to the DB instance is ultimately controlled by the security group it uses. That public access is not permitted if the security group assigned to the DB instance doesn't permit it.

When the DB instance isn't publicly accessible, it is an internal DB instance with a DNS name that resolves to a private IP address.

Default: The default behavior varies depending on whether DBSubnetGroupName is specified.

If DBSubnetGroupName isn't specified, and PubliclyAccessible isn't specified, the following applies:

If DBSubnetGroupName is specified, and PubliclyAccessible isn't specified, the following applies:

" + "documentation":"

Specifies whether the DB instance is publicly accessible.

When the DB instance is publicly accessible and you connect from outside of the DB instance's virtual private cloud (VPC), its Domain Name System (DNS) endpoint resolves to the public IP address. When you connect from within the same VPC as the DB instance, the endpoint resolves to the private IP address. Access to the DB instance is ultimately controlled by the security group it uses. That public access is not permitted if the security group assigned to the DB instance doesn't permit it.

When the DB instance isn't publicly accessible, it is an internal DB instance with a DNS name that resolves to a private IP address.

Default: The default behavior varies depending on whether DBSubnetGroupName is specified.

If DBSubnetGroupName isn't specified, and PubliclyAccessible isn't specified, the following applies:

If DBSubnetGroupName is specified, and PubliclyAccessible isn't specified, the following applies:

" }, "Tags":{ "shape":"TagList", @@ -5643,7 +5643,7 @@ }, "PubliclyAccessible":{ "shape":"BooleanOptional", - "documentation":"

Indicates whether the DB cluster is publicly accessible.

When the DB cluster is publicly accessible, its Domain Name System (DNS) endpoint resolves to the private IP address from within the DB cluster's virtual private cloud (VPC). It resolves to the public IP address from outside of the DB cluster's VPC. Access to the DB cluster is ultimately controlled by the security group it uses. That public access isn't permitted if the security group assigned to the DB cluster doesn't permit it.

When the DB cluster isn't publicly accessible, it is an internal DB cluster with a DNS name that resolves to a private IP address.

For more information, see CreateDBCluster.

This setting is only for non-Aurora Multi-AZ DB clusters.

" + "documentation":"

Indicates whether the DB cluster is publicly accessible.

When the DB cluster is publicly accessible and you connect from outside of the DB cluster's virtual private cloud (VPC), its Domain Name System (DNS) endpoint resolves to the public IP address. When you connect from within the same VPC as the DB cluster, the endpoint resolves to the private IP address. Access to the DB cluster is ultimately controlled by the security group it uses. That public access isn't permitted if the security group assigned to the DB cluster doesn't permit it.

When the DB cluster isn't publicly accessible, it is an internal DB cluster with a DNS name that resolves to a private IP address.

For more information, see CreateDBCluster.

This setting is only for non-Aurora Multi-AZ DB clusters.

" }, "AutoMinorVersionUpgrade":{ "shape":"Boolean", @@ -6819,7 +6819,7 @@ }, "PubliclyAccessible":{ "shape":"Boolean", - "documentation":"

Indicates whether the DB instance is publicly accessible.

When the DB cluster is publicly accessible, its Domain Name System (DNS) endpoint resolves to the private IP address from within the DB cluster's virtual private cloud (VPC). It resolves to the public IP address from outside of the DB cluster's VPC. Access to the DB cluster is ultimately controlled by the security group it uses. That public access isn't permitted if the security group assigned to the DB cluster doesn't permit it.

When the DB instance isn't publicly accessible, it is an internal DB instance with a DNS name that resolves to a private IP address.

For more information, see CreateDBInstance.

" + "documentation":"

Indicates whether the DB instance is publicly accessible.

When the DB instance is publicly accessible and you connect from outside of the DB instance's virtual private cloud (VPC), its Domain Name System (DNS) endpoint resolves to the public IP address. When you connect from within the same VPC as the DB instance, the endpoint resolves to the private IP address. Access to the DB cluster is ultimately controlled by the security group it uses. That public access isn't permitted if the security group assigned to the DB cluster doesn't permit it.

When the DB instance isn't publicly accessible, it is an internal DB instance with a DNS name that resolves to a private IP address.

For more information, see CreateDBInstance.

" }, "StatusInfos":{ "shape":"DBInstanceStatusInfoList", @@ -8713,7 +8713,7 @@ }, "DeleteAutomatedBackups":{ "shape":"BooleanOptional", - "documentation":"

Specifies whether to remove automated backups immediately after the DB cluster is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB cluster is deleted.

" + "documentation":"

Specifies whether to remove automated backups immediately after the DB cluster is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB cluster is deleted.

You must delete automated backups for Amazon RDS Multi-AZ DB clusters. For more information about managing automated backups for RDS Multi-AZ DB clusters, see Managing automated backups.

" } }, "documentation":"

" @@ -9182,7 +9182,7 @@ }, "Source":{ "shape":"String", - "documentation":"

A specific source to return parameters for.

Valid Values:

" + "documentation":"

A specific source to return parameters for.

Valid Values:

" }, "Filters":{ "shape":"FilterList", @@ -12563,7 +12563,7 @@ }, "PubliclyAccessible":{ "shape":"BooleanOptional", - "documentation":"

Specifies whether the DB instance is publicly accessible.

When the DB cluster is publicly accessible, its Domain Name System (DNS) endpoint resolves to the private IP address from within the DB cluster's virtual private cloud (VPC). It resolves to the public IP address from outside of the DB cluster's VPC. Access to the DB cluster is ultimately controlled by the security group it uses. That public access isn't permitted if the security group assigned to the DB cluster doesn't permit it.

When the DB instance isn't publicly accessible, it is an internal DB instance with a DNS name that resolves to a private IP address.

PubliclyAccessible only applies to DB instances in a VPC. The DB instance must be part of a public subnet and PubliclyAccessible must be enabled for it to be publicly accessible.

Changes to the PubliclyAccessible parameter are applied immediately regardless of the value of the ApplyImmediately parameter.

" + "documentation":"

Specifies whether the DB instance is publicly accessible.

When the DB instance is publicly accessible and you connect from outside of the DB instance's virtual private cloud (VPC), its Domain Name System (DNS) endpoint resolves to the public IP address. When you connect from within the same VPC as the DB instance, the endpoint resolves to the private IP address. Access to the DB instance is ultimately controlled by the security group it uses. That public access isn't permitted if the security group assigned to the DB instance doesn't permit it.

When the DB instance isn't publicly accessible, it is an internal DB instance with a DNS name that resolves to a private IP address.

PubliclyAccessible only applies to DB instances in a VPC. The DB instance must be part of a public subnet and PubliclyAccessible must be enabled for it to be publicly accessible.

Changes to the PubliclyAccessible parameter are applied immediately regardless of the value of the ApplyImmediately parameter.

" }, "MonitoringRoleArn":{ "shape":"String", diff --git a/botocore/data/sagemaker/2017-07-24/service-2.json b/botocore/data/sagemaker/2017-07-24/service-2.json index e56dc5afc2..87ea35704c 100644 --- a/botocore/data/sagemaker/2017-07-24/service-2.json +++ b/botocore/data/sagemaker/2017-07-24/service-2.json @@ -31172,7 +31172,23 @@ "ml.g4dn.4xlarge", "ml.g4dn.8xlarge", "ml.g4dn.12xlarge", - "ml.g4dn.16xlarge" + "ml.g4dn.16xlarge", + "ml.g5.xlarge", + "ml.g5.2xlarge", + "ml.g5.4xlarge", + "ml.g5.8xlarge", + "ml.g5.16xlarge", + "ml.g5.12xlarge", + "ml.g5.24xlarge", + "ml.g5.48xlarge", + "ml.r5d.large", + "ml.r5d.xlarge", + "ml.r5d.2xlarge", + "ml.r5d.4xlarge", + "ml.r5d.8xlarge", + "ml.r5d.12xlarge", + "ml.r5d.16xlarge", + "ml.r5d.24xlarge" ] }, "ProcessingJob":{ @@ -36145,7 +36161,27 @@ "ml.c6i.12xlarge", "ml.c6i.16xlarge", "ml.c6i.24xlarge", - "ml.c6i.32xlarge" + "ml.c6i.32xlarge", + "ml.r5d.large", + "ml.r5d.xlarge", + "ml.r5d.2xlarge", + "ml.r5d.4xlarge", + "ml.r5d.8xlarge", + "ml.r5d.12xlarge", + "ml.r5d.16xlarge", + "ml.r5d.24xlarge", + "ml.t3.medium", + "ml.t3.large", + "ml.t3.xlarge", + "ml.t3.2xlarge", + "ml.r5.large", + "ml.r5.xlarge", + "ml.r5.2xlarge", + "ml.r5.4xlarge", + "ml.r5.8xlarge", + "ml.r5.12xlarge", + "ml.r5.16xlarge", + "ml.r5.24xlarge" ] }, "TrainingInstanceTypes":{ diff --git a/botocore/data/secretsmanager/2017-10-17/service-2.json b/botocore/data/secretsmanager/2017-10-17/service-2.json index 1acf43a5f7..2e5e318248 100644 --- a/botocore/data/secretsmanager/2017-10-17/service-2.json +++ b/botocore/data/secretsmanager/2017-10-17/service-2.json @@ -69,7 +69,7 @@ {"shape":"PreconditionNotMetException"}, {"shape":"DecryptionFailure"} ], - "documentation":"

Creates a new secret. A secret can be a password, a set of credentials such as a user name and password, an OAuth token, or other secret information that you store in an encrypted form in Secrets Manager. The secret also includes the connection information to access a database or other service, which Secrets Manager doesn't encrypt. A secret in Secrets Manager consists of both the protected secret data and the important information needed to manage the secret.

For secrets that use managed rotation, you need to create the secret through the managing service. For more information, see Secrets Manager secrets managed by other Amazon Web Services services.

For information about creating a secret in the console, see Create a secret.

To create a secret, you can provide the secret value to be encrypted in either the SecretString parameter or the SecretBinary parameter, but not both. If you include SecretString or SecretBinary then Secrets Manager creates an initial secret version and automatically attaches the staging label AWSCURRENT to it.

For database credentials you want to rotate, for Secrets Manager to be able to rotate the secret, you must make sure the JSON you store in the SecretString matches the JSON structure of a database secret.

If you don't specify an KMS encryption key, Secrets Manager uses the Amazon Web Services managed key aws/secretsmanager. If this key doesn't already exist in your account, then Secrets Manager creates it for you automatically. All users and roles in the Amazon Web Services account automatically have access to use aws/secretsmanager. Creating aws/secretsmanager can result in a one-time significant delay in returning the result.

If the secret is in a different Amazon Web Services account from the credentials calling the API, then you can't use aws/secretsmanager to encrypt the secret, and you must create and use a customer managed KMS key.

Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters except SecretBinary or SecretString because it might be logged. For more information, see Logging Secrets Manager events with CloudTrail.

Required permissions: secretsmanager:CreateSecret. If you include tags in the secret, you also need secretsmanager:TagResource. To add replica Regions, you must also have secretsmanager:ReplicateSecretToRegions. For more information, see IAM policy actions for Secrets Manager and Authentication and access control in Secrets Manager.

To encrypt the secret with a KMS key other than aws/secretsmanager, you need kms:GenerateDataKey and kms:Decrypt permission to the key.

" + "documentation":"

Creates a new secret. A secret can be a password, a set of credentials such as a user name and password, an OAuth token, or other secret information that you store in an encrypted form in Secrets Manager. The secret also includes the connection information to access a database or other service, which Secrets Manager doesn't encrypt. A secret in Secrets Manager consists of both the protected secret data and the important information needed to manage the secret.

For secrets that use managed rotation, you need to create the secret through the managing service. For more information, see Secrets Manager secrets managed by other Amazon Web Services services.

For information about creating a secret in the console, see Create a secret.

To create a secret, you can provide the secret value to be encrypted in either the SecretString parameter or the SecretBinary parameter, but not both. If you include SecretString or SecretBinary then Secrets Manager creates an initial secret version and automatically attaches the staging label AWSCURRENT to it.

For database credentials you want to rotate, for Secrets Manager to be able to rotate the secret, you must make sure the JSON you store in the SecretString matches the JSON structure of a database secret.

If you don't specify an KMS encryption key, Secrets Manager uses the Amazon Web Services managed key aws/secretsmanager. If this key doesn't already exist in your account, then Secrets Manager creates it for you automatically. All users and roles in the Amazon Web Services account automatically have access to use aws/secretsmanager. Creating aws/secretsmanager can result in a one-time significant delay in returning the result.

If the secret is in a different Amazon Web Services account from the credentials calling the API, then you can't use aws/secretsmanager to encrypt the secret, and you must create and use a customer managed KMS key.

Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters except SecretBinary or SecretString because it might be logged. For more information, see Logging Secrets Manager events with CloudTrail.

Required permissions: secretsmanager:CreateSecret. If you include tags in the secret, you also need secretsmanager:TagResource. To add replica Regions, you must also have secretsmanager:ReplicateSecretToRegions. For more information, see IAM policy actions for Secrets Manager and Authentication and access control in Secrets Manager.

To encrypt the secret with a KMS key other than aws/secretsmanager, you need kms:GenerateDataKey and kms:Decrypt permission to the key.

When you enter commands in a command shell, there is a risk of the command history being accessed or utilities having access to your command parameters. This is a concern if the command includes the value of a secret. Learn how to Mitigate the risks of using command-line tools to store Secrets Manager secrets.

" }, "DeleteResourcePolicy":{ "name":"DeleteResourcePolicy", @@ -234,7 +234,7 @@ {"shape":"InternalServiceError"}, {"shape":"DecryptionFailure"} ], - "documentation":"

Creates a new version with a new encrypted secret value and attaches it to the secret. The version can contain a new SecretString value or a new SecretBinary value.

We recommend you avoid calling PutSecretValue at a sustained rate of more than once every 10 minutes. When you update the secret value, Secrets Manager creates a new version of the secret. Secrets Manager removes outdated versions when there are more than 100, but it does not remove versions created less than 24 hours ago. If you call PutSecretValue more than once every 10 minutes, you create more versions than Secrets Manager removes, and you will reach the quota for secret versions.

You can specify the staging labels to attach to the new version in VersionStages. If you don't include VersionStages, then Secrets Manager automatically moves the staging label AWSCURRENT to this version. If this operation creates the first version for the secret, then Secrets Manager automatically attaches the staging label AWSCURRENT to it. If this operation moves the staging label AWSCURRENT from another version to this version, then Secrets Manager also automatically moves the staging label AWSPREVIOUS to the version that AWSCURRENT was removed from.

This operation is idempotent. If you call this operation with a ClientRequestToken that matches an existing version's VersionId, and you specify the same secret data, the operation succeeds but does nothing. However, if the secret data is different, then the operation fails because you can't modify an existing version; you can only create new ones.

Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters except SecretBinary, SecretString, or RotationToken because it might be logged. For more information, see Logging Secrets Manager events with CloudTrail.

Required permissions: secretsmanager:PutSecretValue. For more information, see IAM policy actions for Secrets Manager and Authentication and access control in Secrets Manager.

" + "documentation":"

Creates a new version with a new encrypted secret value and attaches it to the secret. The version can contain a new SecretString value or a new SecretBinary value.

We recommend you avoid calling PutSecretValue at a sustained rate of more than once every 10 minutes. When you update the secret value, Secrets Manager creates a new version of the secret. Secrets Manager removes outdated versions when there are more than 100, but it does not remove versions created less than 24 hours ago. If you call PutSecretValue more than once every 10 minutes, you create more versions than Secrets Manager removes, and you will reach the quota for secret versions.

You can specify the staging labels to attach to the new version in VersionStages. If you don't include VersionStages, then Secrets Manager automatically moves the staging label AWSCURRENT to this version. If this operation creates the first version for the secret, then Secrets Manager automatically attaches the staging label AWSCURRENT to it. If this operation moves the staging label AWSCURRENT from another version to this version, then Secrets Manager also automatically moves the staging label AWSPREVIOUS to the version that AWSCURRENT was removed from.

This operation is idempotent. If you call this operation with a ClientRequestToken that matches an existing version's VersionId, and you specify the same secret data, the operation succeeds but does nothing. However, if the secret data is different, then the operation fails because you can't modify an existing version; you can only create new ones.

Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters except SecretBinary, SecretString, or RotationToken because it might be logged. For more information, see Logging Secrets Manager events with CloudTrail.

Required permissions: secretsmanager:PutSecretValue. For more information, see IAM policy actions for Secrets Manager and Authentication and access control in Secrets Manager.

When you enter commands in a command shell, there is a risk of the command history being accessed or utilities having access to your command parameters. This is a concern if the command includes the value of a secret. Learn how to Mitigate the risks of using command-line tools to store Secrets Manager secrets.

" }, "RemoveRegionsFromReplication":{ "name":"RemoveRegionsFromReplication", @@ -366,7 +366,7 @@ {"shape":"PreconditionNotMetException"}, {"shape":"DecryptionFailure"} ], - "documentation":"

Modifies the details of a secret, including metadata and the secret value. To change the secret value, you can also use PutSecretValue.

To change the rotation configuration of a secret, use RotateSecret instead.

To change a secret so that it is managed by another service, you need to recreate the secret in that service. See Secrets Manager secrets managed by other Amazon Web Services services.

We recommend you avoid calling UpdateSecret at a sustained rate of more than once every 10 minutes. When you call UpdateSecret to update the secret value, Secrets Manager creates a new version of the secret. Secrets Manager removes outdated versions when there are more than 100, but it does not remove versions created less than 24 hours ago. If you update the secret value more than once every 10 minutes, you create more versions than Secrets Manager removes, and you will reach the quota for secret versions.

If you include SecretString or SecretBinary to create a new secret version, Secrets Manager automatically moves the staging label AWSCURRENT to the new version. Then it attaches the label AWSPREVIOUS to the version that AWSCURRENT was removed from.

If you call this operation with a ClientRequestToken that matches an existing version's VersionId, the operation results in an error. You can't modify an existing version, you can only create a new version. To remove a version, remove all staging labels from it. See UpdateSecretVersionStage.

Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters except SecretBinary or SecretString because it might be logged. For more information, see Logging Secrets Manager events with CloudTrail.

Required permissions: secretsmanager:UpdateSecret. For more information, see IAM policy actions for Secrets Manager and Authentication and access control in Secrets Manager. If you use a customer managed key, you must also have kms:GenerateDataKey, kms:Encrypt, and kms:Decrypt permissions on the key. If you change the KMS key and you don't have kms:Encrypt permission to the new key, Secrets Manager does not re-ecrypt existing secret versions with the new key. For more information, see Secret encryption and decryption.

" + "documentation":"

Modifies the details of a secret, including metadata and the secret value. To change the secret value, you can also use PutSecretValue.

To change the rotation configuration of a secret, use RotateSecret instead.

To change a secret so that it is managed by another service, you need to recreate the secret in that service. See Secrets Manager secrets managed by other Amazon Web Services services.

We recommend you avoid calling UpdateSecret at a sustained rate of more than once every 10 minutes. When you call UpdateSecret to update the secret value, Secrets Manager creates a new version of the secret. Secrets Manager removes outdated versions when there are more than 100, but it does not remove versions created less than 24 hours ago. If you update the secret value more than once every 10 minutes, you create more versions than Secrets Manager removes, and you will reach the quota for secret versions.

If you include SecretString or SecretBinary to create a new secret version, Secrets Manager automatically moves the staging label AWSCURRENT to the new version. Then it attaches the label AWSPREVIOUS to the version that AWSCURRENT was removed from.

If you call this operation with a ClientRequestToken that matches an existing version's VersionId, the operation results in an error. You can't modify an existing version, you can only create a new version. To remove a version, remove all staging labels from it. See UpdateSecretVersionStage.

Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters except SecretBinary or SecretString because it might be logged. For more information, see Logging Secrets Manager events with CloudTrail.

Required permissions: secretsmanager:UpdateSecret. For more information, see IAM policy actions for Secrets Manager and Authentication and access control in Secrets Manager. If you use a customer managed key, you must also have kms:GenerateDataKey, kms:Encrypt, and kms:Decrypt permissions on the key. If you change the KMS key and you don't have kms:Encrypt permission to the new key, Secrets Manager does not re-encrypt existing secret versions with the new key. For more information, see Secret encryption and decryption.

When you enter commands in a command shell, there is a risk of the command history being accessed or utilities having access to your command parameters. This is a concern if the command includes the value of a secret. Learn how to Mitigate the risks of using command-line tools to store Secrets Manager secrets.

" }, "UpdateSecretVersionStage":{ "name":"UpdateSecretVersionStage", @@ -1810,7 +1810,7 @@ }, "KmsKeyId":{ "shape":"KmsKeyIdType", - "documentation":"

The ARN, key ID, or alias of the KMS key that Secrets Manager uses to encrypt new secret versions as well as any existing versions with the staging labels AWSCURRENT, AWSPENDING, or AWSPREVIOUS. If you don't have kms:Encrypt permission to the new key, Secrets Manager does not re-ecrypt existing secret versions with the new key. For more information about versions and staging labels, see Concepts: Version.

A key alias is always prefixed by alias/, for example alias/aws/secretsmanager. For more information, see About aliases.

If you set this to an empty string, Secrets Manager uses the Amazon Web Services managed key aws/secretsmanager. If this key doesn't already exist in your account, then Secrets Manager creates it for you automatically. All users and roles in the Amazon Web Services account automatically have access to use aws/secretsmanager. Creating aws/secretsmanager can result in a one-time significant delay in returning the result.

You can only use the Amazon Web Services managed key aws/secretsmanager if you call this operation using credentials from the same Amazon Web Services account that owns the secret. If the secret is in a different account, then you must use a customer managed key and provide the ARN of that KMS key in this field. The user making the call must have permissions to both the secret and the KMS key in their respective accounts.

" + "documentation":"

The ARN, key ID, or alias of the KMS key that Secrets Manager uses to encrypt new secret versions as well as any existing versions with the staging labels AWSCURRENT, AWSPENDING, or AWSPREVIOUS. If you don't have kms:Encrypt permission to the new key, Secrets Manager does not re-encrypt existing secret versions with the new key. For more information about versions and staging labels, see Concepts: Version.

A key alias is always prefixed by alias/, for example alias/aws/secretsmanager. For more information, see About aliases.

If you set this to an empty string, Secrets Manager uses the Amazon Web Services managed key aws/secretsmanager. If this key doesn't already exist in your account, then Secrets Manager creates it for you automatically. All users and roles in the Amazon Web Services account automatically have access to use aws/secretsmanager. Creating aws/secretsmanager can result in a one-time significant delay in returning the result.

You can only use the Amazon Web Services managed key aws/secretsmanager if you call this operation using credentials from the same Amazon Web Services account that owns the secret. If the secret is in a different account, then you must use a customer managed key and provide the ARN of that KMS key in this field. The user making the call must have permissions to both the secret and the KMS key in their respective accounts.

" }, "SecretBinary":{ "shape":"SecretBinaryType", diff --git a/botocore/data/taxsettings/2018-05-10/endpoint-rule-set-1.json b/botocore/data/taxsettings/2018-05-10/endpoint-rule-set-1.json index 177f908c8b..dbd7cc6df0 100644 --- a/botocore/data/taxsettings/2018-05-10/endpoint-rule-set-1.json +++ b/botocore/data/taxsettings/2018-05-10/endpoint-rule-set-1.json @@ -1,12 +1,6 @@ { "version": "1.0", "parameters": { - "Region": { - "builtIn": "AWS::Region", - "required": false, - "documentation": "The AWS region used to dispatch the request.", - "type": "String" - }, "UseDualStack": { "builtIn": "AWS::UseDualStack", "required": true, @@ -26,6 +20,12 @@ "required": false, "documentation": "Override the endpoint used to send this request", "type": "String" + }, + "Region": { + "builtIn": "AWS::Region", + "required": false, + "documentation": "The AWS region used to dispatch the request.", + "type": "String" } }, "rules": [ @@ -177,18 +177,19 @@ "rules": [ { "conditions": [], - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://tax-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ], - "type": "tree" + "endpoint": { + "url": "https://tax-fips.{PartitionResult#implicitGlobalRegion}.{PartitionResult#dualStackDnsSuffix}", + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "{PartitionResult#implicitGlobalRegion}" + } + ] + }, + "headers": {} + }, + "type": "endpoint" } ], "type": "tree" @@ -211,6 +212,15 @@ }, true ] + }, + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + false + ] } ], "rules": [ @@ -235,18 +245,19 @@ "rules": [ { "conditions": [], - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://tax-fips.{Region}.{PartitionResult#dnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ], - "type": "tree" + "endpoint": { + "url": "https://tax-fips.{PartitionResult#implicitGlobalRegion}.{PartitionResult#dnsSuffix}", + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "{PartitionResult#implicitGlobalRegion}" + } + ] + }, + "headers": {} + }, + "type": "endpoint" } ], "type": "tree" @@ -261,6 +272,15 @@ }, { "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseFIPS" + }, + false + ] + }, { "fn": "booleanEquals", "argv": [ @@ -293,18 +313,19 @@ "rules": [ { "conditions": [], - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://tax.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ], - "type": "tree" + "endpoint": { + "url": "https://tax.{PartitionResult#implicitGlobalRegion}.{PartitionResult#dualStackDnsSuffix}", + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "{PartitionResult#implicitGlobalRegion}" + } + ] + }, + "headers": {} + }, + "type": "endpoint" } ], "type": "tree" @@ -319,18 +340,19 @@ }, { "conditions": [], - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://tax.{Region}.{PartitionResult#dnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ], - "type": "tree" + "endpoint": { + "url": "https://tax.{PartitionResult#implicitGlobalRegion}.{PartitionResult#dnsSuffix}", + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "{PartitionResult#implicitGlobalRegion}" + } + ] + }, + "headers": {} + }, + "type": "endpoint" } ], "type": "tree" diff --git a/botocore/data/taxsettings/2018-05-10/service-2.json b/botocore/data/taxsettings/2018-05-10/service-2.json index 8596a4869e..31e0ca5a69 100644 --- a/botocore/data/taxsettings/2018-05-10/service-2.json +++ b/botocore/data/taxsettings/2018-05-10/service-2.json @@ -10,7 +10,8 @@ "serviceId":"TaxSettings", "signatureVersion":"v4", "signingName":"tax", - "uid":"taxsettings-2018-05-10" + "uid":"taxsettings-2018-05-10", + "auth":["aws.auth#sigv4"] }, "operations":{ "BatchDeleteTaxRegistration":{ diff --git a/botocore/data/timestream-query/2018-11-01/service-2.json b/botocore/data/timestream-query/2018-11-01/service-2.json index 51a7a97cdf..2d8acf6c5c 100644 --- a/botocore/data/timestream-query/2018-11-01/service-2.json +++ b/botocore/data/timestream-query/2018-11-01/service-2.json @@ -12,7 +12,8 @@ "signatureVersion":"v4", "signingName":"timestream", "targetPrefix":"Timestream_20181101", - "uid":"timestream-query-2018-11-01" + "uid":"timestream-query-2018-11-01", + "auth":["aws.auth#sigv4"] }, "operations":{ "CancelQuery":{ @@ -1581,7 +1582,7 @@ }, "QueryPricingModel":{ "shape":"QueryPricingModel", - "documentation":"

The pricing model for queries in an account.

" + "documentation":"

The pricing model for queries in an account.

The QueryPricingModel parameter is used by several Timestream operations; however, the UpdateAccountSettings API operation doesn't recognize any values other than COMPUTE_UNITS.

" } } }, diff --git a/botocore/data/workspaces-thin-client/2023-08-22/service-2.json b/botocore/data/workspaces-thin-client/2023-08-22/service-2.json index 41171b3dec..0442a76e60 100644 --- a/botocore/data/workspaces-thin-client/2023-08-22/service-2.json +++ b/botocore/data/workspaces-thin-client/2023-08-22/service-2.json @@ -2,6 +2,7 @@ "version":"2.0", "metadata":{ "apiVersion":"2023-08-22", + "auth":["aws.auth#sigv4"], "endpointPrefix":"thinclient", "protocol":"rest-json", "protocols":["rest-json"], @@ -837,7 +838,7 @@ }, "deviceCreationTags":{ "shape":"DeviceCreationTagsMap", - "documentation":"

\"The tag keys and optional values for the newly created devices for this environment.\"

" + "documentation":"

The tag keys and optional values for the newly created devices for this environment.

" } }, "documentation":"

Describes an environment.

" diff --git a/tests/functional/endpoint-rules/taxsettings/endpoint-tests-1.json b/tests/functional/endpoint-rules/taxsettings/endpoint-tests-1.json index 9ea2f41d52..f3593c11da 100644 --- a/tests/functional/endpoint-rules/taxsettings/endpoint-tests-1.json +++ b/tests/functional/endpoint-rules/taxsettings/endpoint-tests-1.json @@ -1,9 +1,50 @@ { "testCases": [ + { + "documentation": "For custom endpoint with region not set and fips disabled", + "expect": { + "endpoint": { + "url": "https://example.com" + } + }, + "params": { + "Endpoint": "https://example.com", + "UseFIPS": false + } + }, + { + "documentation": "For custom endpoint with fips enabled", + "expect": { + "error": "Invalid Configuration: FIPS and custom endpoint are not supported" + }, + "params": { + "Endpoint": "https://example.com", + "UseFIPS": true + } + }, + { + "documentation": "For custom endpoint with fips disabled and dualstack enabled", + "expect": { + "error": "Invalid Configuration: Dualstack and custom endpoint are not supported" + }, + "params": { + "Endpoint": "https://example.com", + "UseFIPS": false, + "UseDualStack": true + } + }, { "documentation": "For region us-east-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-east-1" + } + ] + }, "url": "https://tax-fips.us-east-1.api.aws" } }, @@ -17,6 +58,14 @@ "documentation": "For region us-east-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-east-1" + } + ] + }, "url": "https://tax-fips.us-east-1.amazonaws.com" } }, @@ -30,6 +79,14 @@ "documentation": "For region us-east-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-east-1" + } + ] + }, "url": "https://tax.us-east-1.api.aws" } }, @@ -43,6 +100,14 @@ "documentation": "For region us-east-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-east-1" + } + ] + }, "url": "https://tax.us-east-1.amazonaws.com" } }, @@ -53,105 +118,169 @@ } }, { - "documentation": "For region cn-north-1 with FIPS enabled and DualStack enabled", + "documentation": "For region cn-northwest-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { - "url": "https://tax-fips.cn-north-1.api.amazonwebservices.com.cn" + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "cn-northwest-1" + } + ] + }, + "url": "https://tax-fips.cn-northwest-1.api.amazonwebservices.com.cn" } }, "params": { - "Region": "cn-north-1", + "Region": "cn-northwest-1", "UseFIPS": true, "UseDualStack": true } }, { - "documentation": "For region cn-north-1 with FIPS enabled and DualStack disabled", + "documentation": "For region cn-northwest-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { - "url": "https://tax-fips.cn-north-1.amazonaws.com.cn" + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "cn-northwest-1" + } + ] + }, + "url": "https://tax-fips.cn-northwest-1.amazonaws.com.cn" } }, "params": { - "Region": "cn-north-1", + "Region": "cn-northwest-1", "UseFIPS": true, "UseDualStack": false } }, { - "documentation": "For region cn-north-1 with FIPS disabled and DualStack enabled", + "documentation": "For region cn-northwest-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { - "url": "https://tax.cn-north-1.api.amazonwebservices.com.cn" + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "cn-northwest-1" + } + ] + }, + "url": "https://tax.cn-northwest-1.api.amazonwebservices.com.cn" } }, "params": { - "Region": "cn-north-1", + "Region": "cn-northwest-1", "UseFIPS": false, "UseDualStack": true } }, { - "documentation": "For region cn-north-1 with FIPS disabled and DualStack disabled", + "documentation": "For region cn-northwest-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { - "url": "https://tax.cn-north-1.amazonaws.com.cn" + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "cn-northwest-1" + } + ] + }, + "url": "https://tax.cn-northwest-1.amazonaws.com.cn" } }, "params": { - "Region": "cn-north-1", + "Region": "cn-northwest-1", "UseFIPS": false, "UseDualStack": false } }, { - "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack enabled", + "documentation": "For region us-gov-west-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { - "url": "https://tax-fips.us-gov-east-1.api.aws" + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-gov-west-1" + } + ] + }, + "url": "https://tax-fips.us-gov-west-1.api.aws" } }, "params": { - "Region": "us-gov-east-1", + "Region": "us-gov-west-1", "UseFIPS": true, "UseDualStack": true } }, { - "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack disabled", + "documentation": "For region us-gov-west-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { - "url": "https://tax-fips.us-gov-east-1.amazonaws.com" + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-gov-west-1" + } + ] + }, + "url": "https://tax-fips.us-gov-west-1.amazonaws.com" } }, "params": { - "Region": "us-gov-east-1", + "Region": "us-gov-west-1", "UseFIPS": true, "UseDualStack": false } }, { - "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack enabled", + "documentation": "For region us-gov-west-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { - "url": "https://tax.us-gov-east-1.api.aws" + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-gov-west-1" + } + ] + }, + "url": "https://tax.us-gov-west-1.api.aws" } }, "params": { - "Region": "us-gov-east-1", + "Region": "us-gov-west-1", "UseFIPS": false, "UseDualStack": true } }, { - "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack disabled", + "documentation": "For region us-gov-west-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { - "url": "https://tax.us-gov-east-1.amazonaws.com" + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-gov-west-1" + } + ] + }, + "url": "https://tax.us-gov-west-1.amazonaws.com" } }, "params": { - "Region": "us-gov-east-1", + "Region": "us-gov-west-1", "UseFIPS": false, "UseDualStack": false } @@ -171,6 +300,14 @@ "documentation": "For region us-iso-east-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-iso-east-1" + } + ] + }, "url": "https://tax-fips.us-iso-east-1.c2s.ic.gov" } }, @@ -195,6 +332,14 @@ "documentation": "For region us-iso-east-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-iso-east-1" + } + ] + }, "url": "https://tax.us-iso-east-1.c2s.ic.gov" } }, @@ -219,6 +364,14 @@ "documentation": "For region us-isob-east-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-isob-east-1" + } + ] + }, "url": "https://tax-fips.us-isob-east-1.sc2s.sgov.gov" } }, @@ -243,6 +396,14 @@ "documentation": "For region us-isob-east-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-isob-east-1" + } + ] + }, "url": "https://tax.us-isob-east-1.sc2s.sgov.gov" } }, @@ -253,54 +414,131 @@ } }, { - "documentation": "For custom endpoint with region set and fips disabled and dualstack disabled", + "documentation": "For region eu-isoe-west-1 with FIPS enabled and DualStack enabled", + "expect": { + "error": "FIPS and DualStack are enabled, but this partition does not support one or both" + }, + "params": { + "Region": "eu-isoe-west-1", + "UseFIPS": true, + "UseDualStack": true + } + }, + { + "documentation": "For region eu-isoe-west-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { - "url": "https://example.com" + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "eu-isoe-west-1" + } + ] + }, + "url": "https://tax-fips.eu-isoe-west-1.cloud.adc-e.uk" } }, "params": { - "Region": "us-east-1", + "Region": "eu-isoe-west-1", + "UseFIPS": true, + "UseDualStack": false + } + }, + { + "documentation": "For region eu-isoe-west-1 with FIPS disabled and DualStack enabled", + "expect": { + "error": "DualStack is enabled but this partition does not support DualStack" + }, + "params": { + "Region": "eu-isoe-west-1", "UseFIPS": false, - "UseDualStack": false, - "Endpoint": "https://example.com" + "UseDualStack": true } }, { - "documentation": "For custom endpoint with region not set and fips disabled and dualstack disabled", + "documentation": "For region eu-isoe-west-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { - "url": "https://example.com" + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "eu-isoe-west-1" + } + ] + }, + "url": "https://tax.eu-isoe-west-1.cloud.adc-e.uk" } }, "params": { + "Region": "eu-isoe-west-1", "UseFIPS": false, - "UseDualStack": false, - "Endpoint": "https://example.com" + "UseDualStack": false } }, { - "documentation": "For custom endpoint with fips enabled and dualstack disabled", + "documentation": "For region us-isof-south-1 with FIPS enabled and DualStack enabled", "expect": { - "error": "Invalid Configuration: FIPS and custom endpoint are not supported" + "error": "FIPS and DualStack are enabled, but this partition does not support one or both" }, "params": { - "Region": "us-east-1", + "Region": "us-isof-south-1", "UseFIPS": true, - "UseDualStack": false, - "Endpoint": "https://example.com" + "UseDualStack": true } }, { - "documentation": "For custom endpoint with fips disabled and dualstack enabled", + "documentation": "For region us-isof-south-1 with FIPS enabled and DualStack disabled", "expect": { - "error": "Invalid Configuration: Dualstack and custom endpoint are not supported" + "endpoint": { + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-isof-south-1" + } + ] + }, + "url": "https://tax-fips.us-isof-south-1.csp.hci.ic.gov" + } }, "params": { - "Region": "us-east-1", + "Region": "us-isof-south-1", + "UseFIPS": true, + "UseDualStack": false + } + }, + { + "documentation": "For region us-isof-south-1 with FIPS disabled and DualStack enabled", + "expect": { + "error": "DualStack is enabled but this partition does not support DualStack" + }, + "params": { + "Region": "us-isof-south-1", "UseFIPS": false, - "UseDualStack": true, - "Endpoint": "https://example.com" + "UseDualStack": true + } + }, + { + "documentation": "For region us-isof-south-1 with FIPS disabled and DualStack disabled", + "expect": { + "endpoint": { + "properties": { + "authSchemes": [ + { + "name": "sigv4", + "signingRegion": "us-isof-south-1" + } + ] + }, + "url": "https://tax.us-isof-south-1.csp.hci.ic.gov" + } + }, + "params": { + "Region": "us-isof-south-1", + "UseFIPS": false, + "UseDualStack": false } }, { From 1e7cb30ffd84bc5a6c17a3e64c626b09038816bb Mon Sep 17 00:00:00 2001 From: aws-sdk-python-automation Date: Thu, 18 Jul 2024 19:21:39 +0000 Subject: [PATCH 3/4] Update endpoints model --- botocore/data/endpoints.json | 42 ++++++++++++++++++++++++++++++++---- 1 file changed, 38 insertions(+), 4 deletions(-) diff --git a/botocore/data/endpoints.json b/botocore/data/endpoints.json index 1c2a7de7ae..de4927d664 100644 --- a/botocore/data/endpoints.json +++ b/botocore/data/endpoints.json @@ -7586,6 +7586,7 @@ } ] }, "eu-central-1" : { }, + "eu-central-2" : { }, "eu-north-1" : { }, "eu-south-1" : { }, "eu-south-2" : { }, @@ -13164,6 +13165,7 @@ "tags" : [ "fips" ] } ] }, + "ca-west-1" : { }, "eu-central-1" : { }, "eu-central-2" : { }, "eu-north-1" : { }, @@ -14315,6 +14317,12 @@ }, "hostname" : "portal.sso.ca-central-1.amazonaws.com" }, + "ca-west-1" : { + "credentialScope" : { + "region" : "ca-west-1" + }, + "hostname" : "portal.sso.ca-west-1.amazonaws.com" + }, "eu-central-1" : { "credentialScope" : { "region" : "eu-central-1" @@ -19599,6 +19607,18 @@ "us-west-2" : { } } }, + "tax" : { + "endpoints" : { + "aws-global" : { + "credentialScope" : { + "region" : "us-east-1" + }, + "hostname" : "tax.us-east-1.amazonaws.com" + } + }, + "isRegionalized" : false, + "partitionEndpoint" : "aws-global" + }, "textract" : { "endpoints" : { "ap-northeast-2" : { @@ -24452,17 +24472,31 @@ }, "directconnect" : { "endpoints" : { - "us-gov-east-1" : { + "fips-us-gov-east-1" : { "credentialScope" : { "region" : "us-gov-east-1" }, - "hostname" : "directconnect.us-gov-east-1.amazonaws.com" + "deprecated" : true, + "hostname" : "directconnect-fips.us-gov-east-1.amazonaws.com" }, - "us-gov-west-1" : { + "fips-us-gov-west-1" : { "credentialScope" : { "region" : "us-gov-west-1" }, - "hostname" : "directconnect.us-gov-west-1.amazonaws.com" + "deprecated" : true, + "hostname" : "directconnect-fips.us-gov-west-1.amazonaws.com" + }, + "us-gov-east-1" : { + "variants" : [ { + "hostname" : "directconnect-fips.us-gov-east-1.amazonaws.com", + "tags" : [ "fips" ] + } ] + }, + "us-gov-west-1" : { + "variants" : [ { + "hostname" : "directconnect-fips.us-gov-west-1.amazonaws.com", + "tags" : [ "fips" ] + } ] } } }, From c1f635d1b348a6a41339f6db1af3c8e7c67296a2 Mon Sep 17 00:00:00 2001 From: aws-sdk-python-automation Date: Thu, 18 Jul 2024 19:22:30 +0000 Subject: [PATCH 4/4] Bumping version to 1.34.145 --- .changes/1.34.145.json | 67 +++++++++++++++++++ .../next-release/api-change-acmpca-8983.json | 5 -- .../api-change-connect-24816.json | 5 -- .../next-release/api-change-ec2-38874.json | 5 -- .../api-change-firehose-44210.json | 5 -- .../api-change-ivschat-68235.json | 5 -- .../api-change-medialive-2443.json | 5 -- .../next-release/api-change-rds-60841.json | 5 -- .../api-change-sagemaker-39890.json | 5 -- .../api-change-secretsmanager-33190.json | 5 -- .../api-change-taxsettings-33097.json | 5 -- .../api-change-timestreamquery-6736.json | 5 -- ...api-change-workspacesthinclient-53210.json | 5 -- .../next-release/bugfix-Waiter-88466.json | 5 -- CHANGELOG.rst | 18 +++++ botocore/__init__.py | 2 +- docs/source/conf.py | 2 +- 17 files changed, 87 insertions(+), 67 deletions(-) create mode 100644 .changes/1.34.145.json delete mode 100644 .changes/next-release/api-change-acmpca-8983.json delete mode 100644 .changes/next-release/api-change-connect-24816.json delete mode 100644 .changes/next-release/api-change-ec2-38874.json delete mode 100644 .changes/next-release/api-change-firehose-44210.json delete mode 100644 .changes/next-release/api-change-ivschat-68235.json delete mode 100644 .changes/next-release/api-change-medialive-2443.json delete mode 100644 .changes/next-release/api-change-rds-60841.json delete mode 100644 .changes/next-release/api-change-sagemaker-39890.json delete mode 100644 .changes/next-release/api-change-secretsmanager-33190.json delete mode 100644 .changes/next-release/api-change-taxsettings-33097.json delete mode 100644 .changes/next-release/api-change-timestreamquery-6736.json delete mode 100644 .changes/next-release/api-change-workspacesthinclient-53210.json delete mode 100644 .changes/next-release/bugfix-Waiter-88466.json diff --git a/.changes/1.34.145.json b/.changes/1.34.145.json new file mode 100644 index 0000000000..5b8643f0e1 --- /dev/null +++ b/.changes/1.34.145.json @@ -0,0 +1,67 @@ +[ + { + "category": "``acm-pca``", + "description": "Fix broken waiters for the acm-pca client. Waiters broke in version 1.13.144 of the Boto3 SDK.", + "type": "api-change" + }, + { + "category": "``connect``", + "description": "Amazon Connect expands search API coverage for additional resources. Search for hierarchy groups by name, ID, tag, or other criteria (new endpoint). Search for agent statuses by name, ID, tag, or other criteria (new endpoint). Search for users by their assigned proficiencies (enhanced endpoint)", + "type": "api-change" + }, + { + "category": "``ec2``", + "description": "Amazon VPC IP Address Manager (IPAM) now supports Bring-Your-Own-IP (BYOIP) for IP addresses registered with any Internet Registry. This feature uses DNS TXT records to validate ownership of a public IP address range.", + "type": "api-change" + }, + { + "category": "``firehose``", + "description": "This release 1) Add configurable buffering hints for Snowflake as destination. 2) Add ReadFromTimestamp for MSK As Source. Firehose will start reading data from MSK Cluster using offset associated with this timestamp. 3) Gated public beta release to add Apache Iceberg tables as destination.", + "type": "api-change" + }, + { + "category": "``ivschat``", + "description": "Documentation update for IVS Chat API Reference.", + "type": "api-change" + }, + { + "category": "``medialive``", + "description": "AWS Elemental MediaLive now supports the SRT protocol via the new SRT Caller input type.", + "type": "api-change" + }, + { + "category": "``rds``", + "description": "Updates Amazon RDS documentation to specify an eventual consistency model for DescribePendingMaintenanceActions.", + "type": "api-change" + }, + { + "category": "``sagemaker``", + "description": "SageMaker Training supports R5, T3 and R5D instances family. And SageMaker Processing supports G5 and R5D instances family.", + "type": "api-change" + }, + { + "category": "``secretsmanager``", + "description": "Doc only update for Secrets Manager", + "type": "api-change" + }, + { + "category": "``taxsettings``", + "description": "Set default endpoint for aws partition. Requests from all regions in aws partition will be forward to us-east-1 endpoint.", + "type": "api-change" + }, + { + "category": "``timestream-query``", + "description": "Doc-only update for TimestreamQuery. Added guidance about the accepted valid value for the QueryPricingModel parameter.", + "type": "api-change" + }, + { + "category": "``workspaces-thin-client``", + "description": "Documentation update for WorkSpaces Thin Client.", + "type": "api-change" + }, + { + "category": "Waiter", + "description": "Update waiters to handle expected boolean values when matching errors (`boto/botocore#3220 `__)", + "type": "bugfix" + } +] \ No newline at end of file diff --git a/.changes/next-release/api-change-acmpca-8983.json b/.changes/next-release/api-change-acmpca-8983.json deleted file mode 100644 index 8f3e29022c..0000000000 --- a/.changes/next-release/api-change-acmpca-8983.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``acm-pca``", - "description": "Fix broken waiters for the acm-pca client. Waiters broke in version 1.13.144 of the Boto3 SDK." -} diff --git a/.changes/next-release/api-change-connect-24816.json b/.changes/next-release/api-change-connect-24816.json deleted file mode 100644 index 75dc961761..0000000000 --- a/.changes/next-release/api-change-connect-24816.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``connect``", - "description": "Amazon Connect expands search API coverage for additional resources. Search for hierarchy groups by name, ID, tag, or other criteria (new endpoint). Search for agent statuses by name, ID, tag, or other criteria (new endpoint). Search for users by their assigned proficiencies (enhanced endpoint)" -} diff --git a/.changes/next-release/api-change-ec2-38874.json b/.changes/next-release/api-change-ec2-38874.json deleted file mode 100644 index 0985d3a431..0000000000 --- a/.changes/next-release/api-change-ec2-38874.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``ec2``", - "description": "Amazon VPC IP Address Manager (IPAM) now supports Bring-Your-Own-IP (BYOIP) for IP addresses registered with any Internet Registry. This feature uses DNS TXT records to validate ownership of a public IP address range." -} diff --git a/.changes/next-release/api-change-firehose-44210.json b/.changes/next-release/api-change-firehose-44210.json deleted file mode 100644 index 9f594be5ff..0000000000 --- a/.changes/next-release/api-change-firehose-44210.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``firehose``", - "description": "This release 1) Add configurable buffering hints for Snowflake as destination. 2) Add ReadFromTimestamp for MSK As Source. Firehose will start reading data from MSK Cluster using offset associated with this timestamp. 3) Gated public beta release to add Apache Iceberg tables as destination." -} diff --git a/.changes/next-release/api-change-ivschat-68235.json b/.changes/next-release/api-change-ivschat-68235.json deleted file mode 100644 index ec1afdcfa3..0000000000 --- a/.changes/next-release/api-change-ivschat-68235.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``ivschat``", - "description": "Documentation update for IVS Chat API Reference." -} diff --git a/.changes/next-release/api-change-medialive-2443.json b/.changes/next-release/api-change-medialive-2443.json deleted file mode 100644 index c10f3a88b2..0000000000 --- a/.changes/next-release/api-change-medialive-2443.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``medialive``", - "description": "AWS Elemental MediaLive now supports the SRT protocol via the new SRT Caller input type." -} diff --git a/.changes/next-release/api-change-rds-60841.json b/.changes/next-release/api-change-rds-60841.json deleted file mode 100644 index e8522a49b2..0000000000 --- a/.changes/next-release/api-change-rds-60841.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``rds``", - "description": "Updates Amazon RDS documentation to specify an eventual consistency model for DescribePendingMaintenanceActions." -} diff --git a/.changes/next-release/api-change-sagemaker-39890.json b/.changes/next-release/api-change-sagemaker-39890.json deleted file mode 100644 index 43a7aacf4b..0000000000 --- a/.changes/next-release/api-change-sagemaker-39890.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``sagemaker``", - "description": "SageMaker Training supports R5, T3 and R5D instances family. And SageMaker Processing supports G5 and R5D instances family." -} diff --git a/.changes/next-release/api-change-secretsmanager-33190.json b/.changes/next-release/api-change-secretsmanager-33190.json deleted file mode 100644 index 32e0eb5f7c..0000000000 --- a/.changes/next-release/api-change-secretsmanager-33190.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``secretsmanager``", - "description": "Doc only update for Secrets Manager" -} diff --git a/.changes/next-release/api-change-taxsettings-33097.json b/.changes/next-release/api-change-taxsettings-33097.json deleted file mode 100644 index bb31ac0e21..0000000000 --- a/.changes/next-release/api-change-taxsettings-33097.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``taxsettings``", - "description": "Set default endpoint for aws partition. Requests from all regions in aws partition will be forward to us-east-1 endpoint." -} diff --git a/.changes/next-release/api-change-timestreamquery-6736.json b/.changes/next-release/api-change-timestreamquery-6736.json deleted file mode 100644 index 35c8830020..0000000000 --- a/.changes/next-release/api-change-timestreamquery-6736.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``timestream-query``", - "description": "Doc-only update for TimestreamQuery. Added guidance about the accepted valid value for the QueryPricingModel parameter." -} diff --git a/.changes/next-release/api-change-workspacesthinclient-53210.json b/.changes/next-release/api-change-workspacesthinclient-53210.json deleted file mode 100644 index e1e662a357..0000000000 --- a/.changes/next-release/api-change-workspacesthinclient-53210.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``workspaces-thin-client``", - "description": "Documentation update for WorkSpaces Thin Client." -} diff --git a/.changes/next-release/bugfix-Waiter-88466.json b/.changes/next-release/bugfix-Waiter-88466.json deleted file mode 100644 index 35e969b4cb..0000000000 --- a/.changes/next-release/bugfix-Waiter-88466.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "bugfix", - "category": "Waiter", - "description": "Update waiters to handle expected boolean values when matching errors (`boto/botocore#3220 `__)" -} diff --git a/CHANGELOG.rst b/CHANGELOG.rst index a790598543..56802fba3f 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -2,6 +2,24 @@ CHANGELOG ========= +1.34.145 +======== + +* api-change:``acm-pca``: Fix broken waiters for the acm-pca client. Waiters broke in version 1.13.144 of the Boto3 SDK. +* api-change:``connect``: Amazon Connect expands search API coverage for additional resources. Search for hierarchy groups by name, ID, tag, or other criteria (new endpoint). Search for agent statuses by name, ID, tag, or other criteria (new endpoint). Search for users by their assigned proficiencies (enhanced endpoint) +* api-change:``ec2``: Amazon VPC IP Address Manager (IPAM) now supports Bring-Your-Own-IP (BYOIP) for IP addresses registered with any Internet Registry. This feature uses DNS TXT records to validate ownership of a public IP address range. +* api-change:``firehose``: This release 1) Add configurable buffering hints for Snowflake as destination. 2) Add ReadFromTimestamp for MSK As Source. Firehose will start reading data from MSK Cluster using offset associated with this timestamp. 3) Gated public beta release to add Apache Iceberg tables as destination. +* api-change:``ivschat``: Documentation update for IVS Chat API Reference. +* api-change:``medialive``: AWS Elemental MediaLive now supports the SRT protocol via the new SRT Caller input type. +* api-change:``rds``: Updates Amazon RDS documentation to specify an eventual consistency model for DescribePendingMaintenanceActions. +* api-change:``sagemaker``: SageMaker Training supports R5, T3 and R5D instances family. And SageMaker Processing supports G5 and R5D instances family. +* api-change:``secretsmanager``: Doc only update for Secrets Manager +* api-change:``taxsettings``: Set default endpoint for aws partition. Requests from all regions in aws partition will be forward to us-east-1 endpoint. +* api-change:``timestream-query``: Doc-only update for TimestreamQuery. Added guidance about the accepted valid value for the QueryPricingModel parameter. +* api-change:``workspaces-thin-client``: Documentation update for WorkSpaces Thin Client. +* bugfix:Waiter: Update waiters to handle expected boolean values when matching errors (`boto/botocore#3220 `__) + + 1.34.144 ======== diff --git a/botocore/__init__.py b/botocore/__init__.py index a62d5fa992..76e16ce436 100644 --- a/botocore/__init__.py +++ b/botocore/__init__.py @@ -16,7 +16,7 @@ import os import re -__version__ = '1.34.144' +__version__ = '1.34.145' class NullHandler(logging.Handler): diff --git a/docs/source/conf.py b/docs/source/conf.py index afe2192913..73c138269b 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -59,7 +59,7 @@ # The short X.Y version. version = '1.34.1' # The full version, including alpha/beta/rc tags. -release = '1.34.144' +release = '1.34.145' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages.