Class S3BackendConfig.Jsii$Proxy
- All Implemented Interfaces:
S3BackendConfig
,software.amazon.jsii.JsiiSerializable
- Enclosing interface:
S3BackendConfig
S3BackendConfig
-
Nested Class Summary
Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject
software.amazon.jsii.JsiiObject.InitializationMode
Nested classes/interfaces inherited from interface com.hashicorp.cdktf.S3BackendConfig
S3BackendConfig.Builder, S3BackendConfig.Jsii$Proxy
-
Constructor Summary
ConstructorsModifierConstructorDescriptionprotected
Jsii$Proxy
(S3BackendConfig.Builder builder) Constructor that initializes the object based on literal property values passed by theS3BackendConfig.Builder
.protected
Jsii$Proxy
(software.amazon.jsii.JsiiObjectRef objRef) Constructor that initializes the object based on values retrieved from the JsiiObject. -
Method Summary
Modifier and TypeMethodDescriptioncom.fasterxml.jackson.databind.JsonNode
final boolean
final String
(experimental) (Optional) AWS access key.final String
getAcl()
(experimental) (Optional) Canned ACL to be applied to the state file.final String
(experimental) (Optional) List of allowed AWS account IDs to prevent potential destruction of a live environment.(experimental) Assuming an IAM Role can be configured in two ways.final String
(deprecated) (Optional) IAM Policy JSON describing further restricting permissions for the IAM Role being assumed.(deprecated) (Optional) Set of Amazon Resource Names (ARNs) of IAM Policies describing further restricting permissions for the IAM Role being assumed.(deprecated) (Optional) Map of assume role session tags.(deprecated) (Optional) Set of assume role session tag keys to pass to any subsequent sessions.(experimental) Assume Role With Web Identity Configuration.final String
(experimental) Name of the S3 Bucket.final String
(experimental) (Optional) File containing custom root and intermediate certificates.final String
(deprecated) (Optional) Custom endpoint for the AWS DynamoDB API.final String
(experimental) (Optional) Name of DynamoDB Table to use for state locking and consistency.final String
(experimental) Optional) Custom endpoint URL for the EC2 Instance Metadata Service (IMDS) API.final String
(experimental) (Optional) Mode to use in communicating with the metadata service.final Boolean
(experimental) (Optional) Enable server side encryption of the state file.final String
(deprecated) (Optional) Custom endpoint for the AWS S3 API.final S3BackendEndpointConfig
(experimental) (Optional) The endpoint configuration block.final String
(deprecated) (Optional) External identifier to use when assuming the role.final String
(experimental) (Optional) List of forbidden AWS account IDs to prevent potential destruction of a live environment.final Boolean
(deprecated) (Optional) Enable path-style S3 URLs (https:/// instead of https:// . ). final String
(experimental) (Optional) URL of a proxy to use for HTTP requests when accessing the AWS API.final String
(experimental) (Optional) URL of a proxy to use for HTTPS requests when accessing the AWS API.final String
(deprecated) (Optional) Custom endpoint for the AWS Identity and Access Management (IAM) API.final Boolean
(experimental) Optional) Whether to explicitly allow the backend to perform "insecure" SSL requests.final String
getKey()
(experimental) Path to the state file inside the S3 Bucket.final String
(experimental) (Optional) Amazon Resource Name (ARN) of a Key Management Service (KMS) Key to use for encrypting the state.final Number
(experimental) (Optional) The maximum number of times an AWS API request is retried on retryable failure.final String
(experimental) (Optional) Comma-separated list of hosts that should not use HTTP or HTTPS proxies.final String
(experimental) (Optional) Name of AWS profile in AWS shared credentials file (e.g.final String
(experimental) AWS Region of the S3 Bucket and DynamoDB Table (if used).final String
(experimental) (Optional) Specifies how retries are attempted.final String
(deprecated) (Optional) Amazon Resource Name (ARN) of the IAM Role to assume.final String
(experimental) (Optional) AWS secret access key.final String
(deprecated) (Optional) Session name to use when assuming the role.(experimental) (Optional) List of paths to AWS shared configuration files.final String
(experimental) (Optional) Path to the AWS shared credentials file.(experimental) (Optional) List of paths to AWS shared credentials files.final Boolean
(experimental) (Optional) Skip credentials validation via the STS API.final Boolean
(experimental) (Optional) Skip usage of EC2 Metadata API.final Boolean
(experimental) (Optional) Skip validation of provided region name.final Boolean
(experimental) (Optional) Whether to skip requesting the account ID.final Boolean
(experimental) (Optional) Do not include checksum when uploading S3 Objects.final String
(experimental) (Optional) The key to use for encrypting state with Server-Side Encryption with Customer-Provided Keys (SSE-C).final String
(deprecated) (Optional) Custom endpoint for the AWS Security Token Service (STS) API.final String
(experimental) (Optional) AWS region for STS.final String
getToken()
(experimental) (Optional) Multi-Factor Authentication (MFA) token.final Boolean
(experimental) (Optional) Use the legacy authentication workflow, preferring environment variables over backend configuration.final Boolean
(experimental) (Optional) Enable path-style S3 URLs (https:/// instead of https:// . ). final String
(experimental) (Optional) Prefix applied to the state path inside the bucket.final int
hashCode()
Methods inherited from class software.amazon.jsii.JsiiObject
jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet
-
Constructor Details
-
Jsii$Proxy
protected Jsii$Proxy(software.amazon.jsii.JsiiObjectRef objRef) Constructor that initializes the object based on values retrieved from the JsiiObject.- Parameters:
objRef
- Reference to the JSII managed object.
-
Jsii$Proxy
Constructor that initializes the object based on literal property values passed by theS3BackendConfig.Builder
.
-
-
Method Details
-
getBucket
Description copied from interface:S3BackendConfig
(experimental) Name of the S3 Bucket.- Specified by:
getBucket
in interfaceS3BackendConfig
-
getKey
Description copied from interface:S3BackendConfig
(experimental) Path to the state file inside the S3 Bucket.When using a non-default workspace, the state path will be /workspace_key_prefix/workspace_name/key
- Specified by:
getKey
in interfaceS3BackendConfig
-
getAccessKey
Description copied from interface:S3BackendConfig
(experimental) (Optional) AWS access key.If configured, must also configure secret_key. This can also be sourced from the AWS_ACCESS_KEY_ID environment variable, AWS shared credentials file (e.g. ~/.aws/credentials), or AWS shared configuration file (e.g. ~/.aws/config).
- Specified by:
getAccessKey
in interfaceS3BackendConfig
-
getAcl
Description copied from interface:S3BackendConfig
(experimental) (Optional) Canned ACL to be applied to the state file.- Specified by:
getAcl
in interfaceS3BackendConfig
-
getAllowedAccountIds
Description copied from interface:S3BackendConfig
(experimental) (Optional) List of allowed AWS account IDs to prevent potential destruction of a live environment.Conflicts with forbidden_account_ids.
- Specified by:
getAllowedAccountIds
in interfaceS3BackendConfig
-
getAssumeRole
Description copied from interface:S3BackendConfig
(experimental) Assuming an IAM Role can be configured in two ways.The preferred way is to use the argument assume_role, the other, which is deprecated, is with arguments at the top level.
- Specified by:
getAssumeRole
in interfaceS3BackendConfig
-
getAssumeRolePolicy
Description copied from interface:S3BackendConfig
(deprecated) (Optional) IAM Policy JSON describing further restricting permissions for the IAM Role being assumed.- Specified by:
getAssumeRolePolicy
in interfaceS3BackendConfig
-
getAssumeRolePolicyArns
Description copied from interface:S3BackendConfig
(deprecated) (Optional) Set of Amazon Resource Names (ARNs) of IAM Policies describing further restricting permissions for the IAM Role being assumed.- Specified by:
getAssumeRolePolicyArns
in interfaceS3BackendConfig
-
getAssumeRoleTags
Description copied from interface:S3BackendConfig
(deprecated) (Optional) Map of assume role session tags.- Specified by:
getAssumeRoleTags
in interfaceS3BackendConfig
-
getAssumeRoleTransitiveTagKeys
Description copied from interface:S3BackendConfig
(deprecated) (Optional) Set of assume role session tag keys to pass to any subsequent sessions.- Specified by:
getAssumeRoleTransitiveTagKeys
in interfaceS3BackendConfig
-
getAssumeRoleWithWebIdentity
Description copied from interface:S3BackendConfig
(experimental) Assume Role With Web Identity Configuration.- Specified by:
getAssumeRoleWithWebIdentity
in interfaceS3BackendConfig
-
getCustomCaBundle
Description copied from interface:S3BackendConfig
(experimental) (Optional) File containing custom root and intermediate certificates.Can also be set using the AWS_CA_BUNDLE environment variable. Setting ca_bundle in the shared config file is not supported.
- Specified by:
getCustomCaBundle
in interfaceS3BackendConfig
-
getDynamodbEndpoint
Description copied from interface:S3BackendConfig
(deprecated) (Optional) Custom endpoint for the AWS DynamoDB API.This can also be sourced from the AWS_DYNAMODB_ENDPOINT environment variable.
- Specified by:
getDynamodbEndpoint
in interfaceS3BackendConfig
-
getDynamodbTable
Description copied from interface:S3BackendConfig
(experimental) (Optional) Name of DynamoDB Table to use for state locking and consistency.The table must have a partition key named LockID with type of String. If not configured, state locking will be disabled.
- Specified by:
getDynamodbTable
in interfaceS3BackendConfig
-
getEc2MetadataServiceEndpoint
Description copied from interface:S3BackendConfig
(experimental) Optional) Custom endpoint URL for the EC2 Instance Metadata Service (IMDS) API.Can also be set with the AWS_EC2_METADATA_SERVICE_ENDPOINT environment variable.
- Specified by:
getEc2MetadataServiceEndpoint
in interfaceS3BackendConfig
-
getEc2MetadataServiceEndpointMode
Description copied from interface:S3BackendConfig
(experimental) (Optional) Mode to use in communicating with the metadata service.Valid values are IPv4 and IPv6. Can also be set with the AWS_EC2_METADATA_SERVICE_ENDPOINT_MODE environment variable.
- Specified by:
getEc2MetadataServiceEndpointMode
in interfaceS3BackendConfig
-
getEncrypt
Description copied from interface:S3BackendConfig
(experimental) (Optional) Enable server side encryption of the state file.- Specified by:
getEncrypt
in interfaceS3BackendConfig
-
getEndpoint
Description copied from interface:S3BackendConfig
(deprecated) (Optional) Custom endpoint for the AWS S3 API.This can also be sourced from the AWS_S3_ENDPOINT environment variable.
- Specified by:
getEndpoint
in interfaceS3BackendConfig
-
getEndpoints
Description copied from interface:S3BackendConfig
(experimental) (Optional) The endpoint configuration block.- Specified by:
getEndpoints
in interfaceS3BackendConfig
-
getExternalId
Description copied from interface:S3BackendConfig
(deprecated) (Optional) External identifier to use when assuming the role.- Specified by:
getExternalId
in interfaceS3BackendConfig
-
getForbiddenAccountIds
Description copied from interface:S3BackendConfig
(experimental) (Optional) List of forbidden AWS account IDs to prevent potential destruction of a live environment.Conflicts with allowed_account_ids.
- Specified by:
getForbiddenAccountIds
in interfaceS3BackendConfig
-
getForcePathStyle
Description copied from interface:S3BackendConfig
(deprecated) (Optional) Enable path-style S3 URLs (https:/// instead of https:// . ). - Specified by:
getForcePathStyle
in interfaceS3BackendConfig
-
getHttpProxy
Description copied from interface:S3BackendConfig
(experimental) (Optional) URL of a proxy to use for HTTP requests when accessing the AWS API.Can also be set using the HTTP_PROXY or http_proxy environment variables.
- Specified by:
getHttpProxy
in interfaceS3BackendConfig
-
getHttpsProxy
Description copied from interface:S3BackendConfig
(experimental) (Optional) URL of a proxy to use for HTTPS requests when accessing the AWS API.Can also be set using the HTTPS_PROXY or https_proxy environment variables.
- Specified by:
getHttpsProxy
in interfaceS3BackendConfig
-
getIamEndpoint
Description copied from interface:S3BackendConfig
(deprecated) (Optional) Custom endpoint for the AWS Identity and Access Management (IAM) API.This can also be sourced from the AWS_IAM_ENDPOINT environment variable.
- Specified by:
getIamEndpoint
in interfaceS3BackendConfig
-
getInsecure
Description copied from interface:S3BackendConfig
(experimental) Optional) Whether to explicitly allow the backend to perform "insecure" SSL requests.If omitted, the default value is false.
- Specified by:
getInsecure
in interfaceS3BackendConfig
-
getKmsKeyId
Description copied from interface:S3BackendConfig
(experimental) (Optional) Amazon Resource Name (ARN) of a Key Management Service (KMS) Key to use for encrypting the state.Note that if this value is specified, Terraform will need kms:Encrypt, kms:Decrypt and kms:GenerateDataKey permissions on this KMS key.
- Specified by:
getKmsKeyId
in interfaceS3BackendConfig
-
getMaxRetries
Description copied from interface:S3BackendConfig
(experimental) (Optional) The maximum number of times an AWS API request is retried on retryable failure.Defaults to 5.
- Specified by:
getMaxRetries
in interfaceS3BackendConfig
-
getNoProxy
Description copied from interface:S3BackendConfig
(experimental) (Optional) Comma-separated list of hosts that should not use HTTP or HTTPS proxies.Each value can be one of:
- A domain name
- An IP address
- A CIDR address
- An asterisk (*), to indicate that no proxying should be performed Domain name and IP address values can also include a port number. Can also be set using the NO_PROXY or no_proxy environment variables.
- Specified by:
getNoProxy
in interfaceS3BackendConfig
-
getProfile
Description copied from interface:S3BackendConfig
(experimental) (Optional) Name of AWS profile in AWS shared credentials file (e.g. ~/.aws/credentials) or AWS shared configuration file (e.g. ~/.aws/config) to use for credentials and/or configuration. This can also be sourced from the AWS_PROFILE environment variable.- Specified by:
getProfile
in interfaceS3BackendConfig
-
getRegion
Description copied from interface:S3BackendConfig
(experimental) AWS Region of the S3 Bucket and DynamoDB Table (if used).This can also be sourced from the AWS_DEFAULT_REGION and AWS_REGION environment variables.
- Specified by:
getRegion
in interfaceS3BackendConfig
-
getRetryMode
Description copied from interface:S3BackendConfig
(experimental) (Optional) Specifies how retries are attempted.Valid values are standard and adaptive. Can also be configured using the AWS_RETRY_MODE environment variable or the shared config file parameter retry_mode.
- Specified by:
getRetryMode
in interfaceS3BackendConfig
-
getRoleArn
Description copied from interface:S3BackendConfig
(deprecated) (Optional) Amazon Resource Name (ARN) of the IAM Role to assume.- Specified by:
getRoleArn
in interfaceS3BackendConfig
-
getSecretKey
Description copied from interface:S3BackendConfig
(experimental) (Optional) AWS secret access key.If configured, must also configure access_key. This can also be sourced from the AWS_SECRET_ACCESS_KEY environment variable, AWS shared credentials file (e.g. ~/.aws/credentials), or AWS shared configuration file (e.g. ~/.aws/config)
- Specified by:
getSecretKey
in interfaceS3BackendConfig
-
getSessionName
Description copied from interface:S3BackendConfig
(deprecated) (Optional) Session name to use when assuming the role.- Specified by:
getSessionName
in interfaceS3BackendConfig
-
getSkipCredentialsValidation
Description copied from interface:S3BackendConfig
(experimental) (Optional) Skip credentials validation via the STS API.- Specified by:
getSkipCredentialsValidation
in interfaceS3BackendConfig
-
getSkipMetadataApiCheck
Description copied from interface:S3BackendConfig
(experimental) (Optional) Skip usage of EC2 Metadata API.- Specified by:
getSkipMetadataApiCheck
in interfaceS3BackendConfig
-
getSkipRegionValidation
Description copied from interface:S3BackendConfig
(experimental) (Optional) Skip validation of provided region name.- Specified by:
getSkipRegionValidation
in interfaceS3BackendConfig
-
getSkipRequestingAccountId
Description copied from interface:S3BackendConfig
(experimental) (Optional) Whether to skip requesting the account ID.Useful for AWS API implementations that do not have the IAM, STS API, or metadata API.
- Specified by:
getSkipRequestingAccountId
in interfaceS3BackendConfig
-
getSkipS3Checksum
Description copied from interface:S3BackendConfig
(experimental) (Optional) Do not include checksum when uploading S3 Objects.Useful for some S3-Compatible APIs.
- Specified by:
getSkipS3Checksum
in interfaceS3BackendConfig
-
getSseCustomerKey
Description copied from interface:S3BackendConfig
(experimental) (Optional) The key to use for encrypting state with Server-Side Encryption with Customer-Provided Keys (SSE-C).This is the base64-encoded value of the key, which must decode to 256 bits. This can also be sourced from the AWS_SSE_CUSTOMER_KEY environment variable, which is recommended due to the sensitivity of the value. Setting it inside a terraform file will cause it to be persisted to disk in terraform.tfstate.
- Specified by:
getSseCustomerKey
in interfaceS3BackendConfig
-
getStsEndpoint
Description copied from interface:S3BackendConfig
(deprecated) (Optional) Custom endpoint for the AWS Security Token Service (STS) API.This can also be sourced from the AWS_STS_ENDPOINT environment variable.
- Specified by:
getStsEndpoint
in interfaceS3BackendConfig
-
getStsRegion
Description copied from interface:S3BackendConfig
(experimental) (Optional) AWS region for STS.If unset, AWS will use the same region for STS as other non-STS operations.
- Specified by:
getStsRegion
in interfaceS3BackendConfig
-
getToken
Description copied from interface:S3BackendConfig
(experimental) (Optional) Multi-Factor Authentication (MFA) token.This can also be sourced from the AWS_SESSION_TOKEN environment variable.
- Specified by:
getToken
in interfaceS3BackendConfig
-
getUseLegacyWorkflow
Description copied from interface:S3BackendConfig
(experimental) (Optional) Use the legacy authentication workflow, preferring environment variables over backend configuration.Defaults to true. This behavior does not align with the authentication flow of the AWS CLI or SDK's, and will be removed in the future.
- Specified by:
getUseLegacyWorkflow
in interfaceS3BackendConfig
-
getUsePathStyle
Description copied from interface:S3BackendConfig
(experimental) (Optional) Enable path-style S3 URLs (https:/// instead of https:// . ). - Specified by:
getUsePathStyle
in interfaceS3BackendConfig
-
getWorkspaceKeyPrefix
Description copied from interface:S3BackendConfig
(experimental) (Optional) Prefix applied to the state path inside the bucket.This is only relevant when using a non-default workspace. Defaults to env:
- Specified by:
getWorkspaceKeyPrefix
in interfaceS3BackendConfig
-
$jsii$toJson
@Internal public com.fasterxml.jackson.databind.JsonNode $jsii$toJson()- Specified by:
$jsii$toJson
in interfacesoftware.amazon.jsii.JsiiSerializable
-
equals
-
hashCode
public final int hashCode()
-