1. Docs
  2. Reference
  3. API
  4. Datadog
  5. aws
  6. Integration

Integration

Provides a Datadog - Amazon Web Services integration resource. This can be used to create and manage Datadog - Amazon Web Services integration.

Update operations are currently not supported with datadog API so any change forces a new resource.

Example Usage

using Pulumi;
using Datadog = Pulumi.Datadog;

class MyStack : Stack
{
    public MyStack()
    {
        // Create a new Datadog - Amazon Web Services integration
        var sandbox = new Datadog.Aws.Integration("sandbox", new Datadog.Aws.IntegrationArgs
        {
            AccountId = "1234567890",
            AccountSpecificNamespaceRules = 
            {
                { "auto_scaling", false },
                { "opsworks", false },
            },
            FilterTags = 
            {
                "key:value",
            },
            HostTags = 
            {
                "key:value",
                "key2:value2",
            },
            RoleName = "DatadogAWSIntegrationRole",
        });
    }

}

Coming soon!

import pulumi
import pulumi_datadog as datadog

# Create a new Datadog - Amazon Web Services integration
sandbox = datadog.aws.Integration("sandbox",
    account_id="1234567890",
    account_specific_namespace_rules={
        "auto_scaling": False,
        "opsworks": False,
    },
    filter_tags=["key:value"],
    host_tags=[
        "key:value",
        "key2:value2",
    ],
    role_name="DatadogAWSIntegrationRole")
import * as pulumi from "@pulumi/pulumi";
import * as datadog from "@pulumi/datadog";

// Create a new Datadog - Amazon Web Services integration
const sandbox = new datadog.aws.Integration("sandbox", {
    accountId: "1234567890",
    accountSpecificNamespaceRules: {
        auto_scaling: false,
        opsworks: false,
    },
    filterTags: ["key:value"],
    hostTags: [
        "key:value",
        "key2:value2",
    ],
    roleName: "DatadogAWSIntegrationRole",
});

Create a Integration Resource

new Integration(name: string, args: IntegrationArgs, opts?: CustomResourceOptions);
def Integration(resource_name, opts=None, account_id=None, account_specific_namespace_rules=None, filter_tags=None, host_tags=None, role_name=None, __props__=None);
func NewIntegration(ctx *Context, name string, args IntegrationArgs, opts ...ResourceOption) (*Integration, error)
public Integration(string name, IntegrationArgs args, CustomResourceOptions? opts = null)
name string
The unique name of the resource.
args IntegrationArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
opts ResourceOptions
A bag of options that control this resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args IntegrationArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args IntegrationArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.

Integration Resource Properties

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

Inputs

The Integration resource accepts the following input properties:

AccountId string

Your AWS Account ID without dashes.

RoleName string

Your Datadog role delegation name.

AccountSpecificNamespaceRules Dictionary<string, object>

Enables or disables metric collection for specific AWS namespaces for this AWS account only. A list of namespaces can be found at the available namespace rules API endpoint.

FilterTags List<string>

Array of EC2 tags (in the form key:value) defines a filter that Datadog use when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used.

HostTags List<string>

Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.

AccountId string

Your AWS Account ID without dashes.

RoleName string

Your Datadog role delegation name.

AccountSpecificNamespaceRules map[string]interface{}

Enables or disables metric collection for specific AWS namespaces for this AWS account only. A list of namespaces can be found at the available namespace rules API endpoint.

FilterTags []string

Array of EC2 tags (in the form key:value) defines a filter that Datadog use when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used.

HostTags []string

Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.

accountId string

Your AWS Account ID without dashes.

roleName string

Your Datadog role delegation name.

accountSpecificNamespaceRules {[key: string]: any}

Enables or disables metric collection for specific AWS namespaces for this AWS account only. A list of namespaces can be found at the available namespace rules API endpoint.

filterTags string[]

Array of EC2 tags (in the form key:value) defines a filter that Datadog use when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used.

hostTags string[]

Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.

account_id str

Your AWS Account ID without dashes.

role_name str

Your Datadog role delegation name.

account_specific_namespace_rules Dict[str, Any]

Enables or disables metric collection for specific AWS namespaces for this AWS account only. A list of namespaces can be found at the available namespace rules API endpoint.

filter_tags List[str]

Array of EC2 tags (in the form key:value) defines a filter that Datadog use when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used.

host_tags List[str]

Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.

Outputs

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

ExternalId string

AWS External ID

Id string
The provider-assigned unique ID for this managed resource.
ExternalId string

AWS External ID

Id string
The provider-assigned unique ID for this managed resource.
externalId string

AWS External ID

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

AWS External ID

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

Look up an Existing Integration Resource

Get an existing Integration 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?: IntegrationState, opts?: CustomResourceOptions): Integration
static get(resource_name, id, opts=None, account_id=None, account_specific_namespace_rules=None, external_id=None, filter_tags=None, host_tags=None, role_name=None, __props__=None);
func GetIntegration(ctx *Context, name string, id IDInput, state *IntegrationState, opts ...ResourceOption) (*Integration, error)
public static Integration Get(string name, Input<string> id, IntegrationState? state, CustomResourceOptions? opts = null)
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.

The following state arguments are supported:

AccountId string

Your AWS Account ID without dashes.

AccountSpecificNamespaceRules Dictionary<string, object>

Enables or disables metric collection for specific AWS namespaces for this AWS account only. A list of namespaces can be found at the available namespace rules API endpoint.

ExternalId string

AWS External ID

FilterTags List<string>

Array of EC2 tags (in the form key:value) defines a filter that Datadog use when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used.

HostTags List<string>

Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.

RoleName string

Your Datadog role delegation name.

AccountId string

Your AWS Account ID without dashes.

AccountSpecificNamespaceRules map[string]interface{}

Enables or disables metric collection for specific AWS namespaces for this AWS account only. A list of namespaces can be found at the available namespace rules API endpoint.

ExternalId string

AWS External ID

FilterTags []string

Array of EC2 tags (in the form key:value) defines a filter that Datadog use when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used.

HostTags []string

Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.

RoleName string

Your Datadog role delegation name.

accountId string

Your AWS Account ID without dashes.

accountSpecificNamespaceRules {[key: string]: any}

Enables or disables metric collection for specific AWS namespaces for this AWS account only. A list of namespaces can be found at the available namespace rules API endpoint.

externalId string

AWS External ID

filterTags string[]

Array of EC2 tags (in the form key:value) defines a filter that Datadog use when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used.

hostTags string[]

Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.

roleName string

Your Datadog role delegation name.

account_id str

Your AWS Account ID without dashes.

account_specific_namespace_rules Dict[str, Any]

Enables or disables metric collection for specific AWS namespaces for this AWS account only. A list of namespaces can be found at the available namespace rules API endpoint.

external_id str

AWS External ID

filter_tags List[str]

Array of EC2 tags (in the form key:value) defines a filter that Datadog use when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used.

host_tags List[str]

Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.

role_name str

Your Datadog role delegation name.

Package Details

Repository
https://github.com/pulumi/pulumi-datadog
License
Apache-2.0
Notes
This Pulumi package is based on the datadog Terraform Provider.