Polly's put_lexicon() example does not work

[kumatheworld]

Describe the issue

The following example in the documentation does not work as it specifies the file path as Content:

response = client.put_lexicon(
    Content='file://example.pls',
    Name='W3C',
)

Instead, the file content should be specified as written in the documentation:

with open("example.pls") as file:
    content = file.read()

client.put_lexicon(Name="W3C", Content=content)

Links

https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/polly/client/put_lexicon.html

[RyanFitzSimmonsAK]

Hi @kumatheworld, thanks for reaching out. You're correct that this example is flawed; it uses AWS CLI-specific formatting, and should instead reflect that Content accepts a string, not a file. However, because this documentation is generated from the model file for multiple SDKs, we can't use the Python-specific example from the user guide. I've reached out to the service team to address this issue, and will let you know when I have any updates.

Ticket # for internal use : P159140618

[github-actions]

This issue is now closed. 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.

[RyanFitzSimmonsAK]

The service team made a change to the model file to reflect this, and the Boto3 team made a PR to adjust this example. Thanks for raising this issue!