subcategory |
---|
AWS |
-> Public Preview This feature is in Public Preview. Contact your Databricks representative to request access.
Allows you to create a Private Access Setting that can be used as part of a databricks_mws_workspaces resource to create a Databricks Workspace that leverages AWS PrivateLink.
It is strongly recommended that customers read the Enable Private Link documentation before trying to leverage this resource.
-> Note This resource has an evolving API, which will change in the upcoming versions of the provider in order to simplify user experience.
resource "databricks_mws_private_access_settings" "pas" {
provider = databricks.mws
account_id = var.databricks_account_id
private_access_settings_name = "Private Access Settings for ${local.prefix}"
region = var.region
public_access_enabled = true
}
The databricks_mws_private_access_settings.pas.private_access_settings_id
can then be used as part of a databricks_mws_workspaces resource:
resource "databricks_mws_workspaces" "this" {
provider = databricks.mws
account_id = var.databricks_account_id
aws_region = var.region
workspace_name = local.prefix
credentials_id = databricks_mws_credentials.this.credentials_id
storage_configuration_id = databricks_mws_storage_configurations.this.storage_configuration_id
network_id = databricks_mws_networks.this.network_id
private_access_settings_id = databricks_mws_private_access_settings.pas.private_access_settings_id
pricing_tier = "ENTERPRISE"
depends_on = [databricks_mws_networks.this]
}
The following arguments are available:
account_id
- Account Id that could be found in the bottom left corner of Accounts Consoleprivate_access_settings_name
- Name of Private Access Settings in Databricks Accountpublic_access_enabled
(Boolean, Optional,false
by default) - Iftrue
, the databricks_mws_workspaces can be accessed over the databricks_mws_vpc_endpoint as well as over the public network. In such a case, you could also configure an databricks_ip_access_list for the workspace, to restrict the source networks that could be used to access it over the public network. Iffalse
(default), the workspace can be accessed only over VPC endpoints, and not over the public network.region
- Region of AWS VPCprivate_access_level
- (Optional) The private access level controls which VPC endpoints can connect to the UI or API of any workspace that attaches this private access settings object.ACCOUNT
level access (default) lets only databricks_mws_vpc_endpoint that are registered in your Databricks account connect to your databricks_mws_workspaces.ENDPOINT
level access lets only specified databricks_mws_vpc_endpoint connect to your workspace. Please see theallowed_vpc_endpoint_ids
documentation for more details.allowed_vpc_endpoint_ids
- (Optional) An array of databricks_mws_vpc_endpointvpc_endpoint_id
(notid
). Only used whenprivate_access_level
is set toENDPOINT
. This is an allow list of databricks_mws_vpc_endpoint that in your account that can connect to your databricks_mws_workspaces over AWS PrivateLink. If hybrid access to your workspace is enabled by settingpublic_access_enabled
to true, then this control only works for PrivateLink connections. To control how your workspace is accessed via public internet, see the article for databricks_ip_access_list.
In addition to all arguments above, the following attributes are exported:
private_access_settings_id
- Canonical unique identifier of Private Access Settings in Databricks Accountstatus
- Status of Private Access Settings
-> Note Importing this resource is not currently supported.
The following resources are used in the same context:
- Provisioning Databricks on AWS guide.
- Provisioning Databricks on AWS with PrivateLink guide.
- Provisioning AWS Databricks E2 with a Hub & Spoke firewall for data exfiltration protection guide.
- databricks_mws_vpc_endpoint to register aws_vpc_endpoint resources with Databricks such that they can be used as part of a databricks_mws_networks configuration.
- databricks_mws_networks to configure VPC & subnets for new workspaces within AWS.
- databricks_mws_workspaces to set up workspaces in E2 architecture on AWS.