Update documentation for App Sec SCA (#1710)

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

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

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-07-26 18:27:50.250491",
-            "spec_repo_commit": "7e92b530"
+            "regenerated": "2024-07-26 19:06:12.505492",
+            "spec_repo_commit": "44cf4afe"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-07-26 18:27:50.268852",
-            "spec_repo_commit": "7e92b530"
+            "regenerated": "2024-07-26 19:06:12.524483",
+            "spec_repo_commit": "44cf4afe"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -4216,6 +4216,7 @@ components:
       - profiled_host_usage
       - rum_browser_mobile_sessions_usage
       - rum_replay_sessions_usage
+      - sca_fargate_usage
       - sds_scanned_bytes_usage
       - serverless_apps_usage
       - siem_analyzed_logs_add_on_usage
@@ -4288,6 +4289,7 @@ components:
       - PROFILED_HOST_USAGE
       - RUM_BROWSER_MOBILE_SESSIONS_USAGE
       - RUM_REPLAY_SESSIONS_USAGE
+      - SCA_FARGATE_USAGE
       - SDS_SCANNED_BYTES_USAGE
       - SERVERLESS_APPS_USAGE
       - SIEM_ANALYZED_LOGS_ADD_ON_USAGE
@@ -7991,6 +7993,8 @@ components:
       - siem_ingested_bytes_percentage
       - workflow_executions_usage
       - workflow_executions_percentage
+      - sca_fargate_usage
+      - sca_fargate_percentage
       - '*'
       type: string
       x-enum-varnames:
@@ -8130,6 +8134,8 @@ components:
       - SIEM_INGESTED_BYTES_PERCENTAGE
       - WORKFLOW_EXECUTIONS_USAGE
       - WORKFLOW_EXECUTIONS_PERCENTAGE
+      - SCA_FARGATE_USAGE
+      - SCA_FARGATE_PERCENTAGE
       - ALL
     MonthlyUsageAttributionValues:
       description: Fields in Usage Summary by tag(s).
@@ -8639,6 +8645,16 @@ components:
           description: The total RUM Session Replay usage by tag(s).
           format: double
           type: number
+        sca_fargate_percentage:
+          description: The percentage of Software Composition Analysis Fargate task
+            usage by tag(s).
+          format: double
+          type: number
+        sca_fargate_usage:
+          description: The total Software Composition Analysis Fargate task usage
+            by tag(s).
+          format: double
+          type: number
         sds_scanned_bytes_percentage:
           description: The percentage of Sensitive Data Scanner usage by tag(s).
           format: double
@@ -19256,6 +19272,17 @@ components:
             1st, 2024).
           format: int64
           type: integer
+        sca_fargate_count_avg:
+          description: Shows the average of all Software Composition Analysis Fargate
+            tasks over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        sca_fargate_count_hwm:
+          description: Shows the sum of the high-water marks of all Software Composition
+            Analysis Fargate tasks over all hours in the current date for the given
+            org.
+          format: int64
+          type: integer
         sds_apm_scanned_bytes_sum:
           description: Sum of all APM bytes scanned with sensitive data scanner over
             all hours in the current date for all organizations.
@@ -19964,6 +19991,17 @@ components:
             1st, 2024).
           format: int64
           type: integer
+        sca_fargate_count_avg:
+          description: Shows the average of all Software Composition Analysis Fargate
+            tasks over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        sca_fargate_count_hwm:
+          description: Shows the sum of the high-water marks of all Software Composition
+            Analysis Fargate tasks over all hours in the current date for the given
+            org.
+          format: int64
+          type: integer
         sds_apm_scanned_bytes_sum:
           description: Sum of all APM bytes scanned with sensitive data scanner over
             all hours in the current date for the given org.
@@ -20707,6 +20745,16 @@ components:
             October 1st, 2024).
           format: int64
           type: integer
+        sca_fargate_count_avg_sum:
+          description: Shows the average of all Software Composition Analysis Fargate
+            tasks over all hours in the current months for all organizations.
+          format: int64
+          type: integer
+        sca_fargate_count_hwm_sum:
+          description: Shows the sum of the high-water marks of all Software Composition
+            Analysis Fargate tasks over all hours in the current months for all organizations.
+          format: int64
+          type: integer
         sds_apm_scanned_bytes_sum:
           description: Sum of all APM bytes scanned with sensitive data scanner in
             the current month for all organizations.

