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.
Initializer
using Io.Cdktn;
new DataTerraformRemoteStateAzurermConfig {
System.Collections.Generic.IDictionary<string, object> Defaults = null,
string Workspace = null,
string ContainerName,
string Key,
string StorageAccountName,
string AccessKey = null,
string ClientCertificatePassword = null,
string ClientCertificatePath = null,
string ClientId = null,
string ClientSecret = null,
string Endpoint = null,
string Environment = null,
string MetadataHost = null,
string MsiEndpoint = null,
string OidcRequestToken = null,
string OidcRequestUrl = null,
string OidcToken = null,
string OidcTokenFilePath = null,
string ResourceGroupName = null,
string SasToken = null,
bool Snapshot = null,
string SubscriptionId = null,
string TenantId = null,
bool UseAzureadAuth = null,
bool UseMicrosoftGraph = null,
bool UseMsi = null,
bool UseOidc = null
};
Properties
| Name | Type | Description |
|---|
Defaults | System.Collections.Generic.IDictionary< string, object > | No description. |
Workspace | string | No description. |
ContainerName | string | (Required) The Name of the Storage Container within the Storage Account. |
Key | string | (Required) The name of the Blob used to retrieve/store Terraform’s State file inside the Storage Container. |
StorageAccountName | string | (Required) The Name of the Storage Account. |
AccessKey | string | access_key - (Optional) The Access Key used to access the Blob Storage Account. |
ClientCertificatePassword | string | (Optional) The password associated with the Client Certificate specified in client_certificate_path. |
ClientCertificatePath | string | (Optional) The path to the PFX file used as the Client Certificate when authenticating as a Service Principal. |
ClientId | string | (Optional) The Client ID of the Service Principal. |
ClientSecret | string | (Optional) The Client Secret of the Service Principal. |
Endpoint | string | (Optional) The Custom Endpoint for Azure Resource Manager. This can also be sourced from the ARM_ENDPOINT environment variable. |
Environment | string | (Optional) The Azure Environment which should be used. |
MetadataHost | string | (Optional) The Hostname of the Azure Metadata Service (for example management.azure.com), used to obtain the Cloud Environment when using a Custom Azure Environment. This can also be sourced from the ARM_METADATA_HOSTNAME Environment Variable.). |
MsiEndpoint | string | (Optional) The path to a custom Managed Service Identity endpoint which is automatically determined if not specified. |
OidcRequestToken | string | (Optional) The bearer token for the request to the OIDC provider. |
OidcRequestUrl | string | (Optional) The URL for the OIDC provider from which to request an ID token. |
OidcToken | string | (Optional) The ID token when authenticating using OpenID Connect (OIDC). |
OidcTokenFilePath | string | (Optional) The path to a file containing an ID token when authenticating using OpenID Connect (OIDC). |
ResourceGroupName | string | (Required) The Name of the Resource Group in which the Storage Account exists. |
SasToken | string | (Optional) The SAS Token used to access the Blob Storage Account. |
Snapshot | bool | (Optional) Should the Blob used to store the Terraform Statefile be snapshotted before use? |
SubscriptionId | string | (Optional) The Subscription ID in which the Storage Account exists. |
TenantId | string | (Optional) The Tenant ID in which the Subscription exists. |
UseAzureadAuth | bool | (Optional) Should AzureAD Authentication be used to access the Blob Storage Account. |
UseMicrosoftGraph | bool | (Optional) Should MSAL be used for authentication instead of ADAL, and should Microsoft Graph be used instead of Azure Active Directory Graph? |
UseMsi | bool | (Optional) Should Managed Service Identity authentication be used? |
UseOidc | bool | (Optional) Should OIDC authentication be used? This can also be sourced from the ARM_USE_OIDC environment variable. |
DefaultsOptional
public System.Collections.Generic.IDictionary<string, object> Defaults { get; set; }
- Type: System.Collections.Generic.IDictionary< string, object >
WorkspaceOptional
public string Workspace { get; set; }
ContainerNameRequired
public string ContainerName { get; set; }
(Required) The Name of the Storage Container within the Storage Account.
KeyRequired
public string Key { get; set; }
(Required) The name of the Blob used to retrieve/store Terraform’s State file inside the Storage Container.
StorageAccountNameRequired
public string StorageAccountName { get; set; }
(Required) The Name of the Storage Account.
AccessKeyOptional
public string AccessKey { get; set; }
access_key - (Optional) The Access Key used to access the Blob Storage Account.
This can also be sourced from the ARM_ACCESS_KEY environment variable.
ClientCertificatePasswordOptional
public string ClientCertificatePassword { get; set; }
(Optional) The password associated with the Client Certificate specified in client_certificate_path.
This can also be sourced from the
ARM_CLIENT_CERTIFICATE_PASSWORD environment variable.
ClientCertificatePathOptional
public string ClientCertificatePath { get; set; }
(Optional) The path to the PFX file used as the Client Certificate when authenticating as a Service Principal.
This can also be sourced from the
ARM_CLIENT_CERTIFICATE_PATH environment variable.
ClientIdOptional
public string ClientId { get; set; }
(Optional) The Client ID of the Service Principal.
This can also be sourced from the ARM_CLIENT_ID environment variable.
ClientSecretOptional
public string ClientSecret { get; set; }
(Optional) The Client Secret of the Service Principal.
This can also be sourced from the ARM_CLIENT_SECRET environment variable.
EndpointOptional
public string Endpoint { get; set; }
(Optional) The Custom Endpoint for Azure Resource Manager. This can also be sourced from the ARM_ENDPOINT environment variable.
NOTE: An endpoint should only be configured when using Azure Stack.
EnvironmentOptional
public string Environment { get; set; }
(Optional) The Azure Environment which should be used.
This can also be sourced from the ARM_ENVIRONMENT environment variable.
Possible values are public, china, german, stack and usgovernment. Defaults to public.
public string MetadataHost { get; set; }
(Optional) The Hostname of the Azure Metadata Service (for example management.azure.com), used to obtain the Cloud Environment when using a Custom Azure Environment. This can also be sourced from the ARM_METADATA_HOSTNAME Environment Variable.).
MsiEndpointOptional
public string MsiEndpoint { get; set; }
(Optional) The path to a custom Managed Service Identity endpoint which is automatically determined if not specified.
This can also be sourced from the ARM_MSI_ENDPOINT environment variable.
OidcRequestTokenOptional
public string OidcRequestToken { get; set; }
(Optional) The bearer token for the request to the OIDC provider.
This can
also be sourced from the ARM_OIDC_REQUEST_TOKEN or
ACTIONS_ID_TOKEN_REQUEST_TOKEN environment variables.
OidcRequestUrlOptional
public string OidcRequestUrl { get; set; }
(Optional) The URL for the OIDC provider from which to request an ID token.
This can also be sourced from the ARM_OIDC_REQUEST_URL or
ACTIONS_ID_TOKEN_REQUEST_URL environment variables.
OidcTokenOptional
public string OidcToken { get; set; }
(Optional) The ID token when authenticating using OpenID Connect (OIDC).
This can also be sourced from the ARM_OIDC_TOKEN environment variable.
OidcTokenFilePathOptional
public string OidcTokenFilePath { get; set; }
(Optional) The path to a file containing an ID token when authenticating using OpenID Connect (OIDC).
This can also be sourced from the ARM_OIDC_TOKEN_FILE_PATH environment variable.
ResourceGroupNameOptional
public string ResourceGroupName { get; set; }
(Required) The Name of the Resource Group in which the Storage Account exists.
SasTokenOptional
public string SasToken { get; set; }
(Optional) The SAS Token used to access the Blob Storage Account.
This can also be sourced from the ARM_SAS_TOKEN environment variable.
SnapshotOptional
public bool Snapshot { get; set; }
(Optional) Should the Blob used to store the Terraform Statefile be snapshotted before use?
Defaults to false. This value can also be sourced
from the ARM_SNAPSHOT environment variable.
SubscriptionIdOptional
public string SubscriptionId { get; set; }
(Optional) The Subscription ID in which the Storage Account exists.
This can also be sourced from the ARM_SUBSCRIPTION_ID environment variable.
TenantIdOptional
public string TenantId { get; set; }
(Optional) The Tenant ID in which the Subscription exists.
This can also be sourced from the ARM_TENANT_ID environment variable.
UseAzureadAuthOptional
public bool UseAzureadAuth { get; set; }
(Optional) Should AzureAD Authentication be used to access the Blob Storage Account.
This can also be sourced from the ARM_USE_AZUREAD environment
variable.
Note: When using AzureAD for Authentication to Storage you also need to
ensure the Storage Blob Data Owner role is assigned.
UseMicrosoftGraphOptional
public bool UseMicrosoftGraph { get; set; }
(Optional) Should MSAL be used for authentication instead of ADAL, and should Microsoft Graph be used instead of Azure Active Directory Graph?
Defaults to true.
Note: In Terraform 1.2 the Azure Backend uses MSAL (and Microsoft Graph)
rather than ADAL (and Azure Active Directory Graph) for authentication by
default - you can disable this by setting use_microsoft_graph to false.
This setting will be removed in Terraform 1.3, due to Microsoft’s
deprecation of ADAL.
UseMsiOptional
public bool UseMsi { get; set; }
(Optional) Should Managed Service Identity authentication be used?
This can also be sourced from the ARM_USE_MSI environment variable.
UseOidcOptional
public bool UseOidc { get; set; }
(Optional) Should OIDC authentication be used? This can also be sourced from the ARM_USE_OIDC environment variable.
Note: When using OIDC for authentication, use_microsoft_graph
must be set to true (which is the default).