diff --git a/config/_default/menus/api.en.yaml b/config/_default/menus/api.en.yaml index 9256bb8adb1..3a216080b51 100644 --- a/config/_default/menus/api.en.yaml +++ b/config/_default/menus/api.en.yaml @@ -83,32 +83,6 @@ menu: - ListAWSNamespaces unstable: [] order: 1 - - name: Preview AWS metric name filter - url: /api/latest/aws-integration/preview-aws-metric-name-filter/ - identifier: aws-integration-preview-aws-metric-name-filter - parent: aws-integration - generated: true - params: - versions: - - v2 - operationids: - - PreviewAWSMetricNameFilter - unstable: - - v2 - order: 20 - - name: Get AWS metric name filter preview - url: /api/latest/aws-integration/get-aws-metric-name-filter-preview/ - identifier: aws-integration-get-aws-metric-name-filter-preview - parent: aws-integration - generated: true - params: - versions: - - v2 - operationids: - - GetAWSMetricNameFilterPreview - unstable: - - v2 - order: 19 - name: Create AWS CCM config url: /api/latest/aws-integration/create-aws-ccm-config/ identifier: aws-integration-create-aws-ccm-config @@ -10528,6 +10502,19 @@ menu: - ListBudgets unstable: [] order: 33 + - name: Get a budget's custom forecast + url: /api/latest/cloud-cost-management/get-a-budgets-custom-forecast/ + identifier: cloud-cost-management-get-a-budgets-custom-forecast + parent: cloud-cost-management + generated: true + params: + versions: + - v2 + operationids: + - GetCustomForecast + unstable: + - v2 + order: 69 - name: Delete a budget's custom forecast url: /api/latest/cloud-cost-management/delete-a-budgets-custom-forecast/ identifier: cloud-cost-management-delete-a-budgets-custom-forecast diff --git a/content/en/api/latest/cloud-cost-management/get-a-budgets-custom-forecast/index.md b/content/en/api/latest/cloud-cost-management/get-a-budgets-custom-forecast/index.md new file mode 100644 index 00000000000..9e7e1715535 --- /dev/null +++ b/content/en/api/latest/cloud-cost-management/get-a-budgets-custom-forecast/index.md @@ -0,0 +1,3 @@ +--- +title: Get a budget's custom forecast +--- diff --git a/content/en/api/v2/aws-integration/examples.json b/content/en/api/v2/aws-integration/examples.json index a99b3a59f41..20a83bab20c 100644 --- a/content/en/api/v2/aws-integration/examples.json +++ b/content/en/api/v2/aws-integration/examples.json @@ -44,14 +44,6 @@ "collect_cloudwatch_alarms": false, "collect_custom_metrics": false, "enabled": true, - "metric_name_filters": [ - { - "include_only": [ - "aws.ec2.network_in" - ], - "namespace": "AWS/EC2" - } - ], "namespace_filters": { "exclude_only": [ "AWS/SQS", @@ -84,7 +76,7 @@ } ] }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

[object]

\n

List of AWS Account Integration Configs.

\n
\n
\n
\n
\n
\n

attributes

\n
\n

object

\n

AWS Account response attributes.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

created_at

\n
\n

date-time

\n

Timestamp of when the account integration was created.

\n
\n \n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

metric_name_filters

\n
\n

[ <oneOf>]

\n

AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include only metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Exclude metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

modified_at

\n
\n

date-time

\n

Timestamp of when the account integration was updated.

\n
\n \n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data [required]

\n
\n

[object]

\n

List of AWS Account Integration Configs.

\n
\n
\n
\n
\n
\n

attributes

\n
\n

object

\n

AWS Account response attributes.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

created_at

\n
\n

date-time

\n

Timestamp of when the account integration was created.

\n
\n \n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

modified_at

\n
\n

date-time

\n

Timestamp of when the account integration was updated.

\n
\n \n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" }, "403": { "json": { @@ -153,14 +145,6 @@ "collect_cloudwatch_alarms": false, "collect_custom_metrics": false, "enabled": true, - "metric_name_filters": [ - { - "include_only": [ - "aws.ec2.network_in" - ], - "namespace": "AWS/EC2" - } - ], "namespace_filters": { "exclude_only": [ "AWS/SQS", @@ -192,7 +176,7 @@ "type": "account" } }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS Account response data.

\n
\n
\n
\n
\n
\n

attributes

\n
\n

object

\n

AWS Account response attributes.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

created_at

\n
\n

date-time

\n

Timestamp of when the account integration was created.

\n
\n \n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

metric_name_filters

\n
\n

[ <oneOf>]

\n

AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include only metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Exclude metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

modified_at

\n
\n

date-time

\n

Timestamp of when the account integration was updated.

\n
\n \n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS Account response data.

\n
\n
\n
\n
\n
\n

attributes

\n
\n

object

\n

AWS Account response attributes.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

created_at

\n
\n

date-time

\n

Timestamp of when the account integration was created.

\n
\n \n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

modified_at

\n
\n

date-time

\n

Timestamp of when the account integration was updated.

\n
\n \n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" }, "400": { "json": { @@ -278,14 +262,6 @@ "collect_cloudwatch_alarms": false, "collect_custom_metrics": false, "enabled": true, - "metric_name_filters": [ - { - "include_only": [ - "aws.ec2.network_in" - ], - "namespace": "AWS/EC2" - } - ], "namespace_filters": { "exclude_only": [ "AWS/SQS", @@ -315,7 +291,7 @@ "type": "account" } }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS Account Create Request data.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

The AWS Account Integration Config to be created.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config [required]

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition [required]

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

metric_name_filters

\n
\n

[ <oneOf>]

\n

AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include only metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Exclude metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS Account Create Request data.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

The AWS Account Integration Config to be created.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config [required]

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition [required]

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" } }, "DeleteAWSAccount": { @@ -403,14 +379,6 @@ "collect_cloudwatch_alarms": false, "collect_custom_metrics": false, "enabled": true, - "metric_name_filters": [ - { - "include_only": [ - "aws.ec2.network_in" - ], - "namespace": "AWS/EC2" - } - ], "namespace_filters": { "exclude_only": [ "AWS/SQS", @@ -442,7 +410,7 @@ "type": "account" } }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS Account response data.

\n
\n
\n
\n
\n
\n

attributes

\n
\n

object

\n

AWS Account response attributes.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

created_at

\n
\n

date-time

\n

Timestamp of when the account integration was created.

\n
\n \n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

metric_name_filters

\n
\n

[ <oneOf>]

\n

AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include only metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Exclude metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

modified_at

\n
\n

date-time

\n

Timestamp of when the account integration was updated.

\n
\n \n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS Account response data.

\n
\n
\n
\n
\n
\n

attributes

\n
\n

object

\n

AWS Account response attributes.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

created_at

\n
\n

date-time

\n

Timestamp of when the account integration was created.

\n
\n \n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

modified_at

\n
\n

date-time

\n

Timestamp of when the account integration was updated.

\n
\n \n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" }, "400": { "json": { @@ -527,14 +495,6 @@ "collect_cloudwatch_alarms": false, "collect_custom_metrics": false, "enabled": true, - "metric_name_filters": [ - { - "include_only": [ - "aws.ec2.network_in" - ], - "namespace": "AWS/EC2" - } - ], "namespace_filters": { "exclude_only": [ "AWS/SQS", @@ -566,7 +526,7 @@ "type": "account" } }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS Account response data.

\n
\n
\n
\n
\n
\n

attributes

\n
\n

object

\n

AWS Account response attributes.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

created_at

\n
\n

date-time

\n

Timestamp of when the account integration was created.

\n
\n \n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

metric_name_filters

\n
\n

[ <oneOf>]

\n

AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include only metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Exclude metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

modified_at

\n
\n

date-time

\n

Timestamp of when the account integration was updated.

\n
\n \n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS Account response data.

\n
\n
\n
\n
\n
\n

attributes

\n
\n

object

\n

AWS Account response attributes.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

created_at

\n
\n

date-time

\n

Timestamp of when the account integration was created.

\n
\n \n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

modified_at

\n
\n

date-time

\n

Timestamp of when the account integration was updated.

\n
\n \n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" }, "400": { "json": { @@ -650,14 +610,6 @@ "collect_cloudwatch_alarms": false, "collect_custom_metrics": false, "enabled": true, - "metric_name_filters": [ - { - "include_only": [ - "aws.ec2.network_in" - ], - "namespace": "AWS/EC2" - } - ], "namespace_filters": { "exclude_only": [ "AWS/SQS", @@ -688,7 +640,7 @@ "type": "account" } }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS Account Update Request data.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

The AWS Account Integration Config to be updated.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

metric_name_filters

\n
\n

[ <oneOf>]

\n

AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include only metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Exclude metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS Account Update Request data.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

The AWS Account Integration Config to be updated.

\n
\n
\n
\n
\n
\n

account_tags

\n
\n

[string]

\n

Tags to apply to all hosts and metrics reporting for this account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

auth_config

\n
\n

 <oneOf>

\n

AWS Authentication config.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

AWS Authentication config to integrate your account using an access key pair.

