Package com.hashicorp.cdktf
Class OssBackend.Builder
java.lang.Object
com.hashicorp.cdktf.OssBackend.Builder
- All Implemented Interfaces:
software.amazon.jsii.Builder<OssBackend>
- Enclosing class:
OssBackend
@Stability(Experimental)
public static final class OssBackend.Builder
extends Object
implements software.amazon.jsii.Builder<OssBackend>
(experimental) A fluent builder for
OssBackend.-
Method Summary
Modifier and TypeMethodDescription(experimental) (Optional) Alibaba Cloud access key.(experimental) (Optional) Object ACL to be applied to the state file.assumeRole(OssAssumeRole assumeRole) Deprecated.Use flattened assume role optionsassumeRolePolicy(String assumeRolePolicy) (experimental) (Optional, Available in 1.1.0+) A more restrictive policy to apply to the temporary credentials.assumeRoleRoleArn(String assumeRoleRoleArn) (experimental) (Optional, Available in 1.1.0+) The ARN of the role to assume.assumeRoleSessionExpiration(Number assumeRoleSessionExpiration) (experimental) (Optional, Available in 1.1.0+) The time after which the established session for assuming role expires.assumeRoleSessionName(String assumeRoleSessionName) (experimental) (Optional, Available in 1.1.0+) The session name to use when assuming the role.(experimental) (Required) The name of the OSS bucket.build()static OssBackend.Buildercreate(software.constructs.Construct scope) ecsRoleName(String ecsRoleName) (experimental) (Optional, Available in 0.12.14+) The RAM Role Name attached on a ECS instance for API operations.(experimental) (Optional) Whether to enable server side encryption of the state file.(experimental) (Optional) A custom endpoint for the OSS API.(experimental) (Optional) The name of the state file.(experimental) (Optional) The path directory of the state file will be stored.(experimental) (Optional, Available in 0.12.8+) This is the Alibaba Cloud profile name as set in the shared credentials file.(experimental) (Optional) The region of the OSS bucket.(experimental) (Optional) Alibaba Cloud secret access key.securityToken(String securityToken) (experimental) (Optional) STS access token.sharedCredentialsFile(String sharedCredentialsFile) (experimental) (Optional, Available in 0.12.8+) This is the path to the shared credentials file.stsEndpoint(String stsEndpoint) (experimental) (Optional, Available in 1.0.11+) Custom endpoint for the AliCloud Security Token Service (STS) API.tablestoreEndpoint(String tablestoreEndpoint) (experimental) (Optional) A custom endpoint for the TableStore API.tablestoreTable(String tablestoreTable) (experimental) (Optional) A TableStore table for state locking and consistency.
-
Method Details
-
create
@Stability(Experimental) public static OssBackend.Builder create(software.constructs.Construct scope) - Parameters:
scope- This parameter is required.- Returns:
- a new instance of
OssBackend.Builder.
-
bucket
(experimental) (Required) The name of the OSS bucket.- Parameters:
bucket- (Required) The name of the OSS bucket. This parameter is required.- Returns:
this
-
accessKey
(experimental) (Optional) Alibaba Cloud access key.It supports environment variables ALICLOUD_ACCESS_KEY and ALICLOUD_ACCESS_KEY_ID.
- Parameters:
accessKey- (Optional) Alibaba Cloud access key. This parameter is required.- Returns:
this
-
acl
(experimental) (Optional) Object ACL to be applied to the state file.- Parameters:
acl- (Optional) Object ACL to be applied to the state file. This parameter is required.- Returns:
this
-
assumeRole
Deprecated.Use flattened assume role options- Parameters:
assumeRole- This parameter is required.- Returns:
this
-
assumeRolePolicy
(experimental) (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.- Parameters:
assumeRolePolicy- (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. This parameter is required.- Returns:
this
-
assumeRoleRoleArn
(experimental) (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.- Parameters:
assumeRoleRoleArn- (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. This parameter is required.- Returns:
this
-
assumeRoleSessionExpiration
@Stability(Experimental) public OssBackend.Builder assumeRoleSessionExpiration(Number assumeRoleSessionExpiration) (experimental) (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.- Parameters:
assumeRoleSessionExpiration- (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. This parameter is required.- Returns:
this
-
assumeRoleSessionName
@Stability(Experimental) public OssBackend.Builder assumeRoleSessionName(String assumeRoleSessionName) (experimental) (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.- Parameters:
assumeRoleSessionName- (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. This parameter is required.- Returns:
this
-
ecsRoleName
(experimental) (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.- Parameters:
ecsRoleName- (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. This parameter is required.- Returns:
this
-
encrypt
(experimental) (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.
- Parameters:
encrypt- (Optional) Whether to enable server side encryption of the state file. This parameter is required.- Returns:
this
-
endpoint
(experimental) (Optional) A custom endpoint for the OSS API.It supports environment variables ALICLOUD_OSS_ENDPOINT and OSS_ENDPOINT.
- Parameters:
endpoint- (Optional) A custom endpoint for the OSS API. This parameter is required.- Returns:
this
-
key
(experimental) (Optional) The name of the state file.Defaults to terraform.tfstate.
- Parameters:
key- (Optional) The name of the state file. This parameter is required.- Returns:
this
-
prefix
(experimental) (Optional) The path directory of the state file will be stored.Default to "env:".
- Parameters:
prefix- (Optional) The path directory of the state file will be stored. This parameter is required.- Returns:
this
-
profile
(experimental) (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.- Parameters:
profile- (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. This parameter is required.- Returns:
this
-
region
(experimental) (Optional) The region of the OSS bucket.It supports environment variables ALICLOUD_REGION and ALICLOUD_DEFAULT_REGION.
- Parameters:
region- (Optional) The region of the OSS bucket. This parameter is required.- Returns:
this
-
secretKey
(experimental) (Optional) Alibaba Cloud secret access key.It supports environment variables ALICLOUD_SECRET_KEY and ALICLOUD_ACCESS_KEY_SECRET.
- Parameters:
secretKey- (Optional) Alibaba Cloud secret access key. This parameter is required.- Returns:
this
-
securityToken
(experimental) (Optional) STS access token.It supports environment variable ALICLOUD_SECURITY_TOKEN.
- Parameters:
securityToken- (Optional) STS access token. This parameter is required.- Returns:
this
-
stsEndpoint
(experimental) (Optional, Available in 1.0.11+) Custom endpoint for the AliCloud Security Token Service (STS) API. It supports environment variable ALICLOUD_STS_ENDPOINT.- Parameters:
stsEndpoint- (Optional, Available in 1.0.11+) Custom endpoint for the AliCloud Security Token Service (STS) API. It supports environment variable ALICLOUD_STS_ENDPOINT. This parameter is required.- Returns:
this
-
tablestoreEndpoint
(experimental) (Optional) A custom endpoint for the TableStore API.- Parameters:
tablestoreEndpoint- (Optional) A custom endpoint for the TableStore API. This parameter is required.- Returns:
this
-
tablestoreTable
(experimental) (Optional) A TableStore table for state locking and consistency.The table must have a primary key named LockID of type String.
- Parameters:
tablestoreTable- (Optional) A TableStore table for state locking and consistency. This parameter is required.- Returns:
this
-
build
- Specified by:
buildin interfacesoftware.amazon.jsii.Builder<OssBackend>- Returns:
- a newly built instance of
OssBackend.
-