diff --git a/config/_default/menus/api.en.yaml b/config/_default/menus/api.en.yaml index 9256bb8adb1..3dbfa1b22f9 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 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/security-monitoring/examples.json b/content/en/api/v2/security-monitoring/examples.json index e5c328af388..d1de38dfaa1 100644 --- a/content/en/api/v2/security-monitoring/examples.json +++ b/content/en/api/v2/security-monitoring/examples.json @@ -6187,6 +6187,7 @@ "name": "John Doe" }, "description": "Production database servers handling PII", + "editable": true, "enabled": true, "query": "security:monitoring", "rule_query": "type:log_detection source:cloudtrail", @@ -6208,7 +6209,7 @@ } ] }, - "html": "
\n
\n
\n
\n

data

\n
\n

[object]

\n

A list of critical assets objects.

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

attributes

\n
\n

object

\n

The attributes of the critical asset.

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

creation_author_id

\n
\n

int64

\n

ID of user who created the critical asset.

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

creation_date

\n
\n

int64

\n

A Unix millisecond timestamp given the creation date of the critical asset.

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

creator

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

description

\n
\n

string

\n

A description of the critical asset.

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

enabled

\n
\n

boolean

\n

Whether the critical asset is enabled.

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

query

\n
\n

string

\n

The query for the critical asset. It uses the same syntax as the queries to search signals in the Signals Explorer.

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

rule_query

\n
\n

string

\n

The rule query of the critical asset, with the same syntax as the search bar for detection rules. This determines which rules this critical asset will apply to.

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

severity

\n
\n

enum

\n

Severity associated with this critical asset. Either an explicit severity can be set, or the severity can be increased or decreased, or the severity can be left unchanged (no-op). \nAllowed enum values: info,low,medium,high,critical,increase,decrease,no-op

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

tags

\n
\n

[string]

\n

List of tags associated with the critical asset.

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

update_author_id

\n
\n

int64

\n

ID of user who updated the critical asset.

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

update_date

\n
\n

int64

\n

A Unix millisecond timestamp given the update date of the critical asset.

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

updater

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

version

\n
\n

int32

\n

The version of the critical asset; it starts at 1, and is incremented at each update.

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

id

\n
\n

string

\n

The ID of the critical asset.

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

type

\n
\n

enum

\n

The type of the resource. The value should always be critical_assets. \nAllowed enum values: critical_assets

default: critical_assets

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

data

\n
\n

[object]

\n

A list of critical assets objects.

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

attributes

\n
\n

object

\n

The attributes of the critical asset.

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

creation_author_id

\n
\n

int64

\n

ID of user who created the critical asset.

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

creation_date

\n
\n

int64

\n

A Unix millisecond timestamp given the creation date of the critical asset.

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

creator

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

description

\n
\n

string

\n

A description of the critical asset.

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

editable

\n
\n

boolean

\n

Whether the critical asset is editable.

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

enabled

\n
\n

boolean

\n

Whether the critical asset is enabled.

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

query

\n
\n

string

\n

The query for the critical asset. It uses the same syntax as the queries to search signals in the Signals Explorer.

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

rule_query

\n
\n

string

\n

The rule query of the critical asset, with the same syntax as the search bar for detection rules. This determines which rules this critical asset will apply to.

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

severity

\n
\n

enum

\n

Severity associated with this critical asset. Either an explicit severity can be set, or the severity can be increased or decreased, or the severity can be left unchanged (no-op). \nAllowed enum values: info,low,medium,high,critical,increase,decrease,no-op

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

tags

\n
\n

[string]

\n

List of tags associated with the critical asset.

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

update_author_id

\n
\n

int64

\n

ID of user who updated the critical asset.

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

update_date

\n
\n

int64

\n

A Unix millisecond timestamp given the update date of the critical asset.

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

updater

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

version

\n
\n

int32

\n

The version of the critical asset; it starts at 1, and is incremented at each update.

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

id

\n
\n

string

\n

The ID of the critical asset.

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

