docs: update invoke_api argument documentation

[cokerrd]

Rollback Plan

If a change needs to be reverted, we will publish an updated version of the library.

Changes to Security Controls

No changes to security controls.

Description

Updates invoke_api block documentation to correct argument descriptions and defaults.

• Clarified api_id description
• Corrected stage description from duplicate "Action to invoke a stage" to "Name of the target stage"
• Changed strip_base_path from (Required) to (Optional) with default value of false

Relations

Closes #49160

References

• Cloudformation - Descriptions are present for the InvokeApi properties in the cloudformation documentation
• construct hub - Shows the default value for the strip_base_path property

Output from Acceptance Testing

Not applicable. Only documentation is updated.

[github-actions]

Community Guidelines

This comment is added to every new Pull Request to provide quick reference to how the Terraform AWS Provider is maintained. Please review the information below, and thank you for contributing to the community that keeps the provider thriving! 🚀

Voting for Prioritization

• Please vote on this Pull Request by adding a 👍 reaction to the original post to help the community and maintainers prioritize it.
• Please see our prioritization guide for additional information on how the maintainers handle prioritization.
• Please do not leave +1 or other comments that do not add relevant new information or questions; they generate extra noise for others following the Pull Request and do not help prioritize the request.

Pull Request Authors

• Review the contribution guide relating to the type of change you are making to ensure all of the necessary steps have been taken.
• Whether or not the branch has been rebased will not impact prioritization, but doing so is always a welcome surprise.