Uc Credentials
Connect Unity Catalog to external data and services
Create Accounts Storage Credential GA
POST
Creates a new storage credential. The request object is specific to the cloud:
- AwsIamRole for AWS credentials
- AzureServicePrincipal for Azure credentials
- GcpServiceAccountKey for GCP credentials
The caller must be a metastore admin and have the CREATE_STORAGE_CREDENTIAL privilege on the metastore.
API scopes: unity-catalog
Parameters
- account_idstringpath
<Databricks> account ID of any type. For non-E2 account types, get your account ID from the Accounts Console
- metastore_idstringpath
Unity Catalog metastore ID
Request body
- credential_infoobject
Show child attributesHide child attributes
- namestring
The credential name. The name must be unique among storage and service credentials within the metastore.
- aws_iam_roleobjectRequired
The AWS IAM role configuration.
Show child attributesHide child attributes
- role_arnstring
The Amazon Resource Name (ARN) of the AWS IAM role used to vend temporary credentials.
- unity_catalog_iam_arnstring
The Amazon Resource Name (ARN) of the AWS IAM user managed by <Databricks>. This is the identity that is going to assume the AWS IAM role.
- external_idstring
The external ID used in role assumption to prevent the confused deputy problem.
- azure_service_principalobjectRequired
The Azure service principal configuration.
Show child attributesHide child attributes
- directory_idstring
The directory ID corresponding to the Azure Active Directory (AAD) tenant of the application.
- application_idstring
The application ID of the application registration within the referenced AAD tenant.
- client_secretstring
The client secret generated for the above app ID in AAD.
- gcp_service_account_keyobjectRequired
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID of the service account's private key.
- private_keystring
The service account's RSA private key.
- azure_managed_identityobjectRequired
The Azure managed identity configuration.
Show child attributesHide child attributes
- access_connector_idstring
The Azure resource ID of the Azure Databricks Access Connector. Use the format
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.Databricks/accessConnectors/{connector-name}.
- managed_identity_idstring
The Azure resource ID of the managed identity. Use the format,
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}This is only available for user-assgined identities. For system-assigned identities, the access_connector_id is used to identify the identity. If this field is not provided, then we assume the AzureManagedIdentity is using the system-assigned identity.
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- databricks_gcp_service_accountobjectRequired
The <Databricks> managed GCP service account configuration.
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID that represents the private key for this Service Account
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- commentstring
Comment associated with the credential.
- read_onlyboolean
Whether the credential is usable only for read operations. Only applicable when purpose is STORAGE.
- ownerstring
Username of current owner of credential.
- idstring
The unique identifier of the credential.
- metastore_idstring
Unique identifier of the parent metastore.
- created_atint64
Time at which this credential was created, in epoch milliseconds.
- created_bystring
Username of credential creator.
- updated_atint64
Time at which this credential was last modified, in epoch milliseconds.
- updated_bystring
Username of user who last modified the credential.
- used_for_managed_storageboolean
Whether this credential is the current metastore's root storage credential. Only applicable when purpose is STORAGE.
- full_namestring
The full name of the credential.
- isolation_modestring
Whether the current securable is accessible from all workspaces or a specific set of workspaces.
- skip_validationboolean
Optional, default false. Supplying true to this argument skips validation of the created set of credentials.
Response
- credential_infoobject
Show child attributesHide child attributes
- namestring
The credential name. The name must be unique among storage and service credentials within the metastore.
- aws_iam_roleobjectRequired
The AWS IAM role configuration.
Show child attributesHide child attributes
- role_arnstring
The Amazon Resource Name (ARN) of the AWS IAM role used to vend temporary credentials.
- unity_catalog_iam_arnstring
The Amazon Resource Name (ARN) of the AWS IAM user managed by <Databricks>. This is the identity that is going to assume the AWS IAM role.
- external_idstring
The external ID used in role assumption to prevent the confused deputy problem.
- azure_service_principalobjectRequired
The Azure service principal configuration.
Show child attributesHide child attributes
- directory_idstring
The directory ID corresponding to the Azure Active Directory (AAD) tenant of the application.
- application_idstring
The application ID of the application registration within the referenced AAD tenant.
- client_secretstring
The client secret generated for the above app ID in AAD.
- gcp_service_account_keyobjectRequired
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID of the service account's private key.
- private_keystring
The service account's RSA private key.
- azure_managed_identityobjectRequired
The Azure managed identity configuration.
Show child attributesHide child attributes
- access_connector_idstring
The Azure resource ID of the Azure Databricks Access Connector. Use the format
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.Databricks/accessConnectors/{connector-name}.
- managed_identity_idstring
The Azure resource ID of the managed identity. Use the format,
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}This is only available for user-assgined identities. For system-assigned identities, the access_connector_id is used to identify the identity. If this field is not provided, then we assume the AzureManagedIdentity is using the system-assigned identity.
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- databricks_gcp_service_accountobjectRequired
The <Databricks> managed GCP service account configuration.
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID that represents the private key for this Service Account
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- commentstring
Comment associated with the credential.
- read_onlyboolean
Whether the credential is usable only for read operations. Only applicable when purpose is STORAGE.
- ownerstring
Username of current owner of credential.
- idstring
The unique identifier of the credential.
- metastore_idstring
Unique identifier of the parent metastore.
- created_atint64
Time at which this credential was created, in epoch milliseconds.
- created_bystring
Username of credential creator.
- updated_atint64
Time at which this credential was last modified, in epoch milliseconds.
- updated_bystring
Username of user who last modified the credential.
- used_for_managed_storageboolean
Whether this credential is the current metastore's root storage credential. Only applicable when purpose is STORAGE.
- full_namestring
The full name of the credential.
- isolation_modestring
Whether the current securable is accessible from all workspaces or a specific set of workspaces.
Delete Accounts Storage Credential GA
DELETE
Deletes a storage credential from the metastore. The caller must be an owner of the storage credential.
API scopes: unity-catalog
Parameters
- account_idstringpath
<Databricks> account ID of any type. For non-E2 account types, get your account ID from the Accounts Console
- metastore_idstringpath
Unity Catalog metastore ID
- name_argstringpath
Name of the storage credential.
- forcebooleanquery
Force deletion even if the Storage Credential is not empty. Default is false.
Get Accounts Storage Credential GA
GET
Gets a storage credential from the metastore. The caller must be a metastore admin, the owner of the storage credential, or have a level of privilege on the storage credential.
API scopes: unity-catalog
Parameters
- account_idstringpath
<Databricks> account ID of any type. For non-E2 account types, get your account ID from the Accounts Console
- metastore_idstringpath
Unity Catalog metastore ID
- name_argstringpath
Required. Name of the storage credential.
Response
- credential_infoobject
Show child attributesHide child attributes
- namestring
The credential name. The name must be unique among storage and service credentials within the metastore.
- aws_iam_roleobjectRequired
The AWS IAM role configuration.
Show child attributesHide child attributes
- role_arnstring
The Amazon Resource Name (ARN) of the AWS IAM role used to vend temporary credentials.
- unity_catalog_iam_arnstring
The Amazon Resource Name (ARN) of the AWS IAM user managed by <Databricks>. This is the identity that is going to assume the AWS IAM role.
- external_idstring
The external ID used in role assumption to prevent the confused deputy problem.
- azure_service_principalobjectRequired
The Azure service principal configuration.
Show child attributesHide child attributes
- directory_idstring
The directory ID corresponding to the Azure Active Directory (AAD) tenant of the application.
- application_idstring
The application ID of the application registration within the referenced AAD tenant.
- client_secretstring
The client secret generated for the above app ID in AAD.
- gcp_service_account_keyobjectRequired
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID of the service account's private key.
- private_keystring
The service account's RSA private key.
- azure_managed_identityobjectRequired
The Azure managed identity configuration.
Show child attributesHide child attributes
- access_connector_idstring
The Azure resource ID of the Azure Databricks Access Connector. Use the format
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.Databricks/accessConnectors/{connector-name}.
- managed_identity_idstring
The Azure resource ID of the managed identity. Use the format,
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}This is only available for user-assgined identities. For system-assigned identities, the access_connector_id is used to identify the identity. If this field is not provided, then we assume the AzureManagedIdentity is using the system-assigned identity.
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- databricks_gcp_service_accountobjectRequired
The <Databricks> managed GCP service account configuration.
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID that represents the private key for this Service Account
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- commentstring
Comment associated with the credential.
- read_onlyboolean
Whether the credential is usable only for read operations. Only applicable when purpose is STORAGE.
- ownerstring
Username of current owner of credential.
- idstring
The unique identifier of the credential.
- metastore_idstring
Unique identifier of the parent metastore.
- created_atint64
Time at which this credential was created, in epoch milliseconds.
- created_bystring
Username of credential creator.
- updated_atint64
Time at which this credential was last modified, in epoch milliseconds.
- updated_bystring
Username of user who last modified the credential.
- used_for_managed_storageboolean
Whether this credential is the current metastore's root storage credential. Only applicable when purpose is STORAGE.
- full_namestring
The full name of the credential.
- isolation_modestring
Whether the current securable is accessible from all workspaces or a specific set of workspaces.
List Accounts Storage Credentials GA
GET
Gets a list of all storage credentials that have been assigned to given metastore.
API scopes: unity-catalog
Parameters
- account_idstringpath
<Databricks> account ID of any type. For non-E2 account types, get your account ID from the Accounts Console
- metastore_idstringpath
Unity Catalog metastore ID
Response
- storage_credentialsarray of object
An array of metastore storage credentials.
Show child attributesHide child attributes
- namestring
The credential name. The name must be unique among storage and service credentials within the metastore.
- aws_iam_roleobjectRequired
The AWS IAM role configuration.
Show child attributesHide child attributes
- role_arnstring
The Amazon Resource Name (ARN) of the AWS IAM role used to vend temporary credentials.
- unity_catalog_iam_arnstring
The Amazon Resource Name (ARN) of the AWS IAM user managed by <Databricks>. This is the identity that is going to assume the AWS IAM role.
- external_idstring
The external ID used in role assumption to prevent the confused deputy problem.
- azure_service_principalobjectRequired
The Azure service principal configuration.
Show child attributesHide child attributes
- directory_idstring
The directory ID corresponding to the Azure Active Directory (AAD) tenant of the application.
- application_idstring
The application ID of the application registration within the referenced AAD tenant.
- client_secretstring
The client secret generated for the above app ID in AAD.
- gcp_service_account_keyobjectRequired
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID of the service account's private key.
- private_keystring
The service account's RSA private key.
- azure_managed_identityobjectRequired
The Azure managed identity configuration.
Show child attributesHide child attributes
- access_connector_idstring
The Azure resource ID of the Azure Databricks Access Connector. Use the format
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.Databricks/accessConnectors/{connector-name}.
- managed_identity_idstring
The Azure resource ID of the managed identity. Use the format,
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}This is only available for user-assgined identities. For system-assigned identities, the access_connector_id is used to identify the identity. If this field is not provided, then we assume the AzureManagedIdentity is using the system-assigned identity.
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- databricks_gcp_service_accountobjectRequired
The <Databricks> managed GCP service account configuration.
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID that represents the private key for this Service Account
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- commentstring
Comment associated with the credential.
- read_onlyboolean
Whether the credential is usable only for read operations. Only applicable when purpose is STORAGE.
- ownerstring
Username of current owner of credential.
- idstring
The unique identifier of the credential.
- metastore_idstring
Unique identifier of the parent metastore.
- created_atint64
Time at which this credential was created, in epoch milliseconds.
- created_bystring
Username of credential creator.
- updated_atint64
Time at which this credential was last modified, in epoch milliseconds.
- updated_bystring
Username of user who last modified the credential.
- used_for_managed_storageboolean
Whether this credential is the current metastore's root storage credential. Only applicable when purpose is STORAGE.
- full_namestring
The full name of the credential.
- isolation_modestring
Whether the current securable is accessible from all workspaces or a specific set of workspaces.
Update Accounts Storage Credential GA
PUT
Updates a storage credential on the metastore. The caller must be the owner of the storage credential. If the caller is a metastore admin, only the owner credential can be changed.
API scopes: unity-catalog
Parameters
- account_idstringpath
<Databricks> account ID of any type. For non-E2 account types, get your account ID from the Accounts Console
- metastore_idstringpath
Unity Catalog metastore ID
- name_argstringpath
Name of the storage credential.
Request body
- credential_infoobject
Show child attributesHide child attributes
- namestring
The credential name. The name must be unique among storage and service credentials within the metastore.
- aws_iam_roleobjectRequired
The AWS IAM role configuration.
Show child attributesHide child attributes
- role_arnstring
The Amazon Resource Name (ARN) of the AWS IAM role used to vend temporary credentials.
- unity_catalog_iam_arnstring
The Amazon Resource Name (ARN) of the AWS IAM user managed by <Databricks>. This is the identity that is going to assume the AWS IAM role.
- external_idstring
The external ID used in role assumption to prevent the confused deputy problem.
- azure_service_principalobjectRequired
The Azure service principal configuration.
Show child attributesHide child attributes
- directory_idstring
The directory ID corresponding to the Azure Active Directory (AAD) tenant of the application.
- application_idstring
The application ID of the application registration within the referenced AAD tenant.
- client_secretstring
The client secret generated for the above app ID in AAD.
- gcp_service_account_keyobjectRequired
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID of the service account's private key.
- private_keystring
The service account's RSA private key.
- azure_managed_identityobjectRequired
The Azure managed identity configuration.
Show child attributesHide child attributes
- access_connector_idstring
The Azure resource ID of the Azure Databricks Access Connector. Use the format
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.Databricks/accessConnectors/{connector-name}.
- managed_identity_idstring
The Azure resource ID of the managed identity. Use the format,
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}This is only available for user-assgined identities. For system-assigned identities, the access_connector_id is used to identify the identity. If this field is not provided, then we assume the AzureManagedIdentity is using the system-assigned identity.
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- databricks_gcp_service_accountobjectRequired
The <Databricks> managed GCP service account configuration.
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID that represents the private key for this Service Account
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- commentstring
Comment associated with the credential.
- read_onlyboolean
Whether the credential is usable only for read operations. Only applicable when purpose is STORAGE.
- ownerstring
Username of current owner of credential.
- idstring
The unique identifier of the credential.
- metastore_idstring
Unique identifier of the parent metastore.
- created_atint64
Time at which this credential was created, in epoch milliseconds.
- created_bystring
Username of credential creator.
- updated_atint64
Time at which this credential was last modified, in epoch milliseconds.
- updated_bystring
Username of user who last modified the credential.
- used_for_managed_storageboolean
Whether this credential is the current metastore's root storage credential. Only applicable when purpose is STORAGE.
- full_namestring
The full name of the credential.
- isolation_modestring
Whether the current securable is accessible from all workspaces or a specific set of workspaces.
- skip_validationboolean
Optional. Supplying true to this argument skips validation of the updated set of credentials.
Response
- credential_infoobject
Show child attributesHide child attributes
- namestring
The credential name. The name must be unique among storage and service credentials within the metastore.
- aws_iam_roleobjectRequired
The AWS IAM role configuration.
Show child attributesHide child attributes
- role_arnstring
The Amazon Resource Name (ARN) of the AWS IAM role used to vend temporary credentials.
- unity_catalog_iam_arnstring
The Amazon Resource Name (ARN) of the AWS IAM user managed by <Databricks>. This is the identity that is going to assume the AWS IAM role.
- external_idstring
The external ID used in role assumption to prevent the confused deputy problem.
- azure_service_principalobjectRequired
The Azure service principal configuration.
Show child attributesHide child attributes
- directory_idstring
The directory ID corresponding to the Azure Active Directory (AAD) tenant of the application.
- application_idstring
The application ID of the application registration within the referenced AAD tenant.
- client_secretstring
The client secret generated for the above app ID in AAD.
- gcp_service_account_keyobjectRequired
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID of the service account's private key.
- private_keystring
The service account's RSA private key.
- azure_managed_identityobjectRequired
The Azure managed identity configuration.
Show child attributesHide child attributes
- access_connector_idstring
The Azure resource ID of the Azure Databricks Access Connector. Use the format
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.Databricks/accessConnectors/{connector-name}.
- managed_identity_idstring
The Azure resource ID of the managed identity. Use the format,
/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}This is only available for user-assgined identities. For system-assigned identities, the access_connector_id is used to identify the identity. If this field is not provided, then we assume the AzureManagedIdentity is using the system-assigned identity.
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- databricks_gcp_service_accountobjectRequired
The <Databricks> managed GCP service account configuration.
Show child attributesHide child attributes
- emailstring
The email of the service account.
- private_key_idstring
The ID that represents the private key for this Service Account
- credential_idstring
The <Databricks> internal ID that represents this managed identity.
- commentstring
Comment associated with the credential.
- read_onlyboolean
Whether the credential is usable only for read operations. Only applicable when purpose is STORAGE.
- ownerstring
Username of current owner of credential.
- idstring
The unique identifier of the credential.
- metastore_idstring
Unique identifier of the parent metastore.
- created_atint64
Time at which this credential was created, in epoch milliseconds.
- created_bystring
Username of credential creator.
- updated_atint64
Time at which this credential was last modified, in epoch milliseconds.
- updated_bystring
Username of user who last modified the credential.
- used_for_managed_storageboolean
Whether this credential is the current metastore's root storage credential. Only applicable when purpose is STORAGE.
- full_namestring
The full name of the credential.
- isolation_modestring
Whether the current securable is accessible from all workspaces or a specific set of workspaces.
List Credentials Public GA
GET
List <Databricks> credential configuration objects for an account, specified by ID.
API scopes: unity-catalog
Parameters
- account_idstringpath
Response
- credentialsarray of object
Show child attributesHide child attributes
- credentials_idstring
<Databricks> credential configuration ID.
- account_idstring
The <Databricks> account ID that hosts the credential.
- aws_credentialsobjectRequired
Show child attributesHide child attributes
- sts_roleobjectRequired
Show child attributesHide child attributes
- role_arnstring
The Amazon Resource Name (ARN) of the cross account IAM role.
- credentials_namestring
The human-readable name of the credential configuration object.
- creation_timeint64
Time in epoch milliseconds when the credential was created.