type

\n
\n

enum

\n

The type of the resource. The value should always be critical_assets. \nAllowed enum values: critical_assets

default: critical_assets

\n
\n \n
\n
\n
\n
" }, "403": { "json": { @@ -6246,6 +6247,7 @@ "name": "John Doe" }, "description": "Production database servers handling PII", + "editable": true, "enabled": true, "query": "security:monitoring", "rule_query": "type:log_detection source:cloudtrail", @@ -6266,7 +6268,7 @@ "type": "critical_assets" } }, - "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

The critical asset's properties.

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

attributes

\n
\n

object

\n

The attributes of the critical asset.

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

creation_author_id

\n
\n

int64

\n

ID of user who created the critical asset.

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

creation_date

\n
\n

int64

\n

A Unix millisecond timestamp given the creation date of the critical asset.

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

creator

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

description

\n
\n

string

\n

A description of the critical asset.

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

enabled

\n
\n

boolean

\n

Whether the critical asset is enabled.

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

query

\n
\n

string

\n

The query for the critical asset. It uses the same syntax as the queries to search signals in the Signals Explorer.

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

rule_query

\n
\n

string

\n

The rule query of the critical asset, with the same syntax as the search bar for detection rules. This determines which rules this critical asset will apply to.

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

severity

\n
\n

enum

\n

Severity associated with this critical asset. Either an explicit severity can be set, or the severity can be increased or decreased, or the severity can be left unchanged (no-op). \nAllowed enum values: info,low,medium,high,critical,increase,decrease,no-op

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

tags

\n
\n

[string]

\n

List of tags associated with the critical asset.

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

update_author_id

\n
\n

int64

\n

ID of user who updated the critical asset.

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

update_date

\n
\n

int64

\n

A Unix millisecond timestamp given the update date of the critical asset.

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

updater

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

version

\n
\n

int32

\n

The version of the critical asset; it starts at 1, and is incremented at each update.

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

id

\n
\n

string

\n

The ID of the critical asset.

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

type

\n
\n

enum

\n

The type of the resource. The value should always be critical_assets. \nAllowed enum values: critical_assets

default: critical_assets

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

data

\n
\n

object

\n

The critical asset's properties.

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

attributes

\n
\n

object

\n

The attributes of the critical asset.

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

creation_author_id

\n
\n

int64

\n

ID of user who created the critical asset.

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

creation_date

\n
\n

int64

\n

A Unix millisecond timestamp given the creation date of the critical asset.

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

creator

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

description

\n
\n

string

\n

A description of the critical asset.

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

editable

\n
\n

boolean

\n

Whether the critical asset is editable.

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

enabled

\n
\n

boolean

\n

Whether the critical asset is enabled.

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

query

\n
\n

string

\n

The query for the critical asset. It uses the same syntax as the queries to search signals in the Signals Explorer.

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

rule_query

\n
\n

string

\n

The rule query of the critical asset, with the same syntax as the search bar for detection rules. This determines which rules this critical asset will apply to.

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

severity

\n
\n

enum

\n

Severity associated with this critical asset. Either an explicit severity can be set, or the severity can be increased or decreased, or the severity can be left unchanged (no-op). \nAllowed enum values: info,low,medium,high,critical,increase,decrease,no-op

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

tags

\n
\n

[string]

\n

List of tags associated with the critical asset.

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

update_author_id

\n
\n

int64

\n

ID of user who updated the critical asset.

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

update_date

\n
\n

int64

\n

A Unix millisecond timestamp given the update date of the critical asset.

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

updater

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

version

\n
\n

int32

\n

The version of the critical asset; it starts at 1, and is incremented at each update.

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

id

\n
\n

string

\n

The ID of the critical asset.

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

type

\n
\n

enum

\n

The type of the resource. The value should always be critical_assets. \nAllowed enum values: critical_assets

default: critical_assets

