From 13253d0ec774d160ece99fe9527b412028e8491e Mon Sep 17 00:00:00 2001 From: awssdkgo Date: Wed, 18 Oct 2023 18:34:30 +0000 Subject: [PATCH] Release v1.45.28 (2023-10-18) === ### Service Client Updates * `service/cloud9`: Updates service documentation * Update to imageId parameter behavior and dates updated. * `service/dynamodb`: Updates service API, documentation, waiters, paginators, and examples * Updating descriptions for several APIs. * `service/kendra`: Updates service API and documentation * Changes for a new feature in Amazon Kendra's Query API to Collapse/Expand query results * `service/rds`: Updates service API, documentation, waiters, paginators, and examples * This release adds support for upgrading the storage file system configuration on the DB instance using a blue/green deployment or a read replica. * `service/wisdom`: Updates service API --- CHANGELOG.md | 14 + aws/endpoints/defaults.go | 3 + aws/version.go | 2 +- models/apis/cloud9/2017-09-23/docs-2.json | 2 +- .../2017-09-23/endpoint-rule-set-1.json | 40 +- models/apis/dynamodb/2012-08-10/docs-2.json | 12 +- .../2012-08-10/endpoint-rule-set-1.json | 44 +- models/apis/kendra/2019-02-03/api-2.json | 101 +++++ models/apis/kendra/2019-02-03/docs-2.json | 73 +++- .../2019-02-03/endpoint-rule-set-1.json | 40 +- models/apis/rds/2014-10-31/api-2.json | 16 +- models/apis/rds/2014-10-31/docs-2.json | 9 + .../rds/2014-10-31/endpoint-rule-set-1.json | 44 +- models/apis/wisdom/2020-10-19/api-2.json | 4 +- .../2020-10-19/endpoint-rule-set-1.json | 366 +++++++--------- models/endpoints/endpoints.json | 1 + service/cloud9/api.go | 21 +- service/dynamodb/api.go | 35 +- service/dynamodb/errors.go | 4 + service/kendra/api.go | 406 +++++++++++++++++- service/rds/api.go | 48 +++ 21 files changed, 943 insertions(+), 342 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 28b1cd292c6..7f915e57b37 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,17 @@ +Release v1.45.28 (2023-10-18) +=== + +### Service Client Updates +* `service/cloud9`: Updates service documentation + * Update to imageId parameter behavior and dates updated. +* `service/dynamodb`: Updates service API, documentation, waiters, paginators, and examples + * Updating descriptions for several APIs. +* `service/kendra`: Updates service API and documentation + * Changes for a new feature in Amazon Kendra's Query API to Collapse/Expand query results +* `service/rds`: Updates service API, documentation, waiters, paginators, and examples + * This release adds support for upgrading the storage file system configuration on the DB instance using a blue/green deployment or a read replica. +* `service/wisdom`: Updates service API + Release v1.45.27 (2023-10-17) === diff --git a/aws/endpoints/defaults.go b/aws/endpoints/defaults.go index ae70be25bd7..a4cb4b1d742 100644 --- a/aws/endpoints/defaults.go +++ b/aws/endpoints/defaults.go @@ -12321,6 +12321,9 @@ var awsPartition = partition{ }, "finspace": service{ Endpoints: serviceEndpoints{ + endpointKey{ + Region: "ap-northeast-1", + }: endpoint{}, endpointKey{ Region: "ap-southeast-1", }: endpoint{}, diff --git a/aws/version.go b/aws/version.go index a7cd48fb454..323020e929f 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.45.27" +const SDKVersion = "1.45.28" diff --git a/models/apis/cloud9/2017-09-23/docs-2.json b/models/apis/cloud9/2017-09-23/docs-2.json index ff61c82f6a8..20884b43107 100644 --- a/models/apis/cloud9/2017-09-23/docs-2.json +++ b/models/apis/cloud9/2017-09-23/docs-2.json @@ -232,7 +232,7 @@ "ImageId": { "base": null, "refs": { - "CreateEnvironmentEC2Request$imageId": "

The identifier for the Amazon Machine Image (AMI) that's used to create the EC2 instance. To choose an AMI for the instance, you must specify a valid AMI alias or a valid Amazon EC2 Systems Manager (SSM) path.

The default Amazon Linux AMI is currently used if the parameter isn't explicitly assigned a value in the request. Because Amazon Linux AMI has ended standard support as of December 31, 2020, we recommend you choose Amazon Linux 2, which includes long term support through 2023.

From December 31, 2023, the parameter for Amazon Linux will no longer be available when you specify an AMI for your instance. Amazon Linux 2 will then become the default AMI, which is used to launch your instance if no parameter is explicitly defined.

Since Ubuntu 18.04 has ended standard support as of May 31, 2023, we recommend you choose Ubuntu 22.04.

AMI aliases

SSM paths

" + "CreateEnvironmentEC2Request$imageId": "

The identifier for the Amazon Machine Image (AMI) that's used to create the EC2 instance. To choose an AMI for the instance, you must specify a valid AMI alias or a valid Amazon EC2 Systems Manager (SSM) path.

From November 20, 2023, you will be required to include the imageId parameter for the CreateEnvironmentEC2 action. This change will be reflected across all direct methods of communicating with the API, such as Amazon Web Services SDK, Amazon Web Services CLI and Amazon Web Services CloudFormation. This change will only affect direct API consumers, and not Cloud9 console users.

From January 22, 2024, Amazon Linux (AL1) will be removed from the list of available image IDs for Cloud9. This is necessary as AL1 will reach the end of maintenance support in December 2023, and as a result will no longer receive security updates. We recommend using Amazon Linux 2 as the AMI to create your environment as it is fully supported. This change will only affect direct API consumers, and not Cloud9 console users.

Since Ubuntu 18.04 has ended standard support as of May 31, 2023, we recommend you choose Ubuntu 22.04.

AMI aliases

SSM paths

" } }, "InstanceType": { diff --git a/models/apis/cloud9/2017-09-23/endpoint-rule-set-1.json b/models/apis/cloud9/2017-09-23/endpoint-rule-set-1.json index 26763c88c97..fa3d7dc32ce 100644 --- a/models/apis/cloud9/2017-09-23/endpoint-rule-set-1.json +++ b/models/apis/cloud9/2017-09-23/endpoint-rule-set-1.json @@ -40,7 +40,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -83,7 +82,8 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -96,7 +96,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -110,7 +109,6 @@ "assign": "PartitionResult" } ], - "type": "tree", "rules": [ { "conditions": [ @@ -133,7 +131,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -168,7 +165,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -179,14 +175,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS and DualStack are enabled, but this partition does not support one or both", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -200,14 +198,12 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ - true, { "fn": "getAttr", "argv": [ @@ -216,11 +212,11 @@ }, "supportsFIPS" ] - } + }, + true ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -231,14 +227,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -252,7 +250,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -272,7 +269,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -283,14 +279,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "DualStack is enabled but this partition does not support DualStack", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [], @@ -301,9 +299,11 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" } - ] + ], + "type": "tree" }, { "conditions": [], diff --git a/models/apis/dynamodb/2012-08-10/docs-2.json b/models/apis/dynamodb/2012-08-10/docs-2.json index be1e1a40c46..36edfcf9eb1 100644 --- a/models/apis/dynamodb/2012-08-10/docs-2.json +++ b/models/apis/dynamodb/2012-08-10/docs-2.json @@ -547,7 +547,7 @@ "Put$ConditionExpression": "

A condition that must be satisfied in order for a conditional update to succeed.

", "PutItemInput$ConditionExpression": "

A condition that must be satisfied in order for a conditional PutItem operation to succeed.

An expression can contain any of the following:

For more information on condition expressions, see Condition Expressions in the Amazon DynamoDB Developer Guide.

", "QueryInput$FilterExpression": "

A string that contains conditions that DynamoDB applies after the Query operation, but before the data is returned to you. Items that do not satisfy the FilterExpression criteria are not returned.

A FilterExpression does not allow key attributes. You cannot define a filter expression based on a partition key or a sort key.

A FilterExpression is applied after the items have already been read; the process of filtering does not consume any additional read capacity units.

For more information, see Filter Expressions in the Amazon DynamoDB Developer Guide.

", - "ScanInput$FilterExpression": "

A string that contains conditions that DynamoDB applies after the Scan operation, but before the data is returned to you. Items that do not satisfy the FilterExpression criteria are not returned.

A FilterExpression is applied after the items have already been read; the process of filtering does not consume any additional read capacity units.

For more information, see Filter Expressions in the Amazon DynamoDB Developer Guide.

", + "ScanInput$FilterExpression": "

A string that contains conditions that DynamoDB applies after the Scan operation, but before the data is returned to you. Items that do not satisfy the FilterExpression criteria are not returned.

A FilterExpression is applied after the items have already been read; the process of filtering does not consume any additional read capacity units.

For more information, see Filter Expressions in the Amazon DynamoDB Developer Guide.

", "Update$ConditionExpression": "

A condition that must be satisfied in order for a conditional update to succeed.

", "UpdateItemInput$ConditionExpression": "

A condition that must be satisfied in order for a conditional update to succeed.

An expression can contain any of the following:

For more information about condition expressions, see Specifying Conditions in the Amazon DynamoDB Developer Guide.

" } @@ -1187,15 +1187,15 @@ "ExportType": { "base": null, "refs": { - "ExportDescription$ExportType": "

Choice of whether to execute as a full export or incremental export. Valid values are FULL_EXPORT or INCREMENTAL_EXPORT. If INCREMENTAL_EXPORT is provided, the IncrementalExportSpecification must also be used.

", - "ExportSummary$ExportType": "

Choice of whether to execute as a full export or incremental export. Valid values are FULL_EXPORT or INCREMENTAL_EXPORT. If INCREMENTAL_EXPORT is provided, the IncrementalExportSpecification must also be used.

", - "ExportTableToPointInTimeInput$ExportType": "

Choice of whether to execute as a full export or incremental export. Valid values are FULL_EXPORT or INCREMENTAL_EXPORT. If INCREMENTAL_EXPORT is provided, the IncrementalExportSpecification must also be used.

" + "ExportDescription$ExportType": "

The type of export that was performed. Valid values are FULL_EXPORT or INCREMENTAL_EXPORT.

", + "ExportSummary$ExportType": "

The type of export that was performed. Valid values are FULL_EXPORT or INCREMENTAL_EXPORT.

", + "ExportTableToPointInTimeInput$ExportType": "

Choice of whether to execute as a full export or incremental export. Valid values are FULL_EXPORT or INCREMENTAL_EXPORT. The default value is FULL_EXPORT. If INCREMENTAL_EXPORT is provided, the IncrementalExportSpecification must also be used.

" } }, "ExportViewType": { "base": null, "refs": { - "IncrementalExportSpecification$ExportViewType": "

Choice of whether to output the previous item image prior to the start time of the incremental export. Valid values are NEW_AND_OLD_IMAGES and NEW_IMAGES.

