Workspace Identity Detail

View as Markdown

The details of a directly or indirectly assigned principal's details in a workspace.

GetGET /api/2.0/identity/workspace-identity-details/{principal_id}UpdatePATCH /api/2.0/identity/workspace-identity-details/{principal_id}

WorkspaceIdentityDetail object

The details of a directly or indirectly assigned principal's details in a workspace.

principal_idint64BetaOutput only

The internal ID of the principal (user/sp/group) in <Databricks>.

principal_typestringBetaOutput only

The type of the principal (user/service principal/group).

Values: PRINCIPAL_TYPE_UNSPECIFIED, USER, SERVICE_PRINCIPAL, GROUP

workspace_identity_statusstringBeta

The activity status of an identity in a <Databricks> workspace.

Values: STATE_UNSPECIFIED, ACTIVE, INACTIVE

assignment_typestringBetaOutput only

The type of assignment the principal has to the workspace (direct or indirect).

Values: ASSIGNMENT_TYPE_UNSPECIFIED, DIRECT, INDIRECT

View as Markdown

The WorkspaceIdentityDetail object

{
  "principal_id": 0,
  "principal_type": "string",
  "workspace_identity_status": "string",
  "assignment_type": "string"
}

Get Beta

GET /api/2.0/identity/workspace-identity-details/{principal_id}

Returns the identity details for a principal in a workspace.

API scopes: identity

Parameters

principal_idint64Requiredpath

Required. The internal ID of the principal (user/sp/group) for which the identity details are being requested.

Response

Returns the WorkspaceIdentityDetail object.

View as Markdown

Response

{
  "principal_id": 0,
  "principal_type": "string",
  "workspace_identity_status": "string",
  "assignment_type": "string"
}

Update Beta

PATCH /api/2.0/identity/workspace-identity-details/{principal_id}

Updates a workspace identity detail for a principal.

API scopes: identity

Parameters

principal_idint64Requiredpath

Required. ID of the principal in <Databricks>.

update_maskstringRequiredquery

Required. The list of fields to update.

Request body

workspace_identity_detailobjectRequired

Required. Workspace identity detail to be updated in <Databricks>.

Show child attributesHide child attributes

workspace_identity_statusstring

The activity status of an identity in a <Databricks> workspace.

Values: STATE_UNSPECIFIED, ACTIVE, INACTIVE

Response

Returns the WorkspaceIdentityDetail object.

View as Markdown

Request

{
  "workspace_identity_detail": {
    "workspace_identity_status": "string"
  }
}

Response

{
  "principal_id": 0,
  "principal_type": "string",
  "workspace_identity_status": "string",
  "assignment_type": "string"
}