s3api documentation for retrieving paginated results from list-object-versions is incorrect

[holtzinger]

When trying to retrieve paginated results for a listing of object versions, the official documentation shows that one should use the --starting-token option, however, I later discovered that the correct command is of the form aws s3api list-object-versions --bucket 'bucket' --key 'key' --version-id 'version'.

The option --version-id is nowhere to be found on the documentation page. I would recommend that the documentation be updated to include all current options, as well as including an example of retrieving subsequent pages of results from a paginated set.

[jamesls]

What's going on here is that the CLI will automatically paginate results for you when possible. By default you don't have to specify and pagination params. To normalize the pagination parameters used across various AWS services, it adds a --starting-token argument and hides all the other parameters controlling pagination. In the case of list-object-versions, this corresponds to --key-marker and --version-id-marker. We still support those parameters for backwards compatibility, but we encourage customers to use the --starting-token parameter.

Is --starting-token not working for you? You should be to take the output of NextToken in a response and feed it directly into the value for --starting-token. If you could share a code sample, we could help troubleshoot what's going wrong.

[jamesls]

Closing due to inactivity. We'd be happy to take another look if you provide the requested information.