Appsec Fargate Public Documentation (#1221)

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>

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2022-10-31 20:12:28.337559",
-            "spec_repo_commit": "420bd229"
+            "regenerated": "2022-11-01 20:07:45.812181",
+            "spec_repo_commit": "deeff34e"
         },
         "v2": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2022-10-31 20:12:28.349174",
-            "spec_repo_commit": "420bd229"
+            "regenerated": "2022-11-01 20:07:45.925680",
+            "spec_repo_commit": "deeff34e"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -3661,6 +3661,7 @@ components:
       - api_usage
       - apm_fargate_usage
       - apm_host_usage
+      - appsec_fargate_usage
       - appsec_usage
       - browser_usage
       - container_usage
@@ -3689,6 +3690,7 @@ components:
       - API_USAGE
       - APM_FARGATE_USAGE
       - APM_HOST_USAGE
+      - APPSEC_FARGATE_USAGE
       - APPSEC_USAGE
       - BROWSER_USAGE
       - CONTAINER_USAGE
@@ -6978,6 +6980,8 @@ components:
       - api_percentage
       - apm_fargate_usage
       - apm_fargate_percentage
+      - appsec_fargate_usage
+      - appsec_fargate_percentage
       - apm_host_usage
       - apm_host_percentage
       - appsec_usage
@@ -7033,6 +7037,8 @@ components:
       - API_PERCENTAGE
       - APM_FARGATE_USAGE
       - APM_FARGATE_PERCENTAGE
+      - APPSEC_FARGATE_USAGE
+      - APPSEC_FARGATE_PERCENTAGE
       - APM_HOST_USAGE
       - APM_HOST_PERCENTAGE
       - APPSEC_USAGE
@@ -7109,6 +7115,16 @@ components:
           description: The APM host usage by tag(s).
           format: double
           type: number
+        appsec_fargate_percentage:
+          description: The percentage of Application Security Monitoring ECS Fargate
+            task usage by tag(s).
+          format: double
+          type: number
+        appsec_fargate_usage:
+          description: The Application Security Monitoring ECS Fargate task usage
+            by tag(s).
+          format: double
+          type: number
         appsec_percentage:
           description: The percentage of Application Security Monitoring host usage
             by tag(s).
@@ -14210,6 +14226,8 @@ components:
       - estimated_ingested_spans_percentage
       - apm_fargate_usage
       - apm_fargate_percentage
+      - appsec_fargate_usage
+      - appsec_fargate_percentage
       type: string
       x-enum-varnames:
       - API_PERCENTAGE
@@ -14244,6 +14262,8 @@ components:
       - ESTIMATED_INGESTED_SPANS_PERCENTAGE
       - APM_FARGATE_USAGE
       - APM_FARGATE_PERCENTAGE
+      - APPSEC_FARGATE_USAGE
+      - APPSEC_FARGATE_PERCENTAGE
     UsageAttributionSupportedMetrics:
       description: Supported fields for usage attribution requests (valid requests
         contain one or more metrics, or `*` for all).
@@ -14290,6 +14310,8 @@ components:
       - estimated_ingested_spans_percentage
       - apm_fargate_usage
       - apm_fargate_percentage
+      - appsec_fargate_usage
+      - appsec_fargate_percentage
       - '*'
       type: string
       x-enum-varnames:
@@ -14335,6 +14357,8 @@ components:
       - ESTIMATED_INGESTED_SPANS_PERCENTAGE
       - APM_FARGATE_USAGE
       - APM_FARGATE_PERCENTAGE
+      - APPSEC_FARGATE_USAGE
+      - APPSEC_FARGATE_PERCENTAGE
       - ALL
     UsageAttributionTagNames:
       additionalProperties:
@@ -14391,6 +14415,16 @@ components:
           description: The APM host usage by tag(s).
           format: double
           type: number
+        appsec_fargate_percentage:
+          description: The percentage of Application Security Monitoring ECS Fargate
+            task usage by tag(s).
+          format: double
+          type: number
+        appsec_fargate_usage:
+          description: The Application Security Monitoring ECS Fargate task usage
+            by tag(s).
+          format: double
+          type: number
         appsec_percentage:
           description: The percentage of Application Security Monitoring host usage
             by tag(s).
@@ -15076,6 +15110,11 @@ components:
             hour.
           format: int64
           type: integer
