Account User

View as Markdown

The details of a User resource.

GetGET /api/2.0/identity/accounts/{account_id}/users/{user_id}ListGET /api/2.0/identity/accounts/{account_id}/usersCreatePOST /api/2.0/identity/accounts/{account_id}/usersUpdatePATCH /api/2.0/identity/accounts/{account_id}/users/{user_id}DeleteDELETE /api/2.0/identity/accounts/{account_id}/users/{user_id}

User object

The details of a User resource.

account_idstringBeta

The accountId parent of the user in <Databricks>.

user_idstringBeta

Internal userId of the user in <Databricks>.

external_idstringBeta

ExternalId of the user in the customer's IdP.

usernamestringBeta

Username/email of the user.

full_nameobjectBeta

Show child attributesHide child attributes

given_namestringBeta

family_namestringBeta

account_user_statusstringBeta

The activity status of a user in a <Databricks> account.

Values: STATE_UNSPECIFIED, ACTIVE, INACTIVE

View as Markdown

The User object

{
  "account_id": "string",
  "user_id": "string",
  "external_id": "string",
  "username": "string",
  "full_name": {
    "given_name": "string",
    "family_name": "string"
  },
  "account_user_status": "string"
}

Get Beta

GET /api/2.0/identity/accounts/{account_id}/users/{user_id}

Fetches a user from the <Databricks> account by its internal ID.

API scopes: identity

Parameters

account_idstringpath

Required. The account ID for which the user is being fetched.

user_idstringpath

Required. Internal ID of the user in <Databricks>.

Response

Returns the User object.

View as Markdown

Response

{
  "account_id": "string",
  "user_id": "string",
  "external_id": "string",
  "username": "string",
  "full_name": {
    "given_name": "string",
    "family_name": "string"
  },
  "account_user_status": "string"
}

List Beta

GET /api/2.0/identity/accounts/{account_id}/users

Lists the users in the <Databricks> account, returning one page per call. Supports filtering by username or external ID.

API scopes: identity

Parameters

account_idstringpath

Required. The account ID for which the users are being fetched.

page_sizeint32query

The maximum number of users to return. The service may return fewer than this value.

page_tokenstringquery

A page token, received from a previous ListUsers call. Provide this to retrieve the subsequent page.

filterstringquery

Optional. Allows filtering users by username or external id.

Response

Returns a list of User objects.

View as Markdown

Response

{
  "users": [
    {
      "account_id": "string",
      "user_id": "string",
      "external_id": "string",
      "username": "string",
      "full_name": {},
      "account_user_status": "string"
    }
  ],
  "next_page_token": "string"
}

Create Beta

POST /api/2.0/identity/accounts/{account_id}/users

Creates a local user in the <Databricks> account and returns the created user. A local user is one that is not synced from the customer's identity provider, and can be created whether or not Account Identity Management (AIM) is enabled.

When AIM is enabled, supplying an external ID returns an error. To provision the identity from your identity provider, resolve it by its external ID with ResolveUser; to read an existing external identity, use the ExternalUser resource.

API scopes: identity

Parameters

account_idstringpath

Required. The account ID for which the user is being created.

Request body

userobject

Required. User to be created in <Databricks>

Show child attributesHide child attributes

account_idstring

The accountId parent of the user in <Databricks>.

user_idstring

Internal userId of the user in <Databricks>.

external_idstring

ExternalId of the user in the customer's IdP.

usernamestring

Username/email of the user.

full_nameobject

Show child attributesHide child attributes

given_namestring

family_namestring

account_user_statusstring

The activity status of a user in a <Databricks> account.

Values: STATE_UNSPECIFIED, ACTIVE, INACTIVE

Response

Returns the User object.

View as Markdown

Request

{
  "user": {
    "account_id": "string",
    "user_id": "string",
    "external_id": "string",
    "username": "string",
    "full_name": {},
    "account_user_status": "string"
  }
}

Response

{
  "account_id": "string",
  "user_id": "string",
  "external_id": "string",
  "username": "string",
  "full_name": {
    "given_name": "string",
    "family_name": "string"
  },
  "account_user_status": "string"
}

Update Beta

PATCH /api/2.0/identity/accounts/{account_id}/users/{user_id}

Updates an existing user in the <Databricks> account and returns the updated user. Only the fields named in the update mask are modified. The updatable fields are fullName.givenName, fullName.familyName, status, and externalId.

When AIM is enabled and the user is an external identity (its external_id is set), only external_id can be updated; its other fields are sourced from your identity provider.

API scopes: identity

Parameters

account_idstringpath

Required. The account ID for which the user is being updated.

user_idstringpath

Required. Internal ID of the user in <Databricks>.

update_maskstringquery

Optional. The list of fields to update.

Request body

userobject

Required. User to be updated in <Databricks>

Show child attributesHide child attributes

account_idstring

The accountId parent of the user in <Databricks>.

user_idstring

Internal userId of the user in <Databricks>.

external_idstring

ExternalId of the user in the customer's IdP.

usernamestring

Username/email of the user.

full_nameobject

Show child attributesHide child attributes

given_namestring

family_namestring

account_user_statusstring

The activity status of a user in a <Databricks> account.

Values: STATE_UNSPECIFIED, ACTIVE, INACTIVE

Response

Returns the User object.

View as Markdown

Request

{
  "user": {
    "account_id": "string",
    "user_id": "string",
    "external_id": "string",
    "username": "string",
    "full_name": {},
    "account_user_status": "string"
  }
}

Response

{
  "account_id": "string",
  "user_id": "string",
  "external_id": "string",
  "username": "string",
  "full_name": {
    "given_name": "string",
    "family_name": "string"
  },
  "account_user_status": "string"
}

Delete Beta

DELETE /api/2.0/identity/accounts/{account_id}/users/{user_id}

Deletes a user from the <Databricks> account by its internal ID.

API scopes: identity

Parameters

account_idstringpath

Required. The account ID for which the user is being deleted.

user_idstringpath

Required. Internal ID of the user in <Databricks>.

View as Markdown

Response

{}