Add log autosubscription tag filters config to aws v2 API (#30939)

api-clients-generation-pipeline[bot] · ci.datadog-api-spec · web-flow · commit 5ba14ac802d3 · 2025-08-07T20:07:44.000Z
Co-authored-by: ci.datadog-api-spec &lt;packages@datadoghq.com&gt;
diff --git a/.apigentools-info b/.apigentools-info
@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-08-06 20:55:23.361049",
-            "spec_repo_commit": "fd3370f5"
+            "regenerated": "2025-08-07 18:04:48.795715",
+            "spec_repo_commit": "c5cca507"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-08-06 20:55:33.682038",
-            "spec_repo_commit": "fd3370f5"
+            "regenerated": "2025-08-07 18:04:58.989170",
+            "spec_repo_commit": "c5cca507"
         }
     }
 }
diff --git a/content/en/api/v2/aws-integration/examples.json b/content/en/api/v2/aws-integration/examples.json
diff --git a/content/en/api/v2/aws-integration/request.CreateAWSAccount.json b/content/en/api/v2/aws-integration/request.CreateAWSAccount.json
@@ -15,6 +15,16 @@
           "lambdas": [
             "arn:aws:lambda:us-east-1:123456789012:function:DatadogLambdaLogForwarder"
           ],
+          "log_source_config": {
+            "tag_filters": [
+              {
+                "source": "s3",
+                "tags": [
+                  "test:test"
+                ]
+              }
+            ]
+          },
           "sources": [
             "s3"
           ]
diff --git a/content/en/api/v2/aws-integration/request.CreateAWSAccount_1716720881.json b/content/en/api/v2/aws-integration/request.CreateAWSAccount_1716720881.json
@@ -14,6 +14,16 @@
           "lambdas": [
             "arn:aws:lambda:us-east-1:123456789012:function:DatadogLambdaLogForwarder"
           ],
+          "log_source_config": {
+            "tag_filters": [
+              {
+                "source": "s3",
+                "tags": [
+                  "test:test"
+                ]
+              }
+            ]
+          },
           "sources": [
             "s3"
           ]
diff --git a/content/en/api/v2/aws-integration/request.UpdateAWSAccount.json b/content/en/api/v2/aws-integration/request.UpdateAWSAccount.json
@@ -14,6 +14,16 @@
           "lambdas": [
             "arn:aws:lambda:us-east-1:123456789012:function:DatadogLambdaLogForwarder"
           ],
+          "log_source_config": {
+            "tag_filters": [
+              {
+                "source": "s3",
+                "tags": [
+                  "test:test"
+                ]
+              }
+            ]
+          },
           "sources": [
             "s3"
           ]
diff --git a/content/en/api/v2/events/request.CreateEvent.json b/content/en/api/v2/events/request.CreateEvent.json
@@ -1,37 +1,54 @@
 {
   "data": {
-    "type": "event",
     "attributes": {
       "aggregation_key": "aggregation_key_123",
       "attributes": {
-        "custom": {
-          "threshold": 95,
-          "current_value": 98,
-          "metric": "cpu.utilization"
+        "author": {
+          "name": "example@datadog.com",
+          "type": "user"
         },
-        "links": [
-          {
-            "category": "runbook",
-            "title": "CPU Alert Runbook",
-            "url": "https://example.com/runbooks/cpu-alert"
+        "change_metadata": {
+          "dd": {
+            "team": "datadog_team",
+            "user_email": "datadog@datadog.com",
+            "user_id": "datadog_user_id",
+            "user_name": "datadog_username"
           },
+          "resource_link": "datadog.com/feature/fallback_payments_test"
+        },
+        "changed_resource": {
+          "name": "fallback_payments_test",
+          "type": "feature_flag"
+        },
+        "impacted_resources": [
           {
-            "category": "dashboard",
-            "url": "https://example.com/dashboards/cpu-usage"
+            "name": "payments_api",
+            "type": "service"
           }
         ],
-        "priority": "2",
-        "status": "error"
+        "new_value": {
+          "enabled": true,
+          "percentage": "50%",
+          "rule": {
+            "datacenter": "devcycle.us1.prod"
+          }
+        },
+        "prev_value": {
+          "enabled": true,
+          "percentage": "10%",
+          "rule": {
+            "datacenter": "devcycle.us1.prod"
+          }
+        }
       },
-      "category": "alert",
+      "category": "change",
       "integration_id": "custom-events",
-      "message": "CPU usage exceeded the 95% threshold for more than 5 minutes.",
+      "message": "payment_processed feature flag has been enabled",
       "tags": [
-        "env:production",
-        "team:infrastructure"
+        "env:api_client_test"
       ],
-      "timestamp": "2025-08-05T10:30:00Z",
-      "title": "High CPU usage on production nodes"
-    }
+      "title": "payment_processed feature flag updated"
+    },
+    "type": "event"
   }
 }
diff --git a/data/api/v2/CodeExamples.json b/data/api/v2/CodeExamples.json
@@ -464,12 +464,7 @@
     {
       "group": "events",
       "suffix": "",
-      "description": "Example"
-    },
-    {
-      "group": "events",
-      "suffix": "_change",
-      "description": "Example 2"
+      "description": "Post an event returns \"OK\" response"
     }
   ],
   "SearchEvents": [
@@ -1604,4 +1599,4 @@
       "description": "Update an existing Workflow returns \"Successfully updated a workflow.\" response"
     }
   ]