\n
\n
\n
\n
\n
\n

access_key_id [required]

\n
\n

string

\n

AWS Access Key ID.

\n
\n \n
\n
\n
\n
\n
\n

secret_access_key

\n
\n

string

\n

AWS Secret Access Key.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

AWS Authentication config to integrate your account using an IAM role.

\n
\n
\n
\n
\n
\n

external_id

\n
\n

string

\n

AWS IAM External ID for associated role.

\n
\n \n
\n
\n
\n
\n
\n

role_name [required]

\n
\n

string

\n

AWS IAM Role name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

aws_account_id [required]

\n
\n

string

\n

AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

aws_partition

\n
\n

enum

\n

AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov

\n
\n \n
\n
\n
\n
\n
\n

aws_regions

\n
\n

 <oneOf>

\n

AWS Regions to collect data from. Defaults to include_all.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all regions. Defaults to true.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these regions.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these regions.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

logs_config

\n
\n

object

\n

AWS Logs Collection config.

\n
\n
\n
\n
\n
\n

lambda_forwarder

\n
\n

object

\n

Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.

\n
\n
\n
\n
\n
\n

lambdas

\n
\n

[string]

\n

List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].

\n
\n \n
\n
\n
\n
\n
\n

log_source_config

\n
\n

object

\n

Log source configuration.

\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

List of AWS log source tag filters. Defaults to [].

\n
\n
\n
\n
\n
\n

source

\n
\n

string

\n

The AWS log source to which the tag filters defined in tags are applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the log source specified by source.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

sources

\n
\n

[string]

\n

List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

metrics_config

\n
\n

object

\n

AWS Metrics Collection config.

\n
\n
\n
\n
\n
\n

automute_enabled

\n
\n

boolean

\n

Enable EC2 automute for AWS metrics. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

collect_cloudwatch_alarms

\n
\n

boolean

\n

Enable CloudWatch alarms collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

collect_custom_metrics

\n
\n

boolean

\n

Enable custom metrics collection. Defaults to false.

\n
\n \n
\n
\n
\n
\n
\n

enabled

\n
\n

boolean

\n

Enable AWS metrics collection. Defaults to true.

\n
\n \n
\n
\n
\n
\n
\n

namespace_filters

\n
\n

 <oneOf>

\n

AWS Metrics namespace filters. Defaults to exclude_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these namespaces.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these namespaces.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

tag_filters

\n
\n

[object]

\n

AWS Metrics collection tag filters list. Defaults to [].

\n
\n
\n
\n
\n
\n

namespace

\n
\n

string

\n

The AWS service for which the tag filters defined in tags will be applied.

\n
\n \n
\n
\n
\n
\n
\n

tags

\n
\n

[string]

\n

The AWS resource tags to filter on for the service specified by namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

resources_config

\n
\n

object

\n

AWS Resources Collection config.

\n
\n
\n
\n
\n
\n

cloud_security_posture_management_collection

\n
\n

boolean

\n

Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.

\n
\n \n
\n
\n
\n
\n
\n

extended_collection

\n
\n

boolean

\n

Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

traces_config

\n
\n

object

\n

AWS Traces Collection config.

\n
\n
\n
\n
\n
\n

xray_services

\n
\n

 <oneOf>

\n

AWS X-Ray services to collect traces from. Defaults to include_only.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include all services.

\n
\n
\n
\n
\n
\n

include_all [required]

\n
\n

boolean

\n

Include all services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Include only these services. Defaults to [].

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only these services.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS Account resource type. \nAllowed enum values: account

default: account

\n
\n \n
\n
\n
\n
" } }, "DeleteAWSAccountCCMConfig": { @@ -959,179 +911,6 @@ "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS CCM Config Create/Update Request data.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

AWS CCM Config attributes for Create/Update requests.

\n
\n
\n
\n
\n
\n

ccm_config [required]

\n
\n

object

\n

AWS Cloud Cost Management config.

\n
\n
\n
\n
\n
\n

data_export_configs [required]

\n
\n

[object]

\n

List of data export configurations for Cost and Usage Reports.

\n
\n
\n
\n
\n
\n

bucket_name [required]

\n
\n

string

\n

Name of the S3 bucket where the Cost and Usage Report is stored.

\n
\n \n
\n
\n
\n
\n
\n

bucket_region [required]

\n
\n

string

\n

AWS region of the S3 bucket.

\n
\n \n
\n
\n
\n
\n
\n

report_name [required]

\n
\n

string

\n

Name of the Cost and Usage Report.

\n
\n \n
\n
\n
\n
\n
\n

report_prefix [required]

\n
\n

string

\n

S3 prefix where the Cost and Usage Report is stored.

\n
\n \n
\n
\n
\n
\n
\n

report_type [required]

\n
\n

string

\n

Type of the Cost and Usage Report. Currently only CUR2.0 is supported.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

AWS CCM Config resource type. \nAllowed enum values: ccm_config

default: ccm_config

\n
\n \n
\n
\n
\n
" } }, - "GetAWSMetricNameFilterPreview": { - "responses": { - "200": { - "json": { - "data": { - "attributes": { - "namespaces": [ - { - "filters": [ - { - "match_count": 1, - "pattern": "aws.ec2.network_in" - } - ], - "metrics": [ - { - "cw_name": "NetworkIn", - "dd_names": [ - { - "filtered": true, - "name": "aws.ec2.network_in" - } - ] - } - ], - "namespace": "AWS/EC2" - } - ] - }, - "id": "00000000-abcd-0001-0000-000000000000", - "type": "metric_name_filter_preview" - } - }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS metric name filter preview response data.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

AWS metric name filter preview response attributes.

\n
\n
\n
\n
\n
\n

namespaces [required]

\n
\n

[object]

\n

The list of namespaces affected by the previewed metric name filters.

\n
\n
\n
\n
\n
\n

filters [required]

\n
\n

[object]

\n

The metric name filter patterns evaluated for this namespace and how many metrics they matched.

\n
\n
\n
\n
\n
\n

match_count [required]

\n
\n

int64

\n

The number of Datadog metric names matched by this pattern.

\n
\n \n
\n
\n
\n
\n
\n

pattern [required]

\n
\n

string

\n

The metric name filter pattern.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

metrics [required]

\n
\n

[object]

\n

The CloudWatch metrics collected for this namespace and whether each resulting\nDatadog metric is filtered.

\n
\n
\n
\n
\n
\n

cw_name [required]

\n
\n

string

\n

The CloudWatch metric name.

\n
\n \n
\n
\n
\n
\n
\n

dd_names [required]

\n
\n

[object]

\n

The Datadog metric names produced from this CloudWatch metric.

\n
\n
\n
\n
\n
\n

filtered [required]

\n
\n

boolean

\n

Whether this Datadog metric name is filtered out.

\n
\n \n
\n
\n
\n
\n
\n

name [required]

\n
\n

string

\n

The Datadog metric name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

The AWSMetricNameFilterPreviewResponseData type. \nAllowed enum values: metric_name_filter_preview

default: metric_name_filter_preview

\n
\n \n
\n
\n
\n
" - }, - "403": { - "json": { - "errors": [ - "Bad Request" - ] - }, - "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" - }, - "404": { - "json": { - "errors": [ - "Bad Request" - ] - }, - "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" - }, - "429": { - "json": { - "errors": [ - "Bad Request" - ] - }, - "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" - } - }, - "request": { - "json_curl": {}, - "json": {}, - "html": "" - } - }, - "PreviewAWSMetricNameFilter": { - "responses": { - "200": { - "json": { - "data": { - "attributes": { - "namespaces": [ - { - "filters": [ - { - "match_count": 1, - "pattern": "aws.ec2.network_in" - } - ], - "metrics": [ - { - "cw_name": "NetworkIn", - "dd_names": [ - { - "filtered": true, - "name": "aws.ec2.network_in" - } - ] - } - ], - "namespace": "AWS/EC2" - } - ] - }, - "id": "00000000-abcd-0001-0000-000000000000", - "type": "metric_name_filter_preview" - } - }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS metric name filter preview response data.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

AWS metric name filter preview response attributes.

\n
\n
\n
\n
\n
\n

namespaces [required]

\n
\n

[object]

\n

The list of namespaces affected by the previewed metric name filters.

\n
\n
\n
\n
\n
\n

filters [required]

\n
\n

[object]

\n

The metric name filter patterns evaluated for this namespace and how many metrics they matched.

\n
\n
\n
\n
\n
\n

match_count [required]

\n
\n

int64

\n

The number of Datadog metric names matched by this pattern.

\n
\n \n
\n
\n
\n
\n
\n

pattern [required]

\n
\n

string

\n

The metric name filter pattern.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

metrics [required]

\n
\n

[object]

\n

The CloudWatch metrics collected for this namespace and whether each resulting\nDatadog metric is filtered.

\n
\n
\n
\n
\n
\n

cw_name [required]

\n
\n

string

\n

The CloudWatch metric name.

\n
\n \n
\n
\n
\n
\n
\n

dd_names [required]

\n
\n

[object]

\n

The Datadog metric names produced from this CloudWatch metric.