" + "IncrementalExportSpecification$ExportViewType": "

The view type that was chosen for the export. Valid values are NEW_AND_OLD_IMAGES and NEW_IMAGES. The default value is NEW_AND_OLD_IMAGES.

" } }, "ExpressionAttributeNameMap": { @@ -3032,7 +3032,7 @@ } }, "TransactionCanceledException": { - "base": "

The entire transaction request was canceled.

DynamoDB cancels a TransactWriteItems request under the following circumstances:

DynamoDB cancels a TransactGetItems request under the following circumstances:

If using Java, DynamoDB lists the cancellation reasons on the CancellationReasons property. This property is not set for other languages. Transaction cancellation reasons are ordered in the order of requested items, if an item has no error it will have None code and Null message.

Cancellation reason codes and possible error messages:

", + "base": "

The entire transaction request was canceled.

DynamoDB cancels a TransactWriteItems request under the following circumstances:

DynamoDB cancels a TransactGetItems request under the following circumstances:

If using Java, DynamoDB lists the cancellation reasons on the CancellationReasons property. This property is not set for other languages. Transaction cancellation reasons are ordered in the order of requested items, if an item has no error it will have None code and Null message.

Cancellation reason codes and possible error messages:

", "refs": { } }, diff --git a/models/apis/dynamodb/2012-08-10/endpoint-rule-set-1.json b/models/apis/dynamodb/2012-08-10/endpoint-rule-set-1.json index 5fa72ade6df..5e7f294eea5 100644 --- a/models/apis/dynamodb/2012-08-10/endpoint-rule-set-1.json +++ b/models/apis/dynamodb/2012-08-10/endpoint-rule-set-1.json @@ -40,7 +40,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -83,7 +82,8 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -96,7 +96,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -110,7 +109,6 @@ "assign": "PartitionResult" } ], - "type": "tree", "rules": [ { "conditions": [ @@ -133,7 +131,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -168,7 +165,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -179,14 +175,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS and DualStack are enabled, but this partition does not support one or both", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -200,14 +198,12 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ - true, { "fn": "getAttr", "argv": [ @@ -216,18 +212,17 @@ }, "supportsFIPS" ] - } + }, + true ] } ], - "type": "tree", "rules": [ { "conditions": [ { "fn": "stringEquals", "argv": [ - "aws-us-gov", { "fn": "getAttr", "argv": [ @@ -236,7 +231,8 @@ }, "name" ] - } + }, + "aws-us-gov" ] } ], @@ -256,14 +252,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -277,7 +275,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -297,7 +294,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -308,14 +304,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "DualStack is enabled but this partition does not support DualStack", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -353,9 +351,11 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" } - ] + ], + "type": "tree" }, { "conditions": [], diff --git a/models/apis/kendra/2019-02-03/api-2.json b/models/apis/kendra/2019-02-03/api-2.json index f461f7dbe3e..858d48d53bd 100644 --- a/models/apis/kendra/2019-02-03/api-2.json +++ b/models/apis/kendra/2019-02-03/api-2.json @@ -2769,6 +2769,43 @@ "min": 1, "type": "string" }, + "CollapseConfiguration": { + "members": { + "DocumentAttributeKey": { + "shape": "DocumentAttributeKey" + }, + "Expand": { + "shape": "Boolean" + }, + "ExpandConfiguration": { + "shape": "ExpandConfiguration" + }, + "MissingAttributeKeyStrategy": { + "shape": "MissingAttributeKeyStrategy" + }, + "SortingConfigurations": { + "shape": "SortingConfigurationList" + } + }, + "required": [ + "DocumentAttributeKey" + ], + "type": "structure" + }, + "CollapsedResultDetail": { + "members": { + "DocumentAttribute": { + "shape": "DocumentAttribute" + }, + "ExpandedResults": { + "shape": "ExpandedResultList" + } + }, + "required": [ + "DocumentAttribute" + ], + "type": "structure" + }, "ColumnConfiguration": { "members": { "ChangeDetectingColumns": { @@ -5106,6 +5143,46 @@ "min": 0, "type": "list" }, + "ExpandConfiguration": { + "members": { + "MaxExpandedResultsPerItem": { + "shape": "Integer" + }, + "MaxResultItemsToExpand": { + "shape": "Integer" + } + }, + "type": "structure" + }, + "ExpandedResultItem": { + "members": { + "DocumentAttributes": { + "shape": "DocumentAttributeList" + }, + "DocumentExcerpt": { + "shape": "TextWithHighlights" + }, + "DocumentId": { + "shape": "DocumentId" + }, + "DocumentTitle": { + "shape": "TextWithHighlights" + }, + "DocumentURI": { + "shape": "Url" + }, + "Id": { + "shape": "ResultId" + } + }, + "type": "structure" + }, + "ExpandedResultList": { + "member": { + "shape": "ExpandedResultItem" + }, + "type": "list" + }, "ExperienceConfiguration": { "members": { "ContentSourceConfiguration": { @@ -6806,6 +6883,14 @@ "min": 1, "type": "integer" }, + "MissingAttributeKeyStrategy": { + "enum": [ + "IGNORE", + "COLLAPSE", + "EXPAND" + ], + "type": "string" + }, "Mode": { "enum": [ "ENABLED", @@ -7099,6 +7184,9 @@ "AttributeFilter": { "shape": "AttributeFilter" }, + "CollapseConfiguration": { + "shape": "CollapseConfiguration" + }, "DocumentRelevanceOverrideConfigurations": { "shape": "DocumentRelevanceOverrideConfigurationList" }, @@ -7126,6 +7214,9 @@ "SortingConfiguration": { "shape": "SortingConfiguration" }, + "SortingConfigurations": { + "shape": "SortingConfigurationList" + }, "SpellCorrectionConfiguration": { "shape": "SpellCorrectionConfiguration" }, @@ -7179,6 +7270,9 @@ "AdditionalAttributes": { "shape": "AdditionalResultAttributeList" }, + "CollapsedResultDetail": { + "shape": "CollapsedResultDetail" + }, "DocumentAttributes": { "shape": "DocumentAttributeList" }, @@ -8265,6 +8359,13 @@ ], "type": "structure" }, + "SortingConfigurationList": { + "member": { + "shape": "SortingConfiguration" + }, + "min": 1, + "type": "list" + }, "SourceDocument": { "members": { "AdditionalAttributes": { diff --git a/models/apis/kendra/2019-02-03/docs-2.json b/models/apis/kendra/2019-02-03/docs-2.json index b8621dbb68c..627b8232f9a 100644 --- a/models/apis/kendra/2019-02-03/docs-2.json +++ b/models/apis/kendra/2019-02-03/docs-2.json @@ -53,8 +53,8 @@ "ListTagsForResource": "

Gets a list of tags associated with a specified resource. Indexes, FAQs, and data sources can have tags associated with them.

", "ListThesauri": "

Lists the thesauri for an index.

", "PutPrincipalMapping": "

Maps users to their groups so that you only need to provide the user ID when you issue the query.

You can also map sub groups to groups. For example, the group \"Company Intellectual Property Teams\" includes sub groups \"Research\" and \"Engineering\". These sub groups include their own list of users or people who work in these teams. Only users who work in research and engineering, and therefore belong in the intellectual property group, can see top-secret company documents in their search results.

This is useful for user context filtering, where search results are filtered based on the user or their group access to documents. For more information, see Filtering on user context.

If more than five PUT actions for a group are currently processing, a validation exception is thrown.

", - "Query": "

Searches an index given an input query.

You can configure boosting or relevance tuning at the query level to override boosting at the index level, filter based on document fields/attributes and faceted search, and filter based on the user or their group access to documents. You can also include certain fields in the response that might provide useful additional information.

A query response contains three types of results.

You can specify that the query return only one type of result using the QueryResultTypeFilter parameter. Each query returns the 100 most relevant results. If you filter result type to only question-answers, a maximum of four results are returned. If you filter result type to only answers, a maximum of three results are returned.

", - "Retrieve": "

Retrieves relevant passages or text excerpts given an input query.

This API is similar to the Query API. However, by default, the Query API only returns excerpt passages of up to 100 token words. With the Retrieve API, you can retrieve longer passages of up to 200 token words and up to 100 semantically relevant passages. This doesn't include question-answer or FAQ type responses from your index. The passages are text excerpts that can be semantically extracted from multiple documents and multiple parts of the same document. If in extreme cases your documents produce zero passages using the Retrieve API, you can alternatively use the Query API and its types of responses.

You can also do the following:

You can also include certain fields in the response that might provide useful additional information.

The Retrieve API shares the number of query capacity units that you set for your index. For more information on what's included in a single capacity unit and the default base capacity for an index, see Adjusting capacity.

", + "Query": "

Searches an index given an input query.

If you are working with large language models (LLMs) or implementing retrieval augmented generation (RAG) systems, you can use Amazon Kendra's Retrieve API, which can return longer semantically relevant passages. We recommend using the Retrieve API instead of filing a service limit increase to increase the Query API document excerpt length.

You can configure boosting or relevance tuning at the query level to override boosting at the index level, filter based on document fields/attributes and faceted search, and filter based on the user or their group access to documents. You can also include certain fields in the response that might provide useful additional information.

A query response contains three types of results.

You can specify that the query return only one type of result using the QueryResultTypeFilter parameter. Each query returns the 100 most relevant results. If you filter result type to only question-answers, a maximum of four results are returned. If you filter result type to only answers, a maximum of three results are returned.

", + "Retrieve": "

Retrieves relevant passages or text excerpts given an input query.

This API is similar to the Query API. However, by default, the Query API only returns excerpt passages of up to 100 token words. With the Retrieve API, you can retrieve longer passages of up to 200 token words and up to 100 semantically relevant passages. This doesn't include question-answer or FAQ type responses from your index. The passages are text excerpts that can be semantically extracted from multiple documents and multiple parts of the same document. If in extreme cases your documents produce zero passages using the Retrieve API, you can alternatively use the Query API and its types of responses.

You can also do the following:

You can also include certain fields in the response that might provide useful additional information.

The Retrieve API shares the number of query capacity units that you set for your index. For more information on what's included in a single capacity unit and the default base capacity for an index, see Adjusting capacity.

", "StartDataSourceSyncJob": "

Starts a synchronization job for a data source connector. If a synchronization job is already in progress, Amazon Kendra returns a ResourceInUseException exception.

Re-syncing your data source with your index after modifying, adding, or deleting documents from your data source respository could take up to an hour or more, depending on the number of documents to sync.

", "StopDataSourceSyncJob": "

Stops a synchronization job that is currently running. You can't stop a scheduled synchronization job.

", "SubmitFeedback": "

Enables you to provide feedback to Amazon Kendra to improve the performance of your index.

SubmitFeedback is currently not supported in the Amazon Web Services GovCloud (US-West) region.

