Account Group

View as Markdown

The details of a Group resource.

GetGET /api/2.0/identity/accounts/{account_id}/groups/{group_id}ListGET /api/2.0/identity/accounts/{account_id}/groupsCreatePOST /api/2.0/identity/accounts/{account_id}/groupsUpdatePATCH /api/2.0/identity/accounts/{account_id}/groups/{group_id}DeleteDELETE /api/2.0/identity/accounts/{account_id}/groups/{group_id}

Group object

The details of a Group resource.

account_idstringBeta

The parent account ID for group in <Databricks>.

group_idstringBeta

Internal group ID of the group in <Databricks>.

external_idstringBeta

ExternalId of the group in the customer's IdP.

group_namestringBeta

Display name of the group.

View as Markdown

The Group object

{
  "account_id": "string",
  "group_id": "string",
  "external_id": "string",
  "group_name": "string"
}

Get Beta

GET /api/2.0/identity/accounts/{account_id}/groups/{group_id}

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

API scopes: identity

Parameters

account_idstringpath

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

group_idstringpath

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

Response

Returns the Group object.

View as Markdown

Response

{
  "account_id": "string",
  "group_id": "string",
  "external_id": "string",
  "group_name": "string"
}

List Beta

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

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

API scopes: identity

Parameters

account_idstringpath

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

page_sizeint32query

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

page_tokenstringquery

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

filterstringquery

Optional. Allows filtering groups by group name or external id.

Response

Returns a list of Group objects.

View as Markdown

Response

{
  "groups": [
    {
      "account_id": "string",
      "group_id": "string",
      "external_id": "string",
      "group_name": "string"
    }
  ],
  "next_page_token": "string"
}

Create Beta

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

Creates a local group in the <Databricks> account and returns the created group. A local group 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 ResolveGroup; to read an existing external identity, use the ExternalGroup resource.

API scopes: identity

Parameters

account_idstringpath

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

Request body

groupobject

Required. Group to be created in <Databricks>

Show child attributesHide child attributes

account_idstring

The parent account ID for group in <Databricks>.

group_idstring

Internal group ID of the group in <Databricks>.

external_idstring

ExternalId of the group in the customer's IdP.

group_namestring

Display name of the group.

Response

Returns the Group object.

View as Markdown

Request

{
  "group": {
    "account_id": "string",
    "group_id": "string",
    "external_id": "string",
    "group_name": "string"
  }
}

Response

{
  "account_id": "string",
  "group_id": "string",
  "external_id": "string",
  "group_name": "string"
}

Update Beta

PATCH /api/2.0/identity/accounts/{account_id}/groups/{group_id}

Updates an existing group in the <Databricks> account. Only the fields named in the update mask are modified. Returns the updated Group resource.

When AIM is enabled and the group 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 group is being updated.

group_idstringpath

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

update_maskstringquery

Optional. The list of fields to update.

Request body

groupobject

Required. Group to be updated in <Databricks>

Show child attributesHide child attributes

account_idstring

The parent account ID for group in <Databricks>.

group_idstring

Internal group ID of the group in <Databricks>.

external_idstring

ExternalId of the group in the customer's IdP.

group_namestring

Display name of the group.

Response

Returns the Group object.

View as Markdown

Request

{
  "group": {
    "account_id": "string",
    "group_id": "string",
    "external_id": "string",
    "group_name": "string"
  }
}

Response

{
  "account_id": "string",
  "group_id": "string",
  "external_id": "string",
  "group_name": "string"
}

Delete Beta

DELETE /api/2.0/identity/accounts/{account_id}/groups/{group_id}

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

API scopes: identity

Parameters

account_idstringpath

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

group_idstringpath

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

View as Markdown

Response

{}