Merge master into datadog-api-spec/test/teodor.todorov/SYNTH-13677/make-device-ids-only-be-string

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-11-15 19:35:16.522070",
-            "spec_repo_commit": "ad80112e"
+            "regenerated": "2024-11-19 21:12:16.150137",
+            "spec_repo_commit": "2e48953d"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-11-15 19:35:16.540620",
-            "spec_repo_commit": "ad80112e"
+            "regenerated": "2024-11-19 21:12:16.168656",
+            "spec_repo_commit": "2e48953d"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -23335,6 +23335,9 @@ components:
             apm_service_catalog_read: View service catalog and service definitions.
             apm_service_catalog_write: Add, modify, and delete service catalog definitions
               when those definitions are maintained by Datadog.
+            appsec_vm_read: View infrastructure, application code and library vulnerabilities.
+              This does not restrict access to the vulnerability data source through
+              the API or inventory SQL.
             cases_read: View Cases.
             cases_write: Create and update cases.
             ci_visibility_pipelines_write: Create CI Visibility pipeline spans using
@@ -23375,7 +23378,8 @@ components:
               Remote Configuration for the entire organization.
             security_monitoring_filters_read: Read Security Filters.
             security_monitoring_filters_write: Create, edit, and delete Security Filters.
-            security_monitoring_findings_read: View CSPM Findings.
+            security_monitoring_findings_read: View a list of findings that include
+              both misconfigurations and identity risks.
             security_monitoring_rules_read: Read Detection Rules.
             security_monitoring_rules_write: Create and edit Detection Rules.
             security_monitoring_signals_read: View Security Signals.
@@ -36442,7 +36446,8 @@ tags:
   name: Logs
 - description: 'Manage configuration of [log indexes](https://docs.datadoghq.com/logs/indexes/).
 
-    You need an API and application key with Admin rights to interact with this endpoint.'
+    You need an API and non-scoped application key with Admin rights to interact with
+    these endpoints.'
   externalDocs:
     description: Find out more at
     url: https://docs.datadoghq.com/logs/indexes/
@@ -36454,11 +36459,12 @@ tags:
     about processors can be found in the\n  [processors documentation](https://docs.datadoghq.com/logs/log_configuration/processors/?tab=api#lookup-processor).\n\n-
     For more information about Pipelines, see the\n  [pipeline documentation](https://docs.datadoghq.com/logs/log_configuration/pipelines).\n\n**Notes:**\n\nThese
     endpoints are only available for admin users.\nMake sure to use an application
-    key created by an admin.\n\n**Grok parsing rules may effect JSON output and require\nreturned
-    data to be configured before using in a request.**\nFor example, if you are using
-    the data returned from a\nrequest for another request body, and have a parsing
-    rule\nthat uses a regex pattern like `\\s` for spaces, you will\nneed to configure
-    all escaped spaces as `%{space}` to use\nin the body data."
+    key created by an admin with no applied scopes.\n\n**Grok parsing rules may effect
+    JSON output and require\nreturned data to be configured before using in a request.**\nFor
+    example, if you are using the data returned from a\nrequest for another request
+    body, and have a parsing rule\nthat uses a regex pattern like `\\s` for spaces,
+    you will\nneed to configure all escaped spaces as `%{space}` to use\nin the body
+    data."
   externalDocs:
     description: Find out more at
     url: https://docs.datadoghq.com/logs/log_configuration

.generator/schemas/v2/openapi.yaml

@@ -27145,6 +27145,9 @@ components:
             apm_service_catalog_read: View service catalog and service definitions.
             apm_service_catalog_write: Add, modify, and delete service catalog definitions
               when those definitions are maintained by Datadog.
+            appsec_vm_read: View infrastructure, application code and library vulnerabilities.
+              This does not restrict access to the vulnerability data source through
+              the API or inventory SQL.
             cases_read: View Cases.
             cases_write: Create and update cases.
             ci_visibility_pipelines_write: Create CI Visibility pipeline spans using
@@ -27185,10 +27188,12 @@ components:
               Remote Configuration for the entire organization.
             security_monitoring_filters_read: Read Security Filters.
             security_monitoring_filters_write: Create, edit, and delete Security Filters.
-            security_monitoring_findings_read: View CSPM Findings.
+            security_monitoring_findings_read: View a list of findings that include
+              both misconfigurations and identity risks.
             security_monitoring_rules_read: Read Detection Rules.
             security_monitoring_rules_write: Create and edit Detection Rules.
             security_monitoring_signals_read: View Security Signals.
+            security_monitoring_signals_write: Edit Security Signals.
             security_monitoring_suppressions_read: Read Rule Suppressions.
             security_monitoring_suppressions_write: Write Rule Suppressions.
             security_pipelines_read: View Security Pipelines.
@@ -36248,9 +36253,10 @@ paths:
   /api/v2/posture_management/findings:
     get:
       description: "Get a list of findings. These include both misconfigurations and
-        identity risks.\n\n### Filtering\n\nFilters can be applied by appending query
-        parameters to the URL.\n\n  - Using a single filter: `?filter[attribute_key]=attribute_value`\n
-        \ - Chaining filters: `?filter[attribute_key]=attribute_value&filter[attribute_key]=attribute_value...`\n
+        identity risks.\n\n**Note**: To filter and return only identity risks, add
+        the following query parameter: `?filter[tags]=dd_rule_type:ciem`\n\n### Filtering\n\nFilters
+        can be applied by appending query parameters to the URL.\n\n  - Using a single
+        filter: `?filter[attribute_key]=attribute_value`\n  - Chaining filters: `?filter[attribute_key]=attribute_value&filter[attribute_key]=attribute_value...`\n
         \ - Filtering on tags: `?filter[tags]=tag_key:tag_value&filter[tags]=tag_key_2:tag_value_2`\n\nHere,
         `attribute_key` can be any of the filter keys described further below.\n\nQuery
         parameters of type `integer` support comparison operators (`>`, `>=`, `<`,
@@ -40801,11 +40807,16 @@ paths:
       security:
       - apiKeyAuth: []
         appKeyAuth: []
-      - AuthZ: []
+      - AuthZ:
+        - security_monitoring_rules_write
       summary: Run a historical job
       tags:
       - Security Monitoring
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - security_monitoring_rules_write
       x-unstable: '**Note**: This endpoint is in beta and may be subject to changes.
 
         Please check the documentation regularly for updates.'
@@ -40835,11 +40846,16 @@ paths:
       security:
       - apiKeyAuth: []
         appKeyAuth: []
-      - AuthZ: []
+      - AuthZ:
+        - security_monitoring_signals_write
       summary: Convert a job result to a signal
       tags:
       - Security Monitoring
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - security_monitoring_signals_write
       x-unstable: '**Note**: This endpoint is in beta and may be subject to changes.
 
         Please check the documentation regularly for updates.'
@@ -40897,10 +40913,15 @@ paths:
       security:
       - apiKeyAuth: []
         appKeyAuth: []
-      - AuthZ: []
+      - AuthZ:
+        - security_monitoring_rules_read
       summary: Get a job's details
       tags:
       - Security Monitoring
+      x-permission:
+        operator: OR
+        permissions:
+        - security_monitoring_rules_read
       x-unstable: '**Note**: This endpoint is in beta and may be subject to changes.
 
         Please check the documentation regularly for updates.'
@@ -40928,10 +40949,15 @@ paths:
       security:
       - apiKeyAuth: []
         appKeyAuth: []
-      - AuthZ: []
+      - AuthZ:
+        - security_monitoring_rules_write
       summary: Cancel a historical job
       tags:
       - Security Monitoring
+      x-permission:
+        operator: OR
+        permissions:
+        - security_monitoring_rules_write
       x-unstable: '**Note**: This endpoint is in beta and may be subject to changes.
 
         Please check the documentation regularly for updates.'
@@ -43809,7 +43835,11 @@ tags:
 
     See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives)
 
-    for a list of the archives currently configured in Datadog.'
+    for a list of the archives currently configured in Datadog.
+
+
+    You need an API and non-scoped application key with Admin rights to interact with
+    these endpoints.'
   externalDocs:
     description: Find out more at
     url: https://docs.datadoghq.com/logs/archives/
@@ -43828,8 +43858,11 @@ tags:
     description: Find out more at
     url: https://docs.datadoghq.com/logs/log_configuration/forwarding_custom_destinations/
   name: Logs Custom Destinations
-- description: Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics)
+- description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics)
     for your organization.