", @@ -358,6 +358,7 @@ "BoxConfiguration$CrawlComments": "

TRUE to index comments.

", "BoxConfiguration$CrawlTasks": "

TRUE to index the contents of tasks.

", "BoxConfiguration$CrawlWebLinks": "

TRUE to index web links.

", + "CollapseConfiguration$Expand": "

Specifies whether to expand the collapsed results.

", "ConfluenceAttachmentConfiguration$CrawlAttachments": "

TRUE to index attachments of pages and blogs in Confluence.

", "ConfluenceSpaceConfiguration$CrawlPersonalSpaces": "

TRUE to index personal spaces. You can add restrictions to items in personal spaces. If personal spaces are indexed, queries without user context information may return restricted items from a personal space in their results. For more information, see Filtering on user context.

", "ConfluenceSpaceConfiguration$CrawlArchivedSpaces": "

TRUE to index archived spaces.

", @@ -454,6 +455,18 @@ "CreateThesaurusRequest$ClientToken": "

A token that you provide to identify the request to create a thesaurus. Multiple calls to the CreateThesaurus API with the same client token will create only one thesaurus.

" } }, + "CollapseConfiguration": { + "base": "

Specifies how to group results by document attribute value, and how to display them collapsed/expanded under a designated primary document for each group.

", + "refs": { + "QueryRequest$CollapseConfiguration": "

Provides configuration to determine how to group results by document attribute value, and how to display them (collapsed or expanded) under a designated primary document for each group.

" + } + }, + "CollapsedResultDetail": { + "base": "

Provides details about a collapsed group of search results.

", + "refs": { + "QueryResultItem$CollapsedResultDetail": "

Provides details about a collapsed group of search results.

" + } + }, "ColumnConfiguration": { "base": "

Provides information about how Amazon Kendra should use the columns of a database in an index.

", "refs": { @@ -1261,6 +1274,7 @@ "AttributeFilter$GreaterThanOrEquals": "

Performs a greater or equals than operation on document attributes/fields and their values. Use with the document attribute type Date or Long.

", "AttributeFilter$LessThan": "

Performs a less than operation on document attributes/fields and their values. Use with the document attribute type Date or Long.

", "AttributeFilter$LessThanOrEquals": "

Performs a less than or equals operation on document attributes/fields and their values. Use with the document attribute type Date or Long.

", + "CollapsedResultDetail$DocumentAttribute": "

The value of the document attribute that results are collapsed on.

", "DocumentAttributeList$member": null } }, @@ -1274,6 +1288,7 @@ "DocumentAttributeKey": { "base": null, "refs": { + "CollapseConfiguration$DocumentAttributeKey": "

The document attribute used to group search results. You can use any attribute that has the Sortable flag set to true. You can also sort by any of the following built-in attributes:\"_category\",\"_created_at\", \"_last_updated_at\", \"_version\", \"_view_count\".

", "DocumentAttribute$Key": "

The identifier for the attribute.

", "DocumentAttributeCondition$ConditionDocumentAttributeKey": "

The identifier of the document attribute used for the condition.

For example, 'Source_URI' could be an identifier for the attribute or metadata field that contains source URIs associated with the documents.

Amazon Kendra currently does not support _document_body as an attribute key used for the condition.

", "DocumentAttributeKeyList$member": null, @@ -1299,6 +1314,7 @@ "refs": { "Document$Attributes": "

Custom attributes to apply to the document. Use the custom attributes to provide additional information for searching, to provide facets for refining searches, and to provide additional information in the query response.

For example, 'DataSourceId' and 'DataSourceSyncJobId' are custom attributes that provide information on the synchronization of documents running on a data source. Note, 'DataSourceSyncJobId' could be an optional custom attribute as Amazon Kendra will use the ID of a running sync job.

", "DocumentInfo$Attributes": "

Attributes that identify a specific version of a document to check.

The only valid attributes are:

The attributes follow these rules:

", + "ExpandedResultItem$DocumentAttributes": "

