Dynatrace v0.16.0, Sep 10 24

Dynatrace v0.16.0 published on Tuesday, Sep 10, 2024 by Pulumiverse

dynatrace.IamGroup

Explore with Pulumi AI

Dynatrace v0.16.0 published on Tuesday, Sep 10, 2024 by Pulumiverse

This resource is excluded by default in the export utility since it is part of the account management API. You can, of course, specify that resource explicitly in order to export it. In that case, don’t forget to specify the environment variables DT_CLIENT_ID, DT_ACCOUNT_ID and DT_CLIENT_SECRET for authentication.

This resource requires the OAuth client permissions Allow read access for identity resources (users and groups) (account-idm-read) and Allow write access for identity resources (users and groups) (account-idm-write)

Dynatrace Documentation

Dynatrace IAM - https://www.dynatrace.com/support/help/how-to-use-dynatrace/user-management-and-sso/manage-groups-and-permissions
Settings API - https://www.dynatrace.com/support/help/how-to-use-dynatrace/user-management-and-sso/manage-groups-and-permissions/iam/iam-getting-started

Prerequisites

Using this resource requires an OAuth client to be configured within your account settings. The scopes of the OAuth Client need to include account-idm-read, account-idm-write, account-env-read, account-env-write, iam-policies-management, iam:policies:write, iam:policies:read, iam:bindings:write, iam:bindings:read and iam:effective-permissions:read.

Finally the provider configuration requires the credentials for that OAuth Client. The configuration section of your provider needs to look like this.

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

import pulumi

package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
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) {
    }
}

{}

Resource Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as dynatrace from "@pulumiverse/dynatrace";

const restricted = new dynatrace.IamGroup("restricted", {permissions: {
    permissions: [{
        name: "tenant-viewer",
        scope: "<environment-id>:<managementzone-id>",
        type: "management-zone",
    }],
}});

import pulumi
import pulumiverse_dynatrace as dynatrace

restricted = dynatrace.IamGroup("restricted", permissions={
    "permissions": [{
        "name": "tenant-viewer",
        "scope": "<environment-id>:<managementzone-id>",
        "type": "management-zone",
    }],
})

