aws-cdk 2.1015.0 → 2.1016.0

package/README.md

@@ -189,6 +189,23 @@ The `change-set` flag will make `diff` create a change set and extract resource
 The `--no-change-set` mode will consider any change to a property that requires replacement to be a resource replacement,
 even if the change is purely cosmetic (like replacing a resource reference with a hardcoded arn).
 
+The `--import-existing-resources` option will make `diff` create a change set and compare it using
+the CloudFormation resource import mechanism. This allows CDK to detect changes and show report of resources that
+will be imported rather added. Use this flag when preparing to import existing resources into a CDK stack to
+ensure and validate the changes are correctly reflected by showing 'import'.
+
+```console
+$ cdk diff
+[+] AWS::DynamoDB::GlobalTable MyGlobalTable MyGlobalTable5DC12DB4
+
+$ cdk diff --import-existing-resources
+[←] AWS::DynamoDB::GlobalTable MyGlobalTable MyGlobalTable5DC12DB4 import
+```
+
+In the output above:
+[+] indicates a new resource that would be created.
+[←] indicates a resource that would be imported into the stack instead.
+
 ### `cdk deploy`
 
 Deploys a stack of your CDK app to its environment. During the deployment, the toolkit will output progress

package/build-info.json

@@ -1,4 +1,4 @@
 {
-  "comment": "Generated at 2025-05-14T12:10:00Z by generate.sh",
-  "commit": "d50f212"
+  "comment": "Generated at 2025-05-16T08:27:37Z by generate.sh",
+  "commit": "66e0b2d"
 }

package/lib/cli/cdk-toolkit.d.ts

@@ -227,6 +227,12 @@ export interface DiffOptions {
      * @default true
      */
     readonly changeSet?: boolean;
+    /**
+     * Whether or not the change set imports resources that already exist.
+     *
+     * @default false
+     */
+    readonly importExistingResources?: boolean;
 }
 interface CfnDeployOptions {
     /**