> ## Documentation Index
> Fetch the complete documentation index at: https://cdktn.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Typescript: TerraformModule

> CDKTN Core API Reference for TerraformModule in Typescript.

* *Implements:* <a href="#cdktn.ITerraformDependable">ITerraformDependable</a>

TerraformModule can be used to reference a local terraform module or a module from the Terraform Registry.

It should be used if you can not use generated bindings for the module as you would get by adding the module
to your cdktf.json files "terraformModules" array and running cdktn get.

This class is not creating a Terraform module to be used outside of CDKTN.
If you want to bundle certain resources together like you would do with a Terraform module,
you should use Constructs instead, see [http://cdk.tf/constructs](http://cdk.tf/constructs) for more details.

## Initializers <a name="Initializers" id="cdktn.TerraformModule.Initializer" />

```typescript theme={null}
import { TerraformModule } from 'cdktn'

new TerraformModule(scope: Construct, id: string, options: TerraformModuleConfig)
```

| **Name**                                                                                | **Type**                                                                      | **Description**   |
| --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------- |
| <code><a href="#cdktn.TerraformModule.Initializer.parameter.scope">scope</a></code>     | <code>constructs.Construct</code>                                             | *No description.* |
| <code><a href="#cdktn.TerraformModule.Initializer.parameter.id">id</a></code>           | <code>string</code>                                                           | *No description.* |
| <code><a href="#cdktn.TerraformModule.Initializer.parameter.options">options</a></code> | <code><a href="#cdktn.TerraformModuleConfig">TerraformModuleConfig</a></code> | *No description.* |

***

### `scope`<sup>Required</sup> <a name="scope" id="cdktn.TerraformModule.Initializer.parameter.scope" />

* *Type:* constructs.Construct

***

### `id`<sup>Required</sup> <a name="id" id="cdktn.TerraformModule.Initializer.parameter.id" />

* *Type:* string

***

### `options`<sup>Required</sup> <a name="options" id="cdktn.TerraformModule.Initializer.parameter.options" />

* *Type:* <a href="#cdktn.TerraformModuleConfig">TerraformModuleConfig</a>

***

## Methods <a name="Methods" id="Methods" />

| **Name**                                                                                        | **Description**                                                                   |
| ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| <code><a href="#cdktn.TerraformModule.toString">toString</a></code>                             | Returns a string representation of this construct.                                |
| <code><a href="#cdktn.TerraformModule.with">with</a></code>                                     | Applies one or more mixins to this construct.                                     |
| <code><a href="#cdktn.TerraformModule.addOverride">addOverride</a></code>                       | *No description.*                                                                 |
| <code><a href="#cdktn.TerraformModule.overrideLogicalId">overrideLogicalId</a></code>           | Overrides the auto-generated logical ID with a specific ID.                       |
| <code><a href="#cdktn.TerraformModule.resetOverrideLogicalId">resetOverrideLogicalId</a></code> | Resets a previously passed logical Id to use the auto-generated logical id again. |
| <code><a href="#cdktn.TerraformModule.toHclTerraform">toHclTerraform</a></code>                 | *No description.*                                                                 |
| <code><a href="#cdktn.TerraformModule.toMetadata">toMetadata</a></code>                         | *No description.*                                                                 |
| <code><a href="#cdktn.TerraformModule.toTerraform">toTerraform</a></code>                       | *No description.*                                                                 |
| <code><a href="#cdktn.TerraformModule.addProvider">addProvider</a></code>                       | *No description.*                                                                 |
| <code><a href="#cdktn.TerraformModule.getString">getString</a></code>                           | *No description.*                                                                 |
| <code><a href="#cdktn.TerraformModule.interpolationForOutput">interpolationForOutput</a></code> | *No description.*                                                                 |

***

### `toString` <a name="toString" id="cdktn.TerraformModule.toString" />

```typescript theme={null}
public toString(): string
```

Returns a string representation of this construct.

### `with` <a name="with" id="cdktn.TerraformModule.with" />

```typescript theme={null}
public with(mixins: ...IMixin[]): IConstruct
```

Applies one or more mixins to this construct.

Mixins are applied in order. The list of constructs is captured at the
start of the call, so constructs added by a mixin will not be visited.
Use multiple `with()` calls if subsequent mixins should apply to added
constructs.

#### `mixins`<sup>Required</sup> <a name="mixins" id="cdktn.TerraformModule.with.parameter.mixins" />

* *Type:* ...constructs.IMixin\[]

The mixins to apply.

***

### `addOverride` <a name="addOverride" id="cdktn.TerraformModule.addOverride" />

```typescript theme={null}
public addOverride(path: string, value: any): void
```

#### `path`<sup>Required</sup> <a name="path" id="cdktn.TerraformModule.addOverride.parameter.path" />

* *Type:* string

***

#### `value`<sup>Required</sup> <a name="value" id="cdktn.TerraformModule.addOverride.parameter.value" />

* *Type:* any

***

### `overrideLogicalId` <a name="overrideLogicalId" id="cdktn.TerraformModule.overrideLogicalId" />

```typescript theme={null}
public overrideLogicalId(newLogicalId: string): void
```

Overrides the auto-generated logical ID with a specific ID.

#### `newLogicalId`<sup>Required</sup> <a name="newLogicalId" id="cdktn.TerraformModule.overrideLogicalId.parameter.newLogicalId" />

* *Type:* string

The new logical ID to use for this stack element.

***

### `resetOverrideLogicalId` <a name="resetOverrideLogicalId" id="cdktn.TerraformModule.resetOverrideLogicalId" />

```typescript theme={null}
public resetOverrideLogicalId(): void
```

Resets a previously passed logical Id to use the auto-generated logical id again.

### `toHclTerraform` <a name="toHclTerraform" id="cdktn.TerraformModule.toHclTerraform" />

```typescript theme={null}
public toHclTerraform(): any
```

### `toMetadata` <a name="toMetadata" id="cdktn.TerraformModule.toMetadata" />

```typescript theme={null}
public toMetadata(): any
```

### `toTerraform` <a name="toTerraform" id="cdktn.TerraformModule.toTerraform" />

```typescript theme={null}
public toTerraform(): any
```

### `addProvider` <a name="addProvider" id="cdktn.TerraformModule.addProvider" />

```typescript theme={null}
public addProvider(provider: TerraformProvider | TerraformModuleProvider): void
```

#### `provider`<sup>Required</sup> <a name="provider" id="cdktn.TerraformModule.addProvider.parameter.provider" />

* *Type:* <a href="#cdktn.TerraformProvider">TerraformProvider</a> | <a href="#cdktn.TerraformModuleProvider">TerraformModuleProvider</a>

***

### `getString` <a name="getString" id="cdktn.TerraformModule.getString" />

```typescript theme={null}
public getString(output: string): string
```

#### `output`<sup>Required</sup> <a name="output" id="cdktn.TerraformModule.getString.parameter.output" />

* *Type:* string

***

### `interpolationForOutput` <a name="interpolationForOutput" id="cdktn.TerraformModule.interpolationForOutput" />

```typescript theme={null}
public interpolationForOutput(moduleOutput: string): IResolvable
```

#### `moduleOutput`<sup>Required</sup> <a name="moduleOutput" id="cdktn.TerraformModule.interpolationForOutput.parameter.moduleOutput" />

* *Type:* string

***

## Static Functions <a name="Static Functions" id="Static Functions" />

| **Name**                                                                                | **Description**               |
| --------------------------------------------------------------------------------------- | ----------------------------- |
| <code><a href="#cdktn.TerraformModule.isConstruct">isConstruct</a></code>               | Checks if `x` is a construct. |
| <code><a href="#cdktn.TerraformModule.isTerraformElement">isTerraformElement</a></code> | *No description.*             |

***

### `isConstruct` <a name="isConstruct" id="cdktn.TerraformModule.isConstruct" />

```typescript theme={null}
import { TerraformModule } from 'cdktn'

TerraformModule.isConstruct(x: any)
```

Checks if `x` is a construct.

Use this method instead of `instanceof` to properly detect `Construct`
instances, even when the construct library is symlinked.

Explanation: in JavaScript, multiple copies of the `constructs` library on
disk are seen as independent, completely different libraries. As a
consequence, the class `Construct` in each copy of the `constructs` library
is seen as a different class, and an instance of one class will not test as
`instanceof` the other class. `npm install` will not create installations
like this, but users may manually symlink construct libraries together or
use a monorepo tool: in those cases, multiple copies of the `constructs`
library can be accidentally installed, and `instanceof` will behave
unpredictably. It is safest to avoid using `instanceof`, and using
this type-testing method instead.

#### `x`<sup>Required</sup> <a name="x" id="cdktn.TerraformModule.isConstruct.parameter.x" />

* *Type:* any

Any object.

***

### `isTerraformElement` <a name="isTerraformElement" id="cdktn.TerraformModule.isTerraformElement" />

```typescript theme={null}
import { TerraformModule } from 'cdktn'

TerraformModule.isTerraformElement(x: any)
```

#### `x`<sup>Required</sup> <a name="x" id="cdktn.TerraformModule.isTerraformElement.parameter.x" />

* *Type:* any

***

## Properties <a name="Properties" id="Properties" />

| **Name**                                                                                                                       | **Type**                                                                                                                                         | **Description**   |
| ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------- |
| <code><a href="#cdktn.TerraformModule.property.node">node</a></code>                                                           | <code>constructs.Node</code>                                                                                                                     | The tree node.    |
| <code><a href="#cdktn.TerraformModule.property.cdktfStack">cdktfStack</a></code>                                               | <code><a href="#cdktn.TerraformStack">TerraformStack</a></code>                                                                                  | *No description.* |
| <code><a href="#cdktn.TerraformModule.property.fqn">fqn</a></code>                                                             | <code>string</code>                                                                                                                              | *No description.* |
| <code><a href="#cdktn.TerraformModule.property.friendlyUniqueId">friendlyUniqueId</a></code>                                   | <code>string</code>                                                                                                                              | *No description.* |
| <code><a href="#cdktn.TerraformModule.property.source">source</a></code>                                                       | <code>string</code>                                                                                                                              | *No description.* |
| <code><a href="#cdktn.TerraformModule.property.providers">providers</a></code>                                                 | <code><a href="#cdktn.TerraformProvider">TerraformProvider</a> \| <a href="#cdktn.TerraformModuleProvider">TerraformModuleProvider</a>\[]</code> | *No description.* |
| <code><a href="#cdktn.TerraformModule.property.skipAssetCreationFromLocalModules">skipAssetCreationFromLocalModules</a></code> | <code>boolean</code>                                                                                                                             | *No description.* |
| <code><a href="#cdktn.TerraformModule.property.version">version</a></code>                                                     | <code>string</code>                                                                                                                              | *No description.* |
| <code><a href="#cdktn.TerraformModule.property.dependsOn">dependsOn</a></code>                                                 | <code>string\[]</code>                                                                                                                           | *No description.* |
| <code><a href="#cdktn.TerraformModule.property.forEach">forEach</a></code>                                                     | <code><a href="#cdktn.ITerraformIterator">ITerraformIterator</a></code>                                                                          | *No description.* |

***

### `node`<sup>Required</sup> <a name="node" id="cdktn.TerraformModule.property.node" />

```typescript theme={null}
public readonly node: Node;
```

* *Type:* constructs.Node

The tree node.

***

### `cdktfStack`<sup>Required</sup> <a name="cdktfStack" id="cdktn.TerraformModule.property.cdktfStack" />

```typescript theme={null}
public readonly cdktfStack: TerraformStack;
```

* *Type:* <a href="#cdktn.TerraformStack">TerraformStack</a>

***

### `fqn`<sup>Required</sup> <a name="fqn" id="cdktn.TerraformModule.property.fqn" />

```typescript theme={null}
public readonly fqn: string;
```

* *Type:* string

***

### `friendlyUniqueId`<sup>Required</sup> <a name="friendlyUniqueId" id="cdktn.TerraformModule.property.friendlyUniqueId" />

```typescript theme={null}
public readonly friendlyUniqueId: string;
```

* *Type:* string

***

### `source`<sup>Required</sup> <a name="source" id="cdktn.TerraformModule.property.source" />

```typescript theme={null}
public readonly source: string;
```

* *Type:* string

***

### `providers`<sup>Optional</sup> <a name="providers" id="cdktn.TerraformModule.property.providers" />

```typescript theme={null}
public readonly providers: (TerraformProvider | TerraformModuleProvider)[];
```

* *Type:* <a href="#cdktn.TerraformProvider">TerraformProvider</a> | <a href="#cdktn.TerraformModuleProvider">TerraformModuleProvider</a>\[]

***

### `skipAssetCreationFromLocalModules`<sup>Optional</sup> <a name="skipAssetCreationFromLocalModules" id="cdktn.TerraformModule.property.skipAssetCreationFromLocalModules" />

```typescript theme={null}
public readonly skipAssetCreationFromLocalModules: boolean;
```

* *Type:* boolean

***

### `version`<sup>Optional</sup> <a name="version" id="cdktn.TerraformModule.property.version" />

```typescript theme={null}
public readonly version: string;
```

* *Type:* string

***

### `dependsOn`<sup>Optional</sup> <a name="dependsOn" id="cdktn.TerraformModule.property.dependsOn" />

```typescript theme={null}
public readonly dependsOn: string[];
```

* *Type:* string\[]

***

### `forEach`<sup>Optional</sup> <a name="forEach" id="cdktn.TerraformModule.property.forEach" />

```typescript theme={null}
public readonly forEach: ITerraformIterator;
```

* *Type:* <a href="#cdktn.ITerraformIterator">ITerraformIterator</a>

***