package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-dynatrace/sdk/go/dynatrace"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := dynatrace.NewIamGroup(ctx, "restricted", &dynatrace.IamGroupArgs{
			Permissions: &dynatrace.IamGroupPermissionsArgs{
				Permissions: dynatrace.IamGroupPermissionsPermissionArray{
					&dynatrace.IamGroupPermissionsPermissionArgs{
						Name:  pulumi.String("tenant-viewer"),
						Scope: pulumi.String("<environment-id>:<managementzone-id>"),
						Type:  pulumi.String("management-zone"),
					},
				},
			},
		})
		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 restricted = new Dynatrace.IamGroup("restricted", new()
    {
        Permissions = new Dynatrace.Inputs.IamGroupPermissionsArgs
        {
            Permissions = new[]
            {
                new Dynatrace.Inputs.IamGroupPermissionsPermissionArgs
                {
                    Name = "tenant-viewer",
                    Scope = "<environment-id>:<managementzone-id>",
                    Type = "management-zone",
                },
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.dynatrace.IamGroup;
import com.pulumi.dynatrace.IamGroupArgs;
import com.pulumi.dynatrace.inputs.IamGroupPermissionsArgs;
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 restricted = new IamGroup("restricted", IamGroupArgs.builder()
            .permissions(IamGroupPermissionsArgs.builder()
                .permissions(IamGroupPermissionsPermissionArgs.builder()
                    .name("tenant-viewer")
                    .scope("<environment-id>:<managementzone-id>")
                    .type("management-zone")
                    .build())
                .build())
            .build());

    }
}

resources:
  restricted:
    type: dynatrace:IamGroup
    properties:
      permissions:
        permissions:
          - name: tenant-viewer
            scope: <environment-id>:<managementzone-id>
            type: management-zone

Create IamGroup Resource

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

Constructor syntax

new IamGroup(name: string, args?: IamGroupArgs, opts?: CustomResourceOptions);

@overload
def IamGroup(resource_name: str,
             args: Optional[IamGroupArgs] = None,
             opts: Optional[ResourceOptions] = None)

@overload
def IamGroup(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             description: Optional[str] = None,
             federated_attribute_values: Optional[Sequence[str]] = None,
             name: Optional[str] = None,
             permissions: Optional[IamGroupPermissionsArgs] = None)

func NewIamGroup(ctx *Context, name string, args *IamGroupArgs, opts ...ResourceOption) (*IamGroup, error)

public IamGroup(string name, IamGroupArgs? args = null, CustomResourceOptions? opts = null)

public IamGroup(String name, IamGroupArgs args)
public IamGroup(String name, IamGroupArgs args, CustomResourceOptions options)

type: dynatrace:IamGroup
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 IamGroupArgs: 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 IamGroupArgs: 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 IamGroupArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args IamGroupArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args IamGroupArgs: 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 iamGroupResource = new Dynatrace.IamGroup("iamGroupResource", new()
{
    Description = "string",
    FederatedAttributeValues = new[]
    {
        "string",
    },
    Name = "string",
    Permissions = new Dynatrace.Inputs.IamGroupPermissionsArgs
    {
        Permissions = new[]
        {
            new Dynatrace.Inputs.IamGroupPermissionsPermissionArgs
            {
                Name = "string",
                Scope = "string",
                Type = "string",
            },
        },
    },
});

example, err := dynatrace.NewIamGroup(ctx, "iamGroupResource", &dynatrace.IamGroupArgs{
	Description: pulumi.String("string"),
	FederatedAttributeValues: pulumi.StringArray{
		pulumi.String("string"),
	},
	Name: pulumi.String("string"),
	Permissions: &dynatrace.IamGroupPermissionsArgs{
		Permissions: dynatrace.IamGroupPermissionsPermissionArray{
			&dynatrace.IamGroupPermissionsPermissionArgs{
				Name:  pulumi.String("string"),
				Scope: pulumi.String("string"),
				Type:  pulumi.String("string"),
			},
		},
	},
})

var iamGroupResource = new IamGroup("iamGroupResource", IamGroupArgs.builder()
    .description("string")
    .federatedAttributeValues("string")
    .name("string")
    .permissions(IamGroupPermissionsArgs.builder()
        .permissions(IamGroupPermissionsPermissionArgs.builder()
            .name("string")
            .scope("string")
            .type("string")
            .build())
        .build())
    .build());

iam_group_resource = dynatrace.IamGroup("iamGroupResource",
    description="string",
    federated_attribute_values=["string"],
    name="string",
    permissions=dynatrace.IamGroupPermissionsArgs(
        permissions=[dynatrace.IamGroupPermissionsPermissionArgs(
            name="string",
            scope="string",
            type="string",
        )],
    ))

const iamGroupResource = new dynatrace.IamGroup("iamGroupResource", {
    description: "string",
    federatedAttributeValues: ["string"],
    name: "string",
    permissions: {
        permissions: [{
            name: "string",
            scope: "string",
            type: "string",
        }],
    },
});

type: dynatrace:IamGroup
properties:
    description: string
    federatedAttributeValues:
        - string
    name: string
    permissions:
        permissions:
            - name: string
              scope: string
              type: string

IamGroup 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 IamGroup resource accepts the following input properties:

Description string
FederatedAttributeValues List<string>
Name string
Permissions Pulumiverse.Dynatrace.Inputs.IamGroupPermissions

Description string
FederatedAttributeValues []string
Name string
Permissions IamGroupPermissionsArgs

description String
federatedAttributeValues List<String>
name String
permissions IamGroupPermissions

description string
federatedAttributeValues string[]
name string
permissions IamGroupPermissions

description str
federated_attribute_values Sequence[str]
name str
permissions IamGroupPermissionsArgs

description String
federatedAttributeValues List<String>
name String
permissions Property Map

Outputs

All input properties are implicitly available as output properties. Additionally, the IamGroup 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 str: The provider-assigned unique ID for this managed resource.

id String: The provider-assigned unique ID for this managed resource.

Look up Existing IamGroup Resource

Get an existing IamGroup 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?: IamGroupState, opts?: CustomResourceOptions): IamGroup

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        description: Optional[str] = None,
        federated_attribute_values: Optional[Sequence[str]] = None,
        name: Optional[str] = None,
        permissions: Optional[IamGroupPermissionsArgs] = None) -> IamGroup