\n
\n
\n
\n
\n
\n

filtered [required]

\n
\n

boolean

\n

Whether this Datadog metric name is filtered out.

\n
\n \n
\n
\n
\n
\n
\n

name [required]

\n
\n

string

\n

The Datadog metric name.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

The AWSMetricNameFilterPreviewResponseData type. \nAllowed enum values: metric_name_filter_preview

default: metric_name_filter_preview

\n
\n \n
\n
\n
\n
" - }, - "400": { - "json": { - "errors": [ - { - "detail": "Missing required attribute in body", - "meta": {}, - "source": { - "header": "Authorization", - "parameter": "limit", - "pointer": "/data/attributes/title" - }, - "status": "400", - "title": "Bad Request" - } - ] - }, - "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

\n
\n
\n
\n
\n
\n

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

\n
\n \n
\n
\n
\n
\n
\n

meta

\n
\n

object

\n

Non-standard meta-information about the error

\n
\n \n
\n
\n
\n
\n
\n

source

\n
\n

object

\n

References to the source of the error.

\n
\n
\n
\n
\n
\n

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

\n
\n \n
\n
\n
\n
\n
\n

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

\n
\n \n
\n
\n
\n
\n
\n

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

status

\n
\n

string

\n

Status code of the response.

\n
\n \n
\n
\n
\n
\n
\n

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" - }, - "403": { - "json": { - "errors": [ - "Bad Request" - ] - }, - "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" - }, - "404": { - "json": { - "errors": [ - "Bad Request" - ] - }, - "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" - }, - "429": { - "json": { - "errors": [ - "Bad Request" - ] - }, - "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" - } - }, - "request": { - "json_curl": { - "data": { - "attributes": { - "metric_name_filters": [ - {} - ] - }, - "type": "metric_name_filter_preview" - } - }, - "json": { - "data": { - "attributes": { - "metric_name_filters": [ - { - "include_only": [ - "aws.ec2.network_in" - ], - "namespace": "AWS/EC2" - } - ] - }, - "type": "metric_name_filter_preview" - } - }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

AWS metric name filter preview request data.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

AWS metric name filter preview request attributes.

\n
\n
\n
\n
\n
\n

metric_name_filters [required]

\n
\n

[ <oneOf>]

\n

The metric name filters to preview.

\n
\n
\n
\n
\n
\n

Option 1

\n
\n

object

\n

Include only metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

include_only [required]

\n
\n

[string]

\n

Include only metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

Option 2

\n
\n

object

\n

Exclude metric names matching one of these patterns for a single namespace.

\n
\n
\n
\n
\n
\n

exclude_only [required]

\n
\n

[string]

\n

Exclude metric names matching one of these patterns.

\n
\n \n
\n
\n
\n
\n
\n

namespace [required]

\n
\n

string

\n

The AWS CloudWatch namespace to which this metric name filter applies.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

The AWSMetricNameFilterPreviewResponseData type. \nAllowed enum values: metric_name_filter_preview

default: metric_name_filter_preview

\n
\n \n
\n
\n
\n
" - } - }, "ListAWSNamespaces": { "responses": { "200": { diff --git a/content/en/api/v2/cloud-cost-management/examples.json b/content/en/api/v2/cloud-cost-management/examples.json index 4c33a17067e..26f134de264 100644 --- a/content/en/api/v2/cloud-cost-management/examples.json +++ b/content/en/api/v2/cloud-cost-management/examples.json @@ -2038,6 +2038,67 @@ "html": "" } }, + "GetCustomForecast": { + "responses": { + "200": { + "json": { + "data": { + "attributes": { + "budget_uid": "00000000-0000-0000-0000-000000000001", + "created_at": 1738258683590, + "created_by": "00000000-0a0a-0a0a-aaa0-00000000000a", + "entries": [ + { + "amount": 400, + "month": 202501, + "tag_filters": [ + { + "tag_key": "service", + "tag_value": "ec2" + } + ] + } + ], + "updated_at": 1738258683590, + "updated_by": "00000000-0a0a-0a0a-aaa0-00000000000a" + }, + "id": "11111111-1111-1111-1111-111111111111", + "type": "custom_forecast" + } + }, + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

Custom forecast resource wrapper in a response.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Attributes of a custom forecast.

\n
\n
\n
\n
\n
\n

budget_uid [required]

\n
\n

string

\n

The UUID of the budget that this custom forecast belongs to.

\n
\n \n
\n
\n
\n
\n
\n

created_at [required]

\n
\n

int64

\n

Timestamp the custom forecast was created, in Unix milliseconds.

\n
\n \n
\n
\n
\n
\n
\n

