1. Packages
  2. Datadog Provider
  3. API Docs
  4. getRole
Datadog v4.59.0 published on Wednesday, Oct 22, 2025 by Pulumi
pulumi/pulumi-datadog

datadog.getRole

Get Started
datadog logo
Datadog v4.59.0 published on Wednesday, Oct 22, 2025 by Pulumi
pulumi/pulumi-datadog

    Use this data source to retrieve information about an existing role for use in other resources.

    Example Usage

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

const apiKeyManager = datadog.getRole({
    filter: "API Key Manager",
});

    import pulumi
import pulumi_datadog as datadog

api_key_manager = datadog.get_role(filter="API Key Manager")

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := datadog.LookupRole(ctx, &datadog.LookupRoleArgs{
			Filter: "API Key Manager",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var apiKeyManager = Datadog.GetRole.Invoke(new()
    {
        Filter = "API Key Manager",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.datadog.DatadogFunctions;
import com.pulumi.datadog.inputs.GetRoleArgs;
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) {
        final var apiKeyManager = DatadogFunctions.getRole(GetRoleArgs.builder()
            .filter("API Key Manager")
            .build());

    }
}

    variables:
  apiKeyManager:
    fn::invoke:
      function: datadog:getRole
      arguments:
        filter: API Key Manager

    Using getRole

    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 getRole(args: GetRoleArgs, opts?: InvokeOptions): Promise<GetRoleResult>
function getRoleOutput(args: GetRoleOutputArgs, opts?: InvokeOptions): Output<GetRoleResult>
    def get_role(filter: Optional[str] = None,
             opts: Optional[InvokeOptions] = None) -> GetRoleResult
def get_role_output(filter: Optional[pulumi.Input[str]] = None,
             opts: Optional[InvokeOptions] = None) -> Output[GetRoleResult]
    func LookupRole(ctx *Context, args *LookupRoleArgs, opts ...InvokeOption) (*LookupRoleResult, error)
func LookupRoleOutput(ctx *Context, args *LookupRoleOutputArgs, opts ...InvokeOption) LookupRoleResultOutput

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

    public static class GetRole 
{
    public static Task<GetRoleResult> InvokeAsync(GetRoleArgs args, InvokeOptions? opts = null)
    public static Output<GetRoleResult> Invoke(GetRoleInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetRoleResult> getRole(GetRoleArgs args, InvokeOptions options)
public static Output<GetRoleResult> getRole(GetRoleArgs args, InvokeOptions options)

    fn::invoke:
  function: datadog:index/getRole:getRole
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Filter string
    A string on which to filter the roles.
    Filter string
    A string on which to filter the roles.
    filter String
    A string on which to filter the roles.
    filter string
    A string on which to filter the roles.
    filter str
    A string on which to filter the roles.
    filter String
    A string on which to filter the roles.

    getRole Result

    The following output properties are available:

    Filter string
    A string on which to filter the roles.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Name of the role.
    UserCount int
    Number of users assigned to this role.
    Filter string
    A string on which to filter the roles.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Name of the role.
    UserCount int
    Number of users assigned to this role.
    filter String
    A string on which to filter the roles.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Name of the role.
    userCount Integer
    Number of users assigned to this role.
    filter string
    A string on which to filter the roles.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    Name of the role.
    userCount number
    Number of users assigned to this role.
    filter str
    A string on which to filter the roles.
    id str
    The provider-assigned unique ID for this managed resource.
    name str
    Name of the role.
    user_count int
    Number of users assigned to this role.
    filter String
    A string on which to filter the roles.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Name of the role.
    userCount Number
    Number of users assigned to this role.

    Package Details

    Repository
    Datadog pulumi/pulumi-datadog
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the datadog Terraform Provider.
    datadog logo
    Datadog v4.59.0 published on Wednesday, Oct 22, 2025 by Pulumi
    pulumi/pulumi-datadog
      Meet Neo: Your AI Platform Teammate