DynamoDB Client delete_item has incorrect request syntax

[tylerapplebaum]

Describe the issue

The Request Syntax shows these ReturnValues:

ReturnValues='NONE'|'ALL_OLD'|'UPDATED_OLD'|'ALL_NEW'|'UPDATED_NEW',

This is not true. If I attempt to return UPDATED_NEW, I receive this error:

[ERROR] ClientError: An error occurred (ValidationException) when calling the DeleteItem operation: ReturnValues can only be ALL_OLD or NONE

The correct return value options are: ALL_OLD or NONE.

Links

https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/client/delete_item.html

[RyanFitzSimmonsAK]

Hi @tylerapplebaum, thanks for reaching out. This behavior is documented.

The ReturnValues parameter is used by several DynamoDB operations; however, DeleteItem does not recognize any values other than NONE or ALL_OLD.

However, I understand why it'd be misleading for the request syntax to reflect all possible values. This happens because the ReturnValues enum is used in multiple places in the DynamoDB model file. I've reached out to the DynamoDB about possibly fixing this, but given how thoroughly this is documented, I suspect this is a purposeful design decision that they'd hesitate to change. I'll let you know when I hear back. Thanks!

Ticket # for internal use : P170246187