docs(custom-resource): add example for AwsApiCall

[ymhiroki]

There weren't any examples for AwsApiCall in the document other than the Overview.
This commit adds examples to the document of AwsApiCall and it helps users understand the usage.

---

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

[rix0rrr]

Hey, thanks for this!

I was confused about how a user chooses between v2 and v3 on the custom resource, but I see from the README that it's done by registering a special fact. That information is missing here, which might be a bit confusing.

But I think we might change something about this construct anyway, so let's hold off on this change a little until we've settled on how it works.

[rix0rrr]

Okay yeah, the v3 documentation is out of date. See the following PR: #26631

Pull request has been modified.

[ymhiroki]

@rix0rrr Thanks for your comments!
I updated the PR to use only SDKv3. How about it?

[rix0rrr]

I updated the PR to use only SDKv3. How about it?

I meant the other way around. It should all be only SDKv2-style strings.

[rix0rrr]

I meant the other way around. It should all be only SDKv2-style strings.

Pull request has been modified.

[ymhiroki]

I see. I fixed it.

[rix0rrr]

Thanks!

[mergify]

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

[aws-cdk-automation]

AWS CodeBuild CI Report

• CodeBuild project: AutoBuildv2Project1C6BFA3F-wQm2hXv2jqQv
• Commit ID: e89c2c3
• Result: SUCCEEDED
• Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

[mergify]

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).