+        appsec_fargate_count:
+          description: The Application Security Monitoring ECS Fargate tasks during
+            the given hour.
+          format: int64
+          type: integer
         avg_profiled_fargate_tasks:
           description: The average profiled task count for Fargate Profiling.
           format: int64
@@ -15907,6 +15946,11 @@ components:
             hours in the current date for all organizations.
           format: int64
           type: integer
+        appsec_fargate_count_avg:
+          description: Shows the average of all Application Security Monitoring ECS
+            Fargate tasks over all hours in the current date for all organizations.
+          format: int64
+          type: integer
         audit_logs_lines_indexed_sum:
           description: Shows the sum of audit logs lines indexed over all hours in
             the current date for all organizations.
@@ -16257,6 +16301,11 @@ components:
             hours in the current date for the given org.
           format: int64
           type: integer
+        appsec_fargate_count_avg:
+          description: Shows the average of all Application Security Monitoring ECS
+            Fargate tasks over all hours in the current months for the given org.
+          format: int64
+          type: integer
         audit_logs_lines_indexed_sum:
           description: Shows the sum of all audit logs lines indexed over all hours
             in the current date for the given org.
@@ -16610,6 +16659,11 @@ components:
             hours in the current months for all organizations.
           format: int64
           type: integer
+        appsec_fargate_count_avg_sum:
+          description: Shows the average of all Application Security Monitoring ECS
+            Fargate tasks over all hours in the current months for all organizations.
+          format: int64
+          type: integer
         audit_logs_lines_indexed_agg_sum:
           description: Shows the sum of all audit logs lines indexed over all hours
             in the current months for all organizations.

src/datadog_api_client/v1/model/hourly_usage_attribution_usage_type.py

