Deprecate audit logs usage (#1411)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>
Co-authored-by: api-clients-generation-pipeline[bot] <54105614+api-clients-generation-pipeline[bot]@users.noreply.github.com>

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

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2023-04-11 13:58:25.676584",
-            "spec_repo_commit": "27919220"
+            "regenerated": "2023-04-11 20:40:39.976360",
+            "spec_repo_commit": "9b02c84d"
         },
         "v2": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2023-04-11 13:58:25.694170",
-            "spec_repo_commit": "27919220"
+            "regenerated": "2023-04-11 20:40:39.989307",
+            "spec_repo_commit": "9b02c84d"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -16763,6 +16763,7 @@ components:
           format: int64
           type: integer
         audit_logs_lines_indexed_sum:
+          deprecated: true
           description: Shows the sum of audit logs lines indexed over all hours in
             the current date for all organizations.
           format: int64
@@ -17164,6 +17165,7 @@ components:
           format: int64
           type: integer
         audit_logs_lines_indexed_sum:
+          deprecated: true
           description: Shows the sum of all audit logs lines indexed over all hours
             in the current date for the given org.
           format: int64
@@ -17568,6 +17570,7 @@ components:
           format: int64
           type: integer
         audit_logs_lines_indexed_agg_sum:
+          deprecated: true
           description: Shows the sum of all audit logs lines indexed over all hours
             in the current months for all organizations.
           format: int64
@@ -28073,12 +28076,10 @@ paths:
       - Usage Metering
   /api/v1/usage/audit_logs:
     get:
+      deprecated: true
       description: 'Get hourly usage for audit logs.
 
-        **Note:** hourly usage data for all products is now available in the [Get
-        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
-        Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
-        for the associated migration guide.'
+        **Note:** This endpoint has been deprecated.'
       operationId: GetUsageAuditLogs
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`

.generator/schemas/v2/openapi.yaml

@@ -23154,8 +23154,7 @@ paths:
       - description: 'Comma separated list of product families to retrieve. Available
           families are `all`, `analyzed_logs`,
 
-          `application_security`, `audit_logs`, `audit_trail`, `serverless`, `ci_app`,
-          `cloud_cost_management`,
+          `application_security`, `audit_trail`, `serverless`, `ci_app`, `cloud_cost_management`,
 
           `cspm`, `custom_events`, `cws`, `dbm`, `fargate`,
 
@@ -23168,7 +23167,9 @@ paths:
           `sds`, `snmp`,
 
           `synthetics_api`, `synthetics_browser`, `synthetics_parallel_testing`, and
-          `timeseries`.'
+          `timeseries`.
+
+          The following product family has been **deprecated**: `audit_logs`.'
         in: query
         name: filter[product_families]
         required: true

src/datadog_api_client/v1/api/usage_metering_api.py

@@ -1747,10 +1747,10 @@ def get_usage_audit_logs(
         *,
         end_hr: Union[datetime, UnsetType] = unset,
     ) -> UsageAuditLogsResponse:
-        """Get hourly usage for audit logs.
+        """Get hourly usage for audit logs. **Deprecated**.
 
         Get hourly usage for audit logs.
-        **Note:** hourly usage data for all products is now available in the `Get hourly usage by product family API <https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family>`_. Refer to `Migrating from the V1 Hourly Usage APIs to V2 <https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/>`_ for the associated migration guide.
+        **Note:** This endpoint has been deprecated.
 
         :param start_hr: Datetime in ISO-8601 format, UTC, precise to hour: ``[YYYY-MM-DDThh]`` for usage beginning at this hour.
         :type start_hr: datetime
@@ -1765,6 +1765,7 @@ def get_usage_audit_logs(
         if end_hr is not unset:
             kwargs["end_hr"] = end_hr
 
+        warnings.warn("get_usage_audit_logs is deprecated", DeprecationWarning, stacklevel=2)
         return self._get_usage_audit_logs_endpoint.call_with_http_info(**kwargs)
 
     def get_usage_billable_summary(

src/datadog_api_client/v1/model/usage_summary_date.py

@@ -288,7 +288,7 @@ def __init__(
         :param appsec_fargate_count_avg: Shows the average of all Application Security Monitoring ECS Fargate tasks over all hours in the current date for all organizations.
         :type appsec_fargate_count_avg: int, optional
 
-        :param audit_logs_lines_indexed_sum: Shows the sum of audit logs lines indexed over all hours in the current date for all organizations.
+        :param audit_logs_lines_indexed_sum: Shows the sum of audit logs lines indexed over all hours in the current date for all organizations. **Deprecated**.
         :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.

src/datadog_api_client/v1/model/usage_summary_date_org.py

@@ -287,7 +287,7 @@ def __init__(
         :param appsec_fargate_count_avg: Shows the average of all Application Security Monitoring ECS Fargate tasks over all hours in the current months for the given org.
         :type appsec_fargate_count_avg: int, optional
 
-        :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.
+        :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. **Deprecated**.
         :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.

src/datadog_api_client/v1/model/usage_summary_response.py

@@ -317,7 +317,7 @@ def __init__(
         :param appsec_fargate_count_avg_sum: Shows the average of all Application Security Monitoring ECS Fargate tasks over all hours in the current months for all organizations.
         :type appsec_fargate_count_avg_sum: int, optional
 
-        :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.
+        :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. **Deprecated**.
         :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.

src/datadog_api_client/v2/api/usage_metering_api.py

@@ -424,12 +424,13 @@ 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`` , ``audit_trail`` , ``serverless`` , ``ci_app`` , ``cloud_cost_management`` ,
+            ``application_security`` , ``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`` ,
             ``synthetics_api`` , ``synthetics_browser`` , ``synthetics_parallel_testing`` , and ``timeseries``.
+            The following product family has been **deprecated** : ``audit_logs``.
         :type filter_product_families: str
         :param filter_timestamp_end: Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh] for usage ending **before** this hour.
         :type filter_timestamp_end: datetime, optional