aws-doc-sdk-examples icon indicating copy to clipboard operation
aws-doc-sdk-examples copied to clipboard

[Enhancement]: <add, update PHP SES examples>

Open tkhill-AWS opened this issue 2 years ago • 1 comments

Background story

There are two SES APIs and two clients for the PHP SDK (and other SDKs). Customers either don't know there are two clients for PHP or confused about it, since we only have V1 examples that are shown in the guided section of the PHP Dev. Guide.

We should update the existing v1 examples to use the v2 client where possible and add new V2 examples to cover new (or equivalient [but handled differently]) functionality.

SES - changes.xlsx

The new/updated examples should also be added to SOS.

What does this example accomplish?

Raises awareness to clients that there are two APIs and shows examples for the V2 API.

Which AWS service(s)?

SES

Which AWS SDKs or tools?

  • [ ] All languages
  • [ ] .NET
  • [ ] C++
  • [ ] Go (v2)
  • [ ] Java
  • [ ] Java (v2)
  • [ ] JavaScript
  • [ ] JavaScript (v3)
  • [ ] Kotlin
  • [X] PHP
  • [ ] Python
  • [ ] Ruby
  • [ ] Rust
  • [ ] Swift
  • [ ] Not applicable

Are there existing code examples to leverage?

Yes, see, the spreadsheet attached that lists existing code examples to be modified.

Do you have any reference code?

No.

tkhill-AWS avatar Jun 16 '23 17:06 tkhill-AWS

PHP SDK SES user here. My SES integration would have happened more quickly if the examples referenced the V2 client. Specifically I was confused about how to use the V1 client to get the verification status of users' email addresses. The ListVerifiedEmailAddresses method is deprecated and advises using ListIdentities instead. But ListIdentities doesn't return the verification status! The ListEmailIdentities method of the V2 client returns this information straight away.

deang avatar Dec 14 '23 19:12 deang