Add audit trail to usage metering API (#1370)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2023-03-13 10:16:15.993063",
-            "spec_repo_commit": "5ad82066"
+            "regenerated": "2023-03-13 16:14:01.584162",
+            "spec_repo_commit": "13001c30"
         },
         "v2": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2023-03-13 10:16:16.005178",
-            "spec_repo_commit": "5ad82066"
+            "regenerated": "2023-03-13 16:14:01.600810",
+            "spec_repo_commit": "13001c30"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -16714,6 +16714,11 @@ components:
             the current date for all organizations.
           format: int64
           type: integer
+        audit_trail_enabled_hwm:
+          description: Shows the number of organizations that had Audit Trail enabled
+            in the current date.
+          format: int64
+          type: integer
         avg_profiled_fargate_tasks:
           description: The average profiled task count for Fargate Profiling.
           format: int64
@@ -17100,6 +17105,11 @@ components:
             in the current date for the given org.
           format: int64
           type: integer
+        audit_trail_enabled_hwm:
+          description: Shows whether Audit Trail is enabled for the current date for
+            the given org.
+          format: int64
+          type: integer
         avg_profiled_fargate_tasks:
           description: The average profiled task count for Fargate Profiling.
           format: int64
@@ -17489,6 +17499,11 @@ components:
             in the current months for all organizations.
           format: int64
           type: integer
+        audit_trail_enabled_hwm_sum:
+          description: Shows the total number of organizations that had Audit Trail
+            enabled over a specific number of months.
+          format: int64
+          type: integer
         avg_profiled_fargate_tasks_sum:
           description: Shows the average of all profiled Fargate tasks over all hours
             in the current months for all organizations.

.generator/schemas/v2/openapi.yaml

@@ -20790,7 +20790,9 @@ paths:
       - description: 'Comma separated list of product families to retrieve. Available
           families are `all`, `analyzed_logs`,
 
-          `application_security`, `audit_logs`, `serverless`, `ci_app`, `cloud_cost_management`,
+          `application_security`, `audit_logs`, `audit_trail`, `serverless`, `ci_app`,
+          `cloud_cost_management`,
+
           `cspm`, `custom_events`, `cws`, `dbm`, `fargate`,
 
           `infra_hosts`, `incident_management`, `indexed_logs`, `indexed_spans`, `ingested_spans`,

src/datadog_api_client/v1/model/usage_summary_date.py

@@ -30,6 +30,7 @@ def openapi_types(_):
             "apm_host_top99p": (int,),
             "appsec_fargate_count_avg": (int,),
             "audit_logs_lines_indexed_sum": (int,),
+            "audit_trail_enabled_hwm": (int,),
             "avg_profiled_fargate_tasks": (int,),
             "aws_host_top99p": (int,),
             "aws_lambda_func_count": (int,),
@@ -109,6 +110,7 @@ def openapi_types(_):
         "apm_host_top99p": "apm_host_top99p",
         "appsec_fargate_count_avg": "appsec_fargate_count_avg",
         "audit_logs_lines_indexed_sum": "audit_logs_lines_indexed_sum",
+        "audit_trail_enabled_hwm": "audit_trail_enabled_hwm",
         "avg_profiled_fargate_tasks": "avg_profiled_fargate_tasks",
         "aws_host_top99p": "aws_host_top99p",
         "aws_lambda_func_count": "aws_lambda_func_count",
