com.databricks.sdk.service.catalog

Class ExternalLocationsAPI

java.lang.Object

com.databricks.sdk.service.catalog.ExternalLocationsAPI

@Generated
public class ExternalLocationsAPI
extends Object

An external location is an object that combines a cloud storage path with a storage credential that authorizes access to the cloud storage path. Each external location is subject to Unity Catalog access-control policies that control which users and groups can access the credential. If a user does not have access to an external location in Unity Catalog, the request fails and Unity Catalog does not attempt to authenticate to your cloud tenant on the user’s behalf.

Databricks recommends using external locations rather than using storage credentials directly.

To create external locations, you must be a metastore admin or a user with the **CREATE_EXTERNAL_LOCATION** privilege.

Constructor Summary

Constructors

Constructor and Description
ExternalLocationsAPI(ApiClient apiClient) Regular-use constructor
ExternalLocationsAPI(ExternalLocationsService mock) Constructor for mocks

Method Summary

Modifier and Type	Method and Description
ExternalLocationInfo	create(CreateExternalLocation request) Create an external location.
ExternalLocationInfo	create(String name, String url, String credentialName)
void	delete(DeleteExternalLocationRequest request) Delete an external location.
void	delete(String name)
ExternalLocationInfo	get(GetExternalLocationRequest request) Get an external location.
ExternalLocationInfo	get(String name)
ExternalLocationsService	impl()
Iterable<ExternalLocationInfo>	list() List external locations.
ExternalLocationInfo	update(String name)
ExternalLocationInfo	update(UpdateExternalLocation request) Update an external location.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ExternalLocationsAPI

public ExternalLocationsAPI(ApiClient apiClient)

Regular-use constructor

ExternalLocationsAPI

public ExternalLocationsAPI(ExternalLocationsService mock)

Constructor for mocks

Method Detail

create

public ExternalLocationInfo create(String name,
                                   String url,
                                   String credentialName)

create

public ExternalLocationInfo create(CreateExternalLocation request)

Create an external location.

Creates a new external location entry in the metastore. The caller must be a metastore admin or have the **CREATE_EXTERNAL_LOCATION** privilege on both the metastore and the associated storage credential.

delete

public void delete(String name)

delete

public void delete(DeleteExternalLocationRequest request)

Delete an external location.

Deletes the specified external location from the metastore. The caller must be the owner of the external location.

get

public ExternalLocationInfo get(String name)

get

public ExternalLocationInfo get(GetExternalLocationRequest request)

Get an external location.

Gets an external location from the metastore. The caller must be either a metastore admin, the owner of the external location, or a user that has some privilege on the external location.

list

public Iterable<ExternalLocationInfo> list()

List external locations.

Gets an array of external locations (__ExternalLocationInfo__ objects) from the metastore. The caller must be a metastore admin, the owner of the external location, or a user that has some privilege on the external location. There is no guarantee of a specific ordering of the elements in the array.

update

public ExternalLocationInfo update(String name)

update

public ExternalLocationInfo update(UpdateExternalLocation request)

Update an external location.

Updates an external location in the metastore. The caller must be the owner of the external location, or be a metastore admin. In the second case, the admin can only update the name of the external location.

impl

public ExternalLocationsService impl()