/*WRITE ONLY BELOW THIS LINE*/ /*WRITE ONLY ABOVE THIS LINE*/ "use strict"; const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; const {useMDXComponents: _provideComponents} = arguments[0]; function _createMdxContent(props) { const _components = { code: "code", h1: "h1", p: "p", pre: "pre", ..._provideComponents(), ...props.components }, {CliCommandsApiReference} = _components; if (!CliCommandsApiReference) _missingMdxReference("CliCommandsApiReference", true); return _jsxs(_Fragment, { children: [_jsx(_components.h1, { id: "overview-and-basic-usage", children: "Overview and basic usage" }), "\n", _jsx(_components.p, { children: "Allows you to preview changes to the stack that would be made if you tried to update it using specified configuration." }), "\n", _jsx("br", {}), "\n", "\n", "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-bash", children: "stacktape preview-changes --stage <> --region <>\n" }) }), "\n", _jsx(_components.h1, { id: "api-reference", children: "API reference" }), "\n", _jsx(CliCommandsApiReference, { command: "preview-changes", sortedArgs: [{ description: "#### AWS region to use for the current operation.\n---\n", allowedTypes: ["string"], allowedValues: ["af-south-1", "ap-east-1", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "ap-south-1", "ap-southeast-1", "ap-southeast-2", "ca-central-1", "eu-central-1", "eu-north-1", "eu-south-1", "eu-west-1", "eu-west-2", "eu-west-3", "me-south-1", "sa-east-1", "us-east-1", "us-east-2", "us-west-1", "us-west-2"], alias: "r", required: true, name: "region", shortDescription: "

AWS region to use for the current operation.

\n", longDescription: "" }, { description: "#### Stage used for the operation.\n---\n- Example stages are `production`, `staging`, `testing` or `dev-john`.\n- You can configure the default stage used with every Stacktape command using the `defaults:configure` command.\n- Maximum allowed length is 12 characters.", allowedTypes: ["string"], alias: "s", required: true, name: "stage", shortDescription: "

Stage used for the operation.

\n", longDescription: "

Example stages are production, staging, testing or dev-john.
You can configure the default stage used with every Stacktape command using the defaults:configure command.
Maximum allowed length is 12 characters.

\n" }, { description: "#### Name of the AWS account used to perform the operation\n---\n- The account must be first connected in the [Stacktape console](https://console.stacktape.com/aws-accounts)", allowedTypes: ["string"], alias: "aa", required: false, name: "awsAccount", shortDescription: "

Name of the AWS account used to perform the operation

\n", longDescription: '

The account must be first connected in the Stacktape console

\n' }, { description: "#### Path to your stacktape configuration file.\n---\n- Relative to CWD (current working directory).", allowedTypes: ["string"], alias: "cp", required: false, name: "configPath", shortDescription: "

Path to your stacktape configuration file.

\n", longDescription: "

Relative to CWD (current working directory).

\n" }, { description: "#### Current working directory for the current operation.\n---\n- Every file path in your config will be resolved relatively to specified cwd.\n- By default, directory containing the configuration file is used.", allowedTypes: ["string"], alias: "cwd", required: false, name: "currentWorkingDirectory", shortDescription: "

Current working directory for the current operation.

\n", longDescription: "

Every file path in your config will be resolved relatively to specified cwd.
By default, directory containing the configuration file is used.

\n" }, { description: "#### Shows help for the command\n---\n- If specified, the command won't perform any action besides printing help.", allowedTypes: ["string"], alias: "h", required: false, name: "help", shortDescription: "

Shows help for the command

\n", longDescription: "

If specified, the command won't perform any action besides printing help.

\n" }, { description: "#### Format of logs printed to your console.\n---\nAvailable options:\n- `fancy`: Logs are colorized and dynamically re-rendered.\n- `normal`: Logs are colorized but not dynamically re-rendered.\n- `basic`: Simple text only\n- `json`: Logs are printed as JSON objects", allowedTypes: ["string"], allowedValues: ["basic", "fancy", "json", "normal"], alias: "lf", required: false, name: "logFormat", shortDescription: "

Format of logs printed to your console.

\n", longDescription: "

Available options:

fancy: Logs are colorized and dynamically re-rendered.
normal: Logs are colorized but not dynamically re-rendered.
basic: Simple text only
json: Logs are printed as JSON objects

\n" }, { description: "#### Level of logs that are being printed to the console.\n---\nAvailable options:\n- `info`: Prints basic information about everything that's happening.\n- `error`: Prints only errors.\n- `debug`: Prints detailed information about everything that's happening.", allowedTypes: ["string"], allowedValues: ["debug", "error", "info"], alias: "ll", required: false, name: "logLevel", shortDescription: "

Level of logs that are being printed to the console.

\n", longDescription: "

Available options:

info: Prints basic information about everything that's happening.
error: Prints only errors.
debug: Prints detailed information about everything that's happening.

\n" }, { description: "#### Preserves temporary files that stacktape generates using the operation.\n---\n- Temp folder includes CloudFormation template, packaged compute resources and other files.\n- By default, these changes are saved to `.stacktape/[invocation-id]`.\n- Temp folder location is also printed to the console.", allowedTypes: ["boolean"], alias: "ptf", required: false, name: "preserveTempFiles", shortDescription: "

Preserves temporary files that stacktape generates using the operation.

\n", longDescription: "

Temp folder includes CloudFormation template, packaged compute resources and other files.
By default, these changes are saved to .stacktape/[invocation-id].
Temp folder location is also printed to the console.

\n" }, { description: "#### AWS profile to use with the command\n---\n- You can manage AWS profiles on your system using `aws-profile:create`, `aws-profile:update` or `aws-profile:delete` command.\n- You can configure the default profile used with every Stacktape command using the `defaults:configure` command.", allowedTypes: ["string"], alias: "p", required: false, name: "profile", shortDescription: "

AWS profile to use with the command

\n", longDescription: "

You can manage AWS profiles on your system using aws-profile:create, aws-profile:update or aws-profile:delete command.
You can configure the default profile used with every Stacktape command using the defaults:configure command.

\n" }, { description: "#### Name of the Stacktape project relevant for this operation", allowedTypes: ["string"], alias: "prj", required: false, name: "projectName", shortDescription: "

Name of the Stacktape project relevant for this operation

\n" }, { description: "#### Id of the template to download\n---\n- The list of available templates is available on the [Config builder page](https://console.stacktape.com/templates)", allowedTypes: ["string"], alias: "ti", required: false, name: "templateId", shortDescription: "

Id of the template to download

\n", longDescription: '

The list of available templates is available on the Config builder page

\n' }] })] }); } function MDXContent(props = {}) { const {wrapper: MDXLayout} = { ..._provideComponents(), ...props.components }; return MDXLayout ? _jsx(MDXLayout, { ...props, children: _jsx(_createMdxContent, { ...props }) }) : _createMdxContent(props); } return { default: MDXContent }; function _missingMdxReference(id, component) { throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it."); }