> ## 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: DataTerraformRemoteStateOssConfig
> CDKTN Core API Reference for DataTerraformRemoteStateOssConfig in Python.
## Initializer
```python theme={null}
import cdktn
cdktn.DataTerraformRemoteStateOssConfig(
defaults: typing.Mapping[typing.Any] = None,
workspace: str = None,
bucket: str,
access_key: str = None,
acl: str = None,
assume_role: OssAssumeRole = None,
assume_role_policy: str = None,
assume_role_role_arn: str = None,
assume_role_session_expiration: typing.Union[int, float] = None,
assume_role_session_name: str = None,
ecs_role_name: str = None,
encrypt: bool = None,
endpoint: str = None,
key: str = None,
prefix: str = None,
profile: str = None,
region: str = None,
secret_key: str = None,
security_token: str = None,
shared_credentials_file: str = None,
sts_endpoint: str = None,
tablestore_endpoint: str = None,
tablestore_table: str = None
)
```
## Properties
| **Name** | **Type** | **Description** |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| defaults | typing.Mapping\[typing.Any] | *No description.* |
| workspace | str | *No description.* |
| bucket | str | (Required) The name of the OSS bucket. |
| access\_key | str | (Optional) Alibaba Cloud access key. |
| acl | str | (Optional) Object ACL to be applied to the state file. |
| assume\_role | OssAssumeRole | *No description.* |
| assume\_role\_policy | str | (Optional, Available in 1.1.0+) A more restrictive policy to apply to the temporary credentials. This gives you a way to further restrict the permissions for the resulting temporary security credentials. You cannot use this policy to grant permissions that exceed those of the role that is being assumed. |
| assume\_role\_role\_arn | str | (Optional, Available in 1.1.0+) The ARN of the role to assume. If ARN is set to an empty string, it does not perform role switching. It supports the environment variable ALICLOUD\_ASSUME\_ROLE\_ARN. Terraform executes configuration on account with provided credentials. |
| assume\_role\_session\_expiration | typing.Union\[int, float] | (Optional, Available in 1.1.0+) The time after which the established session for assuming role expires. Valid value range: \[900-3600] seconds. Default to 3600 (in this case Alibaba Cloud uses its own default value). It supports environment variable ALICLOUD\_ASSUME\_ROLE\_SESSION\_EXPIRATION. |
| assume\_role\_session\_name | str | (Optional, Available in 1.1.0+) The session name to use when assuming the role. If omitted, 'terraform' is passed to the AssumeRole call as session name. It supports environment variable ALICLOUD\_ASSUME\_ROLE\_SESSION\_NAME. |
| ecs\_role\_name | str | (Optional, Available in 0.12.14+) The RAM Role Name attached on a ECS instance for API operations. You can retrieve this from the 'Access Control' section of the Alibaba Cloud console. |
| encrypt | bool | (Optional) Whether to enable server side encryption of the state file. |
| endpoint | str | (Optional) A custom endpoint for the OSS API. |
| key | str | (Optional) The name of the state file. |
| prefix | str | (Optional) The path directory of the state file will be stored. |
| profile | str | (Optional, Available in 0.12.8+) This is the Alibaba Cloud profile name as set in the shared credentials file. It can also be sourced from the ALICLOUD\_PROFILE environment variable. |
| region | str | (Optional) The region of the OSS bucket. |
| secret\_key | str | (Optional) Alibaba Cloud secret access key. |
| security\_token | str | (Optional) STS access token. |
| shared\_credentials\_file | str | (Optional, Available in 0.12.8+) This is the path to the shared credentials file. It can also be sourced from the ALICLOUD\_SHARED\_CREDENTIALS\_FILE environment variable. If this is not set and a profile is specified, \~/.aliyun/config.json will be used. |
| sts\_endpoint | str | (Optional, Available in 1.0.11+) Custom endpoint for the AliCloud Security Token Service (STS) API. It supports environment variable ALICLOUD\_STS\_ENDPOINT. |
| tablestore\_endpoint | str | (Optional) A custom endpoint for the TableStore API. |
| tablestore\_table | str | (Optional) A TableStore table for state locking and consistency. |
***
### `defaults`Optional
```python theme={null}
defaults: typing.Mapping[typing.Any]
```
* *Type:* typing.Mapping\[typing.Any]
***
### `workspace`Optional
```python theme={null}
workspace: str
```
* *Type:* str
***
### `bucket`Required
```python theme={null}
bucket: str
```
* *Type:* str
(Required) The name of the OSS bucket.
***
### `access_key`Optional
```python theme={null}
access_key: str
```
* *Type:* str
(Optional) Alibaba Cloud access key.
It supports environment variables ALICLOUD\_ACCESS\_KEY and ALICLOUD\_ACCESS\_KEY\_ID.
***
### `acl`Optional
```python theme={null}
acl: str
```
* *Type:* str
(Optional) Object ACL to be applied to the state file.
***
### ~~`assume_role`~~Optional
* *Deprecated:* Use flattened assume role options
```python theme={null}
assume_role: OssAssumeRole
```
* *Type:* OssAssumeRole
***
### `assume_role_policy`Optional
```python theme={null}
assume_role_policy: str
```
* *Type:* str
(Optional, Available in 1.1.0+) A more restrictive policy to apply to the temporary credentials. This gives you a way to further restrict the permissions for the resulting temporary security credentials. You cannot use this policy to grant permissions that exceed those of the role that is being assumed.
***
### `assume_role_role_arn`Optional
```python theme={null}
assume_role_role_arn: str
```
* *Type:* str
(Optional, Available in 1.1.0+) The ARN of the role to assume. If ARN is set to an empty string, it does not perform role switching. It supports the environment variable ALICLOUD\_ASSUME\_ROLE\_ARN. Terraform executes configuration on account with provided credentials.
***
### `assume_role_session_expiration`Optional
```python theme={null}
assume_role_session_expiration: typing.Union[int, float]
```
* *Type:* typing.Union\[int, float]
(Optional, Available in 1.1.0+) The time after which the established session for assuming role expires. Valid value range: \[900-3600] seconds. Default to 3600 (in this case Alibaba Cloud uses its own default value). It supports environment variable ALICLOUD\_ASSUME\_ROLE\_SESSION\_EXPIRATION.
***
### `assume_role_session_name`Optional
```python theme={null}
assume_role_session_name: str
```
* *Type:* str
(Optional, Available in 1.1.0+) The session name to use when assuming the role. If omitted, 'terraform' is passed to the AssumeRole call as session name. It supports environment variable ALICLOUD\_ASSUME\_ROLE\_SESSION\_NAME.
***
### `ecs_role_name`Optional
```python theme={null}
ecs_role_name: str
```
* *Type:* str
(Optional, Available in 0.12.14+) The RAM Role Name attached on a ECS instance for API operations. You can retrieve this from the 'Access Control' section of the Alibaba Cloud console.
***
### `encrypt`Optional
```python theme={null}
encrypt: bool
```
* *Type:* bool
(Optional) Whether to enable server side encryption of the state file.
If it is true, OSS will use 'AES256' encryption algorithm to encrypt state file.
***
### `endpoint`Optional
```python theme={null}
endpoint: str
```
* *Type:* str
(Optional) A custom endpoint for the OSS API.
It supports environment variables ALICLOUD\_OSS\_ENDPOINT and OSS\_ENDPOINT.
***
### `key`Optional
```python theme={null}
key: str
```
* *Type:* str
(Optional) The name of the state file.
Defaults to terraform.tfstate.
***
### `prefix`Optional
```python theme={null}
prefix: str
```
* *Type:* str
(Optional) The path directory of the state file will be stored.
Default to "env:".
***
### `profile`Optional
```python theme={null}
profile: str
```
* *Type:* str
(Optional, Available in 0.12.8+) This is the Alibaba Cloud profile name as set in the shared credentials file. It can also be sourced from the ALICLOUD\_PROFILE environment variable.
***
### `region`Optional
```python theme={null}
region: str
```
* *Type:* str
(Optional) The region of the OSS bucket.
It supports environment variables ALICLOUD\_REGION and ALICLOUD\_DEFAULT\_REGION.
***
### `secret_key`Optional
```python theme={null}
secret_key: str
```
* *Type:* str
(Optional) Alibaba Cloud secret access key.
It supports environment variables ALICLOUD\_SECRET\_KEY and ALICLOUD\_ACCESS\_KEY\_SECRET.
***
### `security_token`Optional
```python theme={null}
security_token: str
```
* *Type:* str
(Optional) STS access token.
It supports environment variable ALICLOUD\_SECURITY\_TOKEN.
***
### `shared_credentials_file`Optional
```python theme={null}
shared_credentials_file: str
```
* *Type:* str
(Optional, Available in 0.12.8+) This is the path to the shared credentials file. It can also be sourced from the ALICLOUD\_SHARED\_CREDENTIALS\_FILE environment variable. If this is not set and a profile is specified, \~/.aliyun/config.json will be used.
***
### `sts_endpoint`Optional
```python theme={null}
sts_endpoint: str
```
* *Type:* str
(Optional, Available in 1.0.11+) Custom endpoint for the AliCloud Security Token Service (STS) API. It supports environment variable ALICLOUD\_STS\_ENDPOINT.
***
### `tablestore_endpoint`Optional
```python theme={null}
tablestore_endpoint: str
```
* *Type:* str
(Optional) A custom endpoint for the TableStore API.
***
### `tablestore_table`Optional
```python theme={null}
tablestore_table: str
```
* *Type:* str
(Optional) A TableStore table for state locking and consistency.
The table must have a primary key named LockID of type String.
***