Account External Service Principal
A service principal from your identity provider (IdP), identified by its ID in your IdP. This resource is read-only and requires Microsoft Entra ID as your IdP. Getting an external service principal syncs its details and group memberships from your IdP, and adds it to your account if it isn't already there.
ExternalServicePrincipal object
A service principal from your identity provider (IdP), identified by its ID in your IdP. This resource is read-only and requires Microsoft Entra ID as your IdP. Getting an external service principal syncs its details and group memberships from your IdP, and adds it to your account if it isn't already there.
- namestringOutput onlyIDImmutable
The resource name of the external service principal, in one of these formats:
- Account APIs:
accounts/{account_id}/external-service-principals/{external_service_principal_id} - Workspace APIs:
external-service-principals/{external_service_principal_id}
- Account APIs:
- external_service_principal_idstringOutput only
The ID of the service principal in your IdP.
- internal_idstringOutput only
The Databricks ID of the service principal. Use it as the
service_principal_idin the service principal APIs.
- application_idstringOutput only
The service principal's application ID, from your IdP.
- display_namestringOutput only
The service principal's display name, from your IdP.
- account_sp_statusstringOutput only
Whether the service principal is active in the account.
ACTIVEINACTIVE
- account_idstringOutput only
The ID of the account that contains the service principal.
Get an external service principal in the account GA
GET
Gets a service principal by its ID in your identity provider (IdP) and syncs its details and group memberships from your IdP. If the service principal isn't in your account yet, it's added. Requires automatic identity management with Microsoft Entra ID as your IdP.
API scopes: identity
Parameters
- namestringRequiredpath
The resource name of the external service principal, in the format
accounts/{account_id}/external-service-principals/{external_service_principal_id}.
Response
Returns the ExternalServicePrincipal object.