created_by [required]

\n
\n

string

\n

The id of the user that created the custom forecast.

\n
\n \n
\n
\n
\n
\n
\n

entries [required]

\n
\n

[object]

\n

Monthly custom forecast entries.

\n
\n
\n
\n
\n
\n

amount [required]

\n
\n

double

\n

Forecast amount for the month.

\n
\n \n
\n
\n
\n
\n
\n

month [required]

\n
\n

int64

\n

Month the custom forecast entry applies to, in YYYYMM format.

\n
\n \n
\n
\n
\n
\n
\n

tag_filters [required]

\n
\n

[object]

\n

Tag filters that scope this custom forecast entry to specific resources.

\n
\n
\n
\n
\n
\n

tag_key [required]

\n
\n

string

\n

The tag key to filter on.

\n
\n \n
\n
\n
\n
\n
\n

tag_value [required]

\n
\n

string

\n

The tag value to filter on.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

updated_at [required]

\n
\n

int64

\n

Timestamp the custom forecast was last updated, in Unix milliseconds.

\n
\n \n
\n
\n
\n
\n
\n

updated_by [required]

\n
\n

string

\n

The id of the user that last updated the custom forecast.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

The unique identifier of the custom forecast.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

The type of the custom forecast resource. Must be custom_forecast. \nAllowed enum values: custom_forecast

default: custom_forecast

