Docs Packages
  1. Packages
  2. Databricks
  3. API Docs
  4. Token
Databricks v1.35.0 published on Friday, Mar 29, 2024 by Pulumi
pulumi/pulumi-databricks

databricks.Token

Explore with Pulumi AI

databricks logo
Databricks v1.35.0 published on Friday, Mar 29, 2024 by Pulumi
pulumi/pulumi-databricks

    This resource creates Personal Access Tokens for the same user that is authenticated with the provider. Most likely you should use databricks.OboToken to create On-Behalf-Of tokens for a databricks.ServicePrincipal in Databricks workspaces on AWS. Databricks workspaces on other clouds use their own native OAuth token flows.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as databricks from "@pulumi/databricks";

// initialize provider in normal mode
const createdWorkspace = new databricks.Provider("createdWorkspace", {host: databricks_mws_workspaces["this"].workspace_url});
// create PAT token to provision entities within workspace
const pat = new databricks.Token("pat", {
    comment: "Terraform Provisioning",
    lifetimeSeconds: 8640000,
}, {
    provider: databricks.created_workspace,
});
export const databricksToken = pat.tokenValue;

    import pulumi
import pulumi_databricks as databricks

# initialize provider in normal mode
created_workspace = databricks.Provider("createdWorkspace", host=databricks_mws_workspaces["this"]["workspace_url"])
# create PAT token to provision entities within workspace
pat = databricks.Token("pat",
    comment="Terraform Provisioning",
    lifetime_seconds=8640000,
    opts=pulumi.ResourceOptions(provider=databricks["created_workspace"]))
pulumi.export("databricksToken", pat.token_value)

    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 {
		// initialize provider in normal mode
		_, err := databricks.NewProvider(ctx, "createdWorkspace", &databricks.ProviderArgs{
			Host: pulumi.Any(databricks_mws_workspaces.This.Workspace_url),
		})
		if err != nil {
			return err
		}
		// create PAT token to provision entities within workspace
		pat, err := databricks.NewToken(ctx, "pat", &databricks.TokenArgs{
			Comment:         pulumi.String("Terraform Provisioning"),
			LifetimeSeconds: pulumi.Int(8640000),
		}, pulumi.Provider(databricks.Created_workspace))
		if err != nil {
			return err
		}
		ctx.Export("databricksToken", pat.TokenValue)
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Databricks = Pulumi.Databricks;

return await Deployment.RunAsync(() => 
{
    // initialize provider in normal mode
    var createdWorkspace = new Databricks.Provider("createdWorkspace", new()
    {
        Host = databricks_mws_workspaces.This.Workspace_url,
    });

    // create PAT token to provision entities within workspace
    var pat = new Databricks.Token("pat", new()
    {
        Comment = "Terraform Provisioning",
        LifetimeSeconds = 8640000,
    }, new CustomResourceOptions
    {
        Provider = databricks.Created_workspace,
    });

    return new Dictionary<string, object?>
    {
        ["databricksToken"] = pat.TokenValue,
    };
});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.databricks.Provider;
import com.pulumi.databricks.ProviderArgs;
import com.pulumi.databricks.Token;
import com.pulumi.databricks.TokenArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.List;
import java.util.ArrayList;
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) {
        var createdWorkspace = new Provider("createdWorkspace", ProviderArgs.builder()        
            .host(databricks_mws_workspaces.this().workspace_url())
            .build());

        var pat = new Token("pat", TokenArgs.builder()        
            .comment("Terraform Provisioning")
            .lifetimeSeconds(8640000)
            .build(), CustomResourceOptions.builder()
                .provider(databricks.created_workspace())
                .build());

        ctx.export("databricksToken", pat.tokenValue());
    }
}

    resources:
  # initialize provider in normal mode
  createdWorkspace:
    type: pulumi:providers:databricks
    properties:
      host: ${databricks_mws_workspaces.this.workspace_url}
  # create PAT token to provision entities within workspace
  pat:
    type: databricks:Token
    properties:
      comment: Terraform Provisioning
      # 100 day token
      lifetimeSeconds: 8.64e+06
    options:
      provider: ${databricks.created_workspace}
outputs:
  # output token for other modules
  databricksToken: ${pat.tokenValue}

    A token can be automatically rotated by taking a dependency on the time_rotating resource:

    import * as pulumi from "@pulumi/pulumi";
import * as databricks from "@pulumi/databricks";
import * as time from "@pulumiverse/time";

const _this = new time.Rotating("this", {rotationDays: 30});
const pat = new databricks.Token("pat", {
    comment: pulumi.interpolate`Terraform (created: ${_this.rfc3339})`,
    lifetimeSeconds: 60 * 24 * 60 * 60,
});

    import pulumi
import pulumi_databricks as databricks
import pulumiverse_time as time

this = time.Rotating("this", rotation_days=30)
pat = databricks.Token("pat",
    comment=this.rfc3339.apply(lambda rfc3339: f"Terraform (created: {rfc3339})"),
    lifetime_seconds=60 * 24 * 60 * 60)

    package main

import (
	"fmt"

	"github.com/pulumi/pulumi-databricks/sdk/go/databricks"
	"github.com/pulumi/pulumi-time/sdk/go/time"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		this, err := time.NewRotating(ctx, "this", &time.RotatingArgs{
			RotationDays: pulumi.Int(30),
		})
		if err != nil {
			return err
		}
		_, err = databricks.NewToken(ctx, "pat", &databricks.TokenArgs{
			Comment: this.Rfc3339.ApplyT(func(rfc3339 string) (string, error) {
				return fmt.Sprintf("Terraform (created: %v)", rfc3339), nil
			}).(pulumi.StringOutput),
			LifetimeSeconds: 60 * 24 * 60 * 60,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Databricks = Pulumi.Databricks;
using Time = Pulumiverse.Time;

return await Deployment.RunAsync(() => 
{
    var @this = new Time.Rotating("this", new()
    {
        RotationDays = 30,
    });

    var pat = new Databricks.Token("pat", new()
    {
        Comment = @this.Rfc3339.Apply(rfc3339 => $"Terraform (created: {rfc3339})"),
        LifetimeSeconds = 60 * 24 * 60 * 60,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.time.Rotating;
import com.pulumi.time.RotatingArgs;
import com.pulumi.databricks.Token;
import com.pulumi.databricks.TokenArgs;
import java.util.List;
import java.util.ArrayList;
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) {
        var this_ = new Rotating("this", RotatingArgs.builder()        
            .rotationDays(30)
            .build());

        var pat = new Token("pat", TokenArgs.builder()        
            .comment(this_.rfc3339().applyValue(rfc3339 -> String.format("Terraform (created: %s)", rfc3339)))
            .lifetimeSeconds(60 * 24 * 60 * 60)
            .build());

    }
}

    Coming soon!

    Create Token Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Token(name: string, args?: TokenArgs, opts?: CustomResourceOptions);
    @overload
def Token(resource_name: str,
          args: Optional[TokenArgs] = None,
          opts: Optional[ResourceOptions] = None)

@overload
def Token(resource_name: str,
          opts: Optional[ResourceOptions] = None,
          comment: Optional[str] = None,
          creation_time: Optional[int] = None,
          expiry_time: Optional[int] = None,
          lifetime_seconds: Optional[int] = None,
          token_id: Optional[str] = None)
    func NewToken(ctx *Context, name string, args *TokenArgs, opts ...ResourceOption) (*Token, error)
    public Token(string name, TokenArgs? args = null, CustomResourceOptions? opts = null)
    public Token(String name, TokenArgs args)
public Token(String name, TokenArgs args, CustomResourceOptions options)

    type: databricks:Token
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args TokenArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args TokenArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args TokenArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args TokenArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args TokenArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Example

    The following reference example uses placeholder values for all input properties.

    var tokenResource = new Databricks.Token("tokenResource", new()
{
    Comment = "string",
    CreationTime = 0,
    ExpiryTime = 0,
    LifetimeSeconds = 0,
    TokenId = "string",
});

    example, err := databricks.NewToken(ctx, "tokenResource", &databricks.TokenArgs{
	Comment:         pulumi.String("string"),
	CreationTime:    pulumi.Int(0),
	ExpiryTime:      pulumi.Int(0),
	LifetimeSeconds: pulumi.Int(0),
	TokenId:         pulumi.String("string"),
})

    var tokenResource = new Token("tokenResource", TokenArgs.builder()        
    .comment("string")
    .creationTime(0)
    .expiryTime(0)
    .lifetimeSeconds(0)
    .tokenId("string")
    .build());

    token_resource = databricks.Token("tokenResource",
    comment="string",
    creation_time=0,
    expiry_time=0,
    lifetime_seconds=0,
    token_id="string")

    const tokenResource = new databricks.Token("tokenResource", {
    comment: "string",
    creationTime: 0,
    expiryTime: 0,
    lifetimeSeconds: 0,
    tokenId: "string",
});

    type: databricks:Token
properties:
    comment: string
    creationTime: 0
    expiryTime: 0
    lifetimeSeconds: 0
    tokenId: string

    Token Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The Token resource accepts the following input properties:

    Comment string
    (String) Comment that will appear on the user’s settings page for this token.
    CreationTime int
    ExpiryTime int
    LifetimeSeconds int
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    TokenId string
    Comment string
    (String) Comment that will appear on the user’s settings page for this token.
    CreationTime int
    ExpiryTime int
    LifetimeSeconds int
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    TokenId string
    comment String
    (String) Comment that will appear on the user’s settings page for this token.
    creationTime Integer
    expiryTime Integer
    lifetimeSeconds Integer
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    tokenId String
    comment string
    (String) Comment that will appear on the user’s settings page for this token.
    creationTime number
    expiryTime number
    lifetimeSeconds number
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    tokenId string
    comment str
    (String) Comment that will appear on the user’s settings page for this token.
    creation_time int
    expiry_time int
    lifetime_seconds int
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    token_id str
    comment String
    (String) Comment that will appear on the user’s settings page for this token.
    creationTime Number
    expiryTime Number
    lifetimeSeconds Number
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    tokenId String

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Token resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    TokenValue string
    Sensitive value of the newly-created token.
    Id string
    The provider-assigned unique ID for this managed resource.
    TokenValue string
    Sensitive value of the newly-created token.
    id String
    The provider-assigned unique ID for this managed resource.
    tokenValue String
    Sensitive value of the newly-created token.
    id string
    The provider-assigned unique ID for this managed resource.
    tokenValue string
    Sensitive value of the newly-created token.
    id str
    The provider-assigned unique ID for this managed resource.
    token_value str
    Sensitive value of the newly-created token.
    id String
    The provider-assigned unique ID for this managed resource.
    tokenValue String
    Sensitive value of the newly-created token.

    Look up Existing Token Resource

    Get an existing Token resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: TokenState, opts?: CustomResourceOptions): Token
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        comment: Optional[str] = None,
        creation_time: Optional[int] = None,
        expiry_time: Optional[int] = None,
        lifetime_seconds: Optional[int] = None,
        token_id: Optional[str] = None,
        token_value: Optional[str] = None) -> Token
    func GetToken(ctx *Context, name string, id IDInput, state *TokenState, opts ...ResourceOption) (*Token, error)
    public static Token Get(string name, Input<string> id, TokenState? state, CustomResourceOptions? opts = null)
    public static Token get(String name, Output<String> id, TokenState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Comment string
    (String) Comment that will appear on the user’s settings page for this token.
    CreationTime int
    ExpiryTime int
    LifetimeSeconds int
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    TokenId string
    TokenValue string
    Sensitive value of the newly-created token.
    Comment string
    (String) Comment that will appear on the user’s settings page for this token.
    CreationTime int
    ExpiryTime int
    LifetimeSeconds int
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    TokenId string
    TokenValue string
    Sensitive value of the newly-created token.
    comment String
    (String) Comment that will appear on the user’s settings page for this token.
    creationTime Integer
    expiryTime Integer
    lifetimeSeconds Integer
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    tokenId String
    tokenValue String
    Sensitive value of the newly-created token.
    comment string
    (String) Comment that will appear on the user’s settings page for this token.
    creationTime number
    expiryTime number
    lifetimeSeconds number
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    tokenId string
    tokenValue string
    Sensitive value of the newly-created token.
    comment str
    (String) Comment that will appear on the user’s settings page for this token.
    creation_time int
    expiry_time int
    lifetime_seconds int
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    token_id str
    token_value str
    Sensitive value of the newly-created token.
    comment String
    (String) Comment that will appear on the user’s settings page for this token.
    creationTime Number
    expiryTime Number
    lifetimeSeconds Number
    (Integer) The lifetime of the token, in seconds. If no lifetime is specified, the token remains valid indefinitely.
    tokenId String
    tokenValue String
    Sensitive value of the newly-created token.

    Import

    -> Note Importing this resource is not currently supported.

    To learn more about importing existing cloud resources, see Importing resources.

    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 v1.35.0 published on Friday, Mar 29, 2024 by Pulumi
    pulumi/pulumi-databricks