transactGetItems Javadoc is incorrect

[tkhill-AWS]

Describe the issue

Both transactGetItems() methods start out with:

Retrieves multiple items from one or more tables in a single atomic transaction. TransactGetItem is a composite operation where the request contains a set of up to 25 get requests, each containing a table reference and a GetItemEnhancedRequest. ...

A) I'm not sure if the max. of 25 requests is accurate since the DDB Dev. Guide say states:

TransactGetItems API
TransactGetItems is a synchronous read operation that groups up to 100 Get actions together. These actions can target up to 100 distinct items in one or more DynamoDB tables within the same AWS account and Region. The aggregate size of the items in the transaction can't exceed 4 MB.

B) This part of the Javadoc description also isn't quite accurate:

each containing a table reference and a GetItemEnhancedRequest.

The Javadoc for TransactGetItemsEnhancedRequest.Builder shows 3 possibilities for the 2nd parameter.

Links

https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/DynamoDbEnhancedClient.html#transactGetItems(java.util.function.Consumer)

https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/DynamoDbEnhancedClient.html#transactGetItems(software.amazon.awssdk.enhanced.dynamodb.model.TransactGetItemsEnhancedRequest)

[debora-ito]

@tkhill-AWS thanks Todd, I just repro this with transactWriteItems, the limit is 100, not 25.

We'll fix the wording.

[debora-ito]

Addressed by #4031.

[github-actions]

⚠️COMMENT VISIBILITY WARNING⚠️

Comments on closed issues are hard for our team to see.
If you need more assistance, please open a new issue that references this one.
If you wish to keep having a conversation with other community members under this issue feel free to do so.