\n
\n \n
\n
\n
\n
" }, "400": { "json": { @@ -6345,6 +6347,7 @@ "name": "John Doe" }, "description": "Production database servers handling PII", + "editable": true, "enabled": true, "query": "security:monitoring", "rule_query": "type:log_detection source:cloudtrail", @@ -6366,7 +6369,7 @@ } ] }, - "html": "
\n
\n
\n
\n

data

\n
\n

[object]

\n

A list of critical assets objects.

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

attributes

\n
\n

object

\n

The attributes of the critical asset.

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

creation_author_id

\n
\n

int64

\n

ID of user who created the critical asset.

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

creation_date

\n
\n

int64

\n

A Unix millisecond timestamp given the creation date of the critical asset.

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

creator

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

description

\n
\n

string

\n

A description of the critical asset.

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

enabled

\n
\n

boolean

\n

Whether the critical asset is enabled.

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

query

\n
\n

string

\n

The query for the critical asset. It uses the same syntax as the queries to search signals in the Signals Explorer.

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

rule_query

\n
\n

string

\n

The rule query of the critical asset, with the same syntax as the search bar for detection rules. This determines which rules this critical asset will apply to.

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

severity

\n
\n

enum

\n

Severity associated with this critical asset. Either an explicit severity can be set, or the severity can be increased or decreased, or the severity can be left unchanged (no-op). \nAllowed enum values: info,low,medium,high,critical,increase,decrease,no-op

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

tags

\n
\n

[string]

\n

List of tags associated with the critical asset.

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

update_author_id

\n
\n

int64

\n

ID of user who updated the critical asset.

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

update_date

\n
\n

int64

\n

A Unix millisecond timestamp given the update date of the critical asset.

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

updater

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

version

\n
\n

int32

\n

The version of the critical asset; it starts at 1, and is incremented at each update.

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

id

\n
\n

string

\n

The ID of the critical asset.

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

type

\n
\n

enum

\n

The type of the resource. The value should always be critical_assets. \nAllowed enum values: critical_assets

default: critical_assets

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

data

\n
\n

[object]

\n

A list of critical assets objects.

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

attributes

\n
\n

object

\n

The attributes of the critical asset.

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

creation_author_id

\n
\n

int64

\n

ID of user who created the critical asset.

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

creation_date

\n
\n

int64

\n

A Unix millisecond timestamp given the creation date of the critical asset.

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

creator

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

description

\n
\n

string

\n

A description of the critical asset.

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

editable

\n
\n

boolean

\n

Whether the critical asset is editable.

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

enabled

\n
\n

boolean

\n

Whether the critical asset is enabled.

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

query

\n
\n

string

\n

The query for the critical asset. It uses the same syntax as the queries to search signals in the Signals Explorer.

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

rule_query

\n
\n

string

\n

The rule query of the critical asset, with the same syntax as the search bar for detection rules. This determines which rules this critical asset will apply to.

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

severity

\n
\n

enum

\n

Severity associated with this critical asset. Either an explicit severity can be set, or the severity can be increased or decreased, or the severity can be left unchanged (no-op). \nAllowed enum values: info,low,medium,high,critical,increase,decrease,no-op

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

tags

\n
\n

[string]

\n

List of tags associated with the critical asset.

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

update_author_id

\n
\n

int64

\n

ID of user who updated the critical asset.

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

update_date

\n
\n

int64

\n

A Unix millisecond timestamp given the update date of the critical asset.

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

updater

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

version

\n
\n

int32

\n

The version of the critical asset; it starts at 1, and is incremented at each update.

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

id

\n
\n

string

\n

The ID of the critical asset.

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

type

\n
\n

enum

\n

The type of the resource. The value should always be critical_assets. \nAllowed enum values: critical_assets

default: critical_assets

\n
\n \n
\n
\n
\n
" }, "403": { "json": { @@ -6445,6 +6448,7 @@ "name": "John Doe" }, "description": "Production database servers handling PII", + "editable": true, "enabled": true, "query": "security:monitoring", "rule_query": "type:log_detection source:cloudtrail", @@ -6465,7 +6469,7 @@ "type": "critical_assets" } }, - "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

