aws-cdk 2.1114.1 → 2.1115.0

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

@@ -101,6 +101,11 @@ export declare class CdkToolkit {
     cliTelemetryStatus(args: any): Promise<void>;
     cliTelemetry(enable: boolean): Promise<void>;
     diff(options: DiffOptions): Promise<number>;
+    /**
+     * Try to create a diff changeset for the given stack.
+     * Returns undefined if the stack cannot be accessed and changeSetOnly is not set.
+     */
+    private tryCreateDiffChangeSet;
     deploy(options: DeployOptions): Promise<void>;
     /**
      * Detect infrastructure drift for the given stack(s)
@@ -239,11 +244,14 @@ export interface DiffOptions {
         [name: string]: string | undefined;
     };
     /**
-     * Whether or not to create, analyze, and subsequently delete a changeset
+     * How to compute the diff.
+     * - 'change-set': always use a changeset, fail if it cannot be created
+     * - 'template': skip changeset, compare templates directly
+     * - 'auto': try changeset, fall back to template on failure
      *
-     * @default true
+     * @default 'auto'
      */
-    readonly changeSet?: boolean;
+    readonly method?: 'auto' | 'change-set' | 'template';
     /**
      * Whether or not the change set imports resources that already exist.
      *
@@ -272,21 +280,6 @@ interface CfnDeployOptions {
      * Role to pass to CloudFormation for deployment
      */
     roleArn?: string;
-    /**
-     * Optional name to use for the CloudFormation change set.
-     * If not provided, a name will be generated automatically.
-     *
-     * @deprecated Use 'deploymentMethod' instead
-     */
-    changeSetName?: string;
-    /**
-     * Whether to execute the ChangeSet
-     * Not providing `execute` parameter will result in execution of ChangeSet
-     *
-     * @default true
-     * @deprecated Use 'deploymentMethod' instead
-     */
-    execute?: boolean;
     /**
      * Deployment method
      */