func GetIamGroup(ctx *Context, name string, id IDInput, state *IamGroupState, opts ...ResourceOption) (*IamGroup, error)

public static IamGroup Get(string name, Input<string> id, IamGroupState? state, CustomResourceOptions? opts = null)

public static IamGroup get(String name, Output<String> id, IamGroupState 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:

Description string
FederatedAttributeValues List<string>
Name string
Permissions Pulumiverse.Dynatrace.Inputs.IamGroupPermissions

Description string
FederatedAttributeValues []string
Name string
Permissions IamGroupPermissionsArgs

description String
federatedAttributeValues List<String>
name String
permissions IamGroupPermissions

description string
federatedAttributeValues string[]
name string
permissions IamGroupPermissions

description str
federated_attribute_values Sequence[str]
name str
permissions IamGroupPermissionsArgs

description String
federatedAttributeValues List<String>
name String
permissions Property Map

Supporting Types

IamGroupPermissions, IamGroupPermissionsArgs

Permissions List<Pulumiverse.Dynatrace.Inputs.IamGroupPermissionsPermission>: A Permission

Permissions []IamGroupPermissionsPermission: A Permission

permissions List<IamGroupPermissionsPermission>: A Permission

permissions IamGroupPermissionsPermission[]: A Permission

permissions Sequence[IamGroupPermissionsPermission]: A Permission

permissions List<Property Map>: A Permission

IamGroupPermissionsPermission, IamGroupPermissionsPermissionArgs

Name string: Possible values: account-company-info, account-user-management, account-viewer, account-saml-flexible-federation, tenant-viewer, tenant-manage-settings, tenant-agent-install, tenant-logviewer, tenant-view-sensitive-request-data, tenant-configure-request-capture-data, tenant-replay-sessions-with-masking, tenant-replay-sessions-without-masking, tenant-manage-security-problems, tenant-view-security-problems, tenant-manage-support-tickets
Scope string: If type is account this attribute should hold the UUID of the account. If type is 'tenantthis attribute should hold the ID of the environment (https://\n\n.live.dynatrace.com). Iftypeismanagement-zonethis attribute should hold a value like\n\n:\n\n. You need to use the attribute legacy_id when referring to a resource dynatrace.ManagementZoneV2 or a data source dynatrace.ManagementZone.
Type string: The type of this permission. Possible values are account, tenant, management-zone

Name string: Possible values: account-company-info, account-user-management, account-viewer, account-saml-flexible-federation, tenant-viewer, tenant-manage-settings, tenant-agent-install, tenant-logviewer, tenant-view-sensitive-request-data, tenant-configure-request-capture-data, tenant-replay-sessions-with-masking, tenant-replay-sessions-without-masking, tenant-manage-security-problems, tenant-view-security-problems, tenant-manage-support-tickets
Scope string: If type is account this attribute should hold the UUID of the account. If type is 'tenantthis attribute should hold the ID of the environment (https://\n\n.live.dynatrace.com). Iftypeismanagement-zonethis attribute should hold a value like\n\n:\n\n. You need to use the attribute legacy_id when referring to a resource dynatrace.ManagementZoneV2 or a data source dynatrace.ManagementZone.
Type string: The type of this permission. Possible values are account, tenant, management-zone

name String: Possible values: account-company-info, account-user-management, account-viewer, account-saml-flexible-federation, tenant-viewer, tenant-manage-settings, tenant-agent-install, tenant-logviewer, tenant-view-sensitive-request-data, tenant-configure-request-capture-data, tenant-replay-sessions-with-masking, tenant-replay-sessions-without-masking, tenant-manage-security-problems, tenant-view-security-problems, tenant-manage-support-tickets
scope String: If type is account this attribute should hold the UUID of the account. If type is 'tenantthis attribute should hold the ID of the environment (https://\n\n.live.dynatrace.com). Iftypeismanagement-zonethis attribute should hold a value like\n\n:\n\n. You need to use the attribute legacy_id when referring to a resource dynatrace.ManagementZoneV2 or a data source dynatrace.ManagementZone.
type String: The type of this permission. Possible values are account, tenant, management-zone

name string: Possible values: account-company-info, account-user-management, account-viewer, account-saml-flexible-federation, tenant-viewer, tenant-manage-settings, tenant-agent-install, tenant-logviewer, tenant-view-sensitive-request-data, tenant-configure-request-capture-data, tenant-replay-sessions-with-masking, tenant-replay-sessions-without-masking, tenant-manage-security-problems, tenant-view-security-problems, tenant-manage-support-tickets
scope string: If type is account this attribute should hold the UUID of the account. If type is 'tenantthis attribute should hold the ID of the environment (https://\n\n.live.dynatrace.com). Iftypeismanagement-zonethis attribute should hold a value like\n\n:\n\n. You need to use the attribute legacy_id when referring to a resource dynatrace.ManagementZoneV2 or a data source dynatrace.ManagementZone.
type string: The type of this permission. Possible values are account, tenant, management-zone

name str: Possible values: account-company-info, account-user-management, account-viewer, account-saml-flexible-federation, tenant-viewer, tenant-manage-settings, tenant-agent-install, tenant-logviewer, tenant-view-sensitive-request-data, tenant-configure-request-capture-data, tenant-replay-sessions-with-masking, tenant-replay-sessions-without-masking, tenant-manage-security-problems, tenant-view-security-problems, tenant-manage-support-tickets
scope str: If type is account this attribute should hold the UUID of the account. If type is 'tenantthis attribute should hold the ID of the environment (https://\n\n.live.dynatrace.com). Iftypeismanagement-zonethis attribute should hold a value like\n\n:\n\n. You need to use the attribute legacy_id when referring to a resource dynatrace.ManagementZoneV2 or a data source dynatrace.ManagementZone.
type str: The type of this permission. Possible values are account, tenant, management-zone

name String: Possible values: account-company-info, account-user-management, account-viewer, account-saml-flexible-federation, tenant-viewer, tenant-manage-settings, tenant-agent-install, tenant-logviewer, tenant-view-sensitive-request-data, tenant-configure-request-capture-data, tenant-replay-sessions-with-masking, tenant-replay-sessions-without-masking, tenant-manage-security-problems, tenant-view-security-problems, tenant-manage-support-tickets
scope String: If type is account this attribute should hold the UUID of the account. If type is 'tenantthis attribute should hold the ID of the environment (https://\n\n.live.dynatrace.com). Iftypeismanagement-zonethis attribute should hold a value like\n\n:\n\n. You need to use the attribute legacy_id when referring to a resource dynatrace.ManagementZoneV2 or a data source dynatrace.ManagementZone.
type String: The type of this permission. Possible values are account, tenant, management-zone

Package Details

Repository: dynatrace pulumiverse/pulumi-dynatrace
License: Apache-2.0
Notes: This Pulumi package is based on the dynatrace Terraform Provider.

Dynatrace v0.16.0 published on Tuesday, Sep 10, 2024 by Pulumiverse

pulumiverse/pulumi-dynatrace

dynatrace.IamGroup

On this page

On this page

Dynatrace Documentation

Prerequisites

Resource Example Usage

Create IamGroup Resource

Constructor syntax

Parameters

Constructor example

IamGroup Resource Properties

Inputs

Outputs

Look up Existing IamGroup Resource

Supporting Types

IamGroupPermissions, IamGroupPermissionsArgs

IamGroupPermissionsPermission, IamGroupPermissionsPermissionArgs

Package Details

On this page

On this page