1. Registry
  2. Packages
  3. Databricks Provider
  4. API Docs
  5. getWorkspaceIamServicePrincipalV2
Viewing docs for Databricks v1.109.0
published on Tuesday, Sep 8, 2026 by Pulumi
databricks logo databricks logo
Viewing docs for Databricks v1.109.0
published on Tuesday, Sep 8, 2026 by Pulumi

    Public Beta

    API Documentation

    Reads a single service principal by its internal ID, using a workspace-scoped provider.

    Example Usage

    Example usage:

    Look up a service principal by its internal ID, using a workspace-scoped provider.

    import * as pulumi from "@pulumi/pulumi";
    import * as databricks from "@pulumi/databricks";
    
    const _this = databricks.getWorkspaceIamServicePrincipalV2({
        servicePrincipalId: "123456789",
    });
    
    import pulumi
    import pulumi_databricks as databricks
    
    this = databricks.get_workspace_iam_service_principal_v2(service_principal_id="123456789")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-databricks/sdk/go/databricks"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := databricks.GetWorkspaceIamServicePrincipalV2(ctx, &databricks.LookupWorkspaceIamServicePrincipalV2Args{
    			ServicePrincipalId: "123456789",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Databricks = Pulumi.Databricks;
    
    return await Deployment.RunAsync(() => 
    {
        var @this = Databricks.GetWorkspaceIamServicePrincipalV2.Invoke(new()
        {
            ServicePrincipalId = "123456789",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.databricks.DatabricksFunctions;
    import com.pulumi.databricks.inputs.GetWorkspaceIamServicePrincipalV2Args;
    import java.util.ArrayList;
    import java.util.Arrays;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            final var this = DatabricksFunctions.getWorkspaceIamServicePrincipalV2(GetWorkspaceIamServicePrincipalV2Args.builder()
                .servicePrincipalId("123456789")
                .build());
    
        }
    }
    
    variables:
      this:
        fn::invoke:
          function: databricks:getWorkspaceIamServicePrincipalV2
          arguments:
            servicePrincipalId: '123456789'
    
    pulumi {
      required_providers {
        databricks = {
          source = "pulumi/databricks"
        }
      }
    }
    
    data "databricks_getworkspaceiamserviceprincipalv2" "this" {
      service_principal_id = "123456789"
    }
    

    Using getWorkspaceIamServicePrincipalV2

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getWorkspaceIamServicePrincipalV2(args: GetWorkspaceIamServicePrincipalV2Args, opts?: InvokeOptions): Promise<GetWorkspaceIamServicePrincipalV2Result>
    function getWorkspaceIamServicePrincipalV2Output(args: GetWorkspaceIamServicePrincipalV2OutputArgs, opts?: InvokeOutputOptions): Output<GetWorkspaceIamServicePrincipalV2Result>
    def get_workspace_iam_service_principal_v2(provider_config: Optional[GetWorkspaceIamServicePrincipalV2ProviderConfig] = None,
                                               service_principal_id: Optional[str] = None,
                                               opts: Optional[InvokeOptions] = None) -> GetWorkspaceIamServicePrincipalV2Result
    def get_workspace_iam_service_principal_v2_output(provider_config: pulumi.Input[Optional[GetWorkspaceIamServicePrincipalV2ProviderConfigArgs]] = None,
                                               service_principal_id: pulumi.Input[Optional[str]] = None,
                                               opts: Optional[InvokeOutputOptions] = None) -> Output[GetWorkspaceIamServicePrincipalV2Result]
    func LookupWorkspaceIamServicePrincipalV2(ctx *Context, args *LookupWorkspaceIamServicePrincipalV2Args, opts ...InvokeOption) (*LookupWorkspaceIamServicePrincipalV2Result, error)
    func LookupWorkspaceIamServicePrincipalV2Output(ctx *Context, args *LookupWorkspaceIamServicePrincipalV2OutputArgs, opts ...InvokeOption) LookupWorkspaceIamServicePrincipalV2ResultOutput

    > Note: This function is named LookupWorkspaceIamServicePrincipalV2 in the Go SDK.

    public static class GetWorkspaceIamServicePrincipalV2 
    {
        public static Task<GetWorkspaceIamServicePrincipalV2Result> InvokeAsync(GetWorkspaceIamServicePrincipalV2Args args, InvokeOptions? opts = null)
        public static Output<GetWorkspaceIamServicePrincipalV2Result> Invoke(GetWorkspaceIamServicePrincipalV2InvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetWorkspaceIamServicePrincipalV2Result> Invoke(GetWorkspaceIamServicePrincipalV2InvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetWorkspaceIamServicePrincipalV2Result> getWorkspaceIamServicePrincipalV2(GetWorkspaceIamServicePrincipalV2Args args, InvokeOptions options)
    public static Output<GetWorkspaceIamServicePrincipalV2Result> getWorkspaceIamServicePrincipalV2(GetWorkspaceIamServicePrincipalV2Args args, InvokeOptions options)
    public static Output<GetWorkspaceIamServicePrincipalV2Result> getWorkspaceIamServicePrincipalV2(GetWorkspaceIamServicePrincipalV2Args args, InvokeOutputOptions options)
    
    fn::invoke:
      function: databricks:index/getWorkspaceIamServicePrincipalV2:getWorkspaceIamServicePrincipalV2
      arguments:
        # arguments dictionary
    data "databricks_get_workspace_iam_service_principal_v2" "name" {
        # arguments
    }

    The following arguments are supported:

    ServicePrincipalId string
    Internal service principal ID of the service principal in Databricks
    ProviderConfig GetWorkspaceIamServicePrincipalV2ProviderConfig
    Configure the provider for management through account provider.
    ServicePrincipalId string
    Internal service principal ID of the service principal in Databricks
    ProviderConfig GetWorkspaceIamServicePrincipalV2ProviderConfig
    Configure the provider for management through account provider.
    service_principal_id string
    Internal service principal ID of the service principal in Databricks
    provider_config object
    Configure the provider for management through account provider.
    servicePrincipalId String
    Internal service principal ID of the service principal in Databricks
    providerConfig GetWorkspaceIamServicePrincipalV2ProviderConfig
    Configure the provider for management through account provider.
    servicePrincipalId string
    Internal service principal ID of the service principal in Databricks
    providerConfig GetWorkspaceIamServicePrincipalV2ProviderConfig
    Configure the provider for management through account provider.
    service_principal_id str
    Internal service principal ID of the service principal in Databricks
    provider_config GetWorkspaceIamServicePrincipalV2ProviderConfig
    Configure the provider for management through account provider.
    servicePrincipalId String
    Internal service principal ID of the service principal in Databricks
    providerConfig Property Map
    Configure the provider for management through account provider.

    getWorkspaceIamServicePrincipalV2 Result

    The following output properties are available:

    AccountId string
    (string) - The parent account ID for the service principal in Databricks
    AccountSpStatus string
    (string) - The activity status of a service principal in a Databricks account. Possible values are: ACTIVE, INACTIVE
    ApplicationId string
    (string) - Application ID of the service principal. Set at creation time and cannot be changed afterwards; when omitted, the server generates one
    DisplayName string
    (string) - Display name of the service principal
    ExternalId string
    (string) - ExternalId of the service principal in the customer's IdP
    ServicePrincipalId string
    (string) - Internal service principal ID of the service principal in Databricks
    ProviderConfig GetWorkspaceIamServicePrincipalV2ProviderConfig
    AccountId string
    (string) - The parent account ID for the service principal in Databricks
    AccountSpStatus string
    (string) - The activity status of a service principal in a Databricks account. Possible values are: ACTIVE, INACTIVE
    ApplicationId string
    (string) - Application ID of the service principal. Set at creation time and cannot be changed afterwards; when omitted, the server generates one
    DisplayName string
    (string) - Display name of the service principal
    ExternalId string
    (string) - ExternalId of the service principal in the customer's IdP
    ServicePrincipalId string
    (string) - Internal service principal ID of the service principal in Databricks
    ProviderConfig GetWorkspaceIamServicePrincipalV2ProviderConfig
    account_id string
    (string) - The parent account ID for the service principal in Databricks
    account_sp_status string
    (string) - The activity status of a service principal in a Databricks account. Possible values are: ACTIVE, INACTIVE
    application_id string
    (string) - Application ID of the service principal. Set at creation time and cannot be changed afterwards; when omitted, the server generates one
    display_name string
    (string) - Display name of the service principal
    external_id string
    (string) - ExternalId of the service principal in the customer's IdP
    service_principal_id string
    (string) - Internal service principal ID of the service principal in Databricks
    provider_config object
    accountId String
    (string) - The parent account ID for the service principal in Databricks
    accountSpStatus String
    (string) - The activity status of a service principal in a Databricks account. Possible values are: ACTIVE, INACTIVE
    applicationId String
    (string) - Application ID of the service principal. Set at creation time and cannot be changed afterwards; when omitted, the server generates one
    displayName String
    (string) - Display name of the service principal
    externalId String
    (string) - ExternalId of the service principal in the customer's IdP
    servicePrincipalId String
    (string) - Internal service principal ID of the service principal in Databricks
    providerConfig GetWorkspaceIamServicePrincipalV2ProviderConfig
    accountId string
    (string) - The parent account ID for the service principal in Databricks
    accountSpStatus string
    (string) - The activity status of a service principal in a Databricks account. Possible values are: ACTIVE, INACTIVE
    applicationId string
    (string) - Application ID of the service principal. Set at creation time and cannot be changed afterwards; when omitted, the server generates one
    displayName string
    (string) - Display name of the service principal
    externalId string
    (string) - ExternalId of the service principal in the customer's IdP
    servicePrincipalId string
    (string) - Internal service principal ID of the service principal in Databricks
    providerConfig GetWorkspaceIamServicePrincipalV2ProviderConfig
    account_id str
    (string) - The parent account ID for the service principal in Databricks
    account_sp_status str
    (string) - The activity status of a service principal in a Databricks account. Possible values are: ACTIVE, INACTIVE
    application_id str
    (string) - Application ID of the service principal. Set at creation time and cannot be changed afterwards; when omitted, the server generates one
    display_name str
    (string) - Display name of the service principal
    external_id str
    (string) - ExternalId of the service principal in the customer's IdP
    service_principal_id str
    (string) - Internal service principal ID of the service principal in Databricks
    provider_config GetWorkspaceIamServicePrincipalV2ProviderConfig
    accountId String
    (string) - The parent account ID for the service principal in Databricks
    accountSpStatus String
    (string) - The activity status of a service principal in a Databricks account. Possible values are: ACTIVE, INACTIVE
    applicationId String
    (string) - Application ID of the service principal. Set at creation time and cannot be changed afterwards; when omitted, the server generates one
    displayName String
    (string) - Display name of the service principal
    externalId String
    (string) - ExternalId of the service principal in the customer's IdP
    servicePrincipalId String
    (string) - Internal service principal ID of the service principal in Databricks
    providerConfig Property Map

    Supporting Types

    GetWorkspaceIamServicePrincipalV2ProviderConfig

    WorkspaceId string
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.
    WorkspaceId string
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.
    workspace_id string
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.
    workspaceId String
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.
    workspaceId string
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.
    workspace_id str
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.
    workspaceId String
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.

    Package Details

    Repository
    databricks pulumi/pulumi-databricks
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the databricks Terraform Provider.
    databricks logo databricks logo
    Viewing docs for Databricks v1.109.0
    published on Tuesday, Sep 8, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial