1. Packages
  2. Packages
  3. Dynatrace
  4. API Docs
  5. User
Viewing docs for Dynatrace v0.36.0
published on Tuesday, Jun 9, 2026 by Pulumiverse
dynatrace logo
Viewing docs for Dynatrace v0.36.0
published on Tuesday, Jun 9, 2026 by Pulumiverse

    Dynatrace Managed only

    To utilize this resource, please define the environment variables DT_CLUSTER_URL and DT_CLUSTER_API_TOKEN with the cluster API token scope Service Provider API (ServiceProviderAPI).

    Dynatrace Documentation

    • User and group management - https://docs.dynatrace.com/managed/manage/identity-access-management/user-and-group-management

    • User management API - https://www.dynatrace.com/support/help/dynatrace-api/account-management-api/user-management-api

    Export Example Usage

    • terraform-provider-dynatrace -export dynatrace.User downloads all existing users

    The full documentation of the export feature is available here.

    Resource Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as dynatrace from "@pulumiverse/dynatrace";
    
    const config = new pulumi.Config();
    const cluster = config.get("cluster") || "<the-id-of-your-dynatrace-cluster>";
    const environment = config.get("environment") || "<the-id-of-an-environment-within-your-cluster";
    const terraform = new dynatrace.UserGroup("terraform", {
        name: "Anonymous",
        ldapGroups: ["Anonymous"],
    });
    const terraformUser = new dynatrace.User("terraform", {
        email: "me@example.com",
        firstName: "John",
        groups: [terraform.id],
        lastName: "Doe",
        userName: "me@example.com",
    });
    const terraformCluster = new dynatrace.Policy("terraform_cluster", {
        name: "terraform_cluster",
        cluster: cluster,
        statementQuery: "ALLOW settings:objects:read, settings:schemas:read WHERE settings:schemaId = \"terraform-cluster\";",
    });
    const terraformEnv = new dynatrace.Policy("terraform_env", {
        name: "terraform_env",
        environment: environment,
        statementQuery: "ALLOW environment:roles:viewer;",
    });
    const terraformClusterBinding = new dynatrace.PolicyBindings("terraform_cluster_binding", {
        cluster: cluster,
        group: terraform.id,
        policies: [terraformCluster.id],
    });
    const terraformEnvBinding = new dynatrace.PolicyBindings("terraform_env_binding", {
        environment: environment,
        group: terraform.id,
        policies: [terraformEnv.id],
    });
    
    import pulumi
    import pulumiverse_dynatrace as dynatrace
    
    config = pulumi.Config()
    cluster = config.get("cluster")
    if cluster is None:
        cluster = "<the-id-of-your-dynatrace-cluster>"
    environment = config.get("environment")
    if environment is None:
        environment = "<the-id-of-an-environment-within-your-cluster"
    terraform = dynatrace.UserGroup("terraform",
        name="Anonymous",
        ldap_groups=["Anonymous"])
    terraform_user = dynatrace.User("terraform",
        email="me@example.com",
        first_name="John",
        groups=[terraform.id],
        last_name="Doe",
        user_name="me@example.com")
    terraform_cluster = dynatrace.Policy("terraform_cluster",
        name="terraform_cluster",
        cluster=cluster,
        statement_query="ALLOW settings:objects:read, settings:schemas:read WHERE settings:schemaId = \"terraform-cluster\";")
    terraform_env = dynatrace.Policy("terraform_env",
        name="terraform_env",
        environment=environment,
        statement_query="ALLOW environment:roles:viewer;")
    terraform_cluster_binding = dynatrace.PolicyBindings("terraform_cluster_binding",
        cluster=cluster,
        group=terraform.id,
        policies=[terraform_cluster.id])
    terraform_env_binding = dynatrace.PolicyBindings("terraform_env_binding",
        environment=environment,
        group=terraform.id,
        policies=[terraform_env.id])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
    	"github.com/pulumiverse/pulumi-dynatrace/sdk/go/dynatrace"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		cfg := config.New(ctx, "")
    		cluster := "<the-id-of-your-dynatrace-cluster>"
    		if param := cfg.Get("cluster"); param != "" {
    			cluster = param
    		}
    		environment := "<the-id-of-an-environment-within-your-cluster"
    		if param := cfg.Get("environment"); param != "" {
    			environment = param
    		}
    		terraform, err := dynatrace.NewUserGroup(ctx, "terraform", &dynatrace.UserGroupArgs{
    			Name: pulumi.String("Anonymous"),
    			LdapGroups: pulumi.StringArray{
    				pulumi.String("Anonymous"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		_, err = dynatrace.NewUser(ctx, "terraform", &dynatrace.UserArgs{
    			Email:     pulumi.String("me@example.com"),
    			FirstName: pulumi.String("John"),
    			Groups: pulumi.StringArray{
    				terraform.ID(),
    			},
    			LastName: pulumi.String("Doe"),
    			UserName: pulumi.String("me@example.com"),
    		})
    		if err != nil {
    			return err
    		}
    		terraformCluster, err := dynatrace.NewPolicy(ctx, "terraform_cluster", &dynatrace.PolicyArgs{
    			Name:           pulumi.String("terraform_cluster"),
    			Cluster:        pulumi.String(pulumi.String(cluster)),
    			StatementQuery: pulumi.String("ALLOW settings:objects:read, settings:schemas:read WHERE settings:schemaId = \"terraform-cluster\";"),
    		})
    		if err != nil {
    			return err
    		}
    		terraformEnv, err := dynatrace.NewPolicy(ctx, "terraform_env", &dynatrace.PolicyArgs{
    			Name:           pulumi.String("terraform_env"),
    			Environment:    pulumi.String(pulumi.String(environment)),
    			StatementQuery: pulumi.String("ALLOW environment:roles:viewer;"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = dynatrace.NewPolicyBindings(ctx, "terraform_cluster_binding", &dynatrace.PolicyBindingsArgs{
    			Cluster: pulumi.String(pulumi.String(cluster)),
    			Group:   terraform.ID(),
    			Policies: pulumi.StringArray{
    				terraformCluster.ID(),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		_, err = dynatrace.NewPolicyBindings(ctx, "terraform_env_binding", &dynatrace.PolicyBindingsArgs{
    			Environment: pulumi.String(pulumi.String(environment)),
    			Group:       terraform.ID(),
    			Policies: pulumi.StringArray{
    				terraformEnv.ID(),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Dynatrace = Pulumiverse.Dynatrace;
    
    return await Deployment.RunAsync(() => 
    {
        var config = new Config();
        var cluster = config.Get("cluster") ?? "<the-id-of-your-dynatrace-cluster>";
        var environment = config.Get("environment") ?? "<the-id-of-an-environment-within-your-cluster";
        var terraform = new Dynatrace.UserGroup("terraform", new()
        {
            Name = "Anonymous",
            LdapGroups = new[]
            {
                "Anonymous",
            },
        });
    
        var terraformUser = new Dynatrace.User("terraform", new()
        {
            Email = "me@example.com",
            FirstName = "John",
            Groups = new[]
            {
                terraform.Id,
            },
            LastName = "Doe",
            UserName = "me@example.com",
        });
    
        var terraformCluster = new Dynatrace.Policy("terraform_cluster", new()
        {
            Name = "terraform_cluster",
            Cluster = cluster,
            StatementQuery = "ALLOW settings:objects:read, settings:schemas:read WHERE settings:schemaId = \"terraform-cluster\";",
        });
    
        var terraformEnv = new Dynatrace.Policy("terraform_env", new()
        {
            Name = "terraform_env",
            Environment = environment,
            StatementQuery = "ALLOW environment:roles:viewer;",
        });
    
        var terraformClusterBinding = new Dynatrace.PolicyBindings("terraform_cluster_binding", new()
        {
            Cluster = cluster,
            Group = terraform.Id,
            Policies = new[]
            {
                terraformCluster.Id,
            },
        });
    
        var terraformEnvBinding = new Dynatrace.PolicyBindings("terraform_env_binding", new()
        {
            Environment = environment,
            Group = terraform.Id,
            Policies = new[]
            {
                terraformEnv.Id,
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.dynatrace.UserGroup;
    import com.pulumi.dynatrace.UserGroupArgs;
    import com.pulumi.dynatrace.User;
    import com.pulumi.dynatrace.UserArgs;
    import com.pulumi.dynatrace.Policy;
    import com.pulumi.dynatrace.PolicyArgs;
    import com.pulumi.dynatrace.PolicyBindings;
    import com.pulumi.dynatrace.PolicyBindingsArgs;
    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 config = ctx.config();
            final var cluster = config.get("cluster").orElse("<the-id-of-your-dynatrace-cluster>");
            final var environment = config.get("environment").orElse("<the-id-of-an-environment-within-your-cluster");
            var terraform = new UserGroup("terraform", UserGroupArgs.builder()
                .name("Anonymous")
                .ldapGroups("Anonymous")
                .build());
    
            var terraformUser = new User("terraformUser", UserArgs.builder()
                .email("me@example.com")
                .firstName("John")
                .groups(terraform.id())
                .lastName("Doe")
                .userName("me@example.com")
                .build());
    
            var terraformCluster = new Policy("terraformCluster", PolicyArgs.builder()
                .name("terraform_cluster")
                .cluster(cluster)
                .statementQuery("ALLOW settings:objects:read, settings:schemas:read WHERE settings:schemaId = \"terraform-cluster\";")
                .build());
    
            var terraformEnv = new Policy("terraformEnv", PolicyArgs.builder()
                .name("terraform_env")
                .environment(environment)
                .statementQuery("ALLOW environment:roles:viewer;")
                .build());
    
            var terraformClusterBinding = new PolicyBindings("terraformClusterBinding", PolicyBindingsArgs.builder()
                .cluster(cluster)
                .group(terraform.id())
                .policies(terraformCluster.id())
                .build());
    
            var terraformEnvBinding = new PolicyBindings("terraformEnvBinding", PolicyBindingsArgs.builder()
                .environment(environment)
                .group(terraform.id())
                .policies(terraformEnv.id())
                .build());
    
        }
    }
    
    configuration:
      cluster:
        type: string
        default: <the-id-of-your-dynatrace-cluster>
      environment:
        type: string
        default: <the-id-of-an-environment-within-your-cluster
    resources:
      terraform:
        type: dynatrace:UserGroup
        properties:
          name: Anonymous
          ldapGroups:
            - Anonymous
      terraformUser:
        type: dynatrace:User
        name: terraform
        properties:
          email: me@example.com
          firstName: John
          groups:
            - ${terraform.id}
          lastName: Doe
          userName: me@example.com
      terraformCluster:
        type: dynatrace:Policy
        name: terraform_cluster
        properties:
          name: terraform_cluster
          cluster: ${cluster}
          statementQuery: ALLOW settings:objects:read, settings:schemas:read WHERE settings:schemaId = "terraform-cluster";
      terraformEnv:
        type: dynatrace:Policy
        name: terraform_env
        properties:
          name: terraform_env
          environment: ${environment}
          statementQuery: ALLOW environment:roles:viewer;
      terraformClusterBinding:
        type: dynatrace:PolicyBindings
        name: terraform_cluster_binding
        properties:
          cluster: ${cluster}
          group: ${terraform.id}
          policies:
            - ${terraformCluster.id}
      terraformEnvBinding:
        type: dynatrace:PolicyBindings
        name: terraform_env_binding
        properties:
          environment: ${environment}
          group: ${terraform.id}
          policies:
            - ${terraformEnv.id}
    
    pulumi {
      required_providers {
        dynatrace = {
          source = "pulumi/dynatrace"
        }
      }
    }
    
    resource "dynatrace_usergroup" "terraform" {
      name        = "Anonymous"
      ldap_groups = ["Anonymous"]
    }
    resource "dynatrace_user" "terraform" {
      email      = "me@example.com"
      first_name = "John"
      groups     = [dynatrace_usergroup.terraform.id]
      last_name  = "Doe"
      user_name  = "me@example.com"
    }
    resource "dynatrace_policy" "terraform_cluster" {
      name            = "terraform_cluster"
      cluster         = var.cluster
      statement_query = "ALLOW settings:objects:read, settings:schemas:read WHERE settings:schemaId = \"terraform-cluster\";"
    }
    resource "dynatrace_policy" "terraform_env" {
      name            = "terraform_env"
      environment     = var.environment
      statement_query = "ALLOW environment:roles:viewer;"
    }
    resource "dynatrace_policybindings" "terraform_cluster_binding" {
      cluster  = var.cluster
      group    = dynatrace_usergroup.terraform.id
      policies = [dynatrace_policy.terraform_cluster.id]
    }
    resource "dynatrace_policybindings" "terraform_env_binding" {
      environment = var.environment
      group       = dynatrace_usergroup.terraform.id
      policies    = [dynatrace_policy.terraform_env.id]
    }
    variable "cluster" {
      type    = string
      default = "<the-id-of-your-dynatrace-cluster>"
    }
    variable "environment" {
      type    = string
      default = "<the-id-of-an-environment-within-your-cluster"
    }
    

    Create User Resource

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

    Constructor syntax

    new User(name: string, args: UserArgs, opts?: CustomResourceOptions);
    @overload
    def User(resource_name: str,
             args: UserArgs,
             opts: Optional[ResourceOptions] = None)
    
    @overload
    def User(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             email: Optional[str] = None,
             first_name: Optional[str] = None,
             last_name: Optional[str] = None,
             user_name: Optional[str] = None,
             groups: Optional[Sequence[str]] = None)
    func NewUser(ctx *Context, name string, args UserArgs, opts ...ResourceOption) (*User, error)
    public User(string name, UserArgs args, CustomResourceOptions? opts = null)
    public User(String name, UserArgs args)
    public User(String name, UserArgs args, CustomResourceOptions options)
    
    type: dynatrace:User
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "dynatrace_user" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args UserArgs
    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 UserArgs
    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 UserArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args UserArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args UserArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

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

    var userResource = new Dynatrace.User("userResource", new()
    {
        Email = "string",
        FirstName = "string",
        LastName = "string",
        UserName = "string",
        Groups = new[]
        {
            "string",
        },
    });
    
    example, err := dynatrace.NewUser(ctx, "userResource", &dynatrace.UserArgs{
    	Email:     pulumi.String("string"),
    	FirstName: pulumi.String("string"),
    	LastName:  pulumi.String("string"),
    	UserName:  pulumi.String("string"),
    	Groups: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    })
    
    resource "dynatrace_user" "userResource" {
      email      = "string"
      first_name = "string"
      last_name  = "string"
      user_name  = "string"
      groups     = ["string"]
    }
    
    var userResource = new User("userResource", UserArgs.builder()
        .email("string")
        .firstName("string")
        .lastName("string")
        .userName("string")
        .groups("string")
        .build());
    
    user_resource = dynatrace.User("userResource",
        email="string",
        first_name="string",
        last_name="string",
        user_name="string",
        groups=["string"])
    
    const userResource = new dynatrace.User("userResource", {
        email: "string",
        firstName: "string",
        lastName: "string",
        userName: "string",
        groups: ["string"],
    });
    
    type: dynatrace:User
    properties:
        email: string
        firstName: string
        groups:
            - string
        lastName: string
        userName: string
    

    User Resource Properties

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

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The User resource accepts the following input properties:

    Email string
    User's email address
    FirstName string
    User's first name
    LastName string
    User's last name
    UserName string
    The User Name
    Groups List<string>
    List of user's user group IDs
    Email string
    User's email address
    FirstName string
    User's first name
    LastName string
    User's last name
    UserName string
    The User Name
    Groups []string
    List of user's user group IDs
    email string
    User's email address
    first_name string
    User's first name
    last_name string
    User's last name
    user_name string
    The User Name
    groups list(string)
    List of user's user group IDs
    email String
    User's email address
    firstName String
    User's first name
    lastName String
    User's last name
    userName String
    The User Name
    groups List<String>
    List of user's user group IDs
    email string
    User's email address
    firstName string
    User's first name
    lastName string
    User's last name
    userName string
    The User Name
    groups string[]
    List of user's user group IDs
    email str
    User's email address
    first_name str
    User's first name
    last_name str
    User's last name
    user_name str
    The User Name
    groups Sequence[str]
    List of user's user group IDs
    email String
    User's email address
    firstName String
    User's first name
    lastName String
    User's last name
    userName String
    The User Name
    groups List<String>
    List of user's user group IDs

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing User Resource

    Get an existing User 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?: UserState, opts?: CustomResourceOptions): User
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            email: Optional[str] = None,
            first_name: Optional[str] = None,
            groups: Optional[Sequence[str]] = None,
            last_name: Optional[str] = None,
            user_name: Optional[str] = None) -> User
    func GetUser(ctx *Context, name string, id IDInput, state *UserState, opts ...ResourceOption) (*User, error)
    public static User Get(string name, Input<string> id, UserState? state, CustomResourceOptions? opts = null)
    public static User get(String name, Output<String> id, UserState state, CustomResourceOptions options)
    resources:  _:    type: dynatrace:User    get:      id: ${id}
    import {
      to = dynatrace_user.example
      id = "${id}"
    }
    
    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:
    Email string
    User's email address
    FirstName string
    User's first name
    Groups List<string>
    List of user's user group IDs
    LastName string
    User's last name
    UserName string
    The User Name
    Email string
    User's email address
    FirstName string
    User's first name
    Groups []string
    List of user's user group IDs
    LastName string
    User's last name
    UserName string
    The User Name
    email string
    User's email address
    first_name string
    User's first name
    groups list(string)
    List of user's user group IDs
    last_name string
    User's last name
    user_name string
    The User Name
    email String
    User's email address
    firstName String
    User's first name
    groups List<String>
    List of user's user group IDs
    lastName String
    User's last name
    userName String
    The User Name
    email string
    User's email address
    firstName string
    User's first name
    groups string[]
    List of user's user group IDs
    lastName string
    User's last name
    userName string
    The User Name
    email str
    User's email address
    first_name str
    User's first name
    groups Sequence[str]
    List of user's user group IDs
    last_name str
    User's last name
    user_name str
    The User Name
    email String
    User's email address
    firstName String
    User's first name
    groups List<String>
    List of user's user group IDs
    lastName String
    User's last name
    userName String
    The User Name

    Package Details

    Repository
    dynatrace pulumiverse/pulumi-dynatrace
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the dynatrace Terraform Provider.
    dynatrace logo
    Viewing docs for Dynatrace v0.36.0
    published on Tuesday, Jun 9, 2026 by Pulumiverse

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial