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

datadog.SyntheticsGlobalVariable

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

    Provides a Datadog synthetics global variable resource. This can be used to create and manage Datadog synthetics global variables.

    Example Usage

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

// Create new synthetics_global_variable resource
const testVariable = new datadog.SyntheticsGlobalVariable("test_variable", {
    name: "EXAMPLE_VARIABLE",
    description: "Description of the variable",
    tags: [
        "foo:bar",
        "env:test",
    ],
    value: "variable-value",
});

    import pulumi
import pulumi_datadog as datadog

# Create new synthetics_global_variable resource
test_variable = datadog.SyntheticsGlobalVariable("test_variable",
    name="EXAMPLE_VARIABLE",
    description="Description of the variable",
    tags=[
        "foo:bar",
        "env:test",
    ],
    value="variable-value")

    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 {
		// Create new synthetics_global_variable resource
		_, err := datadog.NewSyntheticsGlobalVariable(ctx, "test_variable", &datadog.SyntheticsGlobalVariableArgs{
			Name:        pulumi.String("EXAMPLE_VARIABLE"),
			Description: pulumi.String("Description of the variable"),
			Tags: pulumi.StringArray{
				pulumi.String("foo:bar"),
				pulumi.String("env:test"),
			},
			Value: pulumi.String("variable-value"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    // Create new synthetics_global_variable resource
    var testVariable = new Datadog.SyntheticsGlobalVariable("test_variable", new()
    {
        Name = "EXAMPLE_VARIABLE",
        Description = "Description of the variable",
        Tags = new[]
        {
            "foo:bar",
            "env:test",
        },
        Value = "variable-value",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.datadog.SyntheticsGlobalVariable;
import com.pulumi.datadog.SyntheticsGlobalVariableArgs;
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) {
        // Create new synthetics_global_variable resource
        var testVariable = new SyntheticsGlobalVariable("testVariable", SyntheticsGlobalVariableArgs.builder()
            .name("EXAMPLE_VARIABLE")
            .description("Description of the variable")
            .tags(            
                "foo:bar",
                "env:test")
            .value("variable-value")
            .build());

    }
}

    resources:
  # Create new synthetics_global_variable resource
  testVariable:
    type: datadog:SyntheticsGlobalVariable
    name: test_variable
    properties:
      name: EXAMPLE_VARIABLE
      description: Description of the variable
      tags:
        - foo:bar
        - env:test
      value: variable-value

    Create SyntheticsGlobalVariable Resource

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

    Constructor syntax

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

@overload
def SyntheticsGlobalVariable(resource_name: str,
                             opts: Optional[ResourceOptions] = None,
                             name: Optional[str] = None,
                             description: Optional[str] = None,
                             is_fido: Optional[bool] = None,
                             is_totp: Optional[bool] = None,
                             options: Optional[SyntheticsGlobalVariableOptionsArgs] = None,
                             parse_test_id: Optional[str] = None,
                             parse_test_options: Optional[SyntheticsGlobalVariableParseTestOptionsArgs] = None,
                             restricted_roles: Optional[Sequence[str]] = None,
                             secure: Optional[bool] = None,
                             tags: Optional[Sequence[str]] = None,
                             value: Optional[str] = None)
    func NewSyntheticsGlobalVariable(ctx *Context, name string, args SyntheticsGlobalVariableArgs, opts ...ResourceOption) (*SyntheticsGlobalVariable, error)
    public SyntheticsGlobalVariable(string name, SyntheticsGlobalVariableArgs args, CustomResourceOptions? opts = null)
    public SyntheticsGlobalVariable(String name, SyntheticsGlobalVariableArgs args)
public SyntheticsGlobalVariable(String name, SyntheticsGlobalVariableArgs args, CustomResourceOptions options)

    type: datadog:SyntheticsGlobalVariable
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 SyntheticsGlobalVariableArgs
    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 SyntheticsGlobalVariableArgs
    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 SyntheticsGlobalVariableArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args SyntheticsGlobalVariableArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args SyntheticsGlobalVariableArgs
    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 syntheticsGlobalVariableResource = new Datadog.SyntheticsGlobalVariable("syntheticsGlobalVariableResource", new()
{
    Name = "string",
    Description = "string",
    IsFido = false,
    IsTotp = false,
    Options = new Datadog.Inputs.SyntheticsGlobalVariableOptionsArgs
    {
        TotpParameters = new Datadog.Inputs.SyntheticsGlobalVariableOptionsTotpParametersArgs
        {
            Digits = 0,
            RefreshInterval = 0,
        },
    },
    ParseTestId = "string",
    ParseTestOptions = new Datadog.Inputs.SyntheticsGlobalVariableParseTestOptionsArgs
    {
        Type = "string",
        Field = "string",
        LocalVariableName = "string",
        Parser = new Datadog.Inputs.SyntheticsGlobalVariableParseTestOptionsParserArgs
        {
            Type = "string",
            Value = "string",
        },
    },
    Secure = false,
    Tags = new[]
    {
        "string",
    },
    Value = "string",
});

    example, err := datadog.NewSyntheticsGlobalVariable(ctx, "syntheticsGlobalVariableResource", &datadog.SyntheticsGlobalVariableArgs{
	Name:        pulumi.String("string"),
	Description: pulumi.String("string"),
	IsFido:      pulumi.Bool(false),
	IsTotp:      pulumi.Bool(false),
	Options: &datadog.SyntheticsGlobalVariableOptionsArgs{
		TotpParameters: &datadog.SyntheticsGlobalVariableOptionsTotpParametersArgs{
			Digits:          pulumi.Int(0),
			RefreshInterval: pulumi.Int(0),
		},
	},
	ParseTestId: pulumi.String("string"),
	ParseTestOptions: &datadog.SyntheticsGlobalVariableParseTestOptionsArgs{
		Type:              pulumi.String("string"),
		Field:             pulumi.String("string"),
		LocalVariableName: pulumi.String("string"),
		Parser: &datadog.SyntheticsGlobalVariableParseTestOptionsParserArgs{
			Type:  pulumi.String("string"),
			Value: pulumi.String("string"),
		},
	},
	Secure: pulumi.Bool(false),
	Tags: pulumi.StringArray{
		pulumi.String("string"),
	},
	Value: pulumi.String("string"),
})

    var syntheticsGlobalVariableResource = new SyntheticsGlobalVariable("syntheticsGlobalVariableResource", SyntheticsGlobalVariableArgs.builder()
    .name("string")
    .description("string")
    .isFido(false)
    .isTotp(false)
    .options(SyntheticsGlobalVariableOptionsArgs.builder()
        .totpParameters(SyntheticsGlobalVariableOptionsTotpParametersArgs.builder()
            .digits(0)
            .refreshInterval(0)
            .build())
        .build())
    .parseTestId("string")
    .parseTestOptions(SyntheticsGlobalVariableParseTestOptionsArgs.builder()
        .type("string")
        .field("string")
        .localVariableName("string")
        .parser(SyntheticsGlobalVariableParseTestOptionsParserArgs.builder()
            .type("string")
            .value("string")
            .build())
        .build())
    .secure(false)
    .tags("string")
    .value("string")
    .build());

    synthetics_global_variable_resource = datadog.SyntheticsGlobalVariable("syntheticsGlobalVariableResource",
    name="string",
    description="string",
    is_fido=False,
    is_totp=False,
    options={
        "totp_parameters": {
            "digits": 0,
            "refresh_interval": 0,
        },
    },
    parse_test_id="string",
    parse_test_options={
        "type": "string",
        "field": "string",
        "local_variable_name": "string",
        "parser": {
            "type": "string",
            "value": "string",
        },
    },
    secure=False,
    tags=["string"],
    value="string")

    const syntheticsGlobalVariableResource = new datadog.SyntheticsGlobalVariable("syntheticsGlobalVariableResource", {
    name: "string",
    description: "string",
    isFido: false,
    isTotp: false,
    options: {
        totpParameters: {
            digits: 0,
            refreshInterval: 0,
        },
    },
    parseTestId: "string",
    parseTestOptions: {
        type: "string",
        field: "string",
        localVariableName: "string",
        parser: {
            type: "string",
            value: "string",
        },
    },
    secure: false,
    tags: ["string"],
    value: "string",
});

    type: datadog:SyntheticsGlobalVariable
properties:
    description: string
    isFido: false
    isTotp: false
    name: string
    options:
        totpParameters:
            digits: 0
            refreshInterval: 0
    parseTestId: string
    parseTestOptions:
        field: string
        localVariableName: string
        parser:
            type: string
            value: string
        type: string
    secure: false
    tags:
        - string
    value: string

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

    Name string
    Synthetics global variable name. Must be all uppercase with underscores.
    Description string
    Description of the global variable. Defaults to "".
    IsFido bool
    If set to true, the global variable is a FIDO variable. Defaults to false.
    IsTotp bool
    If set to true, the global variable is a TOTP variable. Defaults to false.
    Options SyntheticsGlobalVariableOptions
    Additional options for the variable, such as a MFA token.
    ParseTestId string
    Id of the Synthetics test to use for a variable from test.
    ParseTestOptions SyntheticsGlobalVariableParseTestOptions
    ID of the Synthetics test to use a source of the global variable value.
    RestrictedRoles List<string>
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Secure bool
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    Tags List<string>
    A list of tags to associate with your synthetics global variable.
    Value string
    The value of the global variable. Required unless is_fido is set to true.
    Name string
    Synthetics global variable name. Must be all uppercase with underscores.
    Description string
    Description of the global variable. Defaults to "".
    IsFido bool
    If set to true, the global variable is a FIDO variable. Defaults to false.
    IsTotp bool
    If set to true, the global variable is a TOTP variable. Defaults to false.
    Options SyntheticsGlobalVariableOptionsArgs
    Additional options for the variable, such as a MFA token.
    ParseTestId string
    Id of the Synthetics test to use for a variable from test.
    ParseTestOptions SyntheticsGlobalVariableParseTestOptionsArgs
    ID of the Synthetics test to use a source of the global variable value.
    RestrictedRoles []string
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Secure bool
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    Tags []string
    A list of tags to associate with your synthetics global variable.
    Value string
    The value of the global variable. Required unless is_fido is set to true.
    name String
    Synthetics global variable name. Must be all uppercase with underscores.
    description String
    Description of the global variable. Defaults to "".
    isFido Boolean
    If set to true, the global variable is a FIDO variable. Defaults to false.
    isTotp Boolean
    If set to true, the global variable is a TOTP variable. Defaults to false.
    options SyntheticsGlobalVariableOptions
    Additional options for the variable, such as a MFA token.
    parseTestId String
    Id of the Synthetics test to use for a variable from test.
    parseTestOptions SyntheticsGlobalVariableParseTestOptions
    ID of the Synthetics test to use a source of the global variable value.
    restrictedRoles List<String>
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    secure Boolean
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    tags List<String>
    A list of tags to associate with your synthetics global variable.
    value String
    The value of the global variable. Required unless is_fido is set to true.
    name string
    Synthetics global variable name. Must be all uppercase with underscores.
    description string
    Description of the global variable. Defaults to "".
    isFido boolean
    If set to true, the global variable is a FIDO variable. Defaults to false.
    isTotp boolean
    If set to true, the global variable is a TOTP variable. Defaults to false.
    options SyntheticsGlobalVariableOptions
    Additional options for the variable, such as a MFA token.
    parseTestId string
    Id of the Synthetics test to use for a variable from test.
    parseTestOptions SyntheticsGlobalVariableParseTestOptions
    ID of the Synthetics test to use a source of the global variable value.
    restrictedRoles string[]
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    secure boolean
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    tags string[]
    A list of tags to associate with your synthetics global variable.
    value string
    The value of the global variable. Required unless is_fido is set to true.
    name str
    Synthetics global variable name. Must be all uppercase with underscores.
    description str
    Description of the global variable. Defaults to "".
    is_fido bool
    If set to true, the global variable is a FIDO variable. Defaults to false.
    is_totp bool
    If set to true, the global variable is a TOTP variable. Defaults to false.
    options SyntheticsGlobalVariableOptionsArgs
    Additional options for the variable, such as a MFA token.
    parse_test_id str
    Id of the Synthetics test to use for a variable from test.
    parse_test_options SyntheticsGlobalVariableParseTestOptionsArgs
    ID of the Synthetics test to use a source of the global variable value.
    restricted_roles Sequence[str]
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    secure bool
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    tags Sequence[str]
    A list of tags to associate with your synthetics global variable.
    value str
    The value of the global variable. Required unless is_fido is set to true.
    name String
    Synthetics global variable name. Must be all uppercase with underscores.
    description String
    Description of the global variable. Defaults to "".
    isFido Boolean
    If set to true, the global variable is a FIDO variable. Defaults to false.
    isTotp Boolean
    If set to true, the global variable is a TOTP variable. Defaults to false.
    options Property Map
    Additional options for the variable, such as a MFA token.
    parseTestId String
    Id of the Synthetics test to use for a variable from test.
    parseTestOptions Property Map
    ID of the Synthetics test to use a source of the global variable value.
    restrictedRoles List<String>
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    secure Boolean
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    tags List<String>
    A list of tags to associate with your synthetics global variable.
    value String
    The value of the global variable. Required unless is_fido is set to true.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the SyntheticsGlobalVariable 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 SyntheticsGlobalVariable Resource

    Get an existing SyntheticsGlobalVariable 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?: SyntheticsGlobalVariableState, opts?: CustomResourceOptions): SyntheticsGlobalVariable
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        description: Optional[str] = None,
        is_fido: Optional[bool] = None,
        is_totp: Optional[bool] = None,
        name: Optional[str] = None,
        options: Optional[SyntheticsGlobalVariableOptionsArgs] = None,
        parse_test_id: Optional[str] = None,
        parse_test_options: Optional[SyntheticsGlobalVariableParseTestOptionsArgs] = None,
        restricted_roles: Optional[Sequence[str]] = None,
        secure: Optional[bool] = None,
        tags: Optional[Sequence[str]] = None,
        value: Optional[str] = None) -> SyntheticsGlobalVariable
    func GetSyntheticsGlobalVariable(ctx *Context, name string, id IDInput, state *SyntheticsGlobalVariableState, opts ...ResourceOption) (*SyntheticsGlobalVariable, error)
    public static SyntheticsGlobalVariable Get(string name, Input<string> id, SyntheticsGlobalVariableState? state, CustomResourceOptions? opts = null)
    public static SyntheticsGlobalVariable get(String name, Output<String> id, SyntheticsGlobalVariableState state, CustomResourceOptions options)
    resources:  _:    type: datadog:SyntheticsGlobalVariable    get:      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:
    Description string
    Description of the global variable. Defaults to "".
    IsFido bool
    If set to true, the global variable is a FIDO variable. Defaults to false.
    IsTotp bool
    If set to true, the global variable is a TOTP variable. Defaults to false.
    Name string
    Synthetics global variable name. Must be all uppercase with underscores.
    Options SyntheticsGlobalVariableOptions
    Additional options for the variable, such as a MFA token.
    ParseTestId string
    Id of the Synthetics test to use for a variable from test.
    ParseTestOptions SyntheticsGlobalVariableParseTestOptions
    ID of the Synthetics test to use a source of the global variable value.
    RestrictedRoles List<string>
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Secure bool
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    Tags List<string>
    A list of tags to associate with your synthetics global variable.
    Value string
    The value of the global variable. Required unless is_fido is set to true.
    Description string
    Description of the global variable. Defaults to "".
    IsFido bool
    If set to true, the global variable is a FIDO variable. Defaults to false.
    IsTotp bool
    If set to true, the global variable is a TOTP variable. Defaults to false.
    Name string
    Synthetics global variable name. Must be all uppercase with underscores.
    Options SyntheticsGlobalVariableOptionsArgs
    Additional options for the variable, such as a MFA token.
    ParseTestId string
    Id of the Synthetics test to use for a variable from test.
    ParseTestOptions SyntheticsGlobalVariableParseTestOptionsArgs
    ID of the Synthetics test to use a source of the global variable value.
    RestrictedRoles []string
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Secure bool
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    Tags []string
    A list of tags to associate with your synthetics global variable.
    Value string
    The value of the global variable. Required unless is_fido is set to true.
    description String
    Description of the global variable. Defaults to "".
    isFido Boolean
    If set to true, the global variable is a FIDO variable. Defaults to false.
    isTotp Boolean
    If set to true, the global variable is a TOTP variable. Defaults to false.
    name String
    Synthetics global variable name. Must be all uppercase with underscores.
    options SyntheticsGlobalVariableOptions
    Additional options for the variable, such as a MFA token.
    parseTestId String
    Id of the Synthetics test to use for a variable from test.
    parseTestOptions SyntheticsGlobalVariableParseTestOptions
    ID of the Synthetics test to use a source of the global variable value.
    restrictedRoles List<String>
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    secure Boolean
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    tags List<String>
    A list of tags to associate with your synthetics global variable.
    value String
    The value of the global variable. Required unless is_fido is set to true.
    description string
    Description of the global variable. Defaults to "".
    isFido boolean
    If set to true, the global variable is a FIDO variable. Defaults to false.
    isTotp boolean
    If set to true, the global variable is a TOTP variable. Defaults to false.
    name string
    Synthetics global variable name. Must be all uppercase with underscores.
    options SyntheticsGlobalVariableOptions
    Additional options for the variable, such as a MFA token.
    parseTestId string
    Id of the Synthetics test to use for a variable from test.
    parseTestOptions SyntheticsGlobalVariableParseTestOptions
    ID of the Synthetics test to use a source of the global variable value.
    restrictedRoles string[]
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    secure boolean
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    tags string[]
    A list of tags to associate with your synthetics global variable.
    value string
    The value of the global variable. Required unless is_fido is set to true.
    description str
    Description of the global variable. Defaults to "".
    is_fido bool
    If set to true, the global variable is a FIDO variable. Defaults to false.
    is_totp bool
    If set to true, the global variable is a TOTP variable. Defaults to false.
    name str
    Synthetics global variable name. Must be all uppercase with underscores.
    options SyntheticsGlobalVariableOptionsArgs
    Additional options for the variable, such as a MFA token.
    parse_test_id str
    Id of the Synthetics test to use for a variable from test.
    parse_test_options SyntheticsGlobalVariableParseTestOptionsArgs
    ID of the Synthetics test to use a source of the global variable value.
    restricted_roles Sequence[str]
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    secure bool
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    tags Sequence[str]
    A list of tags to associate with your synthetics global variable.
    value str
    The value of the global variable. Required unless is_fido is set to true.
    description String
    Description of the global variable. Defaults to "".
    isFido Boolean
    If set to true, the global variable is a FIDO variable. Defaults to false.
    isTotp Boolean
    If set to true, the global variable is a TOTP variable. Defaults to false.
    name String
    Synthetics global variable name. Must be all uppercase with underscores.
    options Property Map
    Additional options for the variable, such as a MFA token.
    parseTestId String
    Id of the Synthetics test to use for a variable from test.
    parseTestOptions Property Map
    ID of the Synthetics test to use a source of the global variable value.
    restrictedRoles List<String>
    A list of role identifiers to associate with the Synthetics global variable. Deprecated. This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    Deprecated: This field is no longer supported by the Datadog API. Please use datadog.RestrictionPolicy instead.

    secure Boolean
    If set to true, the value of the global variable is hidden. This setting is automatically set to true if is_totp or is_fido is set to true. Defaults to false.
    tags List<String>
    A list of tags to associate with your synthetics global variable.
    value String
    The value of the global variable. Required unless is_fido is set to true.

    Supporting Types

    SyntheticsGlobalVariableOptions, SyntheticsGlobalVariableOptionsArgs

    totpParameters Property Map
    Parameters needed for MFA/TOTP.

    SyntheticsGlobalVariableOptionsTotpParameters, SyntheticsGlobalVariableOptionsTotpParametersArgs

    Digits int
    Number of digits for the OTP. Value must be between 4 and 10.
    RefreshInterval int
    Interval for which to refresh the token (in seconds). Value must be between 0 and 999.
    Digits int
    Number of digits for the OTP. Value must be between 4 and 10.
    RefreshInterval int
    Interval for which to refresh the token (in seconds). Value must be between 0 and 999.
    digits Integer
    Number of digits for the OTP. Value must be between 4 and 10.
    refreshInterval Integer
    Interval for which to refresh the token (in seconds). Value must be between 0 and 999.
    digits number
    Number of digits for the OTP. Value must be between 4 and 10.
    refreshInterval number
    Interval for which to refresh the token (in seconds). Value must be between 0 and 999.
    digits int
    Number of digits for the OTP. Value must be between 4 and 10.
    refresh_interval int
    Interval for which to refresh the token (in seconds). Value must be between 0 and 999.
    digits Number
    Number of digits for the OTP. Value must be between 4 and 10.
    refreshInterval Number
    Interval for which to refresh the token (in seconds). Value must be between 0 and 999.

    SyntheticsGlobalVariableParseTestOptions, SyntheticsGlobalVariableParseTestOptionsArgs

    Type string
    Defines the source to use to extract the value. Valid values are http_body, http_header, http_status_code, local_variable.
    Field string
    Required when type = http_header. Defines the header to use to extract the value
    LocalVariableName string
    When type is local_variable, name of the local variable to use to extract the value.
    Parser SyntheticsGlobalVariableParseTestOptionsParser
    Type string
    Defines the source to use to extract the value. Valid values are http_body, http_header, http_status_code, local_variable.
    Field string
    Required when type = http_header. Defines the header to use to extract the value
    LocalVariableName string
    When type is local_variable, name of the local variable to use to extract the value.
    Parser SyntheticsGlobalVariableParseTestOptionsParser
    type String
    Defines the source to use to extract the value. Valid values are http_body, http_header, http_status_code, local_variable.
    field String
    Required when type = http_header. Defines the header to use to extract the value
    localVariableName String
    When type is local_variable, name of the local variable to use to extract the value.
    parser SyntheticsGlobalVariableParseTestOptionsParser
    type string
    Defines the source to use to extract the value. Valid values are http_body, http_header, http_status_code, local_variable.
    field string
    Required when type = http_header. Defines the header to use to extract the value
    localVariableName string
    When type is local_variable, name of the local variable to use to extract the value.
    parser SyntheticsGlobalVariableParseTestOptionsParser
    type str
    Defines the source to use to extract the value. Valid values are http_body, http_header, http_status_code, local_variable.
    field str
    Required when type = http_header. Defines the header to use to extract the value
    local_variable_name str
    When type is local_variable, name of the local variable to use to extract the value.
    parser SyntheticsGlobalVariableParseTestOptionsParser
    type String
    Defines the source to use to extract the value. Valid values are http_body, http_header, http_status_code, local_variable.
    field String
    Required when type = http_header. Defines the header to use to extract the value
    localVariableName String
    When type is local_variable, name of the local variable to use to extract the value.
    parser Property Map

    SyntheticsGlobalVariableParseTestOptionsParser, SyntheticsGlobalVariableParseTestOptionsParserArgs

    Type string
    Type of parser to extract the value. Valid values are raw, json_path, regex, x_path.
    Value string
    Value for the parser to use, required for type json_path or regex.
    Type string
    Type of parser to extract the value. Valid values are raw, json_path, regex, x_path.
    Value string
    Value for the parser to use, required for type json_path or regex.
    type String
    Type of parser to extract the value. Valid values are raw, json_path, regex, x_path.
    value String
    Value for the parser to use, required for type json_path or regex.
    type string
    Type of parser to extract the value. Valid values are raw, json_path, regex, x_path.
    value string
    Value for the parser to use, required for type json_path or regex.
    type str
    Type of parser to extract the value. Valid values are raw, json_path, regex, x_path.
    value str
    Value for the parser to use, required for type json_path or regex.
    type String
    Type of parser to extract the value. Valid values are raw, json_path, regex, x_path.
    value String
    Value for the parser to use, required for type json_path or regex.

    Import

    The pulumi import command can be used, for example:

    Synthetics global variables can be imported using their string ID, e.g.

    $ pulumi import datadog:index/syntheticsGlobalVariable:SyntheticsGlobalVariable fizz abcde123-fghi-456-jkl-mnopqrstuv

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

    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