packages/datadog-api-client-v1/models/HourlyUsageAttributionUsageType.ts

@@ -73,6 +73,7 @@ export type HourlyUsageAttributionUsageType =
   | typeof PROFILED_HOST_USAGE
   | typeof RUM_BROWSER_MOBILE_SESSIONS_USAGE
   | typeof RUM_REPLAY_SESSIONS_USAGE
+  | typeof SCA_FARGATE_USAGE
   | typeof SDS_SCANNED_BYTES_USAGE
   | typeof SERVERLESS_APPS_USAGE
   | typeof SIEM_ANALYZED_LOGS_ADD_ON_USAGE
@@ -152,6 +153,7 @@ export const PROFILED_HOST_USAGE = "profiled_host_usage";
 export const RUM_BROWSER_MOBILE_SESSIONS_USAGE =
   "rum_browser_mobile_sessions_usage";
 export const RUM_REPLAY_SESSIONS_USAGE = "rum_replay_sessions_usage";
+export const SCA_FARGATE_USAGE = "sca_fargate_usage";
 export const SDS_SCANNED_BYTES_USAGE = "sds_scanned_bytes_usage";
 export const SERVERLESS_APPS_USAGE = "serverless_apps_usage";
 export const SIEM_ANALYZED_LOGS_ADD_ON_USAGE =

packages/datadog-api-client-v1/models/MonthlyUsageAttributionSupportedMetrics.ts

@@ -147,6 +147,8 @@ export type MonthlyUsageAttributionSupportedMetrics =
   | typeof SIEM_INGESTED_BYTES_PERCENTAGE
   | typeof WORKFLOW_EXECUTIONS_USAGE
   | typeof WORKFLOW_EXECUTIONS_PERCENTAGE
+  | typeof SCA_FARGATE_USAGE
+  | typeof SCA_FARGATE_PERCENTAGE
   | typeof ALL
   | UnparsedObject;
 export const API_USAGE = "api_usage";
@@ -312,4 +314,6 @@ export const SIEM_INGESTED_BYTES_USAGE = "siem_ingested_bytes_usage";
 export const SIEM_INGESTED_BYTES_PERCENTAGE = "siem_ingested_bytes_percentage";
 export const WORKFLOW_EXECUTIONS_USAGE = "workflow_executions_usage";
 export const WORKFLOW_EXECUTIONS_PERCENTAGE = "workflow_executions_percentage";
+export const SCA_FARGATE_USAGE = "sca_fargate_usage";
+export const SCA_FARGATE_PERCENTAGE = "sca_fargate_percentage";
 export const ALL = "*";

packages/datadog-api-client-v1/models/MonthlyUsageAttributionValues.ts

