1. Packages
  2. Datadog Provider
  3. API Docs
  4. aws
  5. Integration
Datadog v4.36.1 published on Friday, Nov 15, 2024 by Pulumi

datadog.aws.Integration

Explore with Pulumi AI

datadog logo
Datadog v4.36.1 published on Friday, Nov 15, 2024 by Pulumi

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

    Example Usage

    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",
        roleName: "DatadogAWSIntegrationRole",
        filterTags: ["key:value"],
        hostTags: [
            "key:value",
            "key2:value2",
        ],
        accountSpecificNamespaceRules: {
            auto_scaling: "false",
            opsworks: "false",
        },
        excludedRegions: [
            "us-east-1",
            "us-west-2",
        ],
    });
    
    import pulumi
    import pulumi_datadog as datadog
    
    # Create a new Datadog - Amazon Web Services integration
    sandbox = datadog.aws.Integration("sandbox",
        account_id="1234567890",
        role_name="DatadogAWSIntegrationRole",
        filter_tags=["key:value"],
        host_tags=[
            "key:value",
            "key2:value2",
        ],
        account_specific_namespace_rules={
            "auto_scaling": "false",
            "opsworks": "false",
        },
        excluded_regions=[
            "us-east-1",
            "us-west-2",
        ])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-datadog/sdk/v4/go/datadog/aws"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Create a new Datadog - Amazon Web Services integration
    		_, err := aws.NewIntegration(ctx, "sandbox", &aws.IntegrationArgs{
    			AccountId: pulumi.String("1234567890"),
    			RoleName:  pulumi.String("DatadogAWSIntegrationRole"),
    			FilterTags: pulumi.StringArray{
    				pulumi.String("key:value"),
    			},
    			HostTags: pulumi.StringArray{
    				pulumi.String("key:value"),
    				pulumi.String("key2:value2"),
    			},
    			AccountSpecificNamespaceRules: pulumi.StringMap{
    				"auto_scaling": pulumi.String("false"),
    				"opsworks":     pulumi.String("false"),
    			},
    			ExcludedRegions: pulumi.StringArray{
    				pulumi.String("us-east-1"),
    				pulumi.String("us-west-2"),
    			},
    		})
    		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 a new Datadog - Amazon Web Services integration
        var sandbox = new Datadog.Aws.Integration("sandbox", new()
        {
            AccountId = "1234567890",
            RoleName = "DatadogAWSIntegrationRole",
            FilterTags = new[]
            {
                "key:value",
            },
            HostTags = new[]
            {
                "key:value",
                "key2:value2",
            },
            AccountSpecificNamespaceRules = 
            {
                { "auto_scaling", "false" },
                { "opsworks", "false" },
            },
            ExcludedRegions = new[]
            {
                "us-east-1",
                "us-west-2",
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.datadog.aws.Integration;
    import com.pulumi.datadog.aws.IntegrationArgs;
    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 a new Datadog - Amazon Web Services integration
            var sandbox = new Integration("sandbox", IntegrationArgs.builder()
                .accountId("1234567890")
                .roleName("DatadogAWSIntegrationRole")
                .filterTags("key:value")
                .hostTags(            
                    "key:value",
                    "key2:value2")
                .accountSpecificNamespaceRules(Map.ofEntries(
                    Map.entry("auto_scaling", false),
                    Map.entry("opsworks", false)
                ))
                .excludedRegions(            
                    "us-east-1",
                    "us-west-2")
                .build());
    
        }
    }
    
    resources:
      # Create a new Datadog - Amazon Web Services integration
      sandbox:
        type: datadog:aws:Integration
        properties:
          accountId: '1234567890'
          roleName: DatadogAWSIntegrationRole
          filterTags:
            - key:value
          hostTags:
            - key:value
            - key2:value2
          accountSpecificNamespaceRules:
            auto_scaling: false
            opsworks: false
          excludedRegions:
            - us-east-1
            - us-west-2
    

    Create Integration Resource

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

    Constructor syntax

    new Integration(name: string, args?: IntegrationArgs, opts?: CustomResourceOptions);
    @overload
    def Integration(resource_name: str,
                    args: Optional[IntegrationArgs] = None,
                    opts: Optional[ResourceOptions] = None)
    
    @overload
    def Integration(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    access_key_id: Optional[str] = None,
                    account_id: Optional[str] = None,
                    account_specific_namespace_rules: Optional[Mapping[str, str]] = None,
                    cspm_resource_collection_enabled: Optional[str] = None,
                    excluded_regions: Optional[Sequence[str]] = None,
                    extended_resource_collection_enabled: Optional[str] = None,
                    filter_tags: Optional[Sequence[str]] = None,
                    host_tags: Optional[Sequence[str]] = None,
                    metrics_collection_enabled: Optional[str] = None,
                    resource_collection_enabled: Optional[str] = None,
                    role_name: Optional[str] = None,
                    secret_access_key: Optional[str] = None)
    func NewIntegration(ctx *Context, name string, args *IntegrationArgs, opts ...ResourceOption) (*Integration, error)
    public Integration(string name, IntegrationArgs? args = null, CustomResourceOptions? opts = null)
    public Integration(String name, IntegrationArgs args)
    public Integration(String name, IntegrationArgs args, CustomResourceOptions options)
    
    type: datadog:aws:Integration
    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 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.
    args IntegrationArgs
    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 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.
    name String
    The unique name of the resource.
    args IntegrationArgs
    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 integrationResource = new Datadog.Aws.Integration("integrationResource", new()
    {
        AccessKeyId = "string",
        AccountId = "string",
        AccountSpecificNamespaceRules = 
        {
            { "string", "string" },
        },
        CspmResourceCollectionEnabled = "string",
        ExcludedRegions = new[]
        {
            "string",
        },
        ExtendedResourceCollectionEnabled = "string",
        FilterTags = new[]
        {
            "string",
        },
        HostTags = new[]
        {
            "string",
        },
        MetricsCollectionEnabled = "string",
        RoleName = "string",
        SecretAccessKey = "string",
    });
    
    example, err := aws.NewIntegration(ctx, "integrationResource", &aws.IntegrationArgs{
    	AccessKeyId: pulumi.String("string"),
    	AccountId:   pulumi.String("string"),
    	AccountSpecificNamespaceRules: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	CspmResourceCollectionEnabled: pulumi.String("string"),
    	ExcludedRegions: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	ExtendedResourceCollectionEnabled: pulumi.String("string"),
    	FilterTags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	HostTags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	MetricsCollectionEnabled: pulumi.String("string"),
    	RoleName:                 pulumi.String("string"),
    	SecretAccessKey:          pulumi.String("string"),
    })
    
    var integrationResource = new Integration("integrationResource", IntegrationArgs.builder()
        .accessKeyId("string")
        .accountId("string")
        .accountSpecificNamespaceRules(Map.of("string", "string"))
        .cspmResourceCollectionEnabled("string")
        .excludedRegions("string")
        .extendedResourceCollectionEnabled("string")
        .filterTags("string")
        .hostTags("string")
        .metricsCollectionEnabled("string")
        .roleName("string")
        .secretAccessKey("string")
        .build());
    
    integration_resource = datadog.aws.Integration("integrationResource",
        access_key_id="string",
        account_id="string",
        account_specific_namespace_rules={
            "string": "string",
        },
        cspm_resource_collection_enabled="string",
        excluded_regions=["string"],
        extended_resource_collection_enabled="string",
        filter_tags=["string"],
        host_tags=["string"],
        metrics_collection_enabled="string",
        role_name="string",
        secret_access_key="string")
    
    const integrationResource = new datadog.aws.Integration("integrationResource", {
        accessKeyId: "string",
        accountId: "string",
        accountSpecificNamespaceRules: {
            string: "string",
        },
        cspmResourceCollectionEnabled: "string",
        excludedRegions: ["string"],
        extendedResourceCollectionEnabled: "string",
        filterTags: ["string"],
        hostTags: ["string"],
        metricsCollectionEnabled: "string",
        roleName: "string",
        secretAccessKey: "string",
    });
    
    type: datadog:aws:Integration
    properties:
        accessKeyId: string
        accountId: string
        accountSpecificNamespaceRules:
            string: string
        cspmResourceCollectionEnabled: string
        excludedRegions:
            - string
        extendedResourceCollectionEnabled: string
        filterTags:
            - string
        hostTags:
            - string
        metricsCollectionEnabled: string
        roleName: string
        secretAccessKey: string
    

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

    AccessKeyId string
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    AccountId string
    Your AWS Account ID without dashes.
    AccountSpecificNamespaceRules Dictionary<string, string>
    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.
    CspmResourceCollectionEnabled string
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    ExcludedRegions List<string>
    An array of AWS regions to exclude from metrics collection.
    ExtendedResourceCollectionEnabled string
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    FilterTags List<string>
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    HostTags List<string>
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    MetricsCollectionEnabled string
    Whether Datadog collects metrics for this AWS account.
    ResourceCollectionEnabled string
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    RoleName string
    Your Datadog role delegation name.
    SecretAccessKey string
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.
    AccessKeyId string
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    AccountId string
    Your AWS Account ID without dashes.
    AccountSpecificNamespaceRules map[string]string
    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.
    CspmResourceCollectionEnabled string
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    ExcludedRegions []string
    An array of AWS regions to exclude from metrics collection.
    ExtendedResourceCollectionEnabled string
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    FilterTags []string
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    HostTags []string
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    MetricsCollectionEnabled string
    Whether Datadog collects metrics for this AWS account.
    ResourceCollectionEnabled string
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    RoleName string
    Your Datadog role delegation name.
    SecretAccessKey string
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.
    accessKeyId String
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    accountId String
    Your AWS Account ID without dashes.
    accountSpecificNamespaceRules Map<String,String>
    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.
    cspmResourceCollectionEnabled String
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    excludedRegions List<String>
    An array of AWS regions to exclude from metrics collection.
    extendedResourceCollectionEnabled String
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    filterTags List<String>
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    hostTags List<String>
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    metricsCollectionEnabled String
    Whether Datadog collects metrics for this AWS account.
    resourceCollectionEnabled String
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    roleName String
    Your Datadog role delegation name.
    secretAccessKey String
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.
    accessKeyId string
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    accountId string
    Your AWS Account ID without dashes.
    accountSpecificNamespaceRules {[key: string]: string}
    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.
    cspmResourceCollectionEnabled string
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    excludedRegions string[]
    An array of AWS regions to exclude from metrics collection.
    extendedResourceCollectionEnabled string
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    filterTags string[]
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    hostTags string[]
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    metricsCollectionEnabled string
    Whether Datadog collects metrics for this AWS account.
    resourceCollectionEnabled string
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    roleName string
    Your Datadog role delegation name.
    secretAccessKey string
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.
    access_key_id str
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    account_id str
    Your AWS Account ID without dashes.
    account_specific_namespace_rules Mapping[str, str]
    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.
    cspm_resource_collection_enabled str
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    excluded_regions Sequence[str]
    An array of AWS regions to exclude from metrics collection.
    extended_resource_collection_enabled str
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    filter_tags Sequence[str]
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    host_tags Sequence[str]
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    metrics_collection_enabled str
    Whether Datadog collects metrics for this AWS account.
    resource_collection_enabled str
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    role_name str
    Your Datadog role delegation name.
    secret_access_key str
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.
    accessKeyId String
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    accountId String
    Your AWS Account ID without dashes.
    accountSpecificNamespaceRules Map<String>
    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.
    cspmResourceCollectionEnabled String
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    excludedRegions List<String>
    An array of AWS regions to exclude from metrics collection.
    extendedResourceCollectionEnabled String
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    filterTags List<String>
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    hostTags List<String>
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    metricsCollectionEnabled String
    Whether Datadog collects metrics for this AWS account.
    resourceCollectionEnabled String
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    roleName String
    Your Datadog role delegation name.
    secretAccessKey String
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.

    Outputs

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

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

    Look up 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
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            access_key_id: Optional[str] = None,
            account_id: Optional[str] = None,
            account_specific_namespace_rules: Optional[Mapping[str, str]] = None,
            cspm_resource_collection_enabled: Optional[str] = None,
            excluded_regions: Optional[Sequence[str]] = None,
            extended_resource_collection_enabled: Optional[str] = None,
            external_id: Optional[str] = None,
            filter_tags: Optional[Sequence[str]] = None,
            host_tags: Optional[Sequence[str]] = None,
            metrics_collection_enabled: Optional[str] = None,
            resource_collection_enabled: Optional[str] = None,
            role_name: Optional[str] = None,
            secret_access_key: Optional[str] = None) -> Integration
    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)
    public static Integration get(String name, Output<String> id, IntegrationState 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:
    AccessKeyId string
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    AccountId string
    Your AWS Account ID without dashes.
    AccountSpecificNamespaceRules Dictionary<string, string>
    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.
    CspmResourceCollectionEnabled string
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    ExcludedRegions List<string>
    An array of AWS regions to exclude from metrics collection.
    ExtendedResourceCollectionEnabled string
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    ExternalId string
    FilterTags List<string>
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    HostTags List<string>
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    MetricsCollectionEnabled string
    Whether Datadog collects metrics for this AWS account.
    ResourceCollectionEnabled string
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    RoleName string
    Your Datadog role delegation name.
    SecretAccessKey string
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.
    AccessKeyId string
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    AccountId string
    Your AWS Account ID without dashes.
    AccountSpecificNamespaceRules map[string]string
    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.
    CspmResourceCollectionEnabled string
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    ExcludedRegions []string
    An array of AWS regions to exclude from metrics collection.
    ExtendedResourceCollectionEnabled string
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    ExternalId string
    FilterTags []string
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    HostTags []string
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    MetricsCollectionEnabled string
    Whether Datadog collects metrics for this AWS account.
    ResourceCollectionEnabled string
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    RoleName string
    Your Datadog role delegation name.
    SecretAccessKey string
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.
    accessKeyId String
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    accountId String
    Your AWS Account ID without dashes.
    accountSpecificNamespaceRules Map<String,String>
    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.
    cspmResourceCollectionEnabled String
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    excludedRegions List<String>
    An array of AWS regions to exclude from metrics collection.
    extendedResourceCollectionEnabled String
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    externalId String
    filterTags List<String>
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    hostTags List<String>
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    metricsCollectionEnabled String
    Whether Datadog collects metrics for this AWS account.
    resourceCollectionEnabled String
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    roleName String
    Your Datadog role delegation name.
    secretAccessKey String
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.
    accessKeyId string
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    accountId string
    Your AWS Account ID without dashes.
    accountSpecificNamespaceRules {[key: string]: string}
    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.
    cspmResourceCollectionEnabled string
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    excludedRegions string[]
    An array of AWS regions to exclude from metrics collection.
    extendedResourceCollectionEnabled string
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    externalId string
    filterTags string[]
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    hostTags string[]
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    metricsCollectionEnabled string
    Whether Datadog collects metrics for this AWS account.
    resourceCollectionEnabled string
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    roleName string
    Your Datadog role delegation name.
    secretAccessKey string
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.
    access_key_id str
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    account_id str
    Your AWS Account ID without dashes.
    account_specific_namespace_rules Mapping[str, str]
    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.
    cspm_resource_collection_enabled str
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    excluded_regions Sequence[str]
    An array of AWS regions to exclude from metrics collection.
    extended_resource_collection_enabled str
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    external_id str
    filter_tags Sequence[str]
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    host_tags Sequence[str]
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    metrics_collection_enabled str
    Whether Datadog collects metrics for this AWS account.
    resource_collection_enabled str
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    role_name str
    Your Datadog role delegation name.
    secret_access_key str
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.
    accessKeyId String
    Your AWS access key ID. Only required if your AWS account is a GovCloud or China account.
    accountId String
    Your AWS Account ID without dashes.
    accountSpecificNamespaceRules Map<String>
    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.
    cspmResourceCollectionEnabled String
    Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general resource_collection.
    excludedRegions List<String>
    An array of AWS regions to exclude from metrics collection.
    extendedResourceCollectionEnabled String
    Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for cspm_resource_collection_enabled.
    externalId String
    filterTags List<String>
    Array of EC2 tags (in the form key:value) defines a filter that Datadog uses when collecting metrics from EC2. Wildcards, such as ? (for single characters) and * (for multiple characters) can also be used. Only hosts that match one of the defined tags will be imported into Datadog. The rest will be ignored. Host matching a given tag can also be excluded by adding ! before the tag. e.x. env:production,instance-type:c1.*,!region:us-east-1.
    hostTags List<String>
    Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration.
    metricsCollectionEnabled String
    Whether Datadog collects metrics for this AWS account.
    resourceCollectionEnabled String
    Whether Datadog collects a standard set of resources from your AWS account. Deprecated. Deprecated in favor of extended_resource_collection_enabled.

    Deprecated: Deprecated in favor of extended_resource_collection_enabled.

    roleName String
    Your Datadog role delegation name.
    secretAccessKey String
    Your AWS secret access key. Only required if your AWS account is a GovCloud or China account.

    Import

    Amazon Web Services integrations can be imported using their account ID and role name separated with a colon (:), while the external_id should be passed by setting an environment variable called EXTERNAL_ID

    $ pulumi import datadog:aws/integration:Integration EXTERNAL_ID=${external_id} datadog_integration_aws.test ${account_id}:${role_name}
    

    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.36.1 published on Friday, Nov 15, 2024 by Pulumi