Python: CosBackend - CDK Terrain (CDKTN)

Initializers

import cdktn

cdktn.CosBackend(
  scope: Construct,
  bucket: str,
  accelerate: bool = None,
  acl: str = None,
  assume_role: CosBackendAssumeRole = None,
  domain: str = None,
  encrypt: bool = None,
  endpoint: str = None,
  key: str = None,
  prefix: str = None,
  region: str = None,
  secret_id: str = None,
  secret_key: str = None,
  security_token: str = None
)

Name	Type	Description
`scope`	`constructs.Construct`	No description.
`bucket`	`str`	(Required) The name of the COS bucket.
`accelerate`	`bool`	(Optional) Whether to enable global Acceleration.
`acl`	`str`	(Optional) Object ACL to be applied to the state file, allows private and public-read.
`assume_role`	`CosBackendAssumeRole`	(Optional) The assume_role block.
`domain`	`str`	(Optional) The root domain of the API request.
`encrypt`	`bool`	(Optional) Whether to enable server side encryption of the state file.
`endpoint`	`str`	(Optional) The Custom Endpoint for the COS backend.
`key`	`str`	(Optional) The path for saving the state file in bucket.
`prefix`	`str`	(Optional) The directory for saving the state file in bucket.
`region`	`str`	(Optional) The region of the COS bucket.
`secret_id`	`str`	(Optional) Secret id of Tencent Cloud.
`secret_key`	`str`	(Optional) Secret key of Tencent Cloud.
`security_token`	`str`	(Optional) TencentCloud Security Token of temporary access credentials.

`scope`^Required

Type: constructs.Construct

`bucket`^Required

Type: str

(Required) The name of the COS bucket. You shall manually create it first.

`accelerate`^Optional

Type: bool

(Optional) Whether to enable global Acceleration. Defaults to false.

`acl`^Optional

Type: str

(Optional) Object ACL to be applied to the state file, allows private and public-read. Defaults to private.

`assume_role`^Optional

Type: CosBackendAssumeRole

(Optional) The assume_role block. If provided, terraform will attempt to assume this role using the supplied credentials.

`domain`^Optional

Type: str

(Optional) The root domain of the API request. Defaults to tencentcloudapi.com. It supports the environment variable TENCENTCLOUD_DOMAIN.

`encrypt`^Optional

Type: bool

(Optional) Whether to enable server side encryption of the state file. If it is true, COS will use ‘AES256’ encryption algorithm to encrypt state file.

`endpoint`^Optional

Type: str

(Optional) The Custom Endpoint for the COS backend. It supports the environment variable TENCENTCLOUD_ENDPOINT.

`key`^Optional

Type: str

(Optional) The path for saving the state file in bucket. Defaults to terraform.tfstate.

`prefix`^Optional

Type: str

(Optional) The directory for saving the state file in bucket. Default to “env:”.

`region`^Optional

Type: str

(Optional) The region of the COS bucket. It supports environment variables TENCENTCLOUD_REGION.

`secret_id`^Optional

Type: str

(Optional) Secret id of Tencent Cloud. It supports environment variables TENCENTCLOUD_SECRET_ID.

`secret_key`^Optional

Type: str

(Optional) Secret key of Tencent Cloud. It supports environment variables TENCENTCLOUD_SECRET_KEY.

`security_token`^Optional

Type: str

(Optional) TencentCloud Security Token of temporary access credentials. It supports environment variables TENCENTCLOUD_SECURITY_TOKEN.

Methods

Name	Description
`to_string`	Returns a string representation of this construct.
`add_override`	No description.
`override_logical_id`	Overrides the auto-generated logical ID with a specific ID.
`reset_override_logical_id`	Resets a previously passed logical Id to use the auto-generated logical id again.
`to_hcl_terraform`	No description.
`to_metadata`	No description.
`to_terraform`	Adds this resource to the terraform JSON output.
`get_remote_state_data_source`	Creates a TerraformRemoteState resource that accesses this backend.