An array of document attributes assigned to a document in the search results. For example, the document author (\"_author\") or the source URI (\"_source_uri\") of the document.

", "FeaturedResultsItem$DocumentAttributes": "

An array of document attributes assigned to a featured document in the search results. For example, the document author (_author) or the source URI (_source_uri) of the document.

", "QueryResultItem$DocumentAttributes": "

An array of document fields/attributes assigned to a document in the search results. For example, the document author (_author) or the source URI (_source_uri) of the document.

", "RetrieveResultItem$DocumentAttributes": "

An array of document fields/attributes assigned to a document in the search results. For example, the document author (_author) or the source URI (_source_uri) of the document.

", @@ -1360,6 +1376,7 @@ "Document$Id": "

A identifier of the document in the index.

Note, each document ID must be unique per index. You cannot create a data source to index your documents with their unique IDs and then use the BatchPutDocument API to index the same documents, or vice versa. You can delete a data source and then use the BatchPutDocument API to index the same documents, or vice versa.

", "DocumentIdList$member": null, "DocumentInfo$DocumentId": "

The identifier of the document.

", + "ExpandedResultItem$DocumentId": "

The idenitifier of the document.

", "FeaturedDocument$Id": "

The identifier of the document to feature in the search results. You can use the Query API to search for specific documents with their document IDs included in the result items, or you can use the console.

", "FeaturedDocumentMissing$Id": "

The identifier of the document that doesn't exist but you have specified as a featured document.

", "FeaturedDocumentWithMetadata$Id": "

The identifier of the featured document with its metadata. You can use the Query API to search for specific documents with their document IDs included in the result items, or you can use the console.

", @@ -1598,6 +1615,24 @@ "GoogleDriveConfiguration$ExcludeUserAccounts": "

A list of email addresses of the users. Documents owned by these users are excluded from the index. Documents shared with excluded users are indexed unless they are excluded in another way.

" } }, + "ExpandConfiguration": { + "base": "

Specifies the configuration information needed to customize how collapsed search result groups expand.

", + "refs": { + "CollapseConfiguration$ExpandConfiguration": "

Provides configuration information to customize expansion options for a collapsed group.

" + } + }, + "ExpandedResultItem": { + "base": "

A single expanded result in a collapsed group of search results.

An expanded result item contains information about an expanded result document within a collapsed group of search results. This includes the original location of the document, a list of attributes assigned to the document, and relevant text from the document that satisfies the query.

", + "refs": { + "ExpandedResultList$member": null + } + }, + "ExpandedResultList": { + "base": null, + "refs": { + "CollapsedResultDetail$ExpandedResults": "

A list of results in the collapsed group.

" + } + }, "ExperienceConfiguration": { "base": "

Provides the configuration information for your Amazon Kendra experience. This includes the data source IDs and/or FAQ IDs, and user or group information to grant access to your Amazon Kendra experience.

", "refs": { @@ -2250,6 +2285,8 @@ "DescribeQuerySuggestionsConfigResponse$QueryLogLookBackWindowInDays": "

How recent your queries are in your query log time window (in days).

", "DescribeQuerySuggestionsConfigResponse$TotalSuggestionsCount": "

The current total count of query suggestions for an index.

This count can change when you update your query suggestions settings, if you filter out certain queries from suggestions using a block list, and as the query log accumulates more queries for Amazon Kendra to learn from.

If the count is much lower than you expected, it could be because Amazon Kendra needs more queries in the query history to learn from or your current query suggestions settings are too strict.

", "DocumentAttributeValueCountPair$Count": "

The number of documents in the response that have the attribute/field value for the key.

", + "ExpandConfiguration$MaxResultItemsToExpand": "

The number of collapsed search result groups to expand. If you set this value to 10, for example, only the first 10 out of 100 result groups will have expand functionality.

", + "ExpandConfiguration$MaxExpandedResultsPerItem": "

The number of expanded results to show per collapsed primary document. For instance, if you set this value to 3, then at most 3 results per collapsed group will be displayed.

", "GetQuerySuggestionsRequest$MaxSuggestionsCount": "

The maximum number of query suggestions you want to show to your users.

", "GetSnapshotsRequest$MaxResults": "

The maximum number of returned data for the metric.

", "Highlight$BeginOffset": "

The zero-based location in the response string where the highlight starts.

", @@ -2668,6 +2705,12 @@ "UpdateQuerySuggestionsConfigRequest$MinimumQueryCount": "

The the minimum number of times a query must be searched in order to be eligible to suggest to your users.

Decreasing this number increases the number of suggestions. However, this affects the quality of suggestions as it sets a low bar for a query to be considered popular to suggest to users.

How you tune this setting depends on your specific needs.

" } }, + "MissingAttributeKeyStrategy": { + "base": null, + "refs": { + "CollapseConfiguration$MissingAttributeKeyStrategy": "

Specifies the behavior for documents without a value for the collapse attribute.

Amazon Kendra offers three customization options:

" + } + }, "Mode": { "base": null, "refs": { @@ -3073,6 +3116,7 @@ "base": null, "refs": { "ClickFeedback$ResultId": "

The identifier of the search result that was clicked.

", + "ExpandedResultItem$Id": "

The identifier for the expanded result.

", "FeaturedResultsItem$Id": "

The identifier of the featured result.

", "QueryResultItem$Id": "

The identifier for the query result.

", "RelevanceFeedback$ResultId": "

The identifier of the search result that the user provided relevance feedback for.

", @@ -3107,7 +3151,7 @@ "refs": { "BatchPutDocumentRequest$RoleArn": "

The Amazon Resource Name (ARN) of an IAM role with permission to access your S3 bucket. For more information, see IAM access roles for Amazon Kendra.

", "CreateDataSourceRequest$RoleArn": "

The Amazon Resource Name (ARN) of an IAM role with permission to access the data source and required resources. For more information, see IAM access roles for Amazon Kendra..

You can't specify the RoleArn parameter when the Type parameter is set to CUSTOM. If you do, you receive a ValidationException exception.

The RoleArn parameter is required for all other data sources.

", - "CreateExperienceRequest$RoleArn": "

The Amazon Resource Name (ARN) of an IAM role with permission to access Query API, GetQuerySuggestions API, and other required APIs. The role also must include permission to access IAM Identity Center (successor to Single Sign-On) that stores your user and group information. For more information, see IAM access roles for Amazon Kendra.

", + "CreateExperienceRequest$RoleArn": "

The Amazon Resource Name (ARN) of an IAM role with permission to access Query API, GetQuerySuggestions API, and other required APIs. The role also must include permission to access IAM Identity Center that stores your user and group information. For more information, see IAM access roles for Amazon Kendra.

", "CreateFaqRequest$RoleArn": "

The Amazon Resource Name (ARN) of an IAM role with permission to access the S3 bucket that contains the FAQs. For more information, see IAM access roles for Amazon Kendra.

", "CreateIndexRequest$RoleArn": "

The Amazon Resource Name (ARN) of an IAM role with permission to access your Amazon CloudWatch logs and metrics. For more information, see IAM access roles for Amazon Kendra.

", "CreateQuerySuggestionsBlockListRequest$RoleArn": "

The Amazon Resource Name (ARN) of an IAM role with permission to access your S3 bucket that contains the block list text file. For more information, see IAM access roles for Amazon Kendra.

", @@ -3502,7 +3546,15 @@ "SortingConfiguration": { "base": "

Specifies the document attribute to use to sort the response to a Amazon Kendra query. You can specify a single attribute for sorting. The attribute must have the Sortable flag set to true, otherwise Amazon Kendra returns an exception.

You can sort attributes of the following types.

You can't sort attributes of the following type.

", "refs": { - "QueryRequest$SortingConfiguration": "

Provides information that determines how the results of the query are sorted. You can set the field that Amazon Kendra should sort the results on, and specify whether the results should be sorted in ascending or descending order. In the case of ties in sorting the results, the results are sorted by relevance.

If you don't provide sorting configuration, the results are sorted by the relevance that Amazon Kendra determines for the result.

" + "QueryRequest$SortingConfiguration": "

Provides information that determines how the results of the query are sorted. You can set the field that Amazon Kendra should sort the results on, and specify whether the results should be sorted in ascending or descending order. In the case of ties in sorting the results, the results are sorted by relevance.

If you don't provide sorting configuration, the results are sorted by the relevance that Amazon Kendra determines for the result.

", + "SortingConfigurationList$member": null + } + }, + "SortingConfigurationList": { + "base": null, + "refs": { + "CollapseConfiguration$SortingConfigurations": "

A prioritized list of document attributes/fields that determine the primary document among those in a collapsed group.

", + "QueryRequest$SortingConfigurations": "

Provides configuration information to determine how the results of a query are sorted.

You can set upto 3 fields that Amazon Kendra should sort the results on, and specify whether the results should be sorted in ascending or descending order. The sort field quota can be increased.

If you don't provide a sorting configuration, the results are sorted by the relevance that Amazon Kendra determines for the result. In the case of ties in sorting the results, the results are sorted by relevance.

" } }, "SourceDocument": { @@ -3821,6 +3873,8 @@ "base": "

Provides text and information about where to highlight the text.

", "refs": { "AdditionalResultAttributeValue$TextWithHighlightsValue": "

The text associated with the attribute and information about the highlight to apply to the text.

", + "ExpandedResultItem$DocumentTitle": null, + "ExpandedResultItem$DocumentExcerpt": null, "FeaturedResultsItem$DocumentTitle": null, "FeaturedResultsItem$DocumentExcerpt": null, "QueryResultItem$DocumentTitle": "

The title of the document. Contains the text of the title and information for highlighting the relevant terms in the title.

", @@ -4006,6 +4060,7 @@ "base": null, "refs": { "ConfluenceConfiguration$ServerUrl": "

The URL of your Confluence instance. Use the full URL of the server. For example, https://server.example.com:port/. You can also use an IP address, for example, https://192.168.1.113/.

", + "ExpandedResultItem$DocumentURI": "

The URI of the original location of the document.

", "FeaturedDocumentWithMetadata$URI": "

The source URI location of the featured document.

", "FeaturedResultsItem$DocumentURI": "

The source URI location of the featured document.

", "JwtTokenTypeConfiguration$URL": "

The signing key URL.

", @@ -4046,17 +4101,17 @@ } }, "UserGroupResolutionConfiguration": { - "base": "

Provides the configuration information to get users and groups from an IAM Identity Center (successor to Single Sign-On) identity source. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents. You can also use the PutPrincipalMapping API to map users to their groups so that you only need to provide the user ID when you issue the query.

To set up an IAM Identity Center identity source in the console to use with Amazon Kendra, see Getting started with an IAM Identity Center identity source. You must also grant the required permissions to use IAM Identity Center with Amazon Kendra. For more information, see IAM roles for IAM Identity Center.

Amazon Kendra currently does not support using UserGroupResolutionConfiguration with an Amazon Web Services organization member account for your IAM Identity Center identify source. You must create your index in the management account for the organization in order to use UserGroupResolutionConfiguration.

", + "base": "

Provides the configuration information to get users and groups from an IAM Identity Center identity source. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents. You can also use the PutPrincipalMapping API to map users to their groups so that you only need to provide the user ID when you issue the query.

To set up an IAM Identity Center identity source in the console to use with Amazon Kendra, see Getting started with an IAM Identity Center identity source. You must also grant the required permissions to use IAM Identity Center with Amazon Kendra. For more information, see IAM roles for IAM Identity Center.

Amazon Kendra currently does not support using UserGroupResolutionConfiguration with an Amazon Web Services organization member account for your IAM Identity Center identify source. You must create your index in the management account for the organization in order to use UserGroupResolutionConfiguration.

", "refs": { - "CreateIndexRequest$UserGroupResolutionConfiguration": "

Gets users and groups from IAM Identity Center (successor to Single Sign-On) identity source. To configure this, see UserGroupResolutionConfiguration.

", - "DescribeIndexResponse$UserGroupResolutionConfiguration": "

Whether you have enabled the configuration for fetching access levels of groups and users from an IAM Identity Center (successor to Single Sign-On) identity source.

", - "UpdateIndexRequest$UserGroupResolutionConfiguration": "

Enables fetching access levels of groups and users from an IAM Identity Center (successor to Single Sign-On) identity source. To configure this, see UserGroupResolutionConfiguration.

" + "CreateIndexRequest$UserGroupResolutionConfiguration": "

Gets users and groups from IAM Identity Center identity source. To configure this, see UserGroupResolutionConfiguration.

", + "DescribeIndexResponse$UserGroupResolutionConfiguration": "

Whether you have enabled the configuration for fetching access levels of groups and users from an IAM Identity Center identity source.

", + "UpdateIndexRequest$UserGroupResolutionConfiguration": "

Enables fetching access levels of groups and users from an IAM Identity Center identity source. To configure this, see UserGroupResolutionConfiguration.

" } }, "UserGroupResolutionMode": { "base": null, "refs": { - "UserGroupResolutionConfiguration$UserGroupResolutionMode": "

The identity store provider (mode) you want to use to get users and groups. IAM Identity Center (successor to Single Sign-On) is currently the only available mode. Your users and groups must exist in an IAM Identity Center identity source in order to use this mode.

" + "UserGroupResolutionConfiguration$UserGroupResolutionMode": "

The identity store provider (mode) you want to use to get users and groups. IAM Identity Center is currently the only available mode. Your users and groups must exist in an IAM Identity Center identity source in order to use this mode.

" } }, "UserId": { diff --git a/models/apis/kendra/2019-02-03/endpoint-rule-set-1.json b/models/apis/kendra/2019-02-03/endpoint-rule-set-1.json index 6caf5607266..02f854fd29b 100644 --- a/models/apis/kendra/2019-02-03/endpoint-rule-set-1.json +++ b/models/apis/kendra/2019-02-03/endpoint-rule-set-1.json @@ -40,7 +40,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -83,7 +82,8 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -96,7 +96,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -110,7 +109,6 @@ "assign": "PartitionResult" } ], - "type": "tree", "rules": [ { "conditions": [ @@ -133,7 +131,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -168,7 +165,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -179,14 +175,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS and DualStack are enabled, but this partition does not support one or both", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -200,14 +198,12 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ - true, { "fn": "getAttr", "argv": [ @@ -216,11 +212,11 @@ }, "supportsFIPS" ] - } + }, + true ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -231,14 +227,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -252,7 +250,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -272,7 +269,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -283,14 +279,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "DualStack is enabled but this partition does not support DualStack", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [], @@ -301,9 +299,11 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" } - ] + ], + "type": "tree" }, { "conditions": [], diff --git a/models/apis/rds/2014-10-31/api-2.json b/models/apis/rds/2014-10-31/api-2.json index 0461ab8522c..3c01c28d3db 100644 --- a/models/apis/rds/2014-10-31/api-2.json +++ b/models/apis/rds/2014-10-31/api-2.json @@ -3134,7 +3134,9 @@ "TargetEngineVersion":{"shape":"TargetEngineVersion"}, "TargetDBParameterGroupName":{"shape":"TargetDBParameterGroupName"}, "TargetDBClusterParameterGroupName":{"shape":"TargetDBClusterParameterGroupName"}, - "Tags":{"shape":"TagList"} + "Tags":{"shape":"TagList"}, + "TargetDBInstanceClass":{"shape":"TargetDBInstanceClass"}, + "UpgradeTargetStorageConfig":{"shape":"BooleanOptional"} } }, "CreateBlueGreenDeploymentResponse":{ @@ -3410,7 +3412,8 @@ "EnableCustomerOwnedIp":{"shape":"BooleanOptional"}, "AllocatedStorage":{"shape":"IntegerOptional"}, "SourceDBClusterIdentifier":{"shape":"String"}, - "DedicatedLogVolume":{"shape":"BooleanOptional"} + "DedicatedLogVolume":{"shape":"BooleanOptional"}, + "UpgradeStorageConfig":{"shape":"BooleanOptional"} } }, "CreateDBInstanceReadReplicaResult":{ @@ -4349,7 +4352,8 @@ "CertificateDetails":{"shape":"CertificateDetails"}, "ReadReplicaSourceDBClusterIdentifier":{"shape":"String"}, "PercentProgress":{"shape":"String"}, - "DedicatedLogVolume":{"shape":"Boolean"} + "DedicatedLogVolume":{"shape":"Boolean"}, + "IsStorageConfigUpgradeAvailable":{"shape":"BooleanOptional"} }, "wrapper":true }, @@ -8844,6 +8848,12 @@ "min":1, "pattern":"[A-Za-z](?!.*--)[0-9A-Za-z-]*[^-]|^default(?!.*--)(?!.*\\.\\.)[0-9A-Za-z-.]*[^-]" }, + "TargetDBInstanceClass":{ + "type":"string", + "max":20, + "min":5, + "pattern":"db\\.[0-9a-z]{2,6}\\.[0-9a-z]{4,9}" + }, "TargetDBParameterGroupName":{ "type":"string", "max":255, diff --git a/models/apis/rds/2014-10-31/docs-2.json b/models/apis/rds/2014-10-31/docs-2.json index bf89c86c8de..c4eea69e8db 100644 --- a/models/apis/rds/2014-10-31/docs-2.json +++ b/models/apis/rds/2014-10-31/docs-2.json @@ -531,6 +531,7 @@ "CopyDBClusterSnapshotMessage$CopyTags": "

Specifies whether to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot. By default, tags are not copied.

", "CopyDBSnapshotMessage$CopyTags": "

Specifies whether to copy all tags from the source DB snapshot to the target DB snapshot. By default, tags aren't copied.

", "CopyDBSnapshotMessage$CopyOptionGroup": "

Specifies whether to copy the DB option group associated with the source DB snapshot to the target Amazon Web Services account and associate with the target DB snapshot. The associated option group can be copied only with cross-account snapshot copy calls.