\n
\n \n
\n
\n
\n
" + }, + "400": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "404": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "429": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + } + }, + "request": { + "json_curl": {}, + "json": {}, + "html": "" + } + }, "ListBudgets": { "responses": { "200": { diff --git a/data/api/v2/full_spec.yaml b/data/api/v2/full_spec.yaml index e3eaba8baaa..e5d33d01eab 100644 --- a/data/api/v2/full_spec.yaml +++ b/data/api/v2/full_spec.yaml @@ -3541,196 +3541,6 @@ components: type: string x-enum-varnames: - LOGS_SERVICES - AWSMetricNameFilterPreviewDDName: - description: A Datadog metric name and whether it is filtered. - properties: - filtered: - description: Whether this Datadog metric name is filtered out. - example: true - type: boolean - name: - description: The Datadog metric name. - example: "aws.ec2.network_in" - type: string - required: - - name - - filtered - type: object - AWSMetricNameFilterPreviewFilterMatch: - description: A metric name filter pattern and how many metrics it matched. - properties: - match_count: - description: The number of Datadog metric names matched by this pattern. - example: 1 - format: int64 - type: integer - pattern: - description: The metric name filter pattern. - example: "aws.ec2.network_in" - type: string - required: - - pattern - - match_count - type: object - AWSMetricNameFilterPreviewMetric: - description: A CloudWatch metric and the Datadog metric names it produces. - properties: - cw_name: - description: The CloudWatch metric name. - example: "NetworkIn" - type: string - dd_names: - description: The Datadog metric names produced from this CloudWatch metric. - items: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewDDName" - type: array - required: - - cw_name - - dd_names - type: object - AWSMetricNameFilterPreviewNamespace: - description: The metric name filter preview for a single namespace. - properties: - filters: - description: The metric name filter patterns evaluated for this namespace and how many metrics they matched. - items: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewFilterMatch" - type: array - metrics: - description: |- - The CloudWatch metrics collected for this namespace and whether each resulting - Datadog metric is filtered. - items: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewMetric" - type: array - namespace: - description: The AWS CloudWatch namespace. - example: "AWS/EC2" - type: string - required: - - namespace - - filters - - metrics - type: object - AWSMetricNameFilterPreviewRequest: - description: AWS metric name filter preview request body. - properties: - data: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewRequestData" - required: - - data - type: object - AWSMetricNameFilterPreviewRequestAttributes: - description: AWS metric name filter preview request attributes. - properties: - metric_name_filters: - description: The metric name filters to preview. - items: - $ref: "#/components/schemas/AWSMetricNameFilters" - type: array - required: - - metric_name_filters - type: object - AWSMetricNameFilterPreviewRequestData: - description: AWS metric name filter preview request data. - properties: - attributes: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewRequestAttributes" - type: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewType" - required: - - type - - attributes - type: object - AWSMetricNameFilterPreviewResponse: - description: AWS metric name filter preview response body. - properties: - data: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewResponseData" - required: - - data - type: object - AWSMetricNameFilterPreviewResponseAttributes: - description: AWS metric name filter preview response attributes. - properties: - namespaces: - description: The list of namespaces affected by the previewed metric name filters. - items: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewNamespace" - type: array - required: - - namespaces - type: object - AWSMetricNameFilterPreviewResponseData: - description: AWS metric name filter preview response data. - properties: - attributes: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewResponseAttributes" - id: - $ref: "#/components/schemas/AWSAccountConfigID" - type: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewType" - required: - - id - - type - - attributes - type: object - AWSMetricNameFilterPreviewType: - default: "metric_name_filter_preview" - description: The `AWSMetricNameFilterPreviewResponseData` `type`. - enum: - - metric_name_filter_preview - example: "metric_name_filter_preview" - type: string - x-enum-varnames: - - METRIC_NAME_FILTER_PREVIEW - AWSMetricNameFilters: - description: |- - AWS CloudWatch metric name filter for a single namespace. - Exactly one of `include_only` or `exclude_only` must be set. - oneOf: - - $ref: "#/components/schemas/AWSMetricNameFiltersIncludeOnly" - - $ref: "#/components/schemas/AWSMetricNameFiltersExcludeOnly" - AWSMetricNameFiltersExcludeOnly: - description: Exclude metric names matching one of these patterns for a single namespace. - properties: - exclude_only: - description: Exclude metric names matching one of these patterns. - example: - - "aws.ec2.network_in" - items: - description: A metric name pattern to exclude. - example: "aws.ec2.network_in" - type: string - type: array - namespace: - description: The AWS CloudWatch namespace to which this metric name filter applies. - example: "AWS/EC2" - type: string - required: - - namespace - - exclude_only - type: object - AWSMetricNameFiltersIncludeOnly: - description: Include only metric names matching one of these patterns for a single namespace. - properties: - include_only: - description: Include only metric names matching one of these patterns. - example: - - "aws.ec2.network_in" - items: - description: A metric name pattern to include. - example: "aws.ec2.network_in" - type: string - type: array - namespace: - description: The AWS CloudWatch namespace to which this metric name filter applies. - example: "AWS/EC2" - type: string - required: - - namespace - - include_only - type: object AWSMetricsConfig: description: AWS Metrics Collection config. properties: @@ -3750,13 +3560,6 @@ components: description: Enable AWS metrics collection. Defaults to `true`. example: true type: boolean - metric_name_filters: - description: |- - AWS CloudWatch metric name filters. Each filter applies to a single namespace. - Exactly one of `include_only` or `exclude_only` must be set on each filter. - items: - $ref: "#/components/schemas/AWSMetricNameFilters" - type: array namespace_filters: $ref: "#/components/schemas/AWSNamespaceFilters" tag_filters: @@ -128660,6 +128463,57 @@ paths: x-unstable: |- **Note**: This endpoint is in preview and is subject to change. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). + get: + description: Get the custom forecast for a budget. + operationId: GetCustomForecast + parameters: + - $ref: "#/components/parameters/BudgetID" + responses: + "200": + content: + application/json: + examples: + default: + value: + data: + attributes: + budget_uid: 00000000-0000-0000-0000-000000000001 + created_at: 1738258683590 + created_by: 00000000-0a0a-0a0a-aaa0-00000000000a + entries: + - amount: 400 + month: 202501 + tag_filters: + - tag_key: service + tag_value: ec2 + - amount: 450 + month: 202502 + tag_filters: + - tag_key: service + tag_value: ec2 + updated_at: 1738258683590 + updated_by: 00000000-0a0a-0a0a-aaa0-00000000000a + id: 11111111-1111-1111-1111-111111111111 + type: custom_forecast + schema: + $ref: "#/components/schemas/CustomForecastResponse" + description: OK + "400": + $ref: "#/components/responses/BadRequestResponse" + "404": + $ref: "#/components/responses/NotFoundResponse" + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Get a budget's custom forecast + tags: + - Cloud Cost Management + x-menu-order: 69 + x-unstable: |- + **Note**: This endpoint is in preview and is subject to change. + If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). /api/v2/cost/budgets: get: description: List budgets. @@ -142975,10 +142829,6 @@ paths: collect_cloudwatch_alarms: false collect_custom_metrics: false enabled: true - metric_name_filters: - - include_only: - - aws.ec2.network_in - namespace: AWS/EC2 tag_filters: - namespace: AWS/EC2 resources_config: @@ -143120,10 +142970,6 @@ paths: collect_cloudwatch_alarms: false collect_custom_metrics: false enabled: true - metric_name_filters: - - include_only: - - aws.ec2.network_in - namespace: AWS/EC2 tag_filters: - namespace: AWS/EC2 resources_config: @@ -143373,126 +143219,6 @@ paths: x-unstable: |- **Note**: This endpoint is in preview and may be subject to change. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - /api/v2/integration/aws/accounts/{aws_account_config_id}/metric_name_filter_preview: - get: - description: |- - Preview which collected CloudWatch metrics would be filtered by the account's saved metric name filters. - operationId: GetAWSMetricNameFilterPreview - parameters: - - $ref: "#/components/parameters/AWSAccountConfigIDPathParameter" - responses: - "200": - content: - application/json: - examples: - default: - value: - data: - attributes: - namespaces: - - filters: - - match_count: 1 - pattern: "aws.ec2.network_in" - metrics: - - cw_name: "NetworkIn" - dd_names: - - filtered: true - name: "aws.ec2.network_in" - namespace: "AWS/EC2" - id: "00000000-0000-0000-0000-000000000001" - type: metric_name_filter_preview - schema: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewResponse" - description: AWS metric name filter preview result - "403": - $ref: "#/components/responses/ForbiddenResponse" - "404": - $ref: "#/components/responses/NotFoundResponse" - "429": - $ref: "#/components/responses/TooManyRequestsResponse" - summary: Get AWS metric name filter preview - tags: - - AWS Integration - x-menu-order: 19 - "x-permission": - operator: OR - permissions: - - aws_configuration_read - x-unstable: |- - **Note**: This endpoint is in preview and is subject to change. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - post: - description: |- - Preview which collected CloudWatch metrics would be filtered by the supplied metric name filters. - The filters are not persisted. - operationId: PreviewAWSMetricNameFilter - parameters: - - $ref: "#/components/parameters/AWSAccountConfigIDPathParameter" - requestBody: - content: - application/json: - examples: - default: - value: - data: - attributes: - metric_name_filters: - - exclude_only: - - "aws.ec2.network_in" - namespace: "AWS/EC2" - type: metric_name_filter_preview - schema: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewRequest" - description: The metric name filters to preview. - required: true - responses: - "200": - content: - application/json: - examples: - default: - value: - data: - attributes: - namespaces: - - filters: - - match_count: 1 - pattern: "aws.ec2.network_in" - metrics: - - cw_name: "NetworkIn" - dd_names: - - filtered: true - name: "aws.ec2.network_in" - namespace: "AWS/EC2" - id: "00000000-0000-0000-0000-000000000001" - type: metric_name_filter_preview - schema: - $ref: "#/components/schemas/AWSMetricNameFilterPreviewResponse" - description: AWS metric name filter preview result - "400": - content: - application/json: - schema: - $ref: "#/components/schemas/JSONAPIErrorResponse" - description: Bad Request - "403": - $ref: "#/components/responses/ForbiddenResponse" - "404": - $ref: "#/components/responses/NotFoundResponse" - "429": - $ref: "#/components/responses/TooManyRequestsResponse" - summary: Preview AWS metric name filter - tags: - - AWS Integration - x-codegen-request-body-name: body - x-menu-order: 20 - "x-permission": - operator: OR - permissions: - - aws_configuration_read - x-unstable: |- - **Note**: This endpoint is in preview and is subject to change. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). /api/v2/integration/aws/available_namespaces: get: description: Get a list of available AWS CloudWatch namespaces that can send metrics to Datadog. diff --git a/data/api/v2/translate_actions.json b/data/api/v2/translate_actions.json index d2aad45f2dc..5fca8259a44 100644 --- a/data/api/v2/translate_actions.json +++ b/data/api/v2/translate_actions.json @@ -1262,6 +1262,10 @@ "description": "Delete the custom forecast for a budget.", "summary": "Delete a budget's custom forecast" }, + "GetCustomForecast": { + "description": "Get the custom forecast for a budget.", + "summary": "Get a budget's custom forecast" + }, "ListBudgets": { "description": "List budgets.", "summary": "List budgets" @@ -2328,16 +2332,6 @@ "request_description": "Create a Cloud Cost Management config for an AWS Account Integration Config.", "request_schema_description": "AWS CCM Config Create/Update Request body." }, - "GetAWSMetricNameFilterPreview": { - "description": "Preview which collected CloudWatch metrics would be filtered by the account's saved metric name filters.", - "summary": "Get AWS metric name filter preview" - }, - "PreviewAWSMetricNameFilter": { - "description": "Preview which collected CloudWatch metrics would be filtered by the supplied metric name filters.\nThe filters are not persisted.", - "summary": "Preview AWS metric name filter", - "request_description": "The metric name filters to preview.", - "request_schema_description": "AWS metric name filter preview request body." - }, "ListAWSNamespaces": { "description": "Get a list of available AWS CloudWatch namespaces that can send metrics to Datadog.", "summary": "List available namespaces"