Update public docs for CSM Enterprise and CSPM (#1664)

Co-authored-by: ci.datadog-api-spec <[email protected]>
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.6",
-            "regenerated": "2023-09-22 15:04:35.073309",
-            "spec_repo_commit": "61ae9703"
+            "regenerated": "2023-09-22 16:26:43.981290",
+            "spec_repo_commit": "45270a3e"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2023-09-22 15:04:35.095240",
-            "spec_repo_commit": "61ae9703"
+            "regenerated": "2023-09-22 16:26:43.995673",
+            "spec_repo_commit": "45270a3e"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -27121,7 +27121,8 @@ paths:
 
           `application_security`, `audit_trail`, `serverless`, `ci_app`, `cloud_cost_management`,
 
-          `cspm`, `custom_events`, `cws`, `dbm`, `fargate`,
+          `csm_container_enterprise`, `csm_host_enterprise`, `cspm`, `custom_events`,
+          `cws`, `dbm`, `fargate`,
 
           `infra_hosts`, `incident_management`, `indexed_logs`, `indexed_spans`, `ingested_spans`,
           `iot`,

.generator/schemas/v2/openapi.yaml

@@ -1,5 +1,5 @@
 """
-Get hourly usage for CSPM returns "OK" response
+Get hourly usage for CSM Pro returns "OK" response
 """
 
 from datetime import datetime

examples/v1/usage-metering/GetUsageCloudSecurityPostureManagement.py

@@ -1743,9 +1743,9 @@ def get_usage_cloud_security_posture_management(
         *,
         end_hr: Union[datetime, UnsetType] = unset,
     ) -> UsageCloudSecurityPostureManagementResponse:
-        """Get hourly usage for CSPM.
+        """Get hourly usage for CSM Pro.
 
-        Get hourly usage for cloud security posture management (CSPM).
+        Get hourly usage for cloud security management (CSM) pro.
         **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.
 
         :param start_hr: Datetime in ISO-8601 format, UTC, precise to hour: ``[YYYY-MM-DDThh]`` for usage beginning at this hour.

src/datadog_api_client/v1/api/usage_metering_api.py

@@ -311,16 +311,16 @@ def __init__(
         :param container_usage: The container usage by tag(s).
         :type container_usage: float, optional
 
-        :param cspm_containers_percentage: The percentage of CSPM container usage by tag(s).
+        :param cspm_containers_percentage: The percentage of Cloud Security Management Pro container usage by tag(s).
         :type cspm_containers_percentage: float, optional
 
-        :param cspm_containers_usage: The CSPM container usage by tag(s).
+        :param cspm_containers_usage: The Cloud Security Management Pro container usage by tag(s).
         :type cspm_containers_usage: float, optional
 
-        :param cspm_hosts_percentage: The percentage of CSPM host usage by by tag(s).
+        :param cspm_hosts_percentage: The percentage of Cloud Security Management Pro host usage by tag(s).
         :type cspm_hosts_percentage: float, optional
 
-        :param cspm_hosts_usage: The CSPM host usage by tag(s).
+        :param cspm_hosts_usage: The Cloud Security Management Pro host usage by tag(s).
         :type cspm_hosts_usage: float, optional
 
         :param custom_ingested_timeseries_percentage: The percentage of ingested custom metrics usage by tag(s).

src/datadog_api_client/v1/model/monthly_usage_attribution_values.py

@@ -227,16 +227,16 @@ def __init__(
         :param container_usage: The container usage by tag(s).
         :type container_usage: float, optional
 
-        :param cspm_container_percentage: The percentage of Cloud Security Posture Management container usage by tag(s)
+        :param cspm_container_percentage: The percentage of Cloud Security Management Pro container usage by tag(s)
         :type cspm_container_percentage: float, optional
 
-        :param cspm_container_usage: The Cloud Security Posture Management container usage by tag(s)
+        :param cspm_container_usage: The Cloud Security Management Pro container usage by tag(s)
         :type cspm_container_usage: float, optional
 
-        :param cspm_host_percentage: The percentage of Cloud Security Posture Management host usage by tag(s)
+        :param cspm_host_percentage: The percentage of Cloud Security Management Pro host usage by tag(s)
         :type cspm_host_percentage: float, optional
 
-        :param cspm_host_usage: The Cloud Security Posture Management host usage by tag(s)
+        :param cspm_host_usage: The Cloud Security Management Pro host usage by tag(s)
         :type cspm_host_usage: float, optional
 
         :param custom_timeseries_percentage: The percentage of custom metrics usage by tag(s).

src/datadog_api_client/v1/model/usage_attribution_values.py

@@ -59,27 +59,27 @@ def __init__(
         **kwargs,
     ):
         """
-        Cloud Security Posture Management usage for a given organization for a given hour.
+        Cloud Security Management Pro usage for a given organization for a given hour.
 
-        :param aas_host_count: The number of Cloud Security Posture Management Azure app services hosts during a given hour.
+        :param aas_host_count: The number of Cloud Security Management Pro Azure app services hosts during a given hour.
         :type aas_host_count: float, none_type, optional
 
-        :param aws_host_count: The number of Cloud Security Posture Management AWS hosts during a given hour.
+        :param aws_host_count: The number of Cloud Security Management Pro AWS hosts during a given hour.
         :type aws_host_count: float, none_type, optional
 
-        :param azure_host_count: The number of Cloud Security Posture Management Azure hosts during a given hour.
+        :param azure_host_count: The number of Cloud Security Management Pro Azure hosts during a given hour.
         :type azure_host_count: float, none_type, optional
 
-        :param compliance_host_count: The number of Cloud Security Posture Management hosts during a given hour.
+        :param compliance_host_count: The number of Cloud Security Management Pro hosts during a given hour.
         :type compliance_host_count: float, none_type, optional
 
-        :param container_count: The total number of Cloud Security Posture Management containers during a given hour.
+        :param container_count: The total number of Cloud Security Management Pro containers during a given hour.
         :type container_count: float, none_type, optional
 
-        :param gcp_host_count: The number of Cloud Security Posture Management GCP hosts during a given hour.
+        :param gcp_host_count: The number of Cloud Security Management Pro GCP hosts during a given hour.
         :type gcp_host_count: float, none_type, optional
 
-        :param host_count: The total number of Cloud Security Posture Management hosts during a given hour.
+        :param host_count: The total number of Cloud Security Management Pro hosts during a given hour.
         :type host_count: float, none_type, optional
 
         :param hour: The hour for the usage.

src/datadog_api_client/v1/model/usage_cloud_security_posture_management_hour.py

@@ -36,9 +36,9 @@ def openapi_types(_):
 
     def __init__(self_, usage: Union[List[UsageCloudSecurityPostureManagementHour], UnsetType] = unset, **kwargs):
         """
-        The response containing the Cloud Security Posture Management usage for each hour for a given organization.
+        The response containing the Cloud Security Management Pro usage for each hour for a given organization.
 
-        :param usage: Get hourly usage for Cloud Security Posture Management.
+        :param usage: Get hourly usage for Cloud Security Management Pro.
         :type usage: [UsageCloudSecurityPostureManagementHour], optional
         """
         if usage is not unset:

src/datadog_api_client/v1/model/usage_cloud_security_posture_management_response.py

@@ -51,6 +51,16 @@ def openapi_types(_):
             "container_avg": (int,),
             "container_excl_agent_avg": (int,),
             "container_hwm": (int,),
+            "csm_container_enterprise_compliance_count_sum": (int,),
+            "csm_container_enterprise_cws_count_sum": (int,),
+            "csm_container_enterprise_total_count_sum": (int,),
+            "csm_host_enterprise_aas_host_count_top99p": (int,),
+            "csm_host_enterprise_aws_host_count_top99p": (int,),
+            "csm_host_enterprise_azure_host_count_top99p": (int,),
+            "csm_host_enterprise_compliance_host_count_top99p": (int,),
+            "csm_host_enterprise_cws_host_count_top99p": (int,),
+            "csm_host_enterprise_gcp_host_count_top99p": (int,),
+            "csm_host_enterprise_total_host_count_top99p": (int,),
             "cspm_aas_host_top99p": (int,),
             "cspm_aws_host_top99p": (int,),
             "cspm_azure_host_top99p": (int,),
@@ -141,6 +151,16 @@ def openapi_types(_):
         "container_avg": "container_avg",
         "container_excl_agent_avg": "container_excl_agent_avg",
         "container_hwm": "container_hwm",
+        "csm_container_enterprise_compliance_count_sum": "csm_container_enterprise_compliance_count_sum",
+        "csm_container_enterprise_cws_count_sum": "csm_container_enterprise_cws_count_sum",
+        "csm_container_enterprise_total_count_sum": "csm_container_enterprise_total_count_sum",
+        "csm_host_enterprise_aas_host_count_top99p": "csm_host_enterprise_aas_host_count_top99p",
+        "csm_host_enterprise_aws_host_count_top99p": "csm_host_enterprise_aws_host_count_top99p",
+        "csm_host_enterprise_azure_host_count_top99p": "csm_host_enterprise_azure_host_count_top99p",
+        "csm_host_enterprise_compliance_host_count_top99p": "csm_host_enterprise_compliance_host_count_top99p",
+        "csm_host_enterprise_cws_host_count_top99p": "csm_host_enterprise_cws_host_count_top99p",
+        "csm_host_enterprise_gcp_host_count_top99p": "csm_host_enterprise_gcp_host_count_top99p",
+        "csm_host_enterprise_total_host_count_top99p": "csm_host_enterprise_total_host_count_top99p",
         "cspm_aas_host_top99p": "cspm_aas_host_top99p",
         "cspm_aws_host_top99p": "cspm_aws_host_top99p",
         "cspm_azure_host_top99p": "cspm_azure_host_top99p",
@@ -232,6 +252,16 @@ def __init__(
         container_avg: Union[int, UnsetType] = unset,
         container_excl_agent_avg: Union[int, UnsetType] = unset,
         container_hwm: Union[int, UnsetType] = unset,
+        csm_container_enterprise_compliance_count_sum: Union[int, UnsetType] = unset,
+        csm_container_enterprise_cws_count_sum: Union[int, UnsetType] = unset,
+        csm_container_enterprise_total_count_sum: Union[int, UnsetType] = unset,
+        csm_host_enterprise_aas_host_count_top99p: Union[int, UnsetType] = unset,
+        csm_host_enterprise_aws_host_count_top99p: Union[int, UnsetType] = unset,
+        csm_host_enterprise_azure_host_count_top99p: Union[int, UnsetType] = unset,
+        csm_host_enterprise_compliance_host_count_top99p: Union[int, UnsetType] = unset,
+        csm_host_enterprise_cws_host_count_top99p: Union[int, UnsetType] = unset,
+        csm_host_enterprise_gcp_host_count_top99p: Union[int, UnsetType] = unset,
+        csm_host_enterprise_total_host_count_top99p: Union[int, UnsetType] = unset,
         cspm_aas_host_top99p: Union[int, UnsetType] = unset,
         cspm_aws_host_top99p: Union[int, UnsetType] = unset,
         cspm_azure_host_top99p: Union[int, UnsetType] = unset,
@@ -378,25 +408,55 @@ def __init__(
         :param container_hwm: Shows the high-water mark of all distinct containers over all hours in the current date for all organizations.
         :type container_hwm: int, optional
 
-        :param cspm_aas_host_top99p: Shows the 99th percentile of all Cloud Security Posture Management Azure app services hosts over all hours in the current date for all organizations.
+        :param csm_container_enterprise_compliance_count_sum: Shows the sum of all Cloud Security Management Enterprise compliance containers over all hours in the current date for the given org.
+        :type csm_container_enterprise_compliance_count_sum: int, optional
+
+        :param csm_container_enterprise_cws_count_sum: Shows the sum of all Cloud Security Management Enterprise Cloud Workload Security containers over all hours in the current date for the given org.
+        :type csm_container_enterprise_cws_count_sum: int, optional
+
+        :param csm_container_enterprise_total_count_sum: Shows the sum of all Cloud Security Management Enterprise containers over all hours in the current date for the given org.
+        :type csm_container_enterprise_total_count_sum: int, optional
+
+        :param csm_host_enterprise_aas_host_count_top99p: Shows the 99th percentile of all Cloud Security Management Enterprise Azure app services hosts over all hours in the current date for the given org.
+        :type csm_host_enterprise_aas_host_count_top99p: int, optional
+
+        :param csm_host_enterprise_aws_host_count_top99p: Shows the 99th percentile of all Cloud Security Management Enterprise AWS hosts over all hours in the current date for the given org.
+        :type csm_host_enterprise_aws_host_count_top99p: int, optional
+
+        :param csm_host_enterprise_azure_host_count_top99p: Shows the 99th percentile of all Cloud Security Management Enterprise Azure hosts over all hours in the current date for the given org.
+        :type csm_host_enterprise_azure_host_count_top99p: int, optional
+
+        :param csm_host_enterprise_compliance_host_count_top99p: Shows the 99th percentile of all Cloud Security Management Enterprise compliance hosts over all hours in the current date for the given org.
+        :type csm_host_enterprise_compliance_host_count_top99p: int, optional
+
+        :param csm_host_enterprise_cws_host_count_top99p: Shows the 99th percentile of all Cloud Security Management Enterprise Cloud Workload Security hosts over all hours in the current date for the given org.
+        :type csm_host_enterprise_cws_host_count_top99p: int, optional
+
+        :param csm_host_enterprise_gcp_host_count_top99p: Shows the 99th percentile of all Cloud Security Management Enterprise GCP hosts over all hours in the current date for the given org.
+        :type csm_host_enterprise_gcp_host_count_top99p: int, optional
+
+        :param csm_host_enterprise_total_host_count_top99p: Shows the 99th percentile of all Cloud Security Management Enterprise hosts over all hours in the current date for the given org.
+        :type csm_host_enterprise_total_host_count_top99p: int, optional
+
+        :param cspm_aas_host_top99p: Shows the 99th percentile of all Cloud Security Management Pro Azure app services hosts over all hours in the current date for all organizations.
         :type cspm_aas_host_top99p: int, optional
 
-        :param cspm_aws_host_top99p: Shows the 99th percentile of all Cloud Security Posture Management AWS hosts over all hours in the current date for all organizations.
+        :param cspm_aws_host_top99p: Shows the 99th percentile of all Cloud Security Management Pro AWS hosts over all hours in the current date for all organizations.
         :type cspm_aws_host_top99p: int, optional
 
-        :param cspm_azure_host_top99p: Shows the 99th percentile of all Cloud Security Posture Management Azure hosts over all hours in the current date for all organizations.
+        :param cspm_azure_host_top99p: Shows the 99th percentile of all Cloud Security Management Pro Azure hosts over all hours in the current date for all organizations.
         :type cspm_azure_host_top99p: int, optional
 
-        :param cspm_container_avg: Shows the average number of Cloud Security Posture Management containers over all hours in the current date for all organizations.
+        :param cspm_container_avg: Shows the average number of Cloud Security Management Pro containers over all hours in the current date for all organizations.
         :type cspm_container_avg: int, optional
 
-        :param cspm_container_hwm: Shows the high-water mark of Cloud Security Posture Management containers over all hours in the current date for all organizations.
+        :param cspm_container_hwm: Shows the high-water mark of Cloud Security Management Pro containers over all hours in the current date for all organizations.
         :type cspm_container_hwm: int, optional
 
-        :param cspm_gcp_host_top99p: Shows the 99th percentile of all Cloud Security Posture Management GCP hosts over all hours in the current date for all organizations.
+        :param cspm_gcp_host_top99p: Shows the 99th percentile of all Cloud Security Management Pro GCP hosts over all hours in the current date for all organizations.
         :type cspm_gcp_host_top99p: int, optional
 
-        :param cspm_host_top99p: Shows the 99th percentile of all Cloud Security Posture Management hosts over all hours in the current date for all organizations.
+        :param cspm_host_top99p: Shows the 99th percentile of all Cloud Security Management Pro hosts over all hours in the current date for all organizations.
         :type cspm_host_top99p: int, optional
 
         :param custom_ts_avg: Shows the average number of distinct custom metrics over all hours in the current date for all organizations.
@@ -612,6 +672,28 @@ def __init__(
             kwargs["container_excl_agent_avg"] = container_excl_agent_avg
         if container_hwm is not unset:
             kwargs["container_hwm"] = container_hwm
+        if csm_container_enterprise_compliance_count_sum is not unset:
+            kwargs["csm_container_enterprise_compliance_count_sum"] = csm_container_enterprise_compliance_count_sum
+        if csm_container_enterprise_cws_count_sum is not unset:
+            kwargs["csm_container_enterprise_cws_count_sum"] = csm_container_enterprise_cws_count_sum
+        if csm_container_enterprise_total_count_sum is not unset:
+            kwargs["csm_container_enterprise_total_count_sum"] = csm_container_enterprise_total_count_sum
+        if csm_host_enterprise_aas_host_count_top99p is not unset:
+            kwargs["csm_host_enterprise_aas_host_count_top99p"] = csm_host_enterprise_aas_host_count_top99p
+        if csm_host_enterprise_aws_host_count_top99p is not unset:
+            kwargs["csm_host_enterprise_aws_host_count_top99p"] = csm_host_enterprise_aws_host_count_top99p
+        if csm_host_enterprise_azure_host_count_top99p is not unset:
+            kwargs["csm_host_enterprise_azure_host_count_top99p"] = csm_host_enterprise_azure_host_count_top99p
+        if csm_host_enterprise_compliance_host_count_top99p is not unset:
+            kwargs[
+                "csm_host_enterprise_compliance_host_count_top99p"
+            ] = csm_host_enterprise_compliance_host_count_top99p
+        if csm_host_enterprise_cws_host_count_top99p is not unset:
+            kwargs["csm_host_enterprise_cws_host_count_top99p"] = csm_host_enterprise_cws_host_count_top99p
+        if csm_host_enterprise_gcp_host_count_top99p is not unset:
+            kwargs["csm_host_enterprise_gcp_host_count_top99p"] = csm_host_enterprise_gcp_host_count_top99p
+        if csm_host_enterprise_total_host_count_top99p is not unset:
+            kwargs["csm_host_enterprise_total_host_count_top99p"] = csm_host_enterprise_total_host_count_top99p
         if cspm_aas_host_top99p is not unset:
             kwargs["cspm_aas_host_top99p"] = cspm_aas_host_top99p
         if cspm_aws_host_top99p is not unset: