feat(python): add amazon-verified-permissions-rest-api example

[satyatulasijalandharch]

Creating a REST API Gateway with Amazon Verified Permissions for fine-grained authorization

This example deploys a REST API secured by Amazon Verified Permissions (AVP) and Amazon Cognito. The stack demonstrates how to combine a Cedar policy store with an API Gateway Request Authorizer so that only members of the appropriate Cognito group can invoke protected routes.

---

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

[Copilot]

Pull request overview

This pull request adds a comprehensive example demonstrating how to create a REST API Gateway secured with Amazon Verified Permissions (AVP) and Amazon Cognito for fine-grained authorization using Cedar policies.

Key changes:

• Implements a complete CDK Python stack with nested stacks for Cognito, Verified Permissions, and API Gateway
• Provides a Node.js Lambda authorizer that integrates with AVP's isAuthorizedWithToken API
• Includes demo Python Lambda handlers for protected endpoints
• Adds comprehensive documentation covering architecture, deployment, and operations

Reviewed changes

Copilot reviewed 23 out of 26 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
app.py	CDK application entry point
stack/main.py	Root stack orchestrating nested stacks
stack/verified_permissions/	Cedar schema and policy definitions
stack/cognito/main.py	Cognito user pool with admin/user groups
stack/apigw/	REST API configuration with custom authorizer
stack/lambdas/authorizer/main.js	Node.js authorizer calling AVP
stack/lambdas/{user,admin}/main.py	Demo business logic handlers
docs/	Architecture diagrams and implementation guides
README.md	Quick start and project overview

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.