fix(stepfunctions-tasks): allow passing apiEndpoint as intrinsic function

[MathieuGilbert]

Closes #29925, #30749

Reason for this change

The apiEndpoint prop currently only works when it's a string (ie. TaskInput.fromText('some/text')), with the task failing when passed as a reference (ie. TaskInput.fromText(JsonPath.format('some/text/{}', '123')). This is needed to allow for dynamic parts in the path.

Description of changes

• Use the JsonPath.format intrinsic function to combine the apiRoot and apiEndpoint instead of string concatenation.
• Add unit and integration tests to cover passing formatted input.
• Update (and fix) README entry's usage example.
• Add AWS::ApiGateway::Deployment to the IntegTest's allowDestroy prop, as updating the integration test led to this build error:

Failed: /codebuild/output/src2296678373/src/github.com/aws/aws-cdk/packages/@aws-cdk-testing/framework-integ/test/aws-stepfunctions-tasks/test/http/integ.invoke.js
!!! This test contains destructive changes !!!
    Stack: aws-stepfunctions-tasks-http-invoke-integ - Resource: IntegRestApiDeploymentD67E59EC852098a1c127ca9d7d16d22086273910 - Impact: WILL_DESTROY
!!! If these destructive changes are necessary, please indicate this on the PR !!!

Description of how you validated changes

• Unit and integration test cases were added.
• Proved out by copying the construct to an existing app, with a stack similar to what's in the integration test, and invoking via console.

Checklist

• My code adheres to the CONTRIBUTING GUIDE and DESIGN GUIDELINES

---

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

[aws-cdk-automation]

The pull request linter has failed. See the aws-cdk-automation comment below for failure reasons. If you believe this pull request should receive an exemption, please comment and provide a justification.

A comment requesting an exemption should contain the text Exemption Request. Additionally, if clarification is needed add Clarification Request to a comment.

✅ Updated pull request passes all PRLinter validations. Dismissing previous PRLinter review.

[MathieuGilbert]

Clarification Request
How do I get CI to accept the updated integration test and snapshot?

[aws-cdk-automation]

AWS CodeBuild CI Report

• CodeBuild project: AutoBuildv2Project1C6BFA3F-wQm2hXv2jqQv
• Commit ID: 54e62bf
• Result: FAILED
• Build Logs (available for 30 days)

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

[aws-cdk-automation]

This PR has been in the BUILD FAILING state for 3 weeks, and looks abandoned. To keep this PR from being closed, please continue work on it. If not, it will automatically be closed in a week.

[eliasericsson]

@MathieuGilbert Have you gotten any notice on how to get the build to pass? This PR is relevant to my interests. Good work!

[MathieuGilbert]

Thanks @eliasericsson, but no updates yet. I tried opening a discussion question, but no response there either. I'm not sure how to get some actual help 🤷

[aws-cdk-automation]

This PR has been deemed to be abandoned, and will be automatically closed. Please create a new PR for these changes if you think this decision has been made in error.

[github-actions]

Comments on closed issues and PRs are hard for our team to see.
If you need help, please open a new issue that references this one.