@@ -16,14 +16,15 @@ class HourlyUsageAttributionUsageType(ModelSimple):
     """
     Supported products for hourly usage attribution requests.
 
-    :param value: Must be one of ["api_usage", "apm_fargate_usage", "apm_host_usage", "appsec_usage", "browser_usage", "container_usage", "cspm_containers_usage", "cspm_hosts_usage", "custom_timeseries_usage", "cws_containers_usage", "cws_hosts_usage", "dbm_hosts_usage", "dbm_queries_usage", "estimated_indexed_logs_usage", "estimated_ingested_logs_usage", "estimated_indexed_spans_usage", "estimated_ingested_spans_usage", "fargate_usage", "functions_usage", "indexed_logs_usage", "infra_host_usage", "invocations_usage", "npm_host_usage", "profiled_container_usage", "profiled_host_usage", "snmp_usage"].
+    :param value: Must be one of ["api_usage", "apm_fargate_usage", "apm_host_usage", "appsec_fargate_usage", "appsec_usage", "browser_usage", "container_usage", "cspm_containers_usage", "cspm_hosts_usage", "custom_timeseries_usage", "cws_containers_usage", "cws_hosts_usage", "dbm_hosts_usage", "dbm_queries_usage", "estimated_indexed_logs_usage", "estimated_ingested_logs_usage", "estimated_indexed_spans_usage", "estimated_ingested_spans_usage", "fargate_usage", "functions_usage", "indexed_logs_usage", "infra_host_usage", "invocations_usage", "npm_host_usage", "profiled_container_usage", "profiled_host_usage", "snmp_usage"].
     :type value: str
     """
 
     allowed_values = {
         "api_usage",
         "apm_fargate_usage",
         "apm_host_usage",
+        "appsec_fargate_usage",
         "appsec_usage",
         "browser_usage",
         "container_usage",
@@ -51,6 +52,7 @@ class HourlyUsageAttributionUsageType(ModelSimple):
     API_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
     APM_FARGATE_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
     APM_HOST_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
+    APPSEC_FARGATE_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
     APPSEC_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
     BROWSER_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
     CONTAINER_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
@@ -85,6 +87,7 @@ def openapi_types(_):
 HourlyUsageAttributionUsageType.API_USAGE = HourlyUsageAttributionUsageType("api_usage")
 HourlyUsageAttributionUsageType.APM_FARGATE_USAGE = HourlyUsageAttributionUsageType("apm_fargate_usage")
 HourlyUsageAttributionUsageType.APM_HOST_USAGE = HourlyUsageAttributionUsageType("apm_host_usage")
+HourlyUsageAttributionUsageType.APPSEC_FARGATE_USAGE = HourlyUsageAttributionUsageType("appsec_fargate_usage")
 HourlyUsageAttributionUsageType.APPSEC_USAGE = HourlyUsageAttributionUsageType("appsec_usage")
 HourlyUsageAttributionUsageType.BROWSER_USAGE = HourlyUsageAttributionUsageType("browser_usage")
 HourlyUsageAttributionUsageType.CONTAINER_USAGE = HourlyUsageAttributionUsageType("container_usage")

src/datadog_api_client/v1/model/monthly_usage_attribution_supported_metrics.py

@@ -16,7 +16,7 @@ class MonthlyUsageAttributionSupportedMetrics(ModelSimple):
     """
     Supported metrics for monthly usage attribution requests.
 
-    :param value: Must be one of ["api_usage", "api_percentage", "apm_fargate_usage", "apm_fargate_percentage", "apm_host_usage", "apm_host_percentage", "appsec_usage", "appsec_percentage", "browser_usage", "browser_percentage", "container_usage", "container_percentage", "cspm_containers_percentage", "cspm_containers_usage", "cspm_hosts_percentage", "cspm_hosts_usage", "custom_timeseries_usage", "custom_timeseries_percentage", "cws_containers_percentage", "cws_containers_usage", "cws_hosts_percentage", "cws_hosts_usage", "dbm_hosts_percentage", "dbm_hosts_usage", "dbm_queries_percentage", "dbm_queries_usage", "estimated_indexed_logs_usage", "estimated_indexed_logs_percentage", "estimated_ingested_logs_usage", "estimated_ingested_logs_percentage", "estimated_indexed_spans_usage", "estimated_indexed_spans_percentage", "estimated_ingested_spans_usage", "estimated_ingested_spans_percentage", "fargate_usage", "fargate_percentage", "functions_usage", "functions_percentage", "indexed_logs_usage", "indexed_logs_percentage", "infra_host_usage", "infra_host_percentage", "invocations_usage", "invocations_percentage", "npm_host_usage", "npm_host_percentage", "profiled_container_usage", "profiled_container_percentage", "profiled_host_usage", "profiled_host_percentage", "snmp_usage", "snmp_percentage", "*"].
+    :param value: Must be one of ["api_usage", "api_percentage", "apm_fargate_usage", "apm_fargate_percentage", "appsec_fargate_usage", "appsec_fargate_percentage", "apm_host_usage", "apm_host_percentage", "appsec_usage", "appsec_percentage", "browser_usage", "browser_percentage", "container_usage", "container_percentage", "cspm_containers_percentage", "cspm_containers_usage", "cspm_hosts_percentage", "cspm_hosts_usage", "custom_timeseries_usage", "custom_timeseries_percentage", "cws_containers_percentage", "cws_containers_usage", "cws_hosts_percentage", "cws_hosts_usage", "dbm_hosts_percentage", "dbm_hosts_usage", "dbm_queries_percentage", "dbm_queries_usage", "estimated_indexed_logs_usage", "estimated_indexed_logs_percentage", "estimated_ingested_logs_usage", "estimated_ingested_logs_percentage", "estimated_indexed_spans_usage", "estimated_indexed_spans_percentage", "estimated_ingested_spans_usage", "estimated_ingested_spans_percentage", "fargate_usage", "fargate_percentage", "functions_usage", "functions_percentage", "indexed_logs_usage", "indexed_logs_percentage", "infra_host_usage", "infra_host_percentage", "invocations_usage", "invocations_percentage", "npm_host_usage", "npm_host_percentage", "profiled_container_usage", "profiled_container_percentage", "profiled_host_usage", "profiled_host_percentage", "snmp_usage", "snmp_percentage", "*"].
     :type value: str
     """
 
@@ -25,6 +25,8 @@ class MonthlyUsageAttributionSupportedMetrics(ModelSimple):
         "api_percentage",
         "apm_fargate_usage",
         "apm_fargate_percentage",
+        "appsec_fargate_usage",
+        "appsec_fargate_percentage",
         "apm_host_usage",
         "apm_host_percentage",
         "appsec_usage",
@@ -79,6 +81,8 @@ class MonthlyUsageAttributionSupportedMetrics(ModelSimple):
     API_PERCENTAGE: ClassVar["MonthlyUsageAttributionSupportedMetrics"]
     APM_FARGATE_USAGE: ClassVar["MonthlyUsageAttributionSupportedMetrics"]
     APM_FARGATE_PERCENTAGE: ClassVar["MonthlyUsageAttributionSupportedMetrics"]
+    APPSEC_FARGATE_USAGE: ClassVar["MonthlyUsageAttributionSupportedMetrics"]
+    APPSEC_FARGATE_PERCENTAGE: ClassVar["MonthlyUsageAttributionSupportedMetrics"]
     APM_HOST_USAGE: ClassVar["MonthlyUsageAttributionSupportedMetrics"]
     APM_HOST_PERCENTAGE: ClassVar["MonthlyUsageAttributionSupportedMetrics"]
     APPSEC_USAGE: ClassVar["MonthlyUsageAttributionSupportedMetrics"]
@@ -142,6 +146,12 @@ def openapi_types(_):
 MonthlyUsageAttributionSupportedMetrics.APM_FARGATE_PERCENTAGE = MonthlyUsageAttributionSupportedMetrics(
     "apm_fargate_percentage"
 )
+MonthlyUsageAttributionSupportedMetrics.APPSEC_FARGATE_USAGE = MonthlyUsageAttributionSupportedMetrics(
+    "appsec_fargate_usage"
+)
+MonthlyUsageAttributionSupportedMetrics.APPSEC_FARGATE_PERCENTAGE = MonthlyUsageAttributionSupportedMetrics(
+    "appsec_fargate_percentage"
+)
 MonthlyUsageAttributionSupportedMetrics.APM_HOST_USAGE = MonthlyUsageAttributionSupportedMetrics("apm_host_usage")
 MonthlyUsageAttributionSupportedMetrics.APM_HOST_PERCENTAGE = MonthlyUsageAttributionSupportedMetrics(
     "apm_host_percentage"

src/datadog_api_client/v1/model/monthly_usage_attribution_values.py

@@ -23,6 +23,8 @@ def openapi_types(_):
             "apm_fargate_usage": (float,),
             "apm_host_percentage": (float,),
             "apm_host_usage": (float,),
+            "appsec_fargate_percentage": (float,),
+            "appsec_fargate_usage": (float,),
             "appsec_percentage": (float,),
             "appsec_usage": (float,),
             "browser_percentage": (float,),
@@ -66,6 +68,8 @@ def openapi_types(_):
         "apm_fargate_usage": "apm_fargate_usage",
         "apm_host_percentage": "apm_host_percentage",
         "apm_host_usage": "apm_host_usage",
+        "appsec_fargate_percentage": "appsec_fargate_percentage",
+        "appsec_fargate_usage": "appsec_fargate_usage",
         "appsec_percentage": "appsec_percentage",
         "appsec_usage": "appsec_usage",
         "browser_percentage": "browser_percentage",
@@ -110,6 +114,8 @@ def __init__(
         apm_fargate_usage: Union[float, UnsetType] = unset,
         apm_host_percentage: Union[float, UnsetType] = unset,
         apm_host_usage: Union[float, UnsetType] = unset,
+        appsec_fargate_percentage: Union[float, UnsetType] = unset,
+        appsec_fargate_usage: Union[float, UnsetType] = unset,
         appsec_percentage: Union[float, UnsetType] = unset,
         appsec_usage: Union[float, UnsetType] = unset,
         browser_percentage: Union[float, UnsetType] = unset,
@@ -167,6 +173,12 @@ def __init__(
         :param apm_host_usage: The APM host usage by tag(s).
         :type apm_host_usage: float, optional
 
+        :param appsec_fargate_percentage: The percentage of Application Security Monitoring ECS Fargate task usage by tag(s).
+        :type appsec_fargate_percentage: float, optional
+
+        :param appsec_fargate_usage: The Application Security Monitoring ECS Fargate task usage by tag(s).
+        :type appsec_fargate_usage: float, optional
+
         :param appsec_percentage: The percentage of Application Security Monitoring host usage by tag(s).
         :type appsec_percentage: float, optional
 
@@ -281,6 +293,10 @@ def __init__(
             kwargs["apm_host_percentage"] = apm_host_percentage
         if apm_host_usage is not unset:
             kwargs["apm_host_usage"] = apm_host_usage
+        if appsec_fargate_percentage is not unset:
+            kwargs["appsec_fargate_percentage"] = appsec_fargate_percentage
+        if appsec_fargate_usage is not unset:
+            kwargs["appsec_fargate_usage"] = appsec_fargate_usage
         if appsec_percentage is not unset:
             kwargs["appsec_percentage"] = appsec_percentage
         if appsec_usage is not unset:

src/datadog_api_client/v1/model/usage_attribution_sort.py

@@ -16,7 +16,7 @@ class UsageAttributionSort(ModelSimple):
     """
     The field to sort by.
 
-    :param value: If omitted defaults to "custom_timeseries_usage". Must be one of ["api_percentage", "snmp_usage", "apm_host_usage", "api_usage", "appsec_usage", "appsec_percentage", "container_usage", "custom_timeseries_percentage", "container_percentage", "apm_host_percentage", "npm_host_percentage", "browser_percentage", "browser_usage", "infra_host_percentage", "snmp_percentage", "npm_host_usage", "infra_host_usage", "custom_timeseries_usage", "lambda_functions_usage", "lambda_functions_percentage", "lambda_invocations_usage", "lambda_invocations_percentage", "estimated_indexed_logs_usage", "estimated_indexed_logs_percentage", "estimated_ingested_logs_usage", "estimated_ingested_logs_percentage", "estimated_indexed_spans_usage", "estimated_indexed_spans_percentage", "estimated_ingested_spans_usage", "estimated_ingested_spans_percentage", "apm_fargate_usage", "apm_fargate_percentage"].
+    :param value: If omitted defaults to "custom_timeseries_usage". Must be one of ["api_percentage", "snmp_usage", "apm_host_usage", "api_usage", "appsec_usage", "appsec_percentage", "container_usage", "custom_timeseries_percentage", "container_percentage", "apm_host_percentage", "npm_host_percentage", "browser_percentage", "browser_usage", "infra_host_percentage", "snmp_percentage", "npm_host_usage", "infra_host_usage", "custom_timeseries_usage", "lambda_functions_usage", "lambda_functions_percentage", "lambda_invocations_usage", "lambda_invocations_percentage", "estimated_indexed_logs_usage", "estimated_indexed_logs_percentage", "estimated_ingested_logs_usage", "estimated_ingested_logs_percentage", "estimated_indexed_spans_usage", "estimated_indexed_spans_percentage", "estimated_ingested_spans_usage", "estimated_ingested_spans_percentage", "apm_fargate_usage", "apm_fargate_percentage", "appsec_fargate_usage", "appsec_fargate_percentage"].
     :type value: str
     """
 
@@ -53,6 +53,8 @@ class UsageAttributionSort(ModelSimple):
         "estimated_ingested_spans_percentage",
         "apm_fargate_usage",
         "apm_fargate_percentage",
+        "appsec_fargate_usage",
+        "appsec_fargate_percentage",
     }
     API_PERCENTAGE: ClassVar["UsageAttributionSort"]
     SNMP_USAGE: ClassVar["UsageAttributionSort"]
@@ -86,6 +88,8 @@ class UsageAttributionSort(ModelSimple):
     ESTIMATED_INGESTED_SPANS_PERCENTAGE: ClassVar["UsageAttributionSort"]
     APM_FARGATE_USAGE: ClassVar["UsageAttributionSort"]
     APM_FARGATE_PERCENTAGE: ClassVar["UsageAttributionSort"]
+    APPSEC_FARGATE_USAGE: ClassVar["UsageAttributionSort"]
+    APPSEC_FARGATE_PERCENTAGE: ClassVar["UsageAttributionSort"]
 
     @cached_property
     def openapi_types(_):
@@ -126,3 +130,5 @@ def openapi_types(_):
 UsageAttributionSort.ESTIMATED_INGESTED_SPANS_PERCENTAGE = UsageAttributionSort("estimated_ingested_spans_percentage")
 UsageAttributionSort.APM_FARGATE_USAGE = UsageAttributionSort("apm_fargate_usage")
 UsageAttributionSort.APM_FARGATE_PERCENTAGE = UsageAttributionSort("apm_fargate_percentage")
+UsageAttributionSort.APPSEC_FARGATE_USAGE = UsageAttributionSort("appsec_fargate_usage")
+UsageAttributionSort.APPSEC_FARGATE_PERCENTAGE = UsageAttributionSort("appsec_fargate_percentage")