1. Packages
  2. Datadog Provider
  3. API Docs
  4. AwsCurConfig
Datadog v4.57.0 published on Thursday, Oct 2, 2025 by Pulumi

datadog.AwsCurConfig

Deploy with Pulumi
datadog logo
Datadog v4.57.0 published on Thursday, Oct 2, 2025 by Pulumi

    Provides a Datadog AWS CUR (Cost and Usage Report) configuration resource. This enables Datadog Cloud Cost Management to access your AWS billing data by configuring the connection to your AWS Cost and Usage Report. Prerequisites: An active Datadog AWS integration, existing AWS Cost and Usage Report, and proper S3 bucket permissions.

    Example Usage

    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    resources:
      # Create new aws_cur_config resource
      foo:
        type: datadog:AwsCurConfig
        properties:
          accountId: '123456789123'
          bucketName: dd-cost-bucket
          bucketRegion: us-east-1
          reportName: dd-report-name
          reportPrefix: dd-report-prefix
          accountFilters:
            - includeNewAccounts: true
              excludedAccounts:
                - '123456789123'
                - '123456789143'
    

    Create AwsCurConfig Resource

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

    Constructor syntax

    new AwsCurConfig(name: string, args: AwsCurConfigArgs, opts?: CustomResourceOptions);
    @overload
    def AwsCurConfig(resource_name: str,
                     args: AwsCurConfigArgs,
                     opts: Optional[ResourceOptions] = None)
    
    @overload
    def AwsCurConfig(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     account_id: Optional[str] = None,
                     bucket_name: Optional[str] = None,
                     report_name: Optional[str] = None,
                     report_prefix: Optional[str] = None,
                     account_filters: Optional[AwsCurConfigAccountFiltersArgs] = None,
                     bucket_region: Optional[str] = None)
    func NewAwsCurConfig(ctx *Context, name string, args AwsCurConfigArgs, opts ...ResourceOption) (*AwsCurConfig, error)
    public AwsCurConfig(string name, AwsCurConfigArgs args, CustomResourceOptions? opts = null)
    public AwsCurConfig(String name, AwsCurConfigArgs args)
    public AwsCurConfig(String name, AwsCurConfigArgs args, CustomResourceOptions options)
    
    type: datadog:AwsCurConfig
    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 AwsCurConfigArgs
    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 AwsCurConfigArgs
    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 AwsCurConfigArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args AwsCurConfigArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args AwsCurConfigArgs
    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 awsCurConfigResource = new Datadog.AwsCurConfig("awsCurConfigResource", new()
    {
        AccountId = "string",
        BucketName = "string",
        ReportName = "string",
        ReportPrefix = "string",
        AccountFilters = new Datadog.Inputs.AwsCurConfigAccountFiltersArgs
        {
            ExcludedAccounts = new[]
            {
                "string",
            },
            IncludeNewAccounts = false,
            IncludedAccounts = new[]
            {
                "string",
            },
        },
        BucketRegion = "string",
    });
    
    example, err := datadog.NewAwsCurConfig(ctx, "awsCurConfigResource", &datadog.AwsCurConfigArgs{
    	AccountId:    pulumi.String("string"),
    	BucketName:   pulumi.String("string"),
    	ReportName:   pulumi.String("string"),
    	ReportPrefix: pulumi.String("string"),
    	AccountFilters: &datadog.AwsCurConfigAccountFiltersArgs{
    		ExcludedAccounts: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		IncludeNewAccounts: pulumi.Bool(false),
    		IncludedAccounts: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    	},
    	BucketRegion: pulumi.String("string"),
    })
    
    var awsCurConfigResource = new AwsCurConfig("awsCurConfigResource", AwsCurConfigArgs.builder()
        .accountId("string")
        .bucketName("string")
        .reportName("string")
        .reportPrefix("string")
        .accountFilters(AwsCurConfigAccountFiltersArgs.builder()
            .excludedAccounts("string")
            .includeNewAccounts(false)
            .includedAccounts("string")
            .build())
        .bucketRegion("string")
        .build());
    
    aws_cur_config_resource = datadog.AwsCurConfig("awsCurConfigResource",
        account_id="string",
        bucket_name="string",
        report_name="string",
        report_prefix="string",
        account_filters={
            "excluded_accounts": ["string"],
            "include_new_accounts": False,
            "included_accounts": ["string"],
        },
        bucket_region="string")
    
    const awsCurConfigResource = new datadog.AwsCurConfig("awsCurConfigResource", {
        accountId: "string",
        bucketName: "string",
        reportName: "string",
        reportPrefix: "string",
        accountFilters: {
            excludedAccounts: ["string"],
            includeNewAccounts: false,
            includedAccounts: ["string"],
        },
        bucketRegion: "string",
    });
    
    type: datadog:AwsCurConfig
    properties:
        accountFilters:
            excludedAccounts:
                - string
            includeNewAccounts: false
            includedAccounts:
                - string
        accountId: string
        bucketName: string
        bucketRegion: string
        reportName: string
        reportPrefix: string
    

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

    AccountId string
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    BucketName string
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    ReportName string
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    ReportPrefix string
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').
    AccountFilters AwsCurConfigAccountFilters
    BucketRegion string
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).
    AccountId string
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    BucketName string
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    ReportName string
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    ReportPrefix string
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').
    AccountFilters AwsCurConfigAccountFiltersArgs
    BucketRegion string
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).
    accountId String
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    bucketName String
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    reportName String
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    reportPrefix String
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').
    accountFilters AwsCurConfigAccountFilters
    bucketRegion String
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).
    accountId string
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    bucketName string
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    reportName string
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    reportPrefix string
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').
    accountFilters AwsCurConfigAccountFilters
    bucketRegion string
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).
    account_id str
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    bucket_name str
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    report_name str
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    report_prefix str
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').
    account_filters AwsCurConfigAccountFiltersArgs
    bucket_region str
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).
    accountId String
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    bucketName String
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    reportName String
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    reportPrefix String
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').
    accountFilters Property Map
    bucketRegion String
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).

    Outputs

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

    Get an existing AwsCurConfig 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?: AwsCurConfigState, opts?: CustomResourceOptions): AwsCurConfig
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            account_filters: Optional[AwsCurConfigAccountFiltersArgs] = None,
            account_id: Optional[str] = None,
            bucket_name: Optional[str] = None,
            bucket_region: Optional[str] = None,
            report_name: Optional[str] = None,
            report_prefix: Optional[str] = None) -> AwsCurConfig
    func GetAwsCurConfig(ctx *Context, name string, id IDInput, state *AwsCurConfigState, opts ...ResourceOption) (*AwsCurConfig, error)
    public static AwsCurConfig Get(string name, Input<string> id, AwsCurConfigState? state, CustomResourceOptions? opts = null)
    public static AwsCurConfig get(String name, Output<String> id, AwsCurConfigState state, CustomResourceOptions options)
    resources:  _:    type: datadog:AwsCurConfig    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:
    AccountFilters AwsCurConfigAccountFilters
    AccountId string
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    BucketName string
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    BucketRegion string
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).
    ReportName string
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    ReportPrefix string
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').
    AccountFilters AwsCurConfigAccountFiltersArgs
    AccountId string
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    BucketName string
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    BucketRegion string
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).
    ReportName string
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    ReportPrefix string
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').
    accountFilters AwsCurConfigAccountFilters
    accountId String
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    bucketName String
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    bucketRegion String
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).
    reportName String
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    reportPrefix String
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').
    accountFilters AwsCurConfigAccountFilters
    accountId string
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    bucketName string
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    bucketRegion string
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).
    reportName string
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    reportPrefix string
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').
    account_filters AwsCurConfigAccountFiltersArgs
    account_id str
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    bucket_name str
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    bucket_region str
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).
    report_name str
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    report_prefix str
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').
    accountFilters Property Map
    accountId String
    The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
    bucketName String
    The S3 bucket name where your AWS Cost and Usage Report files are stored. This bucket must have appropriate IAM permissions for Datadog access and should be in the same AWS account as the CUR report.
    bucketRegion String
    The AWS region where the S3 bucket containing your Cost and Usage Report is located (e.g., us-east-1, eu-west-1).
    reportName String
    The exact name of your AWS Cost and Usage Report as configured in AWS Billing preferences. This must match the report name exactly as it appears in your AWS billing settings.
    reportPrefix String
    The S3 key prefix where your Cost and Usage Report files are stored within the bucket (e.g., 'cur-reports/', 'billing/cur/').

    Supporting Types

    AwsCurConfigAccountFilters, AwsCurConfigAccountFiltersArgs

    ExcludedAccounts List<string>
    List of AWS account IDs to exclude from cost analysis. Only used when include_new_accounts is true. Cannot be used together with included_accounts.
    IncludeNewAccounts bool
    Whether to automatically include new member accounts in your cost analysis. When true, use excluded_accounts to specify accounts to exclude. When false, use included_accounts to specify only the accounts to include.
    IncludedAccounts List<string>
    List of AWS account IDs to include in cost analysis. Only used when include_new_accounts is false. Cannot be used together with excluded_accounts.
    ExcludedAccounts []string
    List of AWS account IDs to exclude from cost analysis. Only used when include_new_accounts is true. Cannot be used together with included_accounts.
    IncludeNewAccounts bool
    Whether to automatically include new member accounts in your cost analysis. When true, use excluded_accounts to specify accounts to exclude. When false, use included_accounts to specify only the accounts to include.
    IncludedAccounts []string
    List of AWS account IDs to include in cost analysis. Only used when include_new_accounts is false. Cannot be used together with excluded_accounts.
    excludedAccounts List<String>
    List of AWS account IDs to exclude from cost analysis. Only used when include_new_accounts is true. Cannot be used together with included_accounts.
    includeNewAccounts Boolean
    Whether to automatically include new member accounts in your cost analysis. When true, use excluded_accounts to specify accounts to exclude. When false, use included_accounts to specify only the accounts to include.
    includedAccounts List<String>
    List of AWS account IDs to include in cost analysis. Only used when include_new_accounts is false. Cannot be used together with excluded_accounts.
    excludedAccounts string[]
    List of AWS account IDs to exclude from cost analysis. Only used when include_new_accounts is true. Cannot be used together with included_accounts.
    includeNewAccounts boolean
    Whether to automatically include new member accounts in your cost analysis. When true, use excluded_accounts to specify accounts to exclude. When false, use included_accounts to specify only the accounts to include.
    includedAccounts string[]
    List of AWS account IDs to include in cost analysis. Only used when include_new_accounts is false. Cannot be used together with excluded_accounts.
    excluded_accounts Sequence[str]
    List of AWS account IDs to exclude from cost analysis. Only used when include_new_accounts is true. Cannot be used together with included_accounts.
    include_new_accounts bool
    Whether to automatically include new member accounts in your cost analysis. When true, use excluded_accounts to specify accounts to exclude. When false, use included_accounts to specify only the accounts to include.
    included_accounts Sequence[str]
    List of AWS account IDs to include in cost analysis. Only used when include_new_accounts is false. Cannot be used together with excluded_accounts.
    excludedAccounts List<String>
    List of AWS account IDs to exclude from cost analysis. Only used when include_new_accounts is true. Cannot be used together with included_accounts.
    includeNewAccounts Boolean
    Whether to automatically include new member accounts in your cost analysis. When true, use excluded_accounts to specify accounts to exclude. When false, use included_accounts to specify only the accounts to include.
    includedAccounts List<String>
    List of AWS account IDs to include in cost analysis. Only used when include_new_accounts is false. Cannot be used together with excluded_accounts.

    Import

    The pulumi import command can be used, for example:

    $ pulumi import datadog:index/awsCurConfig:AwsCurConfig aws_cur_report <cloud_account_id>
    

    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.57.0 published on Thursday, Oct 2, 2025 by Pulumi
      Meet Neo: Your AI Platform Teammate