> ## 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.

# Python: HttpBackend

> CDKTN Core API Reference for HttpBackend in Python.

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

```python theme={null}
import cdktn

cdktn.HttpBackend(
  scope: Construct,
  address: str,
  client_ca_certificate_pem: str = None,
  client_certificate_pem: str = None,
  client_private_key_pem: str = None,
  lock_address: str = None,
  lock_method: str = None,
  password: str = None,
  retry_max: typing.Union[int, float] = None,
  retry_wait_max: typing.Union[int, float] = None,
  retry_wait_min: typing.Union[int, float] = None,
  skip_cert_verification: bool = None,
  unlock_address: str = None,
  unlock_method: str = None,
  update_method: str = None,
  username: str = None
)
```

| **Name**                                                                                                                | **Type**                               | **Description**                                                                                                           |
| ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.scope">scope</a></code>                                         | <code>constructs.Construct</code>      | *No description.*                                                                                                         |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.address">address</a></code>                                     | <code>str</code>                       | (Required) The address of the REST endpoint.                                                                              |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.clientCaCertificatePem">client\_ca\_certificate\_pem</a></code> | <code>str</code>                       | (Optional) A PEM-encoded CA certificate chain used by the client to verify server certificates during TLS authentication. |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.clientCertificatePem">client\_certificate\_pem</a></code>       | <code>str</code>                       | (Optional) A PEM-encoded certificate used by the server to verify the client during mutual TLS (mTLS) authentication.     |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.clientPrivateKeyPem">client\_private\_key\_pem</a></code>       | <code>str</code>                       | (Optional) A PEM-encoded private key, required if client\_certificate\_pem is specified.                                  |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.lockAddress">lock\_address</a></code>                           | <code>str</code>                       | (Optional) The address of the lock REST endpoint.                                                                         |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.lockMethod">lock\_method</a></code>                             | <code>str</code>                       | (Optional) The HTTP method to use when locking.                                                                           |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.password">password</a></code>                                   | <code>str</code>                       | (Optional) The password for HTTP basic authentication.                                                                    |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.retryMax">retry\_max</a></code>                                 | <code>typing.Union\[int, float]</code> | (Optional) The number of HTTP request retries.                                                                            |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.retryWaitMax">retry\_wait\_max</a></code>                       | <code>typing.Union\[int, float]</code> | (Optional) The maximum time in seconds to wait between HTTP request attempts.                                             |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.retryWaitMin">retry\_wait\_min</a></code>                       | <code>typing.Union\[int, float]</code> | (Optional) The minimum time in seconds to wait between HTTP request attempts.                                             |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.skipCertVerification">skip\_cert\_verification</a></code>       | <code>bool</code>                      | (Optional) Whether to skip TLS verification.                                                                              |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.unlockAddress">unlock\_address</a></code>                       | <code>str</code>                       | (Optional) The address of the unlock REST endpoint.                                                                       |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.unlockMethod">unlock\_method</a></code>                         | <code>str</code>                       | (Optional) The HTTP method to use when unlocking.                                                                         |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.updateMethod">update\_method</a></code>                         | <code>str</code>                       | (Optional) HTTP method to use when updating state.                                                                        |
| <code><a href="#cdktn.HttpBackend.Initializer.parameter.username">username</a></code>                                   | <code>str</code>                       | (Optional) The username for HTTP basic authentication.                                                                    |

***

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

* *Type:* constructs.Construct

***

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

* *Type:* str

(Required) The address of the REST endpoint.

***

### `client_ca_certificate_pem`<sup>Optional</sup> <a name="client_ca_certificate_pem" id="cdktn.HttpBackend.Initializer.parameter.clientCaCertificatePem" />

* *Type:* str

(Optional) A PEM-encoded CA certificate chain used by the client to verify server certificates during TLS authentication.

***

### `client_certificate_pem`<sup>Optional</sup> <a name="client_certificate_pem" id="cdktn.HttpBackend.Initializer.parameter.clientCertificatePem" />

* *Type:* str

(Optional) A PEM-encoded certificate used by the server to verify the client during mutual TLS (mTLS) authentication.

***

