com.databricks.sdk.service.catalog

Interface CredentialsService

@Generated
public interface CredentialsService

A credential represents an authentication and authorization mechanism for accessing services on your cloud tenant. Each credential is subject to Unity Catalog access-control policies that control which users and groups can access the credential.

To create credentials, you must be a Databricks account admin or have the `CREATE SERVICE CREDENTIAL privilege. The user who creates the credential can delegate ownership to another user or group to manage permissions on it

This is the high-level interface, that contains generated methods.

Evolving: this interface is under development. Method signatures may change.

Method Summary

Modifier and Type	Method and Description
CredentialInfo	createCredential(CreateCredentialRequest createCredentialRequest) Create a credential.
void	deleteCredential(DeleteCredentialRequest deleteCredentialRequest) Delete a credential.
TemporaryCredentials	generateTemporaryServiceCredential(GenerateTemporaryServiceCredentialRequest generateTemporaryServiceCredentialRequest) Generate a temporary service credential.
CredentialInfo	getCredential(GetCredentialRequest getCredentialRequest) Get a credential.
ListCredentialsResponse	listCredentials(ListCredentialsRequest listCredentialsRequest) List credentials.
CredentialInfo	updateCredential(UpdateCredentialRequest updateCredentialRequest) Update a credential.
ValidateCredentialResponse	validateCredential(ValidateCredentialRequest validateCredentialRequest) Validate a credential.

Method Detail

createCredential

CredentialInfo createCredential(CreateCredentialRequest createCredentialRequest)

Create a credential.

Creates a new credential.

deleteCredential

void deleteCredential(DeleteCredentialRequest deleteCredentialRequest)

Delete a credential.

Deletes a credential from the metastore. The caller must be an owner of the credential.

generateTemporaryServiceCredential

TemporaryCredentials generateTemporaryServiceCredential(GenerateTemporaryServiceCredentialRequest generateTemporaryServiceCredentialRequest)

Generate a temporary service credential.

Returns a set of temporary credentials generated using the specified service credential. The caller must be a metastore admin or have the metastore privilege **ACCESS** on the service credential.

getCredential

CredentialInfo getCredential(GetCredentialRequest getCredentialRequest)

Get a credential.

Gets a credential from the metastore. The caller must be a metastore admin, the owner of the credential, or have any permission on the credential.

listCredentials

ListCredentialsResponse listCredentials(ListCredentialsRequest listCredentialsRequest)

List credentials.

Gets an array of credentials (as __CredentialInfo__ objects).

The array is limited to only the credentials that the caller has permission to access. If the caller is a metastore admin, retrieval of credentials is unrestricted. There is no guarantee of a specific ordering of the elements in the array.

updateCredential

CredentialInfo updateCredential(UpdateCredentialRequest updateCredentialRequest)

Update a credential.

Updates a credential on the metastore.

The caller must be the owner of the credential or a metastore admin or have the `MANAGE` permission. If the caller is a metastore admin, only the __owner__ field can be changed.

validateCredential

ValidateCredentialResponse validateCredential(ValidateCredentialRequest validateCredentialRequest)

Validate a credential.

Validates a credential.

Either the __credential_name__ or the cloud-specific credential must be provided.

The caller must be a metastore admin or the credential owner.