enable_ip_access_lists

Creates, updates, deletes, gets or lists an enable_ip_access_lists resource.

Overview

Name	enable_ip_access_lists
Type	Resource
Id	databricks_workspace.settings.enable_ip_access_lists

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
setting_name	string	Name of the corresponding setting. This field is populated in the response, but it will not be respected even if it's set in the request body. The setting name in the path parameter will be respected instead. Setting name is required to be 'default' if the setting only has one instance per workspace.
▶acct_ip_acl_enable	object
etag	string	etag used for versioning. The response is at least as fresh as the eTag provided. This is used for optimistic concurrency control as a way to help prevent simultaneous writes of a setting overwriting each other. It is strongly suggested that systems make use of the etag in the read -> update pattern to perform setting updates in order to avoid race conditions. That is, get an etag from a GET request, and pass it with the PATCH request to identify the setting version you are updating.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	account_id, deployment_name	etag	Gets the value of the account IP access toggle setting.
update	update	account_id, deployment_name, allow_missing, setting, field_mask		Updates the value of the account IP access toggle setting.
delete	delete	account_id, deployment_name	etag	Reverts the value of the account IP access toggle setting to default (ON)

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
account_id	string
deployment_name	string	The Databricks Workspace Deployment Name (default: dbc-abcd0123-a1bc)
etag	string	etag used for versioning. The response is at least as fresh as the eTag provided. This is used for optimistic concurrency control as a way to help prevent simultaneous writes of a setting overwriting each other. It is strongly suggested that systems make use of the etag in the read -> delete pattern to perform setting deletions in order to avoid race conditions. That is, get an etag from a GET request, and pass it with the DELETE request to identify the rule set version you are deleting.

SELECT examples

get

Gets the value of the account IP access toggle setting.

SELECT
setting_name,
acct_ip_acl_enable,
etag
FROM databricks_workspace.settings.enable_ip_access_lists
WHERE account_id = '{{ account_id }}' -- required
AND deployment_name = '{{ deployment_name }}' -- required
AND etag = '{{ etag }}'
;

UPDATE examples

update

Updates the value of the account IP access toggle setting.

UPDATE databricks_workspace.settings.enable_ip_access_lists
SET 
allow_missing = {{ allow_missing }},
setting = '{{ setting }}',
field_mask = '{{ field_mask }}'
WHERE 
account_id = '{{ account_id }}' --required
AND deployment_name = '{{ deployment_name }}' --required
AND allow_missing = {{ allow_missing }} --required
AND setting = '{{ setting }}' --required
AND field_mask = '{{ field_mask }}' --required
RETURNING
setting_name,
acct_ip_acl_enable,
etag;

DELETE examples

delete

Reverts the value of the account IP access toggle setting to default (ON)

DELETE FROM databricks_workspace.settings.enable_ip_access_lists
WHERE account_id = '{{ account_id }}' --required
AND deployment_name = '{{ deployment_name }}' --required
AND etag = '{{ etag }}'
;