### `client_private_key_pem`<sup>Optional</sup> <a name="client_private_key_pem" id="cdktn.HttpBackend.Initializer.parameter.clientPrivateKeyPem" />

* *Type:* str

(Optional) A PEM-encoded private key, required if client\_certificate\_pem is specified.

***

### `lock_address`<sup>Optional</sup> <a name="lock_address" id="cdktn.HttpBackend.Initializer.parameter.lockAddress" />

* *Type:* str

(Optional) The address of the lock REST endpoint.

Defaults to disabled.

***

### `lock_method`<sup>Optional</sup> <a name="lock_method" id="cdktn.HttpBackend.Initializer.parameter.lockMethod" />

* *Type:* str

(Optional) The HTTP method to use when locking.

Defaults to LOCK.

***

### `password`<sup>Optional</sup> <a name="password" id="cdktn.HttpBackend.Initializer.parameter.password" />

* *Type:* str

(Optional) The password for HTTP basic authentication.

***

### `retry_max`<sup>Optional</sup> <a name="retry_max" id="cdktn.HttpBackend.Initializer.parameter.retryMax" />

* *Type:* typing.Union\[int, float]

(Optional) The number of HTTP request retries.

Defaults to 2.

***

### `retry_wait_max`<sup>Optional</sup> <a name="retry_wait_max" id="cdktn.HttpBackend.Initializer.parameter.retryWaitMax" />

* *Type:* typing.Union\[int, float]

(Optional) The maximum time in seconds to wait between HTTP request attempts.

Defaults to 30.

***

### `retry_wait_min`<sup>Optional</sup> <a name="retry_wait_min" id="cdktn.HttpBackend.Initializer.parameter.retryWaitMin" />

* *Type:* typing.Union\[int, float]

(Optional) The minimum time in seconds to wait between HTTP request attempts.

Defaults to 1.

***

### `skip_cert_verification`<sup>Optional</sup> <a name="skip_cert_verification" id="cdktn.HttpBackend.Initializer.parameter.skipCertVerification" />

* *Type:* bool

(Optional) Whether to skip TLS verification.

Defaults to false.

***

### `unlock_address`<sup>Optional</sup> <a name="unlock_address" id="cdktn.HttpBackend.Initializer.parameter.unlockAddress" />

* *Type:* str

(Optional) The address of the unlock REST endpoint.

Defaults to disabled.

***

### `unlock_method`<sup>Optional</sup> <a name="unlock_method" id="cdktn.HttpBackend.Initializer.parameter.unlockMethod" />

* *Type:* str

(Optional) The HTTP method to use when unlocking.

Defaults to UNLOCK.

***

### `update_method`<sup>Optional</sup> <a name="update_method" id="cdktn.HttpBackend.Initializer.parameter.updateMethod" />

* *Type:* str

(Optional) HTTP method to use when updating state.

Defaults to POST.

***

### `username`<sup>Optional</sup> <a name="username" id="cdktn.HttpBackend.Initializer.parameter.username" />

* *Type:* str

(Optional) The username for HTTP basic authentication.

***

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

| **Name**                                                                                                | **Description**                                                                   |
| ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| <code><a href="#cdktn.HttpBackend.toString">to\_string</a></code>                                       | Returns a string representation of this construct.                                |
| <code><a href="#cdktn.HttpBackend.with">with</a></code>                                                 | Applies one or more mixins to this construct.                                     |
| <code><a href="#cdktn.HttpBackend.addOverride">add\_override</a></code>                                 | *No description.*                                                                 |
| <code><a href="#cdktn.HttpBackend.overrideLogicalId">override\_logical\_id</a></code>                   | Overrides the auto-generated logical ID with a specific ID.                       |
| <code><a href="#cdktn.HttpBackend.resetOverrideLogicalId">reset\_override\_logical\_id</a></code>       | Resets a previously passed logical Id to use the auto-generated logical id again. |
| <code><a href="#cdktn.HttpBackend.toHclTerraform">to\_hcl\_terraform</a></code>                         | *No description.*                                                                 |
| <code><a href="#cdktn.HttpBackend.toMetadata">to\_metadata</a></code>                                   | *No description.*                                                                 |
| <code><a href="#cdktn.HttpBackend.toTerraform">to\_terraform</a></code>                                 | Adds this resource to the terraform JSON output.                                  |
| <code><a href="#cdktn.HttpBackend.getRemoteStateDataSource">get\_remote\_state\_data\_source</a></code> | Creates a TerraformRemoteState resource that accesses this backend.               |

