feat(apigateway): add grantExecute to API Methods

[otaviomacedo]

To grant permission to a user:

const books = api.root.addResource('books');
books.grantExecute(user);

Closes #5198.

---

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

[gitpod-io]

[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: a04d673
• 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).

[florianbepunkt]

@otaviomacedo Has this been reverted? I'm on cdk v 2.88.0 (build 5d497f9) and for your example above I get Property 'grantExecute' does not exist on type 'Resource'.ts(2339)

EDIT: Never mind. Example was incomplete. The methods exists on the Method construct (not the Resource). Full example is:

const books = api.root.addResource("books");
const method = books.addMethod("POST", {....})
method.grantExecute(user);