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) Creates a new external location entry in the metastore.
void	delete(DeleteExternalLocationRequest request) Deletes the specified external location from the metastore.
void	delete(String name)
ExternalLocationInfo	get(GetExternalLocationRequest request) Gets an external location from the metastore.
ExternalLocationInfo	get(String name)
ExternalLocationsService	impl()
Iterable<ExternalLocationInfo>	list(ListExternalLocationsRequest request) Gets an array of external locations (__ExternalLocationInfo__ objects) from the metastore.
ExternalLocationInfo	update(UpdateExternalLocation request) Updates an external location in the metastore.

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(CreateExternalLocation request)

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)

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)

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(ListExternalLocationsRequest request)

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.

NOTE: we recommend using max_results=0 to use the paginated version of this API. Unpaginated calls will be deprecated soon.

PAGINATION BEHAVIOR: When using pagination (max_results >= 0), a page may contain zero results while still providing a next_page_token. Clients must continue reading pages until next_page_token is absent, which is the only indication that the end of results has been reached.

update

public ExternalLocationInfo update(UpdateExternalLocation request)

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()