`to_string`

def to_string() -> str

Returns a string representation of this construct.

`add_override`

def add_override(
  path: str,
  value: typing.Any
) -> None

`path`^Required

Type: str

`value`^Required

Type: typing.Any

`override_logical_id`

def override_logical_id(
  new_logical_id: str
) -> None

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

`new_logical_id`^Required

Type: str

The new logical ID to use for this stack element.

`reset_override_logical_id`

def reset_override_logical_id() -> None

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

`to_hcl_terraform`

def to_hcl_terraform() -> typing.Any

`to_metadata`

def to_metadata() -> typing.Any

`to_terraform`

def to_terraform() -> typing.Any

Adds this resource to the terraform JSON output.

`get_remote_state_data_source`

def get_remote_state_data_source(
  scope: Construct,
  name: str,
  _fromstack: str
) -> TerraformRemoteState

Creates a TerraformRemoteState resource that accesses this backend.

`scope`^Required

Type: constructs.Construct

`name`^Required

Type: str

`_fromstack`^Required

Type: str

Static Functions

Name	Description
`is_construct`	Checks if `x` is a construct.
`is_terraform_element`	No description.
`is_backend`	No description.

`is_construct`

import cdktn

cdktn.CosBackend.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`^Required

Type: typing.Any

Any object.

`is_terraform_element`

import cdktn

cdktn.CosBackend.is_terraform_element(
  x: typing.Any
)

`x`^Required

Type: typing.Any

`is_backend`

import cdktn

cdktn.CosBackend.is_backend(
  x: typing.Any
)

`x`^Required

Type: typing.Any

Properties

Name	Type	Description
`node`	`constructs.Node`	The tree node.
`cdktf_stack`	`TerraformStack`	No description.
`fqn`	`str`	No description.
`friendly_unique_id`	`str`	No description.

`node`^Required

node: Node

Type: constructs.Node

The tree node.

`cdktf_stack`^Required

cdktf_stack: TerraformStack

Type: TerraformStack

`fqn`^Required

fqn: str

Type: str

`friendly_unique_id`^Required

friendly_unique_id: str

Type: str

Overview

TypeScript

Python

Java

C#

Go

​Initializers

​scopeRequired

​bucketRequired

​accelerateOptional

​aclOptional

​assume_roleOptional

​domainOptional

​encryptOptional

​endpointOptional

​keyOptional

​prefixOptional

​regionOptional

​secret_idOptional

​secret_keyOptional

​security_tokenOptional

​Methods

​to_string

​add_override

​pathRequired

​valueRequired

​override_logical_id

​new_logical_idRequired

​reset_override_logical_id

​to_hcl_terraform

​to_metadata

​to_terraform

​get_remote_state_data_source

​scopeRequired

​nameRequired

​_fromstackRequired

​Static Functions

​is_construct

​xRequired

​is_terraform_element

​xRequired

​is_backend

​xRequired

​Properties

​nodeRequired

​cdktf_stackRequired

​fqnRequired

​friendly_unique_idRequired

Initializers

`scope`^Required

`bucket`^Required

`accelerate`^Optional

`acl`^Optional

`assume_role`^Optional

`domain`^Optional

`encrypt`^Optional

`endpoint`^Optional

`key`^Optional

`prefix`^Optional

`region`^Optional

`secret_id`^Optional

`secret_key`^Optional

`security_token`^Optional

Methods

`to_string`

`add_override`

`path`^Required

`value`^Required

`override_logical_id`

`new_logical_id`^Required

`reset_override_logical_id`

`to_hcl_terraform`

`to_metadata`

`to_terraform`

`get_remote_state_data_source`

`scope`^Required

`name`^Required

`_fromstack`^Required

Static Functions

`is_construct`

`x`^Required

`is_terraform_element`

`x`^Required

`is_backend`

`x`^Required

Properties

`node`^Required

`cdktf_stack`^Required

`fqn`^Required

`friendly_unique_id`^Required