The critical asset's properties.

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

attributes

\n
\n

object

\n

The attributes of the critical asset.

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

creation_author_id

\n
\n

int64

\n

ID of user who created the critical asset.

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

creation_date

\n
\n

int64

\n

A Unix millisecond timestamp given the creation date of the critical asset.

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

creator

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

description

\n
\n

string

\n

A description of the critical asset.

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

enabled

\n
\n

boolean

\n

Whether the critical asset is enabled.

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

query

\n
\n

string

\n

The query for the critical asset. It uses the same syntax as the queries to search signals in the Signals Explorer.

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

rule_query

\n
\n

string

\n

The rule query of the critical asset, with the same syntax as the search bar for detection rules. This determines which rules this critical asset will apply to.

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

severity

\n
\n

enum

\n

Severity associated with this critical asset. Either an explicit severity can be set, or the severity can be increased or decreased, or the severity can be left unchanged (no-op). \nAllowed enum values: info,low,medium,high,critical,increase,decrease,no-op

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

tags

\n
\n

[string]

\n

List of tags associated with the critical asset.

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

update_author_id

\n
\n

int64

\n

ID of user who updated the critical asset.

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

update_date

\n
\n

int64

\n

A Unix millisecond timestamp given the update date of the critical asset.

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

updater

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

version

\n
\n

int32

\n

The version of the critical asset; it starts at 1, and is incremented at each update.

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

id

\n
\n

string

\n

The ID of the critical asset.

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

type

\n
\n

enum

\n

The type of the resource. The value should always be critical_assets. \nAllowed enum values: critical_assets

default: critical_assets

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

data

\n
\n

object

\n

The critical asset's properties.

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

attributes

\n
\n

object

\n

The attributes of the critical asset.

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

creation_author_id

\n
\n

int64

\n

ID of user who created the critical asset.

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

creation_date

\n
\n

int64

\n

A Unix millisecond timestamp given the creation date of the critical asset.

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

creator

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

description

\n
\n

string

\n

A description of the critical asset.

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

editable

\n
\n

boolean

\n

Whether the critical asset is editable.

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

enabled

\n
\n

boolean

\n

Whether the critical asset is enabled.

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

query

\n
\n

string

\n

The query for the critical asset. It uses the same syntax as the queries to search signals in the Signals Explorer.

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

rule_query

\n
\n

string

\n

The rule query of the critical asset, with the same syntax as the search bar for detection rules. This determines which rules this critical asset will apply to.

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

severity

\n
\n

enum

\n

Severity associated with this critical asset. Either an explicit severity can be set, or the severity can be increased or decreased, or the severity can be left unchanged (no-op). \nAllowed enum values: info,low,medium,high,critical,increase,decrease,no-op

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

tags

\n
\n

[string]

\n

List of tags associated with the critical asset.

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

update_author_id

\n
\n

int64

\n

ID of user who updated the critical asset.

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

update_date

\n
\n

int64

\n

A Unix millisecond timestamp given the update date of the critical asset.

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

updater

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

version

\n
\n

int32

\n

The version of the critical asset; it starts at 1, and is incremented at each update.

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

id

\n
\n

string

\n

The ID of the critical asset.

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

type

\n
\n

enum

\n

The type of the resource. The value should always be critical_assets. \nAllowed enum values: critical_assets

default: critical_assets

\n
\n \n
\n
\n
\n
" }, "403": { "json": { @@ -6511,6 +6515,7 @@ "name": "John Doe" }, "description": "Production database servers handling PII", + "editable": true, "enabled": true, "query": "security:monitoring", "rule_query": "type:log_detection source:cloudtrail", @@ -6531,7 +6536,7 @@ "type": "critical_assets" } }, - "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

The critical asset's properties.

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

attributes

\n
\n

object

\n

The attributes of the critical asset.

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

creation_author_id

\n
\n

int64

\n

ID of user who created the critical asset.

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