", + "CreateBlueGreenDeploymentRequest$UpgradeTargetStorageConfig": "

Whether to upgrade the storage file system configuration on the green database. This option migrates the green DB instance from the older 32-bit file system to the preferred configuration. For more information, see Upgrading the storage file system for a DB instance.

", "CreateCustomDBEngineVersionMessage$UseAwsProvidedLatestImage": "

Reserved for future use.

", "CreateDBClusterMessage$StorageEncrypted": "

Specifies whether the DB cluster is encrypted.

Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters

", "CreateDBClusterMessage$EnableIAMDatabaseAuthentication": "

Specifies whether to enable mapping of Amazon Web Services Identity and Access Management (IAM) accounts to database accounts. By default, mapping isn't enabled.

For more information, see IAM Database Authentication in the Amazon Aurora User Guide.

Valid for Cluster Type: Aurora DB clusters only

", @@ -564,6 +565,7 @@ "CreateDBInstanceReadReplicaMessage$DeletionProtection": "

Specifies whether to enable deletion protection for the DB instance. The database can't be deleted when deletion protection is enabled. By default, deletion protection isn't enabled. For more information, see Deleting a DB Instance.

", "CreateDBInstanceReadReplicaMessage$EnableCustomerOwnedIp": "

Specifies whether to enable a customer-owned IP address (CoIP) for an RDS on Outposts read replica.

A CoIP provides local or external connectivity to resources in your Outpost subnets through your on-premises network. For some use cases, a CoIP can provide lower latency for connections to the read replica from outside of its virtual private cloud (VPC) on your local network.

For more information about RDS on Outposts, see Working with Amazon RDS on Amazon Web Services Outposts in the Amazon RDS User Guide.

For more information about CoIPs, see Customer-owned IP addresses in the Amazon Web Services Outposts User Guide.

", "CreateDBInstanceReadReplicaMessage$DedicatedLogVolume": "

Indicates whether the DB instance has a dedicated log volume (DLV) enabled.

", + "CreateDBInstanceReadReplicaMessage$UpgradeStorageConfig": "

Whether to upgrade the storage file system configuration on the read replica. This option migrates the read replica from the old storage file system layout to the preferred layout.

", "CreateEventSubscriptionMessage$Enabled": "

Specifies whether to activate the subscription. If the event notification subscription isn't activated, the subscription is created but not active.

", "CreateGlobalClusterMessage$DeletionProtection": "

Specifies whether to enable deletion protection for the new global database cluster. The global database can't be deleted when deletion protection is enabled.

", "CreateGlobalClusterMessage$StorageEncrypted": "

Specifies whether to enable storage encryption for the new global database cluster.

Constraints:

", @@ -581,6 +583,7 @@ "DBInstance$PerformanceInsightsEnabled": "

Indicates whether Performance Insights is enabled for the DB instance.

", "DBInstance$CustomerOwnedIpEnabled": "

Indicates whether a customer-owned IP address (CoIP) is enabled for an RDS on Outposts DB instance.

A CoIP provides local or external connectivity to resources in your Outpost subnets through your on-premises network. For some use cases, a CoIP can provide lower latency for connections to the DB instance from outside of its virtual private cloud (VPC) on your local network.

For more information about RDS on Outposts, see Working with Amazon RDS on Amazon Web Services Outposts in the Amazon RDS User Guide.

For more information about CoIPs, see Customer-owned IP addresses in the Amazon Web Services Outposts User Guide.

", "DBInstance$ActivityStreamEngineNativeAuditFieldsIncluded": "

Indicates whether engine-native audit fields are included in the database activity stream.

", + "DBInstance$IsStorageConfigUpgradeAvailable": "

Indicates whether an upgrade is recommended for the storage file system configuration on the DB instance. To migrate to the preferred configuration, you can either create a blue/green deployment, or create a read replica from the DB instance. For more information, see Upgrading the storage file system for a DB instance.

", "DBInstanceAutomatedBackup$DedicatedLogVolume": "

Indicates whether the DB instance has a dedicated log volume (DLV) enabled.

", "DeleteBlueGreenDeploymentRequest$DeleteTarget": "

Specifies whether to delete the resources in the green environment. You can't specify this option if the blue/green deployment status is SWITCHOVER_COMPLETED.

", "DeleteDBClusterMessage$DeleteAutomatedBackups": "

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.

", @@ -5286,6 +5289,12 @@ "CreateBlueGreenDeploymentRequest$TargetDBClusterParameterGroupName": "

The DB cluster parameter group associated with the Aurora DB cluster in the green environment.

To test parameter changes, specify a DB cluster parameter group that is different from the one associated with the source DB cluster.

" } }, + "TargetDBInstanceClass": { + "base": null, + "refs": { + "CreateBlueGreenDeploymentRequest$TargetDBInstanceClass": "

Specify the DB instance class for the databases in the green environment.