***

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

```python theme={null}
def to_string() -> str
```

Returns a string representation of this construct.

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

```python theme={null}
def 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.HttpBackend.with.parameter.mixins" />

* *Type:* \*constructs.IMixin

The mixins to apply.

***

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

```python theme={null}
def add_override(
  path: str,
  value: typing.Any
) -> None
```

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

* *Type:* str

***

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

* *Type:* typing.Any

***

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

```python theme={null}
def override_logical_id(
  new_logical_id: str
) -> None
```

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

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

* *Type:* str

The new logical ID to use for this stack element.

***

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

```python theme={null}
def reset_override_logical_id() -> None
```

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

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

```python theme={null}
def to_hcl_terraform() -> typing.Any
```

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

```python theme={null}
def to_metadata() -> typing.Any
```

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

```python theme={null}
def to_terraform() -> typing.Any
```

Adds this resource to the terraform JSON output.

### `get_remote_state_data_source` <a name="get_remote_state_data_source" id="cdktn.HttpBackend.getRemoteStateDataSource" />

```python theme={null}
def get_remote_state_data_source(
  scope: Construct,
  name: str,
  _fromstack: str
) -> TerraformRemoteState
```

Creates a TerraformRemoteState resource that accesses this backend.

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

* *Type:* constructs.Construct

***

#### `name`<sup>Required</sup> <a name="name" id="cdktn.HttpBackend.getRemoteStateDataSource.parameter.name" />

* *Type:* str

***

#### `_fromstack`<sup>Required</sup> <a name="_fromstack" id="cdktn.HttpBackend.getRemoteStateDataSource.parameter._fromStack" />

* *Type:* str

***

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

| **Name**                                                                                | **Description**               |
| --------------------------------------------------------------------------------------- | ----------------------------- |
| <code><a href="#cdktn.HttpBackend.isConstruct">is\_construct</a></code>                 | Checks if `x` is a construct. |
| <code><a href="#cdktn.HttpBackend.isTerraformElement">is\_terraform\_element</a></code> | *No description.*             |
| <code><a href="#cdktn.HttpBackend.isBackend">is\_backend</a></code>                     | *No description.*             |

***

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

```python theme={null}
import cdktn

cdktn.HttpBackend.is_construct(
  x: typing.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.HttpBackend.isConstruct.parameter.x" />

* *Type:* typing.Any

Any object.

***

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

```python theme={null}
import cdktn

cdktn.HttpBackend.is_terraform_element(
  x: typing.Any
)
```

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

* *Type:* typing.Any

***

### `is_backend` <a name="is_backend" id="cdktn.HttpBackend.isBackend" />

```python theme={null}
import cdktn

cdktn.HttpBackend.is_backend(
  x: typing.Any
)
```

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

* *Type:* typing.Any

***

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

| **Name**                                                                                     | **Type**                                                        | **Description**   |
| -------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | ----------------- |
| <code><a href="#cdktn.HttpBackend.property.node">node</a></code>                             | <code>constructs.Node</code>                                    | The tree node.    |
| <code><a href="#cdktn.HttpBackend.property.cdktfStack">cdktf\_stack</a></code>               | <code><a href="#cdktn.TerraformStack">TerraformStack</a></code> | *No description.* |
| <code><a href="#cdktn.HttpBackend.property.fqn">fqn</a></code>                               | <code>str</code>                                                | *No description.* |
| <code><a href="#cdktn.HttpBackend.property.friendlyUniqueId">friendly\_unique\_id</a></code> | <code>str</code>                                                | *No description.* |

***

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

```python theme={null}
node: Node
```

* *Type:* constructs.Node

The tree node.

***

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

```python theme={null}
cdktf_stack: TerraformStack
```

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

***

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

```python theme={null}
fqn: str
```

* *Type:* str

***

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

```python theme={null}
friendly_unique_id: str
```

* *Type:* str

***