@@ -490,6 +490,14 @@ export class MonthlyUsageAttributionValues {
    * The total RUM Session Replay usage by tag(s).
    */
   "rumReplaySessionsUsage"?: number;
+  /**
+   * The percentage of Software Composition Analysis Fargate task usage by tag(s).
+   */
+  "scaFargatePercentage"?: number;
+  /**
+   * The total Software Composition Analysis Fargate task usage by tag(s).
+   */
+  "scaFargateUsage"?: number;
   /**
    * The percentage of Sensitive Data Scanner usage by tag(s).
    */
@@ -1171,6 +1179,16 @@ export class MonthlyUsageAttributionValues {
       type: "number",
       format: "double",
     },
+    scaFargatePercentage: {
+      baseName: "sca_fargate_percentage",
+      type: "number",
+      format: "double",
+    },
+    scaFargateUsage: {
+      baseName: "sca_fargate_usage",
+      type: "number",
+      format: "double",
+    },
     sdsScannedBytesPercentage: {
       baseName: "sds_scanned_bytes_percentage",
       type: "number",

packages/datadog-api-client-v1/models/ObjectSerializer.ts

@@ -831,6 +831,7 @@ const enumsMap: { [key: string]: any[] } = {
     "profiled_host_usage",
     "rum_browser_mobile_sessions_usage",
     "rum_replay_sessions_usage",
+    "sca_fargate_usage",
     "sds_scanned_bytes_usage",
     "serverless_apps_usage",
     "siem_analyzed_logs_add_on_usage",
@@ -1104,6 +1105,8 @@ const enumsMap: { [key: string]: any[] } = {
     "siem_ingested_bytes_percentage",
     "workflow_executions_usage",
     "workflow_executions_percentage",
+    "sca_fargate_usage",
+    "sca_fargate_percentage",
     "*",
   ],
   NoteWidgetDefinitionType: ["note"],

packages/datadog-api-client-v1/models/UsageSummaryDate.ts

@@ -443,6 +443,14 @@ export class UsageSummaryDate {
    * Shows the sum of all browser and mobile RUM units over all hours in the current date for all organizations (To be deprecated on October 1st, 2024).
    */
   "rumUnitsSum"?: number;
+  /**
+   * Shows the average of all Software Composition Analysis Fargate tasks over all hours in the current date for the given org.
+   */
+  "scaFargateCountAvg"?: number;
+  /**
+   * Shows the sum of the high-water marks of all Software Composition Analysis Fargate tasks over all hours in the current date for the given org.
+   */
+  "scaFargateCountHwm"?: number;
   /**
    * Sum of all APM bytes scanned with sensitive data scanner over all hours in the current date for all organizations.
    */
@@ -1075,6 +1083,16 @@ export class UsageSummaryDate {
       type: "number",
       format: "int64",
     },
+    scaFargateCountAvg: {
+      baseName: "sca_fargate_count_avg",
+      type: "number",
+      format: "int64",
+    },
+    scaFargateCountHwm: {
+      baseName: "sca_fargate_count_hwm",
+      type: "number",
+      format: "int64",
+    },
     sdsApmScannedBytesSum: {
       baseName: "sds_apm_scanned_bytes_sum",
       type: "number",

packages/datadog-api-client-v1/models/UsageSummaryDateOrg.ts

@@ -466,6 +466,14 @@ export class UsageSummaryDateOrg {
    * Shows the sum of all browser and mobile RUM units over all hours in the current date for the given org (To be deprecated on October 1st, 2024).
    */
   "rumUnitsSum"?: number;
+  /**
+   * Shows the average of all Software Composition Analysis Fargate tasks over all hours in the current date for the given org.
+   */
+  "scaFargateCountAvg"?: number;
+  /**
+   * Shows the sum of the high-water marks of all Software Composition Analysis Fargate tasks over all hours in the current date for the given org.
+   */
+  "scaFargateCountHwm"?: number;
   /**
    * Sum of all APM bytes scanned with sensitive data scanner over all hours in the current date for the given org.
    */
@@ -1123,6 +1131,16 @@ export class UsageSummaryDateOrg {
       type: "number",
       format: "int64",
     },
+    scaFargateCountAvg: {
+      baseName: "sca_fargate_count_avg",
+      type: "number",
+      format: "int64",
+    },
+    scaFargateCountHwm: {
+      baseName: "sca_fargate_count_hwm",
+      type: "number",
+      format: "int64",
+    },
     sdsApmScannedBytesSum: {
       baseName: "sds_apm_scanned_bytes_sum",
       type: "number",

packages/datadog-api-client-v1/models/UsageSummaryResponse.ts

@@ -480,6 +480,14 @@ export class UsageSummaryResponse {
    * Shows the sum of all browser and mobile RUM units over all hours in the current month for all organizations (To be deprecated on October 1st, 2024).
    */
   "rumUnitsAggSum"?: number;
+  /**
+   * Shows the average of all Software Composition Analysis Fargate tasks over all hours in the current months for all organizations.
+   */
+  "scaFargateCountAvgSum"?: number;
+  /**
+   * Shows the sum of the high-water marks of all Software Composition Analysis Fargate tasks over all hours in the current months for all organizations.
+   */
+  "scaFargateCountHwmSum"?: number;
   /**
    * Sum of all APM bytes scanned with sensitive data scanner in the current month for all organizations.
    */
@@ -1165,6 +1173,16 @@ export class UsageSummaryResponse {
       type: "number",
       format: "int64",
     },
+    scaFargateCountAvgSum: {
+      baseName: "sca_fargate_count_avg_sum",
+      type: "number",
+      format: "int64",
+    },
+    scaFargateCountHwmSum: {
+      baseName: "sca_fargate_count_hwm_sum",
+      type: "number",
+      format: "int64",
+    },
     sdsApmScannedBytesSum: {
       baseName: "sds_apm_scanned_bytes_sum",
       type: "number",