@@ -189,6 +191,7 @@ def __init__(
         apm_host_top99p: Union[int, UnsetType] = unset,
         appsec_fargate_count_avg: Union[int, UnsetType] = unset,
         audit_logs_lines_indexed_sum: Union[int, UnsetType] = unset,
+        audit_trail_enabled_hwm: Union[int, UnsetType] = unset,
         avg_profiled_fargate_tasks: Union[int, UnsetType] = unset,
         aws_host_top99p: Union[int, UnsetType] = unset,
         aws_lambda_func_count: Union[int, UnsetType] = unset,
@@ -282,6 +285,9 @@ def __init__(
         :param audit_logs_lines_indexed_sum: Shows the sum of audit logs lines indexed over all hours in the current date for all organizations.
         :type audit_logs_lines_indexed_sum: int, optional
 
+        :param audit_trail_enabled_hwm: Shows the number of organizations that had Audit Trail enabled in the current date.
+        :type audit_trail_enabled_hwm: int, optional
+
         :param avg_profiled_fargate_tasks: The average profiled task count for Fargate Profiling.
         :type avg_profiled_fargate_tasks: int, optional
 
@@ -504,6 +510,8 @@ def __init__(
             kwargs["appsec_fargate_count_avg"] = appsec_fargate_count_avg
         if audit_logs_lines_indexed_sum is not unset:
             kwargs["audit_logs_lines_indexed_sum"] = audit_logs_lines_indexed_sum
+        if audit_trail_enabled_hwm is not unset:
+            kwargs["audit_trail_enabled_hwm"] = audit_trail_enabled_hwm
         if avg_profiled_fargate_tasks is not unset:
             kwargs["avg_profiled_fargate_tasks"] = avg_profiled_fargate_tasks
         if aws_host_top99p is not unset:

src/datadog_api_client/v1/model/usage_summary_date_org.py

@@ -23,6 +23,7 @@ def openapi_types(_):
             "apm_host_top99p": (int,),
             "appsec_fargate_count_avg": (int,),
             "audit_logs_lines_indexed_sum": (int,),
+            "audit_trail_enabled_hwm": (int,),
             "avg_profiled_fargate_tasks": (int,),
             "aws_host_top99p": (int,),
             "aws_lambda_func_count": (int,),
@@ -104,6 +105,7 @@ def openapi_types(_):
         "apm_host_top99p": "apm_host_top99p",
         "appsec_fargate_count_avg": "appsec_fargate_count_avg",
         "audit_logs_lines_indexed_sum": "audit_logs_lines_indexed_sum",
+        "audit_trail_enabled_hwm": "audit_trail_enabled_hwm",
         "avg_profiled_fargate_tasks": "avg_profiled_fargate_tasks",
         "aws_host_top99p": "aws_host_top99p",
         "aws_lambda_func_count": "aws_lambda_func_count",
@@ -186,6 +188,7 @@ def __init__(
         apm_host_top99p: Union[int, UnsetType] = unset,
         appsec_fargate_count_avg: Union[int, UnsetType] = unset,
         audit_logs_lines_indexed_sum: Union[int, UnsetType] = unset,
+        audit_trail_enabled_hwm: Union[int, UnsetType] = unset,
         avg_profiled_fargate_tasks: Union[int, UnsetType] = unset,
         aws_host_top99p: Union[int, UnsetType] = unset,
         aws_lambda_func_count: Union[int, UnsetType] = unset,
@@ -281,6 +284,9 @@ def __init__(
         :param audit_logs_lines_indexed_sum: Shows the sum of all audit logs lines indexed over all hours in the current date for the given org.
         :type audit_logs_lines_indexed_sum: int, optional
 
+        :param audit_trail_enabled_hwm: Shows whether Audit Trail is enabled for the current date for the given org.
+        :type audit_trail_enabled_hwm: int, optional
+
         :param avg_profiled_fargate_tasks: The average profiled task count for Fargate Profiling.
         :type avg_profiled_fargate_tasks: int, optional
 
@@ -509,6 +515,8 @@ def __init__(
             kwargs["appsec_fargate_count_avg"] = appsec_fargate_count_avg
         if audit_logs_lines_indexed_sum is not unset:
             kwargs["audit_logs_lines_indexed_sum"] = audit_logs_lines_indexed_sum
+        if audit_trail_enabled_hwm is not unset:
+            kwargs["audit_trail_enabled_hwm"] = audit_trail_enabled_hwm
         if avg_profiled_fargate_tasks is not unset:
             kwargs["avg_profiled_fargate_tasks"] = avg_profiled_fargate_tasks
         if aws_host_top99p is not unset:

src/datadog_api_client/v1/model/usage_summary_response.py

@@ -32,6 +32,7 @@ def openapi_types(_):
             "apm_host_top99p_sum": (int,),
             "appsec_fargate_count_avg_sum": (int,),
             "audit_logs_lines_indexed_agg_sum": (int,),
+            "audit_trail_enabled_hwm_sum": (int,),
             "avg_profiled_fargate_tasks_sum": (int,),
             "aws_host_top99p_sum": (int,),
             "aws_lambda_func_count": (int,),
@@ -120,6 +121,7 @@ def openapi_types(_):
         "apm_host_top99p_sum": "apm_host_top99p_sum",
         "appsec_fargate_count_avg_sum": "appsec_fargate_count_avg_sum",
         "audit_logs_lines_indexed_agg_sum": "audit_logs_lines_indexed_agg_sum",
+        "audit_trail_enabled_hwm_sum": "audit_trail_enabled_hwm_sum",
         "avg_profiled_fargate_tasks_sum": "avg_profiled_fargate_tasks_sum",
         "aws_host_top99p_sum": "aws_host_top99p_sum",
         "aws_lambda_func_count": "aws_lambda_func_count",
@@ -209,6 +211,7 @@ def __init__(
         apm_host_top99p_sum: Union[int, UnsetType] = unset,
         appsec_fargate_count_avg_sum: Union[int, UnsetType] = unset,
         audit_logs_lines_indexed_agg_sum: Union[int, UnsetType] = unset,
+        audit_trail_enabled_hwm_sum: Union[int, UnsetType] = unset,
         avg_profiled_fargate_tasks_sum: Union[int, UnsetType] = unset,
         aws_host_top99p_sum: Union[int, UnsetType] = unset,
         aws_lambda_func_count: Union[int, UnsetType] = unset,
@@ -311,6 +314,9 @@ def __init__(
         :param audit_logs_lines_indexed_agg_sum: Shows the sum of all audit logs lines indexed over all hours in the current months for all organizations.
         :type audit_logs_lines_indexed_agg_sum: int, optional
 
+        :param audit_trail_enabled_hwm_sum: Shows the total number of organizations that had Audit Trail enabled over a specific number of months.
+        :type audit_trail_enabled_hwm_sum: int, optional
+
         :param avg_profiled_fargate_tasks_sum: Shows the average of all profiled Fargate tasks over all hours in the current months for all organizations.
         :type avg_profiled_fargate_tasks_sum: int, optional
 
@@ -560,6 +566,8 @@ def __init__(
             kwargs["appsec_fargate_count_avg_sum"] = appsec_fargate_count_avg_sum
         if audit_logs_lines_indexed_agg_sum is not unset:
             kwargs["audit_logs_lines_indexed_agg_sum"] = audit_logs_lines_indexed_agg_sum
+        if audit_trail_enabled_hwm_sum is not unset:
+            kwargs["audit_trail_enabled_hwm_sum"] = audit_trail_enabled_hwm_sum
         if avg_profiled_fargate_tasks_sum is not unset:
             kwargs["avg_profiled_fargate_tasks_sum"] = avg_profiled_fargate_tasks_sum
         if aws_host_top99p_sum is not unset:

src/datadog_api_client/v2/api/usage_metering_api.py

@@ -424,7 +424,8 @@ def get_hourly_usage(
         :param filter_timestamp_start: Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh] for usage beginning at this hour.
         :type filter_timestamp_start: datetime
         :param filter_product_families: Comma separated list of product families to retrieve. Available families are ``all`` , ``analyzed_logs`` ,
-            ``application_security`` , ``audit_logs`` , ``serverless`` , ``ci_app`` , ``cloud_cost_management`` , ``cspm`` , ``custom_events`` , ``cws`` , ``dbm`` , ``fargate`` ,
+            ``application_security`` , ``audit_logs`` , ``audit_trail`` , ``serverless`` , ``ci_app`` , ``cloud_cost_management`` ,
+            ``cspm`` , ``custom_events`` , ``cws`` , ``dbm`` , ``fargate`` ,
             ``infra_hosts`` , ``incident_management`` , ``indexed_logs`` , ``indexed_spans`` , ``ingested_spans`` , ``iot`` ,
             ``lambda_traced_invocations`` , ``logs`` , ``network_flows`` , ``network_hosts`` , ``observability_pipelines`` ,
             ``online_archive`` , ``profiling`` , ``rum`` , ``rum_browser_sessions`` , ``rum_mobile_sessions`` , ``sds`` , ``snmp`` ,