creation_date

\n
\n

int64

\n

A Unix millisecond timestamp given the creation date of the critical asset.

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

creator

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

description

\n
\n

string

\n

A description of the critical asset.

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

enabled

\n
\n

boolean

\n

Whether the critical asset is enabled.

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

query

\n
\n

string

\n

The query for the critical asset. It uses the same syntax as the queries to search signals in the Signals Explorer.

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

rule_query

\n
\n

string

\n

The rule query of the critical asset, with the same syntax as the search bar for detection rules. This determines which rules this critical asset will apply to.

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

severity

\n
\n

enum

\n

Severity associated with this critical asset. Either an explicit severity can be set, or the severity can be increased or decreased, or the severity can be left unchanged (no-op). \nAllowed enum values: info,low,medium,high,critical,increase,decrease,no-op

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

tags

\n
\n

[string]

\n

List of tags associated with the critical asset.

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

update_author_id

\n
\n

int64

\n

ID of user who updated the critical asset.

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

update_date

\n
\n

int64

\n

A Unix millisecond timestamp given the update date of the critical asset.

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

updater

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

version

\n
\n

int32

\n

The version of the critical asset; it starts at 1, and is incremented at each update.

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

id

\n
\n

string

\n

The ID of the critical asset.

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

type

\n
\n

enum

\n

The type of the resource. The value should always be critical_assets. \nAllowed enum values: critical_assets

default: critical_assets

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

data

\n
\n

object

\n

The critical asset's properties.

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

attributes

\n
\n

object

\n

The attributes of the critical asset.

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

creation_author_id

\n
\n

int64

\n

ID of user who created the critical asset.

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

creation_date

\n
\n

int64

\n

A Unix millisecond timestamp given the creation date of the critical asset.

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

creator

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

description

\n
\n

string

\n

A description of the critical asset.

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

editable

\n
\n

boolean

\n

Whether the critical asset is editable.

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

enabled

\n
\n

boolean

\n

Whether the critical asset is enabled.

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

query

\n
\n

string

\n

The query for the critical asset. It uses the same syntax as the queries to search signals in the Signals Explorer.

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

rule_query

\n
\n

string

\n

The rule query of the critical asset, with the same syntax as the search bar for detection rules. This determines which rules this critical asset will apply to.

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

severity

\n
\n

enum

\n

Severity associated with this critical asset. Either an explicit severity can be set, or the severity can be increased or decreased, or the severity can be left unchanged (no-op). \nAllowed enum values: info,low,medium,high,critical,increase,decrease,no-op

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

tags

\n
\n

[string]

\n

List of tags associated with the critical asset.

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

update_author_id

\n
\n

int64

\n

ID of user who updated the critical asset.

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

update_date

\n
\n

int64

\n

A Unix millisecond timestamp given the update date of the critical asset.

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

updater

\n
\n

object

\n

A user.

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

handle

\n
\n

string

\n

The handle of the user.

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

name

\n
\n

string

\n

The name of the user.

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

version

\n
\n

int32

\n

The version of the critical asset; it starts at 1, and is incremented at each update.

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

id

\n
\n

string

\n

The ID of the critical asset.

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

type

\n
\n

enum

\n

The type of the resource. The value should always be critical_assets. \nAllowed enum values: critical_assets

default: critical_assets

\n
\n \n
\n
\n
\n
" }, "400": { "json": { diff --git a/data/api/v2/full_spec.yaml b/data/api/v2/full_spec.yaml index e3eaba8baaa..343688ae0fa 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: @@ -88867,6 +88670,10 @@ components: description: A description of the critical asset. example: Production database servers handling PII type: string + editable: + description: Whether the critical asset is editable. + example: true + type: boolean enabled: description: Whether the critical asset is enabled. example: true @@ -142975,10 +142782,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 +142923,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 +143172,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..03164905664 100644 --- a/data/api/v2/translate_actions.json +++ b/data/api/v2/translate_actions.json @@ -2328,16 +2328,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"