-}
+}
diff --git a/data/api/v2/full_spec.yaml b/data/api/v2/full_spec.yaml
@@ -1652,6 +1652,8 @@ components:
             example: arn:aws:lambda:us-east-1:123456789012:function:DatadogLambdaLogForwarder
             type: string
           type: array
+        log_source_config:
+          $ref: '#/components/schemas/AWSLambdaForwarderConfigLogSourceConfig'
         sources:
           description: 'List of service IDs set to enable automatic log collection.
             Discover the list of available services with the
@@ -1663,6 +1665,44 @@ components:
             type: string
           type: array
       type: object
+    AWSLambdaForwarderConfigLogSourceConfig:
+      description: Log source configuration.
+      properties:
+        tag_filters:
+          description: List of AWS log source tag filters. Defaults to `[]`.
+          items:
+            $ref: '#/components/schemas/AWSLogSourceTagFilter'
+          type: array
+      type: object
+    AWSLogSourceTagFilter:
+      description: 'AWS log source tag filter list. Defaults to `[]`.
+
+        Array of log source to AWS resource tag mappings. Each mapping contains a
+        log source and its associated AWS resource tags (in `key:value` format) used
+        to filter logs submitted to Datadog.
+
+        Tag filters are applied for tags on the AWS resource emitting logs; tags associated
+        with the log storage entity (such as a CloudWatch Log Group or S3 Bucket)
+        are not considered.
+
+        For more information on resource tag filter syntax, [see AWS resource exclusion](https://docs.datadoghq.com/account_management/billing/aws/#aws-resource-exclusion)
+        in the AWS integration billing page.'
+      properties:
+        source:
+          description: The AWS log source to which the tag filters defined in `tags`
+            are applied.
+          example: s3
+          type: string
+        tags:
+          description: The AWS resource tags to filter on for the log source specified
+            by `source`.
+          items:
+            description: Tag in the form `key:value`.
+            example: env:prod
+            type: string
+          nullable: true
+          type: array
+      type: object
     AWSLogsConfig:
       description: AWS Logs Collection config.
       properties:
@@ -53741,9 +53781,12 @@ paths:
               {\n        \"include_only\": [\n          \"us-east-1\"\n        ]\n
               \     },\n      \"logs_config\": {\n        \"lambda_forwarder\": {\n
               \         \"lambdas\": [\n            \"arn:aws:lambda:us-east-1:123456789012:function:DatadogLambdaLogForwarder\"\n
-              \         ],\n          \"sources\": [\n            \"s3\"\n          ]\n
-              \       }\n      },\n      \"metrics_config\": {\n        \"enabled\":
-              true,\n        \"automute_enabled\": true,\n        \"collect_custom_metrics\":
+              \         ],\n          \"sources\": [\n            \"s3\"\n          ],\n
+              \         \"log_source_config\": {\n            \"tag_filters\": [\n
+              \             {\n                \"source\": \"s3\",\n                \"tags\":
+              [\"test:test\"]\n              }\n            ]\n          }\n        }\n
+              \     },\n      \"metrics_config\": {\n        \"enabled\": true,\n
+              \       \"automute_enabled\": true,\n        \"collect_custom_metrics\":
               false,\n        \"collect_cloudwatch_alarms\": false,\n        \"tag_filters\":
               [\n          {\n            \"namespace\": \"AWS/EC2\",\n            \"tags\":
               [\n              \"key:value\"\n            ]\n          }\n        ],\n
diff --git a/data/api/v2/full_spec_deref.json b/data/api/v2/full_spec_deref.json
diff --git a/static/resources/json/full_spec_v2.json b/static/resources/json/full_spec_v2.json

Original file line number	Diff line number	Diff line change
`@@ -4,13 +4,13 @@`
`4`	`4`	`"spec_versions": {`
`5`	`5`	`"v1": {`
`6`	`6`	`"apigentools_version": "1.6.6",`
`7`		`- "regenerated": "2025-08-06 20:55:23.361049",`
`8`		`- "spec_repo_commit": "fd3370f5"`
	`7`	`+ "regenerated": "2025-08-07 18:04:48.795715",`
	`8`	`+ "spec_repo_commit": "c5cca507"`
`9`	`9`	`},`
`10`	`10`	`"v2": {`
`11`	`11`	`"apigentools_version": "1.6.6",`
`12`		`- "regenerated": "2025-08-06 20:55:33.682038",`
`13`		`- "spec_repo_commit": "fd3370f5"`
	`12`	`+ "regenerated": "2025-08-07 18:04:58.989170",`
	`13`	`+ "spec_repo_commit": "c5cca507"`
`14`	`14`	`}`
`15`	`15`	`}`
`16`	`16`	`}`
Original file line number	Diff line number	Diff line change
`@@ -464,12 +464,7 @@`
`464`	`464`	`{`
`465`	`465`	`"group": "events",`
`466`	`466`	`"suffix": "",`
`467`		`- "description": "Example"`
`468`		`- },`
`469`		`- {`
`470`		`- "group": "events",`
`471`		`- "suffix": "_change",`
`472`		`- "description": "Example 2"`
	`467`	`+ "description": "Post an event returns \"OK\" response"`
`473`	`468`	`}`
`474`	`469`	`],`
`475`	`470`	`"SearchEvents": [`
`@@ -1604,4 +1599,4 @@`
`1604`	`1599`	`"description": "Update an existing Workflow returns \"Successfully updated a workflow.\" response"`
`1605`	`1600`	`}`
`1606`	`1601`	`]`
`1607`		`-}`
	`1602`	`+}`