@gammarers/aws-rds-database-auto-running-protection-stack
Version:
This construct is aws rds database or cluster auto running to stop.
1,041 lines (656 loc) • 64.5 kB
Markdown
# API Reference <a name="API Reference" id="api-reference"></a>
## Constructs <a name="Constructs" id="Constructs"></a>
### RDSDatabaseAutoRunningProtectionStack <a name="RDSDatabaseAutoRunningProtectionStack" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack"></a>
#### Initializers <a name="Initializers" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.Initializer"></a>
```typescript
import { RDSDatabaseAutoRunningProtectionStack } from '@gammarers/aws-rds-database-auto-running-protection-stack'
new RDSDatabaseAutoRunningProtectionStack(scope: Construct, id: string, props: RDSDatabaseAutoRunningProtectionStackProps)
```
| **Name** | **Type** | **Description** |
| --- | --- | --- |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.Initializer.parameter.scope">scope</a></code> | <code>constructs.Construct</code> | *No description.* |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.Initializer.parameter.id">id</a></code> | <code>string</code> | *No description.* |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.Initializer.parameter.props">props</a></code> | <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps">RDSDatabaseAutoRunningProtectionStackProps</a></code> | *No description.* |
---
##### `scope`<sup>Required</sup> <a name="scope" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.Initializer.parameter.scope"></a>
- *Type:* constructs.Construct
---
##### `id`<sup>Required</sup> <a name="id" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.Initializer.parameter.id"></a>
- *Type:* string
---
##### `props`<sup>Required</sup> <a name="props" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.Initializer.parameter.props"></a>
- *Type:* <a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps">RDSDatabaseAutoRunningProtectionStackProps</a>
---
#### Methods <a name="Methods" id="Methods"></a>
| **Name** | **Description** |
| --- | --- |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.toString">toString</a></code> | Returns a string representation of this construct. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.addDependency">addDependency</a></code> | Add a dependency between this stack and another stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.addMetadata">addMetadata</a></code> | Adds an arbitary key-value pair, with information you want to record about the stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.addTransform">addTransform</a></code> | Add a Transform to this stack. A Transform is a macro that AWS CloudFormation uses to process your template. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.exportStringListValue">exportStringListValue</a></code> | Create a CloudFormation Export for a string list value. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.exportValue">exportValue</a></code> | Create a CloudFormation Export for a string value. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.formatArn">formatArn</a></code> | Creates an ARN from components. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.getLogicalId">getLogicalId</a></code> | Allocates a stack-unique CloudFormation-compatible logical identity for a specific resource. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.regionalFact">regionalFact</a></code> | Look up a fact value for the given fact for the region of this stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.renameLogicalId">renameLogicalId</a></code> | Rename a generated logical identities. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.reportMissingContextKey">reportMissingContextKey</a></code> | Indicate that a context key was expected. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.resolve">resolve</a></code> | Resolve a tokenized value in the context of the current stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.splitArn">splitArn</a></code> | Splits the provided ARN into its components. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.toJsonString">toJsonString</a></code> | Convert an object, potentially containing tokens, to a JSON string. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.toYamlString">toYamlString</a></code> | Convert an object, potentially containing tokens, to a YAML string. |
---
##### `toString` <a name="toString" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.toString"></a>
```typescript
public toString(): string
```
Returns a string representation of this construct.
##### `addDependency` <a name="addDependency" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.addDependency"></a>
```typescript
public addDependency(target: Stack, reason?: string): void
```
Add a dependency between this stack and another stack.
This can be used to define dependencies between any two stacks within an
app, and also supports nested stacks.
###### `target`<sup>Required</sup> <a name="target" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.addDependency.parameter.target"></a>
- *Type:* aws-cdk-lib.Stack
---
###### `reason`<sup>Optional</sup> <a name="reason" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.addDependency.parameter.reason"></a>
- *Type:* string
---
##### `addMetadata` <a name="addMetadata" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.addMetadata"></a>
```typescript
public addMetadata(key: string, value: any): void
```
Adds an arbitary key-value pair, with information you want to record about the stack.
These get translated to the Metadata section of the generated template.
> [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html)
###### `key`<sup>Required</sup> <a name="key" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.addMetadata.parameter.key"></a>
- *Type:* string
---
###### `value`<sup>Required</sup> <a name="value" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.addMetadata.parameter.value"></a>
- *Type:* any
---
##### `addTransform` <a name="addTransform" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.addTransform"></a>
```typescript
public addTransform(transform: string): void
```
Add a Transform to this stack. A Transform is a macro that AWS CloudFormation uses to process your template.
Duplicate values are removed when stack is synthesized.
> [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-section-structure.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-section-structure.html)
*Example*
```typescript
declare const stack: Stack;
stack.addTransform('AWS::Serverless-2016-10-31')
```
###### `transform`<sup>Required</sup> <a name="transform" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.addTransform.parameter.transform"></a>
- *Type:* string
The transform to add.
---
##### `exportStringListValue` <a name="exportStringListValue" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.exportStringListValue"></a>
```typescript
public exportStringListValue(exportedValue: any, options?: ExportValueOptions): string[]
```
Create a CloudFormation Export for a string list value.
Returns a string list representing the corresponding `Fn.importValue()`
expression for this Export. The export expression is automatically wrapped with an
`Fn::Join` and the import value with an `Fn::Split`, since CloudFormation can only
export strings. You can control the name for the export by passing the `name` option.
If you don't supply a value for `name`, the value you're exporting must be
a Resource attribute (for example: `bucket.bucketName`) and it will be
given the same name as the automatic cross-stack reference that would be created
if you used the attribute in another Stack.
One of the uses for this method is to *remove* the relationship between
two Stacks established by automatic cross-stack references. It will
temporarily ensure that the CloudFormation Export still exists while you
remove the reference from the consuming stack. After that, you can remove
the resource and the manual export.
See `exportValue` for an example of this process.
###### `exportedValue`<sup>Required</sup> <a name="exportedValue" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.exportStringListValue.parameter.exportedValue"></a>
- *Type:* any
---
###### `options`<sup>Optional</sup> <a name="options" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.exportStringListValue.parameter.options"></a>
- *Type:* aws-cdk-lib.ExportValueOptions
---
##### `exportValue` <a name="exportValue" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.exportValue"></a>
```typescript
public exportValue(exportedValue: any, options?: ExportValueOptions): string
```
Create a CloudFormation Export for a string value.
Returns a string representing the corresponding `Fn.importValue()`
expression for this Export. You can control the name for the export by
passing the `name` option.
If you don't supply a value for `name`, the value you're exporting must be
a Resource attribute (for example: `bucket.bucketName`) and it will be
given the same name as the automatic cross-stack reference that would be created
if you used the attribute in another Stack.
One of the uses for this method is to *remove* the relationship between
two Stacks established by automatic cross-stack references. It will
temporarily ensure that the CloudFormation Export still exists while you
remove the reference from the consuming stack. After that, you can remove
the resource and the manual export.
## Example
Here is how the process works. Let's say there are two stacks,
`producerStack` and `consumerStack`, and `producerStack` has a bucket
called `bucket`, which is referenced by `consumerStack` (perhaps because
an AWS Lambda Function writes into it, or something like that).
It is not safe to remove `producerStack.bucket` because as the bucket is being
deleted, `consumerStack` might still be using it.
Instead, the process takes two deployments:
### Deployment 1: break the relationship
- Make sure `consumerStack` no longer references `bucket.bucketName` (maybe the consumer
stack now uses its own bucket, or it writes to an AWS DynamoDB table, or maybe you just
remove the Lambda Function altogether).
- In the `ProducerStack` class, call `this.exportValue(this.bucket.bucketName)`. This
will make sure the CloudFormation Export continues to exist while the relationship
between the two stacks is being broken.
- Deploy (this will effectively only change the `consumerStack`, but it's safe to deploy both).
### Deployment 2: remove the bucket resource
- You are now free to remove the `bucket` resource from `producerStack`.
- Don't forget to remove the `exportValue()` call as well.
- Deploy again (this time only the `producerStack` will be changed -- the bucket will be deleted).
###### `exportedValue`<sup>Required</sup> <a name="exportedValue" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.exportValue.parameter.exportedValue"></a>
- *Type:* any
---
###### `options`<sup>Optional</sup> <a name="options" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.exportValue.parameter.options"></a>
- *Type:* aws-cdk-lib.ExportValueOptions
---
##### `formatArn` <a name="formatArn" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.formatArn"></a>
```typescript
public formatArn(components: ArnComponents): string
```
Creates an ARN from components.
If `partition`, `region` or `account` are not specified, the stack's
partition, region and account will be used.
If any component is the empty string, an empty string will be inserted
into the generated ARN at the location that component corresponds to.
The ARN will be formatted as follows:
arn:{partition}:{service}:{region}:{account}:{resource}{sep}{resource-name}
The required ARN pieces that are omitted will be taken from the stack that
the 'scope' is attached to. If all ARN pieces are supplied, the supplied scope
can be 'undefined'.
###### `components`<sup>Required</sup> <a name="components" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.formatArn.parameter.components"></a>
- *Type:* aws-cdk-lib.ArnComponents
---
##### `getLogicalId` <a name="getLogicalId" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.getLogicalId"></a>
```typescript
public getLogicalId(element: CfnElement): string
```
Allocates a stack-unique CloudFormation-compatible logical identity for a specific resource.
This method is called when a `CfnElement` is created and used to render the
initial logical identity of resources. Logical ID renames are applied at
this stage.
This method uses the protected method `allocateLogicalId` to render the
logical ID for an element. To modify the naming scheme, extend the `Stack`
class and override this method.
###### `element`<sup>Required</sup> <a name="element" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.getLogicalId.parameter.element"></a>
- *Type:* aws-cdk-lib.CfnElement
The CloudFormation element for which a logical identity is needed.
---
##### `regionalFact` <a name="regionalFact" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.regionalFact"></a>
```typescript
public regionalFact(factName: string, defaultValue?: string): string
```
Look up a fact value for the given fact for the region of this stack.
Will return a definite value only if the region of the current stack is resolved.
If not, a lookup map will be added to the stack and the lookup will be done at
CDK deployment time.
What regions will be included in the lookup map is controlled by the
`@aws-cdk/core:target-partitions` context value: it must be set to a list
of partitions, and only regions from the given partitions will be included.
If no such context key is set, all regions will be included.
This function is intended to be used by construct library authors. Application
builders can rely on the abstractions offered by construct libraries and do
not have to worry about regional facts.
If `defaultValue` is not given, it is an error if the fact is unknown for
the given region.
###### `factName`<sup>Required</sup> <a name="factName" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.regionalFact.parameter.factName"></a>
- *Type:* string
---
###### `defaultValue`<sup>Optional</sup> <a name="defaultValue" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.regionalFact.parameter.defaultValue"></a>
- *Type:* string
---
##### `renameLogicalId` <a name="renameLogicalId" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.renameLogicalId"></a>
```typescript
public renameLogicalId(oldId: string, newId: string): void
```
Rename a generated logical identities.
To modify the naming scheme strategy, extend the `Stack` class and
override the `allocateLogicalId` method.
###### `oldId`<sup>Required</sup> <a name="oldId" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.renameLogicalId.parameter.oldId"></a>
- *Type:* string
---
###### `newId`<sup>Required</sup> <a name="newId" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.renameLogicalId.parameter.newId"></a>
- *Type:* string
---
##### `reportMissingContextKey` <a name="reportMissingContextKey" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.reportMissingContextKey"></a>
```typescript
public reportMissingContextKey(report: MissingContext): void
```
Indicate that a context key was expected.
Contains instructions which will be emitted into the cloud assembly on how
the key should be supplied.
###### `report`<sup>Required</sup> <a name="report" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.reportMissingContextKey.parameter.report"></a>
- *Type:* aws-cdk-lib.cloud_assembly_schema.MissingContext
The set of parameters needed to obtain the context.
---
##### `resolve` <a name="resolve" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.resolve"></a>
```typescript
public resolve(obj: any): any
```
Resolve a tokenized value in the context of the current stack.
###### `obj`<sup>Required</sup> <a name="obj" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.resolve.parameter.obj"></a>
- *Type:* any
---
##### `splitArn` <a name="splitArn" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.splitArn"></a>
```typescript
public splitArn(arn: string, arnFormat: ArnFormat): ArnComponents
```
Splits the provided ARN into its components.
Works both if 'arn' is a string like 'arn:aws:s3:::bucket',
and a Token representing a dynamic CloudFormation expression
(in which case the returned components will also be dynamic CloudFormation expressions,
encoded as Tokens).
###### `arn`<sup>Required</sup> <a name="arn" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.splitArn.parameter.arn"></a>
- *Type:* string
the ARN to split into its components.
---
###### `arnFormat`<sup>Required</sup> <a name="arnFormat" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.splitArn.parameter.arnFormat"></a>
- *Type:* aws-cdk-lib.ArnFormat
the expected format of 'arn' - depends on what format the service 'arn' represents uses.
---
##### `toJsonString` <a name="toJsonString" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.toJsonString"></a>
```typescript
public toJsonString(obj: any, space?: number): string
```
Convert an object, potentially containing tokens, to a JSON string.
###### `obj`<sup>Required</sup> <a name="obj" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.toJsonString.parameter.obj"></a>
- *Type:* any
---
###### `space`<sup>Optional</sup> <a name="space" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.toJsonString.parameter.space"></a>
- *Type:* number
---
##### `toYamlString` <a name="toYamlString" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.toYamlString"></a>
```typescript
public toYamlString(obj: any): string
```
Convert an object, potentially containing tokens, to a YAML string.
###### `obj`<sup>Required</sup> <a name="obj" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.toYamlString.parameter.obj"></a>
- *Type:* any
---
#### Static Functions <a name="Static Functions" id="Static Functions"></a>
| **Name** | **Description** |
| --- | --- |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.isConstruct">isConstruct</a></code> | Checks if `x` is a construct. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.isStack">isStack</a></code> | Return whether the given object is a Stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.of">of</a></code> | Looks up the first stack scope in which `construct` is defined. |
---
##### ~~`isConstruct`~~ <a name="isConstruct" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.isConstruct"></a>
```typescript
import { RDSDatabaseAutoRunningProtectionStack } from '@gammarers/aws-rds-database-auto-running-protection-stack'
RDSDatabaseAutoRunningProtectionStack.isConstruct(x: any)
```
Checks if `x` is a construct.
###### `x`<sup>Required</sup> <a name="x" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.isConstruct.parameter.x"></a>
- *Type:* any
Any object.
---
##### `isStack` <a name="isStack" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.isStack"></a>
```typescript
import { RDSDatabaseAutoRunningProtectionStack } from '@gammarers/aws-rds-database-auto-running-protection-stack'
RDSDatabaseAutoRunningProtectionStack.isStack(x: any)
```
Return whether the given object is a Stack.
We do attribute detection since we can't reliably use 'instanceof'.
###### `x`<sup>Required</sup> <a name="x" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.isStack.parameter.x"></a>
- *Type:* any
---
##### `of` <a name="of" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.of"></a>
```typescript
import { RDSDatabaseAutoRunningProtectionStack } from '@gammarers/aws-rds-database-auto-running-protection-stack'
RDSDatabaseAutoRunningProtectionStack.of(construct: IConstruct)
```
Looks up the first stack scope in which `construct` is defined.
Fails if there is no stack up the tree.
###### `construct`<sup>Required</sup> <a name="construct" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.of.parameter.construct"></a>
- *Type:* constructs.IConstruct
The construct to start the search from.
---
#### Properties <a name="Properties" id="Properties"></a>
| **Name** | **Type** | **Description** |
| --- | --- | --- |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.account">account</a></code> | <code>string</code> | The AWS account into which this stack will be deployed. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.artifactId">artifactId</a></code> | <code>string</code> | The ID of the cloud assembly artifact for this stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.availabilityZones">availabilityZones</a></code> | <code>string[]</code> | Returns the list of AZs that are available in the AWS environment (account/region) associated with this stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.bundlingRequired">bundlingRequired</a></code> | <code>boolean</code> | Indicates whether the stack requires bundling or not. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.dependencies">dependencies</a></code> | <code>aws-cdk-lib.Stack[]</code> | Return the stacks this stack depends on. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.environment">environment</a></code> | <code>string</code> | The environment coordinates in which this stack is deployed. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.nested">nested</a></code> | <code>boolean</code> | Indicates if this is a nested stack, in which case `parentStack` will include a reference to it's parent. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.notificationArns">notificationArns</a></code> | <code>string[]</code> | Returns the list of notification Amazon Resource Names (ARNs) for the current stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.partition">partition</a></code> | <code>string</code> | The partition in which this stack is defined. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.region">region</a></code> | <code>string</code> | The AWS region into which this stack will be deployed (e.g. `us-west-2`). |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.stackId">stackId</a></code> | <code>string</code> | The ID of the stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.stackName">stackName</a></code> | <code>string</code> | The concrete CloudFormation physical stack name. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.synthesizer">synthesizer</a></code> | <code>aws-cdk-lib.IStackSynthesizer</code> | Synthesis method for this stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.tags">tags</a></code> | <code>aws-cdk-lib.TagManager</code> | Tags to be applied to the stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.templateFile">templateFile</a></code> | <code>string</code> | The name of the CloudFormation template file emitted to the output directory during synthesis. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.templateOptions">templateOptions</a></code> | <code>aws-cdk-lib.ITemplateOptions</code> | Options for CloudFormation template (like version, transform, description). |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.urlSuffix">urlSuffix</a></code> | <code>string</code> | The Amazon domain suffix for the region in which this stack is defined. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.nestedStackParent">nestedStackParent</a></code> | <code>aws-cdk-lib.Stack</code> | If this is a nested stack, returns it's parent stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.nestedStackResource">nestedStackResource</a></code> | <code>aws-cdk-lib.CfnResource</code> | If this is a nested stack, this represents its `AWS::CloudFormation::Stack` resource. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.terminationProtection">terminationProtection</a></code> | <code>boolean</code> | Whether termination protection is enabled for this stack. |
---
##### `node`<sup>Required</sup> <a name="node" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.node"></a>
```typescript
public readonly node: Node;
```
- *Type:* constructs.Node
The tree node.
---
##### `account`<sup>Required</sup> <a name="account" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.account"></a>
```typescript
public readonly account: string;
```
- *Type:* string
The AWS account into which this stack will be deployed.
This value is resolved according to the following rules:
1. The value provided to `env.account` when the stack is defined. This can
either be a concrete account (e.g. `585695031111`) or the
`Aws.ACCOUNT_ID` token.
3. `Aws.ACCOUNT_ID`, which represents the CloudFormation intrinsic reference
`{ "Ref": "AWS::AccountId" }` encoded as a string token.
Preferably, you should use the return value as an opaque string and not
attempt to parse it to implement your logic. If you do, you must first
check that it is a concrete value an not an unresolved token. If this
value is an unresolved token (`Token.isUnresolved(stack.account)` returns
`true`), this implies that the user wishes that this stack will synthesize
into a **account-agnostic template**. In this case, your code should either
fail (throw an error, emit a synth error using `Annotations.of(construct).addError()`) or
implement some other region-agnostic behavior.
---
##### `artifactId`<sup>Required</sup> <a name="artifactId" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.artifactId"></a>
```typescript
public readonly artifactId: string;
```
- *Type:* string
The ID of the cloud assembly artifact for this stack.
---
##### `availabilityZones`<sup>Required</sup> <a name="availabilityZones" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.availabilityZones"></a>
```typescript
public readonly availabilityZones: string[];
```
- *Type:* string[]
Returns the list of AZs that are available in the AWS environment (account/region) associated with this stack.
If the stack is environment-agnostic (either account and/or region are
tokens), this property will return an array with 2 tokens that will resolve
at deploy-time to the first two availability zones returned from CloudFormation's
`Fn::GetAZs` intrinsic function.
If they are not available in the context, returns a set of dummy values and
reports them as missing, and let the CLI resolve them by calling EC2
`DescribeAvailabilityZones` on the target environment.
To specify a different strategy for selecting availability zones override this method.
---
##### `bundlingRequired`<sup>Required</sup> <a name="bundlingRequired" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.bundlingRequired"></a>
```typescript
public readonly bundlingRequired: boolean;
```
- *Type:* boolean
Indicates whether the stack requires bundling or not.
---
##### `dependencies`<sup>Required</sup> <a name="dependencies" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.dependencies"></a>
```typescript
public readonly dependencies: Stack[];
```
- *Type:* aws-cdk-lib.Stack[]
Return the stacks this stack depends on.
---
##### `environment`<sup>Required</sup> <a name="environment" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.environment"></a>
```typescript
public readonly environment: string;
```
- *Type:* string
The environment coordinates in which this stack is deployed.
In the form
`aws://account/region`. Use `stack.account` and `stack.region` to obtain
the specific values, no need to parse.
You can use this value to determine if two stacks are targeting the same
environment.
If either `stack.account` or `stack.region` are not concrete values (e.g.
`Aws.ACCOUNT_ID` or `Aws.REGION`) the special strings `unknown-account` and/or
`unknown-region` will be used respectively to indicate this stack is
region/account-agnostic.
---
##### `nested`<sup>Required</sup> <a name="nested" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.nested"></a>
```typescript
public readonly nested: boolean;
```
- *Type:* boolean
Indicates if this is a nested stack, in which case `parentStack` will include a reference to it's parent.
---
##### `notificationArns`<sup>Required</sup> <a name="notificationArns" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.notificationArns"></a>
```typescript
public readonly notificationArns: string[];
```
- *Type:* string[]
Returns the list of notification Amazon Resource Names (ARNs) for the current stack.
---
##### `partition`<sup>Required</sup> <a name="partition" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.partition"></a>
```typescript
public readonly partition: string;
```
- *Type:* string
The partition in which this stack is defined.
---
##### `region`<sup>Required</sup> <a name="region" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.region"></a>
```typescript
public readonly region: string;
```
- *Type:* string
The AWS region into which this stack will be deployed (e.g. `us-west-2`).
This value is resolved according to the following rules:
1. The value provided to `env.region` when the stack is defined. This can
either be a concrete region (e.g. `us-west-2`) or the `Aws.REGION`
token.
3. `Aws.REGION`, which is represents the CloudFormation intrinsic reference
`{ "Ref": "AWS::Region" }` encoded as a string token.
Preferably, you should use the return value as an opaque string and not
attempt to parse it to implement your logic. If you do, you must first
check that it is a concrete value an not an unresolved token. If this
value is an unresolved token (`Token.isUnresolved(stack.region)` returns
`true`), this implies that the user wishes that this stack will synthesize
into a **region-agnostic template**. In this case, your code should either
fail (throw an error, emit a synth error using `Annotations.of(construct).addError()`) or
implement some other region-agnostic behavior.
---
##### `stackId`<sup>Required</sup> <a name="stackId" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.stackId"></a>
```typescript
public readonly stackId: string;
```
- *Type:* string
The ID of the stack.
---
*Example*
```typescript
// After resolving, looks like
'arn:aws:cloudformation:us-west-2:123456789012:stack/teststack/51af3dc0-da77-11e4-872e-1234567db123'
```
##### `stackName`<sup>Required</sup> <a name="stackName" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.stackName"></a>
```typescript
public readonly stackName: string;
```
- *Type:* string
The concrete CloudFormation physical stack name.
This is either the name defined explicitly in the `stackName` prop or
allocated based on the stack's location in the construct tree. Stacks that
are directly defined under the app use their construct `id` as their stack
name. Stacks that are defined deeper within the tree will use a hashed naming
scheme based on the construct path to ensure uniqueness.
If you wish to obtain the deploy-time AWS::StackName intrinsic,
you can use `Aws.STACK_NAME` directly.
---
##### `synthesizer`<sup>Required</sup> <a name="synthesizer" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.synthesizer"></a>
```typescript
public readonly synthesizer: IStackSynthesizer;
```
- *Type:* aws-cdk-lib.IStackSynthesizer
Synthesis method for this stack.
---
##### `tags`<sup>Required</sup> <a name="tags" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.tags"></a>
```typescript
public readonly tags: TagManager;
```
- *Type:* aws-cdk-lib.TagManager
Tags to be applied to the stack.
---
##### `templateFile`<sup>Required</sup> <a name="templateFile" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.templateFile"></a>
```typescript
public readonly templateFile: string;
```
- *Type:* string
The name of the CloudFormation template file emitted to the output directory during synthesis.
Example value: `MyStack.template.json`
---
##### `templateOptions`<sup>Required</sup> <a name="templateOptions" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.templateOptions"></a>
```typescript
public readonly templateOptions: ITemplateOptions;
```
- *Type:* aws-cdk-lib.ITemplateOptions
Options for CloudFormation template (like version, transform, description).
---
##### `urlSuffix`<sup>Required</sup> <a name="urlSuffix" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.urlSuffix"></a>
```typescript
public readonly urlSuffix: string;
```
- *Type:* string
The Amazon domain suffix for the region in which this stack is defined.
---
##### `nestedStackParent`<sup>Optional</sup> <a name="nestedStackParent" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.nestedStackParent"></a>
```typescript
public readonly nestedStackParent: Stack;
```
- *Type:* aws-cdk-lib.Stack
If this is a nested stack, returns it's parent stack.
---
##### `nestedStackResource`<sup>Optional</sup> <a name="nestedStackResource" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.nestedStackResource"></a>
```typescript
public readonly nestedStackResource: CfnResource;
```
- *Type:* aws-cdk-lib.CfnResource
If this is a nested stack, this represents its `AWS::CloudFormation::Stack` resource.
`undefined` for top-level (non-nested) stacks.
---
##### `terminationProtection`<sup>Required</sup> <a name="terminationProtection" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStack.property.terminationProtection"></a>
```typescript
public readonly terminationProtection: boolean;
```
- *Type:* boolean
Whether termination protection is enabled for this stack.
---
## Structs <a name="Structs" id="Structs"></a>
### LogOption <a name="LogOption" id="@gammarers/aws-rds-database-auto-running-protection-stack.LogOption"></a>
#### Initializer <a name="Initializer" id="@gammarers/aws-rds-database-auto-running-protection-stack.LogOption.Initializer"></a>
```typescript
import { LogOption } from '@gammarers/aws-rds-database-auto-running-protection-stack'
const logOption: LogOption = { ... }
```
#### Properties <a name="Properties" id="Properties"></a>
| **Name** | **Type** | **Description** |
| --- | --- | --- |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.LogOption.property.machineLogLevel">machineLogLevel</a></code> | <code>aws-cdk-lib.aws_stepfunctions.LogLevel</code> | *No description.* |
---
##### `machineLogLevel`<sup>Optional</sup> <a name="machineLogLevel" id="@gammarers/aws-rds-database-auto-running-protection-stack.LogOption.property.machineLogLevel"></a>
```typescript
public readonly machineLogLevel: LogLevel;
```
- *Type:* aws-cdk-lib.aws_stepfunctions.LogLevel
---
### Notifications <a name="Notifications" id="@gammarers/aws-rds-database-auto-running-protection-stack.Notifications"></a>
#### Initializer <a name="Initializer" id="@gammarers/aws-rds-database-auto-running-protection-stack.Notifications.Initializer"></a>
```typescript
import { Notifications } from '@gammarers/aws-rds-database-auto-running-protection-stack'
const notifications: Notifications = { ... }
```
#### Properties <a name="Properties" id="Properties"></a>
| **Name** | **Type** | **Description** |
| --- | --- | --- |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.Notifications.property.emails">emails</a></code> | <code>string[]</code> | *No description.* |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.Notifications.property.slack">slack</a></code> | <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.Slack">Slack</a></code> | *No description.* |
---
##### `emails`<sup>Optional</sup> <a name="emails" id="@gammarers/aws-rds-database-auto-running-protection-stack.Notifications.property.emails"></a>
```typescript
public readonly emails: string[];
```
- *Type:* string[]
---
##### `slack`<sup>Optional</sup> <a name="slack" id="@gammarers/aws-rds-database-auto-running-protection-stack.Notifications.property.slack"></a>
```typescript
public readonly slack: Slack;
```
- *Type:* <a href="#@gammarers/aws-rds-database-auto-running-protection-stack.Slack">Slack</a>
---
### RDSDatabaseAutoRunningProtectionStackProps <a name="RDSDatabaseAutoRunningProtectionStackProps" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps"></a>
#### Initializer <a name="Initializer" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.Initializer"></a>
```typescript
import { RDSDatabaseAutoRunningProtectionStackProps } from '@gammarers/aws-rds-database-auto-running-protection-stack'
const rDSDatabaseAutoRunningProtectionStackProps: RDSDatabaseAutoRunningProtectionStackProps = { ... }
```
#### Properties <a name="Properties" id="Properties"></a>
| **Name** | **Type** | **Description** |
| --- | --- | --- |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.analyticsReporting">analyticsReporting</a></code> | <code>boolean</code> | Include runtime versioning information in this Stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.crossRegionReferences">crossRegionReferences</a></code> | <code>boolean</code> | Enable this flag to allow native cross region stack references. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.description">description</a></code> | <code>string</code> | A description of the stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.env">env</a></code> | <code>aws-cdk-lib.Environment</code> | The AWS environment (account/region) where this stack will be deployed. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.permissionsBoundary">permissionsBoundary</a></code> | <code>aws-cdk-lib.PermissionsBoundary</code> | Options for applying a permissions boundary to all IAM Roles and Users created within this Stage. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.stackName">stackName</a></code> | <code>string</code> | Name to deploy the stack with. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.suppressTemplateIndentation">suppressTemplateIndentation</a></code> | <code>boolean</code> | Enable this flag to suppress indentation in generated CloudFormation templates. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.synthesizer">synthesizer</a></code> | <code>aws-cdk-lib.IStackSynthesizer</code> | Synthesis method to use while deploying this stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.tags">tags</a></code> | <code>{[ key: string ]: string}</code> | Stack tags that will be applied to all the taggable resources and the stack itself. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.terminationProtection">terminationProtection</a></code> | <code>boolean</code> | Whether to enable termination protection for this stack. |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.targetResource">targetResource</a></code> | <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.TargetResource">TargetResource</a></code> | *No description.* |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.enableRule">enableRule</a></code> | <code>boolean</code> | *No description.* |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.logOption">logOption</a></code> | <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.LogOption">LogOption</a></code> | *No description.* |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.notifications">notifications</a></code> | <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.Notifications">Notifications</a></code> | *No description.* |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.resourceNamingOption">resourceNamingOption</a></code> | <code>@gammarers/aws-resource-naming.ResourceDefaultNaming \| @gammarers/aws-resource-naming.ResourceAutoNaming \| <a href="#@gammarers/aws-rds-database-auto-running-protection-stack.ResourceCustomNaming">ResourceCustomNaming</a></code> | *No description.* |
| <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.timeout">timeout</a></code> | <code><a href="#@gammarers/aws-rds-database-auto-running-protection-stack.Timeout">Timeout</a></code> | *No description.* |
---
##### `analyticsReporting`<sup>Optional</sup> <a name="analyticsReporting" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.analyticsReporting"></a>
```typescript
public readonly analyticsReporting: boolean;
```
- *Type:* boolean
- *Default:* `analyticsReporting` setting of containing `App`, or value of 'aws:cdk:version-reporting' context key
Include runtime versioning information in this Stack.
---
##### `crossRegionReferences`<sup>Optional</sup> <a name="crossRegionReferences" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.crossRegionReferences"></a>
```typescript
public readonly crossRegionReferences: boolean;
```
- *Type:* boolean
- *Default:* false
Enable this flag to allow native cross region stack references.
Enabling this will create a CloudFormation custom resource
in both the producing stack and consuming stack in order to perform the export/import
This feature is currently experimental
---
##### `description`<sup>Optional</sup> <a name="description" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.description"></a>
```typescript
public readonly description: string;
```
- *Type:* string
- *Default:* No description.
A description of the stack.
---
##### `env`<sup>Optional</sup> <a name="env" id="@gammarers/aws-rds-database-auto-running-protection-stack.RDSDatabaseAutoRunningProtectionStackProps.property.env"></a>
```typescript
public readonly env: Environment;
```
- *Type:* aws-cdk-lib.Environment
- *Default:* The environment of the containing `Stage` if available, otherwise create the stack will be environment-agnostic.
The AWS environment (account/region) where this stack will be deployed.
Set the `region`/`account` fields of `env` to either a concrete value to
select the indicated environment (recommended for production stacks), or to
the values of environment variables
`CDK_DEFAULT_REGION`/`CDK_DEFAULT_ACCOUNT` to let the target environment
depend on the AWS credentials/configuration that the CDK CLI