aws-cdk.custom-resources
Constructs for implementing CDK custom resources
Decision gist · record as of 2026-08-14
No — do not install for new projects. This package is end-of-support (AWS CDK v1 reached end-of-support 2023-06-01) and users are explicitly directed to migrate to AWS CDK v2. Only use if maintaining an existing CDK v1 codebase with no migration path; otherwise, adopt the v2 equivalent to receive updates and security patches.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires AWS CDK v1 runtime environment; package is end-of-support as of 2023-06-01 and migration to AWS CDK v2 is recommended.
- Low install friction with 11 runtime dependencies.
- Package is in active maintenance but marked as inactive (Development Status 7) — AWS CDK v1 reached end-of-support on 2023-06-01 and users are advised to migrate to AWS CDK v2.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions beyond attribution and liability disclaimers.
last release 2023-06-19 (1152 days) · last repo commit 2026-08-14 · 12,868 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 155,328 downloads/mo, #10,824 on PyPI
Alternatives
Verify before relying
from aws_cdk import custom_resources as cr
from aws_cdk import aws_lambda as lambda_
from aws_cdk import aws_iam as iam
from aws_cdk import aws_logs as logs
provider = cr.Provider(self, "MyProvider",
on_event_handler=on_event_function,
is_complete_handler=is_complete_function,
log_retention=logs.RetentionDays.ONE_DAY,
role=my_role
)- Whether AWS CDK v2 has a direct replacement for this custom resources module or if migration requires architectural changes.
- Performance characteristics and timeout limits for asynchronous handlers under typical workloads.
- Security implications of Step Functions execution history exposure mentioned in the description for your threat model.
What it is and what it does
This package provides a Provider construct that acts as a mini-framework for building AWS CloudFormation custom resources within AWS CDK. It wraps Lambda functions as handlers for CloudFormation lifecycle events (Create, Update, Delete), managing the request/response protocol, error handling, and response submission back to CloudFormation. The framework supports both synchronous handlers (onEvent) that complete immediately and asynchronous handlers (isComplete) that poll until a resource reaches a stable state, useful for operations exceeding Lambda's timeout window.
The package depends on aws-cdk.core, aws-cdk.aws-lambda, aws-cdk.aws-iam, aws-cdk.aws-logs, and several other CDK modules to construct and manage the underlying infrastructure. However, it is important to note that AWS CDK v1 reached end-of-support on 2023-06-01, and this package is no longer being updated. Users should plan migration to AWS CDK v2 rather than starting new projects with this version.
Use it for
- Implement a custom CloudFormation resource that provisions third-party infrastructure not natively supported by CloudFormation.
- Create a long-running provisioning operation (e.g., database initialization) that requires polling until completion rather than immediate return.
- Build a wrapper around an external API to make it deployable as a CloudFormation custom resource within CDK stacks.
- Handle resource lifecycle events (creation, updates, deletion) with custom business logic before or after standard AWS operations.
- Validate and transform resource properties during CloudFormation deployment using Lambda-based custom logic.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No — do not install for new projects.
This package is end-of-support (AWS CDK v1 reached end-of-support 2023-06-01) and users are explicitly directed to migrate to AWS CDK v2. Only use if maintaining an existing CDK v1 codebase with no migration path; otherwise, adopt the v2 equivalent to receive updates and security patches.
Install
aws-cdk-custom-resources on PyPI
Before you install
Low install friction with 11 runtime dependencies. Package is in active maintenance but marked as inactive (Development Status 7) — AWS CDK v1 reached end-of-support on 2023-06-01 and users are advised to migrate to AWS CDK v2.
Requires AWS CDK v1 runtime environment; package is end-of-support as of 2023-06-01 and migration to AWS CDK v2 is recommended.
License in practice
Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions beyond attribution and liability disclaimers.
Quickstart
from aws_cdk import custom_resources as cr
from aws_cdk import aws_lambda as lambda_
from aws_cdk import aws_iam as iam
from aws_cdk import aws_logs as logs
provider = cr.Provider(self, "MyProvider",
on_event_handler=on_event_function,
is_complete_handler=is_complete_function,
log_retention=logs.RetentionDays.ONE_DAY,
role=my_role
)Verify before relying
- Whether AWS CDK v2 has a direct replacement for this custom resources module or if migration requires architectural changes.
- Performance characteristics and timeout limits for asynchronous handlers under typical workloads.
- Security implications of Step Functions execution history exposure mentioned in the description for your threat model.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release ~=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 11 packagesaws-cdk.aws-cloudformationaws-cdk.aws-ec2aws-cdk.aws-iamaws-cdk.aws-lambdaaws-cdk.aws-logsaws-cdk.aws-snsaws-cdk.coreconstructsjsiipublicationtypeguard |
| Maintenance | Actively maintained 1,152 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 155,328 / month, #10,824 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 7 - InactiveFramework :: AWS CDKFramework :: AWS CDK :: 1Intended Audience :: DevelopersLicense :: OSI ApprovedOperating System :: OS IndependentProgramming Language :: JavaScriptProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Typing :: Typed |
Evidence: aws_cdk.custom_resources-1.204.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “cloudformation custom resources”
- aws-cdk.custom-resourcesProvides a framework for implementing AWS CloudFormation custom…
- crhelperSimplifies writing CloudFormation custom resources by handling…
- cfnresponseSends response objects to AWS CloudFormation custom resources via S3…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also crhelper · aws-cdk.aws-cloudformation · aws-cdk.core · aws-cdk.aws-imagebuilder · cloudformation-cli · aws-cdk-lib · aws-cdk.aws-autoscaling-hooktargets · aws-cdk.aws-sam · aws-cdk.aws-lambda · cdktf-cdktf-provider-aws