datadog.AwsCurConfig
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:
- Account
Id string - The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
- Bucket
Name 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.
- Report
Name 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.
- Report
Prefix 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 AwsCur Config Account Filters - Bucket
Region 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 string - The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
- Bucket
Name 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.
- Report
Name 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.
- Report
Prefix 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 AwsCur Config Account Filters Args - Bucket
Region 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 String - The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
- bucket
Name 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.
- report
Name 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.
- report
Prefix 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 AwsCur Config Account Filters - bucket
Region 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 string - The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
- bucket
Name 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.
- report
Name 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.
- report
Prefix 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 AwsCur Config Account Filters - bucket
Region 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 AwsCur Config Account Filters Args - 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).
- account
Id String - The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
- bucket
Name 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.
- report
Name 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.
- report
Prefix 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 Property Map - bucket
Region 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.
- Account
Filters AwsCur Config Account Filters - Account
Id string - The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
- Bucket
Name 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.
- Bucket
Region string - 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 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.
- Report
Prefix 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 AwsCur Config Account Filters Args - Account
Id string - The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
- Bucket
Name 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.
- Bucket
Region string - 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 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.
- Report
Prefix 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 AwsCur Config Account Filters - account
Id String - The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
- bucket
Name 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.
- bucket
Region String - 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 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.
- report
Prefix 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 AwsCur Config Account Filters - account
Id string - The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
- bucket
Name 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.
- bucket
Region string - 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 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.
- report
Prefix 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 AwsCur Config Account Filters Args - 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/').
- account
Filters Property Map - account
Id String - The AWS account ID of your billing/payer account. For AWS Organizations, this is typically the management account ID.
- bucket
Name 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.
- bucket
Region String - 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 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.
- report
Prefix 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
- Excluded
Accounts List<string> - List of AWS account IDs to exclude from cost analysis. Only used when
include_new_accounts
istrue
. Cannot be used together withincluded_accounts
. - Include
New boolAccounts - Whether to automatically include new member accounts in your cost analysis. When
true
, useexcluded_accounts
to specify accounts to exclude. Whenfalse
, useincluded_accounts
to specify only the accounts to include. - Included
Accounts List<string> - List of AWS account IDs to include in cost analysis. Only used when
include_new_accounts
isfalse
. Cannot be used together withexcluded_accounts
.
- Excluded
Accounts []string - List of AWS account IDs to exclude from cost analysis. Only used when
include_new_accounts
istrue
. Cannot be used together withincluded_accounts
. - Include
New boolAccounts - Whether to automatically include new member accounts in your cost analysis. When
true
, useexcluded_accounts
to specify accounts to exclude. Whenfalse
, useincluded_accounts
to specify only the accounts to include. - Included
Accounts []string - List of AWS account IDs to include in cost analysis. Only used when
include_new_accounts
isfalse
. Cannot be used together withexcluded_accounts
.
- excluded
Accounts List<String> - List of AWS account IDs to exclude from cost analysis. Only used when
include_new_accounts
istrue
. Cannot be used together withincluded_accounts
. - include
New BooleanAccounts - Whether to automatically include new member accounts in your cost analysis. When
true
, useexcluded_accounts
to specify accounts to exclude. Whenfalse
, useincluded_accounts
to specify only the accounts to include. - included
Accounts List<String> - List of AWS account IDs to include in cost analysis. Only used when
include_new_accounts
isfalse
. Cannot be used together withexcluded_accounts
.
- excluded
Accounts string[] - List of AWS account IDs to exclude from cost analysis. Only used when
include_new_accounts
istrue
. Cannot be used together withincluded_accounts
. - include
New booleanAccounts - Whether to automatically include new member accounts in your cost analysis. When
true
, useexcluded_accounts
to specify accounts to exclude. Whenfalse
, useincluded_accounts
to specify only the accounts to include. - included
Accounts string[] - List of AWS account IDs to include in cost analysis. Only used when
include_new_accounts
isfalse
. Cannot be used together withexcluded_accounts
.
- excluded_
accounts Sequence[str] - List of AWS account IDs to exclude from cost analysis. Only used when
include_new_accounts
istrue
. Cannot be used together withincluded_accounts
. - include_
new_ boolaccounts - Whether to automatically include new member accounts in your cost analysis. When
true
, useexcluded_accounts
to specify accounts to exclude. Whenfalse
, useincluded_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
isfalse
. Cannot be used together withexcluded_accounts
.
- excluded
Accounts List<String> - List of AWS account IDs to exclude from cost analysis. Only used when
include_new_accounts
istrue
. Cannot be used together withincluded_accounts
. - include
New BooleanAccounts - Whether to automatically include new member accounts in your cost analysis. When
true
, useexcluded_accounts
to specify accounts to exclude. Whenfalse
, useincluded_accounts
to specify only the accounts to include. - included
Accounts List<String> - List of AWS account IDs to include in cost analysis. Only used when
include_new_accounts
isfalse
. Cannot be used together withexcluded_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.