" + } + }, "TargetDBParameterGroupName": { "base": null, "refs": { diff --git a/models/apis/rds/2014-10-31/endpoint-rule-set-1.json b/models/apis/rds/2014-10-31/endpoint-rule-set-1.json index 00bd15c3610..1dfb5f08259 100644 --- a/models/apis/rds/2014-10-31/endpoint-rule-set-1.json +++ b/models/apis/rds/2014-10-31/endpoint-rule-set-1.json @@ -40,7 +40,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -83,7 +82,8 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -96,7 +96,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -110,7 +109,6 @@ "assign": "PartitionResult" } ], - "type": "tree", "rules": [ { "conditions": [ @@ -133,7 +131,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -168,7 +165,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -179,14 +175,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS and DualStack are enabled, but this partition does not support one or both", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -200,14 +198,12 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ - true, { "fn": "getAttr", "argv": [ @@ -216,18 +212,17 @@ }, "supportsFIPS" ] - } + }, + true ] } ], - "type": "tree", "rules": [ { "conditions": [ { "fn": "stringEquals", "argv": [ - "aws-us-gov", { "fn": "getAttr", "argv": [ @@ -236,7 +231,8 @@ }, "name" ] - } + }, + "aws-us-gov" ] } ], @@ -256,14 +252,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -277,7 +275,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -297,7 +294,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -308,14 +304,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "DualStack is enabled but this partition does not support DualStack", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [], @@ -326,9 +324,11 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" } - ] + ], + "type": "tree" }, { "conditions": [], diff --git a/models/apis/wisdom/2020-10-19/api-2.json b/models/apis/wisdom/2020-10-19/api-2.json index af4a2d03a32..4439be5418f 100644 --- a/models/apis/wisdom/2020-10-19/api-2.json +++ b/models/apis/wisdom/2020-10-19/api-2.json @@ -1552,7 +1552,9 @@ }, "RecommendationIdList":{ "type":"list", - "member":{"shape":"String"} + "member":{"shape":"String"}, + "max":25, + "min":0 }, "RecommendationList":{ "type":"list", diff --git a/models/apis/wisdom/2020-10-19/endpoint-rule-set-1.json b/models/apis/wisdom/2020-10-19/endpoint-rule-set-1.json index ed174d9d57a..47191e6df0b 100644 --- a/models/apis/wisdom/2020-10-19/endpoint-rule-set-1.json +++ b/models/apis/wisdom/2020-10-19/endpoint-rule-set-1.json @@ -40,7 +40,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -58,293 +57,258 @@ "type": "error" }, { - "conditions": [], - "type": "tree", - "rules": [ + "conditions": [ { - "conditions": [ + "fn": "booleanEquals", + "argv": [ { - "fn": "booleanEquals", - "argv": [ - { - "ref": "UseDualStack" - }, - true - ] - } - ], - "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", - "type": "error" - }, - { - "conditions": [], - "endpoint": { - "url": { - "ref": "Endpoint" + "ref": "UseDualStack" }, - "properties": {}, - "headers": {} - }, - "type": "endpoint" + true + ] } - ] + ], + "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", + "type": "error" + }, + { + "conditions": [], + "endpoint": { + "url": { + "ref": "Endpoint" + }, + "properties": {}, + "headers": {} + }, + "type": "endpoint" } - ] + ], + "type": "tree" }, { - "conditions": [], - "type": "tree", + "conditions": [ + { + "fn": "isSet", + "argv": [ + { + "ref": "Region" + } + ] + } + ], "rules": [ { "conditions": [ { - "fn": "isSet", + "fn": "aws.partition", "argv": [ { "ref": "Region" } - ] + ], + "assign": "PartitionResult" } ], - "type": "tree", "rules": [ { "conditions": [ { - "fn": "aws.partition", + "fn": "booleanEquals", "argv": [ { - "ref": "Region" - } - ], - "assign": "PartitionResult" + "ref": "UseFIPS" + }, + true + ] + }, + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + true + ] } ], - "type": "tree", "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseFIPS" - }, - true + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsFIPS" + ] + } ] }, { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseDualStack" - }, - true - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", + "fn": "getAttr", "argv": [ - true, { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsFIPS" - ] - } - ] - }, - { - "fn": "booleanEquals", - "argv": [ - true, - { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsDualStack" - ] - } - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://wisdom-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } + "ref": "PartitionResult" + }, + "supportsDualStack" ] } ] - }, + } + ], + "rules": [ { "conditions": [], - "error": "FIPS and DualStack are enabled, but this partition does not support one or both", - "type": "error" + "endpoint": { + "url": "https://wisdom-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } - ] + ], + "type": "tree" }, + { + "conditions": [], + "error": "FIPS and DualStack are enabled, but this partition does not support one or both", + "type": "error" + } + ], + "type": "tree" + }, + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseFIPS" + }, + true + ] + } + ], + "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { - "ref": "UseFIPS" + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsFIPS" + ] }, true ] } ], - "type": "tree", "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - true, - { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsFIPS" - ] - } - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://wisdom-fips.{Region}.{PartitionResult#dnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ] - } - ] - }, { "conditions": [], - "error": "FIPS is enabled but this partition does not support FIPS", - "type": "error" + "endpoint": { + "url": "https://wisdom-fips.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } - ] + ], + "type": "tree" }, + { + "conditions": [], + "error": "FIPS is enabled but this partition does not support FIPS", + "type": "error" + } + ], + "type": "tree" + }, + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + true + ] + } + ], + "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseDualStack" - }, - true - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", + "fn": "getAttr", "argv": [ - true, { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsDualStack" - ] - } - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://wisdom.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } + "ref": "PartitionResult" + }, + "supportsDualStack" ] } ] - }, - { - "conditions": [], - "error": "DualStack is enabled but this partition does not support DualStack", - "type": "error" } - ] - }, - { - "conditions": [], - "type": "tree", + ], "rules": [ { "conditions": [], "endpoint": { - "url": "https://wisdom.{Region}.{PartitionResult#dnsSuffix}", + "url": "https://wisdom.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } - ] + ], + "type": "tree" + }, + { + "conditions": [], + "error": "DualStack is enabled but this partition does not support DualStack", + "type": "error" } - ] + ], + "type": "tree" + }, + { + "conditions": [], + "endpoint": { + "url": "https://wisdom.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } - ] - }, - { - "conditions": [], - "error": "Invalid Configuration: Missing Region", - "type": "error" + ], + "type": "tree" } - ] + ], + "type": "tree" + }, + { + "conditions": [], + "error": "Invalid Configuration: Missing Region", + "type": "error" } ] } \ No newline at end of file diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index a96e7262a4d..4b3a4413692 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -7042,6 +7042,7 @@ }, "finspace" : { "endpoints" : { + "ap-northeast-1" : { }, "ap-southeast-1" : { }, "ap-southeast-2" : { }, "ca-central-1" : { }, diff --git a/service/cloud9/api.go b/service/cloud9/api.go index fefe84ce383..0789704b08a 100644 --- a/service/cloud9/api.go +++ b/service/cloud9/api.go @@ -1601,15 +1601,18 @@ type CreateEnvironmentEC2Input struct { // EC2 instance. To choose an AMI for the instance, you must specify a valid // AMI alias or a valid Amazon EC2 Systems Manager (SSM) path. // - // The default Amazon Linux AMI is currently used if the parameter isn't explicitly - // assigned a value in the request. Because Amazon Linux AMI has ended standard - // support as of December 31, 2020, we recommend you choose Amazon Linux 2, - // which includes long term support through 2023. - // - // From December 31, 2023, the parameter for Amazon Linux will no longer be - // available when you specify an AMI for your instance. Amazon Linux 2 will - // then become the default AMI, which is used to launch your instance if no - // parameter is explicitly defined. + // From November 20, 2023, you will be required to include the imageId parameter + // for the CreateEnvironmentEC2 action. This change will be reflected across + // all direct methods of communicating with the API, such as Amazon Web Services + // SDK, Amazon Web Services CLI and Amazon Web Services CloudFormation. This + // change will only affect direct API consumers, and not Cloud9 console users. + // + // From January 22, 2024, Amazon Linux (AL1) will be removed from the list of + // available image IDs for Cloud9. This is necessary as AL1 will reach the end + // of maintenance support in December 2023, and as a result will no longer receive + // security updates. We recommend using Amazon Linux 2 as the AMI to create + // your environment as it is fully supported. This change will only affect direct + // API consumers, and not Cloud9 console users. // // Since Ubuntu 18.04 has ended standard support as of May 31, 2023, we recommend // you choose Ubuntu 22.04. diff --git a/service/dynamodb/api.go b/service/dynamodb/api.go index 58b2ecfbee6..2cc389eaf2e 100644 --- a/service/dynamodb/api.go +++ b/service/dynamodb/api.go @@ -3417,6 +3417,10 @@ func (c *DynamoDB) ExecuteTransactionRequest(input *ExecuteTransactionInput) (re // // - There is a user error, such as an invalid data format. // +// - There is an ongoing TransactWriteItems operation that conflicts with +// a concurrent TransactWriteItems request. In this case the TransactWriteItems +// operation fails with a TransactionCanceledException. +// // DynamoDB cancels a TransactGetItems request under the following circumstances: // // - There is an ongoing TransactGetItems operation that conflicts with a @@ -6085,6 +6089,10 @@ func (c *DynamoDB) TransactGetItemsRequest(input *TransactGetItemsInput) (req *r // // - There is a user error, such as an invalid data format. // +// - There is an ongoing TransactWriteItems operation that conflicts with +// a concurrent TransactWriteItems request. In this case the TransactWriteItems +// operation fails with a TransactionCanceledException. +// // DynamoDB cancels a TransactGetItems request under the following circumstances: // // - There is an ongoing TransactGetItems operation that conflicts with a @@ -6346,6 +6354,10 @@ func (c *DynamoDB) TransactWriteItemsRequest(input *TransactWriteItemsInput) (re // // - There is a user error, such as an invalid data format. // +// - There is an ongoing TransactWriteItems operation that conflicts with +// a concurrent TransactWriteItems request. In this case the TransactWriteItems +// operation fails with a TransactionCanceledException. +// // DynamoDB cancels a TransactGetItems request under the following circumstances: // // - There is an ongoing TransactGetItems operation that conflicts with a @@ -14218,9 +14230,7 @@ type ExportDescription struct { // Point in time from which table data was exported. ExportTime *time.Time `type:"timestamp"` - // Choice of whether to execute as a full export or incremental export. Valid - // values are FULL_EXPORT or INCREMENTAL_EXPORT. If INCREMENTAL_EXPORT is provided, - // the IncrementalExportSpecification must also be used. + // The type of export that was performed. Valid values are FULL_EXPORT or INCREMENTAL_EXPORT. ExportType *string `type:"string" enum:"ExportType"` // Status code for the result of the failed export. @@ -14487,9 +14497,7 @@ type ExportSummary struct { // FAILED. ExportStatus *string `type:"string" enum:"ExportStatus"` - // Choice of whether to execute as a full export or incremental export. Valid - // values are FULL_EXPORT or INCREMENTAL_EXPORT. If INCREMENTAL_EXPORT is provided, - // the IncrementalExportSpecification must also be used. + // The type of export that was performed. Valid values are FULL_EXPORT or INCREMENTAL_EXPORT. ExportType *string `type:"string" enum:"ExportType"` } @@ -14555,8 +14563,9 @@ type ExportTableToPointInTimeInput struct { ExportTime *time.Time `type:"timestamp"` // Choice of whether to execute as a full export or incremental export. Valid - // values are FULL_EXPORT or INCREMENTAL_EXPORT. If INCREMENTAL_EXPORT is provided, - // the IncrementalExportSpecification must also be used. + // values are FULL_EXPORT or INCREMENTAL_EXPORT. The default value is FULL_EXPORT. + // If INCREMENTAL_EXPORT is provided, the IncrementalExportSpecification must + // also be used. ExportType *string `type:"string" enum:"ExportType"` // Optional object containing the parameters specific to an incremental export. @@ -16592,8 +16601,8 @@ type IncrementalExportSpecification struct { // this is not provided, the latest time with data available will be used. ExportToTime *time.Time `type:"timestamp"` - // Choice of whether to output the previous item image prior to the start time - // of the incremental export. Valid values are NEW_AND_OLD_IMAGES and NEW_IMAGES. + // The view type that was chosen for the export. Valid values are NEW_AND_OLD_IMAGES + // and NEW_IMAGES. The default value is NEW_AND_OLD_IMAGES. ExportViewType *string `type:"string" enum:"ExportViewType"` } @@ -22336,7 +22345,7 @@ type ScanInput struct { // A FilterExpression is applied after the items have already been read; the // process of filtering does not consume any additional read capacity units. // - // For more information, see Filter Expressions (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression) + // For more information, see Filter Expressions (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Scan.html#Scan.FilterExpression) // in the Amazon DynamoDB Developer Guide. FilterExpression *string `type:"string"` @@ -24550,6 +24559,10 @@ func (s *TransactWriteItemsOutput) SetItemCollectionMetrics(v map[string][]*Item // // - There is a user error, such as an invalid data format. // +// - There is an ongoing TransactWriteItems operation that conflicts with +// a concurrent TransactWriteItems request. In this case the TransactWriteItems +// operation fails with a TransactionCanceledException. +// // DynamoDB cancels a TransactGetItems request under the following circumstances: // // - There is an ongoing TransactGetItems operation that conflicts with a diff --git a/service/dynamodb/errors.go b/service/dynamodb/errors.go index 79b80e693a1..d03749e0c2a 100644 --- a/service/dynamodb/errors.go +++ b/service/dynamodb/errors.go @@ -239,6 +239,10 @@ const ( // // * There is a user error, such as an invalid data format. // + // * There is an ongoing TransactWriteItems operation that conflicts with + // a concurrent TransactWriteItems request. In this case the TransactWriteItems + // operation fails with a TransactionCanceledException. + // // DynamoDB cancels a TransactGetItems request under the following circumstances: // // * There is an ongoing TransactGetItems operation that conflicts with a diff --git a/service/kendra/api.go b/service/kendra/api.go index 29649f586ba..7a7c588c9bb 100644 --- a/service/kendra/api.go +++ b/service/kendra/api.go @@ -6112,6 +6112,13 @@ func (c *Kendra) QueryRequest(input *QueryInput) (req *request.Request, output * // // Searches an index given an input query. // +// If you are working with large language models (LLMs) or implementing retrieval +// augmented generation (RAG) systems, you can use Amazon Kendra's Retrieve +// (https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) +// API, which can return longer semantically relevant passages. We recommend +// using the Retrieve API instead of filing a service limit increase to increase +// the Query API document excerpt length. +// // You can configure boosting or relevance tuning at the query level to override // boosting at the index level, filter based on document fields/attributes and // faceted search, and filter based on the user or their group access to documents. @@ -6260,6 +6267,11 @@ func (c *Kendra) RetrieveRequest(input *RetrieveInput) (req *request.Request, ou // // - Filter based on the user or their group access to documents // +// - View the confidence score bucket for a retrieved passage result. The +// confidence bucket provides a relative ranking that indicates how confident +// Amazon Kendra is that the response is relevant to the query. Confidence +// score buckets are currently available only for English. +// // You can also include certain fields in the response that might provide useful // additional information. // @@ -10305,6 +10317,165 @@ func (s *ClickFeedback) SetResultId(v string) *ClickFeedback { return s } +// Specifies how to group results by document attribute value, and how to display +// them collapsed/expanded under a designated primary document for each group. +type CollapseConfiguration struct { + _ struct{} `type:"structure"` + + // The document attribute used to group search results. You can use any attribute + // that has the Sortable flag set to true. You can also sort by any of the following + // built-in attributes:"_category","_created_at", "_last_updated_at", "_version", + // "_view_count". + // + // DocumentAttributeKey is a required field + DocumentAttributeKey *string `min:"1" type:"string" required:"true"` + + // Specifies whether to expand the collapsed results. + Expand *bool `type:"boolean"` + + // Provides configuration information to customize expansion options for a collapsed + // group. + ExpandConfiguration *ExpandConfiguration `type:"structure"` + + // Specifies the behavior for documents without a value for the collapse attribute. + // + // Amazon Kendra offers three customization options: + // + // * Choose to COLLAPSE all documents with null or missing values in one + // group. This is the default configuration. + // + // * Choose to IGNORE documents with null or missing values. Ignored documents + // will not appear in query results. + // + // * Choose to EXPAND each document with a null or missing value into a group + // of its own. + MissingAttributeKeyStrategy *string `type:"string" enum:"MissingAttributeKeyStrategy"` + + // A prioritized list of document attributes/fields that determine the primary + // document among those in a collapsed group. + SortingConfigurations []*SortingConfiguration `min:"1" type:"list"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CollapseConfiguration) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CollapseConfiguration) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CollapseConfiguration) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CollapseConfiguration"} + if s.DocumentAttributeKey == nil { + invalidParams.Add(request.NewErrParamRequired("DocumentAttributeKey")) + } + if s.DocumentAttributeKey != nil && len(*s.DocumentAttributeKey) < 1 { + invalidParams.Add(request.NewErrParamMinLen("DocumentAttributeKey", 1)) + } + if s.SortingConfigurations != nil && len(s.SortingConfigurations) < 1 { + invalidParams.Add(request.NewErrParamMinLen("SortingConfigurations", 1)) + } + if s.SortingConfigurations != nil { + for i, v := range s.SortingConfigurations { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "SortingConfigurations", i), err.(request.ErrInvalidParams)) + } + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDocumentAttributeKey sets the DocumentAttributeKey field's value. +func (s *CollapseConfiguration) SetDocumentAttributeKey(v string) *CollapseConfiguration { + s.DocumentAttributeKey = &v + return s +} + +// SetExpand sets the Expand field's value. +func (s *CollapseConfiguration) SetExpand(v bool) *CollapseConfiguration { + s.Expand = &v + return s +} + +// SetExpandConfiguration sets the ExpandConfiguration field's value. +func (s *CollapseConfiguration) SetExpandConfiguration(v *ExpandConfiguration) *CollapseConfiguration { + s.ExpandConfiguration = v + return s +} + +// SetMissingAttributeKeyStrategy sets the MissingAttributeKeyStrategy field's value. +func (s *CollapseConfiguration) SetMissingAttributeKeyStrategy(v string) *CollapseConfiguration { + s.MissingAttributeKeyStrategy = &v + return s +} + +// SetSortingConfigurations sets the SortingConfigurations field's value. +func (s *CollapseConfiguration) SetSortingConfigurations(v []*SortingConfiguration) *CollapseConfiguration { + s.SortingConfigurations = v + return s +} + +// Provides details about a collapsed group of search results. +type CollapsedResultDetail struct { + _ struct{} `type:"structure"` + + // The value of the document attribute that results are collapsed on. + // + // DocumentAttribute is a required field + DocumentAttribute *DocumentAttribute `type:"structure" required:"true"` + + // A list of results in the collapsed group. + ExpandedResults []*ExpandedResultItem `type:"list"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CollapsedResultDetail) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CollapsedResultDetail) GoString() string { + return s.String() +} + +// SetDocumentAttribute sets the DocumentAttribute field's value. +func (s *CollapsedResultDetail) SetDocumentAttribute(v *DocumentAttribute) *CollapsedResultDetail { + s.DocumentAttribute = v + return s +} + +// SetExpandedResults sets the ExpandedResults field's value. +func (s *CollapsedResultDetail) SetExpandedResults(v []*ExpandedResultItem) *CollapsedResultDetail { + s.ExpandedResults = v + return s +} + // Provides information about how Amazon Kendra should use the columns of a // database in an index. type ColumnConfiguration struct { @@ -12093,9 +12264,9 @@ type CreateExperienceInput struct { // The Amazon Resource Name (ARN) of an IAM role with permission to access Query // API, GetQuerySuggestions API, and other required APIs. The role also must - // include permission to access IAM Identity Center (successor to Single Sign-On) - // that stores your user and group information. For more information, see IAM - // access roles for Amazon Kendra (https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html). + // include permission to access IAM Identity Center that stores your user and + // group information. For more information, see IAM access roles for Amazon + // Kendra (https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html). RoleArn *string `type:"string"` } @@ -12673,9 +12844,8 @@ type CreateIndexInput struct { // to the user will be searchable and displayable. UserContextPolicy *string `type:"string" enum:"UserContextPolicy"` - // Gets users and groups from IAM Identity Center (successor to Single Sign-On) - // identity source. To configure this, see UserGroupResolutionConfiguration - // (https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html). + // Gets users and groups from IAM Identity Center identity source. To configure + // this, see UserGroupResolutionConfiguration (https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html). UserGroupResolutionConfiguration *UserGroupResolutionConfiguration `type:"structure"` // The user token configuration. @@ -16101,8 +16271,7 @@ type DescribeIndexOutput struct { UserContextPolicy *string `type:"string" enum:"UserContextPolicy"` // Whether you have enabled the configuration for fetching access levels of - // groups and users from an IAM Identity Center (successor to Single Sign-On) - // identity source. + // groups and users from an IAM Identity Center identity source. UserGroupResolutionConfiguration *UserGroupResolutionConfiguration `type:"structure"` // The user token configuration for the Amazon Kendra index. @@ -18344,6 +18513,136 @@ func (s *EntityPersonaConfiguration) SetPersona(v string) *EntityPersonaConfigur return s } +// Specifies the configuration information needed to customize how collapsed +// search result groups expand. +type ExpandConfiguration struct { + _ struct{} `type:"structure"` + + // The number of expanded results to show per collapsed primary document. For + // instance, if you set this value to 3, then at most 3 results per collapsed + // group will be displayed. + MaxExpandedResultsPerItem *int64 `type:"integer"` + + // The number of collapsed search result groups to expand. If you set this value + // to 10, for example, only the first 10 out of 100 result groups will have + // expand functionality. + MaxResultItemsToExpand *int64 `type:"integer"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ExpandConfiguration) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ExpandConfiguration) GoString() string { + return s.String() +} + +// SetMaxExpandedResultsPerItem sets the MaxExpandedResultsPerItem field's value. +func (s *ExpandConfiguration) SetMaxExpandedResultsPerItem(v int64) *ExpandConfiguration { + s.MaxExpandedResultsPerItem = &v + return s +} + +// SetMaxResultItemsToExpand sets the MaxResultItemsToExpand field's value. +func (s *ExpandConfiguration) SetMaxResultItemsToExpand(v int64) *ExpandConfiguration { + s.MaxResultItemsToExpand = &v + return s +} + +// A single expanded result in a collapsed group of search results. +// +// An expanded result item contains information about an expanded result document +// within a collapsed group of search results. This includes the original location +// of the document, a list of attributes assigned to the document, and relevant +// text from the document that satisfies the query. +type ExpandedResultItem struct { + _ struct{} `type:"structure"` + + // An array of document attributes assigned to a document in the search results. + // For example, the document author ("_author") or the source URI ("_source_uri") + // of the document. + DocumentAttributes []*DocumentAttribute `type:"list"` + + // Provides text and information about where to highlight the text. + DocumentExcerpt *TextWithHighlights `type:"structure"` + + // The idenitifier of the document. + DocumentId *string `min:"1" type:"string"` + + // Provides text and information about where to highlight the text. + DocumentTitle *TextWithHighlights `type:"structure"` + + // The URI of the original location of the document. + DocumentURI *string `min:"1" type:"string"` + + // The identifier for the expanded result. + Id *string `min:"1" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ExpandedResultItem) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ExpandedResultItem) GoString() string { + return s.String() +} + +// SetDocumentAttributes sets the DocumentAttributes field's value. +func (s *ExpandedResultItem) SetDocumentAttributes(v []*DocumentAttribute) *ExpandedResultItem { + s.DocumentAttributes = v + return s +} + +// SetDocumentExcerpt sets the DocumentExcerpt field's value. +func (s *ExpandedResultItem) SetDocumentExcerpt(v *TextWithHighlights) *ExpandedResultItem { + s.DocumentExcerpt = v + return s +} + +// SetDocumentId sets the DocumentId field's value. +func (s *ExpandedResultItem) SetDocumentId(v string) *ExpandedResultItem { + s.DocumentId = &v + return s +} + +// SetDocumentTitle sets the DocumentTitle field's value. +func (s *ExpandedResultItem) SetDocumentTitle(v *TextWithHighlights) *ExpandedResultItem { + s.DocumentTitle = v + return s +} + +// SetDocumentURI sets the DocumentURI field's value. +func (s *ExpandedResultItem) SetDocumentURI(v string) *ExpandedResultItem { + s.DocumentURI = &v + return s +} + +// SetId sets the Id field's value. +func (s *ExpandedResultItem) SetId(v string) *ExpandedResultItem { + s.Id = &v + return s +} + // Provides the configuration information for your Amazon Kendra experience. // This includes the data source IDs and/or FAQ IDs, and user or group information // to grant access to your Amazon Kendra experience. @@ -24280,6 +24579,11 @@ type QueryInput struct { // that a document must satisfy to be included in the query results. AttributeFilter *AttributeFilter `type:"structure"` + // Provides configuration to determine how to group results by document attribute + // value, and how to display them (collapsed or expanded) under a designated + // primary document for each group. + CollapseConfiguration *CollapseConfiguration `type:"structure"` + // Overrides relevance tuning configurations of fields/attributes set at the // index level. // @@ -24335,6 +24639,18 @@ type QueryInput struct { // relevance that Amazon Kendra determines for the result. SortingConfiguration *SortingConfiguration `type:"structure"` + // Provides configuration information to determine how the results of a query + // are sorted. + // + // You can set upto 3 fields that Amazon Kendra should sort the results on, + // and specify whether the results should be sorted in ascending or descending + // order. The sort field quota can be increased. + // + // If you don't provide a sorting configuration, the results are sorted by the + // relevance that Amazon Kendra determines for the result. In the case of ties + // in sorting the results, the results are sorted by relevance. + SortingConfigurations []*SortingConfiguration `min:"1" type:"list"` + // Enables suggested spell corrections for queries. SpellCorrectionConfiguration *SpellCorrectionConfiguration `type:"structure"` @@ -24377,6 +24693,9 @@ func (s *QueryInput) Validate() error { if s.RequestedDocumentAttributes != nil && len(s.RequestedDocumentAttributes) < 1 { invalidParams.Add(request.NewErrParamMinLen("RequestedDocumentAttributes", 1)) } + if s.SortingConfigurations != nil && len(s.SortingConfigurations) < 1 { + invalidParams.Add(request.NewErrParamMinLen("SortingConfigurations", 1)) + } if s.VisitorId != nil && len(*s.VisitorId) < 1 { invalidParams.Add(request.NewErrParamMinLen("VisitorId", 1)) } @@ -24385,6 +24704,11 @@ func (s *QueryInput) Validate() error { invalidParams.AddNested("AttributeFilter", err.(request.ErrInvalidParams)) } } + if s.CollapseConfiguration != nil { + if err := s.CollapseConfiguration.Validate(); err != nil { + invalidParams.AddNested("CollapseConfiguration", err.(request.ErrInvalidParams)) + } + } if s.DocumentRelevanceOverrideConfigurations != nil { for i, v := range s.DocumentRelevanceOverrideConfigurations { if v == nil { @@ -24410,6 +24734,16 @@ func (s *QueryInput) Validate() error { invalidParams.AddNested("SortingConfiguration", err.(request.ErrInvalidParams)) } } + if s.SortingConfigurations != nil { + for i, v := range s.SortingConfigurations { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "SortingConfigurations", i), err.(request.ErrInvalidParams)) + } + } + } if s.SpellCorrectionConfiguration != nil { if err := s.SpellCorrectionConfiguration.Validate(); err != nil { invalidParams.AddNested("SpellCorrectionConfiguration", err.(request.ErrInvalidParams)) @@ -24433,6 +24767,12 @@ func (s *QueryInput) SetAttributeFilter(v *AttributeFilter) *QueryInput { return s } +// SetCollapseConfiguration sets the CollapseConfiguration field's value. +func (s *QueryInput) SetCollapseConfiguration(v *CollapseConfiguration) *QueryInput { + s.CollapseConfiguration = v + return s +} + // SetDocumentRelevanceOverrideConfigurations sets the DocumentRelevanceOverrideConfigurations field's value. func (s *QueryInput) SetDocumentRelevanceOverrideConfigurations(v []*DocumentRelevanceConfiguration) *QueryInput { s.DocumentRelevanceOverrideConfigurations = v @@ -24487,6 +24827,12 @@ func (s *QueryInput) SetSortingConfiguration(v *SortingConfiguration) *QueryInpu return s } +// SetSortingConfigurations sets the SortingConfigurations field's value. +func (s *QueryInput) SetSortingConfigurations(v []*SortingConfiguration) *QueryInput { + s.SortingConfigurations = v + return s +} + // SetSpellCorrectionConfiguration sets the SpellCorrectionConfiguration field's value. func (s *QueryInput) SetSpellCorrectionConfiguration(v *SpellCorrectionConfiguration) *QueryInput { s.SpellCorrectionConfiguration = v @@ -24614,6 +24960,9 @@ type QueryResultItem struct { // One or more additional fields/attributes associated with the query result. AdditionalAttributes []*AdditionalResultAttribute `type:"list"` + // Provides details about a collapsed group of search results. + CollapsedResultDetail *CollapsedResultDetail `type:"structure"` + // An array of document fields/attributes assigned to a document in the search // results. For example, the document author (_author) or the source URI (_source_uri) // of the document. @@ -24688,6 +25037,12 @@ func (s *QueryResultItem) SetAdditionalAttributes(v []*AdditionalResultAttribute return s } +// SetCollapsedResultDetail sets the CollapsedResultDetail field's value. +func (s *QueryResultItem) SetCollapsedResultDetail(v *CollapsedResultDetail) *QueryResultItem { + s.CollapsedResultDetail = v + return s +} + // SetDocumentAttributes sets the DocumentAttributes field's value. func (s *QueryResultItem) SetDocumentAttributes(v []*DocumentAttribute) *QueryResultItem { s.DocumentAttributes = v @@ -30348,7 +30703,7 @@ type UpdateIndexInput struct { UserContextPolicy *string `type:"string" enum:"UserContextPolicy"` // Enables fetching access levels of groups and users from an IAM Identity Center - // (successor to Single Sign-On) identity source. To configure this, see UserGroupResolutionConfiguration + // identity source. To configure this, see UserGroupResolutionConfiguration // (https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html). UserGroupResolutionConfiguration *UserGroupResolutionConfiguration `type:"structure"` @@ -31140,10 +31495,9 @@ func (s *UserContext) SetUserId(v string) *UserContext { } // Provides the configuration information to get users and groups from an IAM -// Identity Center (successor to Single Sign-On) identity source. This is useful -// for user context filtering, where search results are filtered based on the -// user or their group access to documents. You can also use the PutPrincipalMapping -// (https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html) +// Identity Center identity source. This is useful for user context filtering, +// where search results are filtered based on the user or their group access +// to documents. You can also use the PutPrincipalMapping (https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html) // API to map users to their groups so that you only need to provide the user // ID when you issue the query. // @@ -31162,9 +31516,9 @@ type UserGroupResolutionConfiguration struct { _ struct{} `type:"structure"` // The identity store provider (mode) you want to use to get users and groups. - // IAM Identity Center (successor to Single Sign-On) is currently the only available - // mode. Your users and groups must exist in an IAM Identity Center identity - // source in order to use this mode. + // IAM Identity Center is currently the only available mode. Your users and + // groups must exist in an IAM Identity Center identity source in order to use + // this mode. // // UserGroupResolutionMode is a required field UserGroupResolutionMode *string `type:"string" required:"true" enum:"UserGroupResolutionMode"` @@ -32661,6 +33015,26 @@ func MetricType_Values() []string { } } +const ( + // MissingAttributeKeyStrategyIgnore is a MissingAttributeKeyStrategy enum value + MissingAttributeKeyStrategyIgnore = "IGNORE" + + // MissingAttributeKeyStrategyCollapse is a MissingAttributeKeyStrategy enum value + MissingAttributeKeyStrategyCollapse = "COLLAPSE" + + // MissingAttributeKeyStrategyExpand is a MissingAttributeKeyStrategy enum value + MissingAttributeKeyStrategyExpand = "EXPAND" +) + +// MissingAttributeKeyStrategy_Values returns all elements of the MissingAttributeKeyStrategy enum +func MissingAttributeKeyStrategy_Values() []string { + return []string{ + MissingAttributeKeyStrategyIgnore, + MissingAttributeKeyStrategyCollapse, + MissingAttributeKeyStrategyExpand, + } +} + const ( // ModeEnabled is a Mode enum value ModeEnabled = "ENABLED" diff --git a/service/rds/api.go b/service/rds/api.go index f602624a4eb..3b77ee83a5b 100644 --- a/service/rds/api.go +++ b/service/rds/api.go @@ -19024,6 +19024,9 @@ type CreateBlueGreenDeploymentInput struct { // from the one associated with the source DB cluster. TargetDBClusterParameterGroupName *string `min:"1" type:"string"` + // Specify the DB instance class for the databases in the green environment. + TargetDBInstanceClass *string `min:"5" type:"string"` + // The DB parameter group associated with the DB instance in the green environment. // // To test parameter changes, specify a DB parameter group that is different @@ -19034,6 +19037,12 @@ type CreateBlueGreenDeploymentInput struct { // // Specify the engine version to upgrade to in the green environment. TargetEngineVersion *string `min:"1" type:"string"` + + // Whether to upgrade the storage file system configuration on the green database. + // This option migrates the green DB instance from the older 32-bit file system + // to the preferred configuration. For more information, see Upgrading the storage + // file system for a DB instance (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.UpgradeFileSystem). + UpgradeTargetStorageConfig *bool `type:"boolean"` } // String returns the string representation. @@ -19072,6 +19081,9 @@ func (s *CreateBlueGreenDeploymentInput) Validate() error { if s.TargetDBClusterParameterGroupName != nil && len(*s.TargetDBClusterParameterGroupName) < 1 { invalidParams.Add(request.NewErrParamMinLen("TargetDBClusterParameterGroupName", 1)) } + if s.TargetDBInstanceClass != nil && len(*s.TargetDBInstanceClass) < 5 { + invalidParams.Add(request.NewErrParamMinLen("TargetDBInstanceClass", 5)) + } if s.TargetDBParameterGroupName != nil && len(*s.TargetDBParameterGroupName) < 1 { invalidParams.Add(request.NewErrParamMinLen("TargetDBParameterGroupName", 1)) } @@ -19109,6 +19121,12 @@ func (s *CreateBlueGreenDeploymentInput) SetTargetDBClusterParameterGroupName(v return s } +// SetTargetDBInstanceClass sets the TargetDBInstanceClass field's value. +func (s *CreateBlueGreenDeploymentInput) SetTargetDBInstanceClass(v string) *CreateBlueGreenDeploymentInput { + s.TargetDBInstanceClass = &v + return s +} + // SetTargetDBParameterGroupName sets the TargetDBParameterGroupName field's value. func (s *CreateBlueGreenDeploymentInput) SetTargetDBParameterGroupName(v string) *CreateBlueGreenDeploymentInput { s.TargetDBParameterGroupName = &v @@ -19121,6 +19139,12 @@ func (s *CreateBlueGreenDeploymentInput) SetTargetEngineVersion(v string) *Creat return s } +// SetUpgradeTargetStorageConfig sets the UpgradeTargetStorageConfig field's value. +func (s *CreateBlueGreenDeploymentInput) SetUpgradeTargetStorageConfig(v bool) *CreateBlueGreenDeploymentInput { + s.UpgradeTargetStorageConfig = &v + return s +} + type CreateBlueGreenDeploymentOutput struct { _ struct{} `type:"structure"` @@ -23345,6 +23369,11 @@ type CreateDBInstanceReadReplicaInput struct { // in the Amazon RDS User Guide. Tags []*Tag `locationNameList:"Tag" type:"list"` + // Whether to upgrade the storage file system configuration on the read replica. + // This option migrates the read replica from the old storage file system layout + // to the preferred layout. + UpgradeStorageConfig *bool `type:"boolean"` + // Specifies whether the DB instance class of the DB instance uses its default // processor features. // @@ -23648,6 +23677,12 @@ func (s *CreateDBInstanceReadReplicaInput) SetTags(v []*Tag) *CreateDBInstanceRe return s } +// SetUpgradeStorageConfig sets the UpgradeStorageConfig field's value. +func (s *CreateDBInstanceReadReplicaInput) SetUpgradeStorageConfig(v bool) *CreateDBInstanceReadReplicaInput { + s.UpgradeStorageConfig = &v + return s +} + // SetUseDefaultProcessorFeatures sets the UseDefaultProcessorFeatures field's value. func (s *CreateDBInstanceReadReplicaInput) SetUseDefaultProcessorFeatures(v bool) *CreateDBInstanceReadReplicaInput { s.UseDefaultProcessorFeatures = &v @@ -27596,6 +27631,13 @@ type DBInstance struct { // The Provisioned IOPS (I/O operations per second) value for the DB instance. Iops *int64 `type:"integer"` + // Indicates whether an upgrade is recommended for the storage file system configuration + // on the DB instance. To migrate to the preferred configuration, you can either + // create a blue/green deployment, or create a read replica from the DB instance. + // For more information, see Upgrading the storage file system for a DB instance + // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.UpgradeFileSystem). + IsStorageConfigUpgradeAvailable *bool `type:"boolean"` + // If StorageEncrypted is enabled, the Amazon Web Services KMS key identifier // for the encrypted DB instance. // @@ -28081,6 +28123,12 @@ func (s *DBInstance) SetIops(v int64) *DBInstance { return s } +// SetIsStorageConfigUpgradeAvailable sets the IsStorageConfigUpgradeAvailable field's value. +func (s *DBInstance) SetIsStorageConfigUpgradeAvailable(v bool) *DBInstance { + s.IsStorageConfigUpgradeAvailable = &v + return s +} + // SetKmsKeyId sets the KmsKeyId field's value. func (s *DBInstance) SetKmsKeyId(v string) *DBInstance { s.KmsKeyId = &v