+
+    You need an API and non-scoped application key with Admin rights to interact with
+    these endpoints.'
   externalDocs:
     description: Find out more at
     url: https://docs.datadoghq.com/logs/logs_to_metrics/

features/v1/logs_indexes.feature

@@ -2,7 +2,8 @@
 Feature: Logs Indexes
   Manage configuration of [log
   indexes](https://docs.datadoghq.com/logs/indexes/). You need an API and
-  application key with Admin rights to interact with this endpoint.
+  non-scoped application key with Admin rights to interact with these
+  endpoints.
 
   Background:
     Given a valid "apiKeyAuth" key in the system

features/v1/logs_pipelines.feature

@@ -10,12 +10,13 @@ Feature: Logs Pipelines
   s/?tab=api#lookup-processor).  - For more information about Pipelines, see
   the   [pipeline documentation](https://docs.datadoghq.com/logs/log_configu
   ration/pipelines).  **Notes:**  These endpoints are only available for
-  admin users. Make sure to use an application key created by an admin.
-  **Grok parsing rules may effect JSON output and require returned data to
-  be configured before using in a request.** For example, if you are using
-  the data returned from a request for another request body, and have a
-  parsing rule that uses a regex pattern like `\s` for spaces, you will need
-  to configure all escaped spaces as `%{space}` to use in the body data.
+  admin users. Make sure to use an application key created by an admin with
+  no applied scopes.  **Grok parsing rules may effect JSON output and
+  require returned data to be configured before using in a request.** For
+  example, if you are using the data returned from a request for another
+  request body, and have a parsing rule that uses a regex pattern like `\s`
+  for spaces, you will need to configure all escaped spaces as `%{space}` to
+  use in the body data.
 
   Background:
     Given a valid "apiKeyAuth" key in the system

features/v2/logs_archives.feature

@@ -2,7 +2,9 @@
 Feature: Logs Archives
   Archives forward all the logs ingested to a cloud storage system.  See the
   [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) for a
-  list of the archives currently configured in Datadog.
+  list of the archives currently configured in Datadog.  You need an API and
+  non-scoped application key with Admin rights to interact with these
+  endpoints.
 
   Background:
     Given a valid "apiKeyAuth" key in the system

features/v2/logs_metrics.feature

@@ -2,7 +2,8 @@
 Feature: Logs Metrics
   Manage configuration of [log-based
   metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for
-  your organization.
+  your organization. You need an API and non-scoped application key with
+  Admin rights to interact with these endpoints.
 
   Background:
     Given a valid "apiKeyAuth" key in the system

lib/datadog_api_client/v2/api/security_monitoring_api.rb

@@ -1409,6 +1409,8 @@ def list_findings(opts = {})
     #
     # Get a list of findings. These include both misconfigurations and identity risks.
     #
+    # **Note**: To filter and return only identity risks, add the following query parameter: `?filter[tags]=dd_rule_type:ciem`
+    #
     # ### Filtering
     #
     # Filters can be applied by appending query parameters to the URL.