Regenerate client from commit 71a3f57 of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v2/openapi.yaml

@@ -1699,6 +1699,15 @@ components:
       required: true
       schema:
         type: string
+    SecurityMonitoringRuleVersion:
+      description: The historical version number of the rule.
+      in: path
+      name: version
+      required: true
+      schema:
+        example: 1
+        format: int64
+        type: integer
     SecurityMonitoringSuppressionID:
       description: The ID of the suppression rule
       in: path
@@ -28735,6 +28744,31 @@ components:
         - bucket_name
         - bucket_region
       type: object
+    DataObservabilityMonitorRunStatus:
+      description: The status of a data observability monitor run.
+      enum:
+        - pending
+        - ok
+        - warn
+        - alert
+        - error
+      example: pending
+      type: string
+      x-enum-varnames:
+        - PENDING
+        - OK
+        - WARN
+        - ALERT
+        - ERROR
+    DataObservabilityMonitorRunType:
+      default: monitor_run
+      description: The JSON:API resource type for a data observability monitor run.
+      enum:
+        - monitor_run
+      example: monitor_run
+      type: string
+      x-enum-varnames:
+        - MONITOR_RUN
     DataRelationshipsTeams:
       description: Associates teams with this schedule in a data structure.
       properties:
@@ -39045,6 +39079,42 @@ components:
         meta:
           $ref: "#/components/schemas/DataDeletionResponseMeta"
       type: object
+    GetDataObservabilityMonitorRunStatusResponse:
+      description: The response for getting the status of a data observability monitor run.
+      properties:
+        data:
+          $ref: "#/components/schemas/GetDataObservabilityMonitorRunStatusResponseData"
+      required:
+        - data
+      type: object
+    GetDataObservabilityMonitorRunStatusResponseAttributes:
+      description: The attributes of a data observability monitor run status response.
+      properties:
+        error_message:
+          description: Error message describing why the monitor run failed. Only present when status is error.
+          example: "run completed but produced no metric data"
+          type: string
+        status:
+          $ref: "#/components/schemas/DataObservabilityMonitorRunStatus"
+      required:
+        - status
+      type: object
+    GetDataObservabilityMonitorRunStatusResponseData:
+      description: The data object for a data observability monitor run status response.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/GetDataObservabilityMonitorRunStatusResponseAttributes"
+        id:
+          description: The unique identifier of the monitor run.
+          example: "abc123def456"
+          type: string
+        type:
+          $ref: "#/components/schemas/DataObservabilityMonitorRunType"
+      required:
+        - id
+        - type
+        - attributes
+      type: object
     GetDeviceAttributes:
       description: The device attributes
       properties:
@@ -77898,6 +77968,27 @@ components:
             $ref: "#/components/schemas/RumRetentionFilterData"
           type: array
       type: object
+    RunDataObservabilityMonitorResponse:
+      description: The response returned when a data observability monitor run is triggered.
+      properties:
+        data:
+          $ref: "#/components/schemas/RunDataObservabilityMonitorResponseData"
+      required:
+        - data
+      type: object
+    RunDataObservabilityMonitorResponseData:
+      description: The data object returned when a data observability monitor run is triggered.
+      properties:
+        id:
+          description: The unique identifier of the monitor run.
+          example: "abc123def456"
+          type: string
+        type:
+          $ref: "#/components/schemas/DataObservabilityMonitorRunType"
+      required:
+        - id
+        - type
+      type: object
     RunHistoricalJobRequest:
       description: Run a historical job request.
       properties:
@@ -124777,6 +124868,105 @@ paths:
       x-unstable: |-
         **Note**: This endpoint is in preview and is subject to change.
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
+  /api/v2/data-observability/monitors/runs/{run_id}/status:
+    get:
+      description: Retrieves the current status of a data observability monitor run. Poll this endpoint after triggering a run to determine when evaluation is complete.
+      operationId: GetDataObservabilityMonitorRunStatus
+      parameters:
+        - description: The ID of the monitor run to retrieve status for.
+          example: "abc123def456"
+          in: path
+          name: run_id
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      attributes:
+                        status: ok
+                      id: "abc123def456"
+                      type: monitor_run
+              schema:
+                $ref: "#/components/schemas/GetDataObservabilityMonitorRunStatusResponse"
+          description: OK
+        "404":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Not Found
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      security:
+        - apiKeyAuth: []
+          appKeyAuth: []
+        - AuthZ:
+            - data_observability_monitors_write
+            - monitors_write
+      summary: Get data observability monitor run status
+      tags:
+        - Data Observability
+      x-unstable: |-
+        **Note**: This endpoint is in preview and is subject to change.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
+  /api/v2/data-observability/monitors/{monitor_id}/run:
+    post:
+      description: Manually triggers a run for a data observability monitor. Only monitors that are not scheduled (manually-runnable) can be triggered this way.
+      operationId: RunDataObservabilityMonitor
+      parameters:
+        - description: The ID of the data observability monitor to run.
+          example: 12345
+          in: path
+          name: monitor_id
+          required: true
+          schema:
+            format: int64
+            type: integer
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      id: "abc123def456"
+                      type: monitor_run
+              schema:
+                $ref: "#/components/schemas/RunDataObservabilityMonitorResponse"
+          description: OK
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Bad Request
+        "404":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Not Found
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      security:
+        - apiKeyAuth: []
+          appKeyAuth: []
+        - AuthZ:
+            - data_observability_monitors_write
+            - monitors_write
+      summary: Run a data observability monitor
+      tags:
+        - Data Observability
+      x-unstable: |-
+        **Note**: This endpoint is in preview and is subject to change.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/datasets:
     get:
       description: Get all datasets that have been configured for an organization.
@@ -169731,6 +169921,60 @@ paths:
         operator: OR
         permissions:
           - security_monitoring_rules_read
+  /api/v2/security_monitoring/rules/{rule_id}/restore/{version}:
+    post:
+      description: |-
+        Restores a custom detection rule to a previously saved historical version.
+        Only custom rules can be restored. Default and partner rules return 400.
+        The restore creates a new version entry; it does not overwrite history.
+      operationId: RestoreSecurityMonitoringRule
+      parameters:
+        - $ref: "#/components/parameters/SecurityMonitoringRuleID"
+        - $ref: "#/components/parameters/SecurityMonitoringRuleVersion"
+      responses:
+        "200":
+          content:
+            "application/json":
+              examples:
+                default:
+                  value:
+                    cases:
+                      - condition: "a > 0"
+                        name: ""
+                        notifications: []
+                        status: info
+                    id: abc-123
+                    isEnabled: true
+                    message: Test rule
+                    name: My security monitoring rule.
+                    tags: []
+                    type: log_detection
+              schema:
+                $ref: "#/components/schemas/SecurityMonitoringRuleResponse"
+          description: OK
+        "400":
+          $ref: "#/components/responses/BadRequestResponse"
+        "403":
+          $ref: "#/components/responses/NotAuthorizedResponse"
+        "404":
+          $ref: "#/components/responses/NotFoundResponse"
+        "409":
+          $ref: "#/components/responses/ConflictResponse"
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      security:
+        - apiKeyAuth: []
+          appKeyAuth: []
+        - AuthZ:
+            - security_monitoring_rules_write
+      summary: Restore a rule to a historical version
+      tags: ["Security Monitoring"]
+      "x-permission":
+        operator: OR
+        permissions:
+          - security_monitoring_rules_write
+      x-unstable: |-
+        **Note**: This endpoint is in beta and may be subject to changes.
   /api/v2/security_monitoring/rules/{rule_id}/test:
     post:
       description: |-
@@ -186518,6 +186762,8 @@ tags:
   - description: |-
       The Data Deletion API allows the user to target and delete data from the allowed products. It's currently enabled for Logs and RUM and depends on `logs_delete_data` and `rum_delete_data` permissions respectively.
     name: Data Deletion
+  - description: Manage and run data observability monitors.
+    name: Data Observability
   - description: |-
       Data Access Controls in Datadog is a feature that allows administrators and access managers to regulate
       access to sensitive data. By defining Restricted Datasets, you can ensure that only specific teams or roles can

examples/v2/security-monitoring/RestoreSecurityMonitoringRule.java

@@ -0,0 +1,30 @@
+// Restore a rule to a historical version returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.SecurityMonitoringApi;
+import com.datadog.api.client.v2.model.SecurityMonitoringRuleResponse;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.restoreSecurityMonitoringRule", true);
+    SecurityMonitoringApi apiInstance = new SecurityMonitoringApi(defaultClient);
+
+    // there is a valid "security_rule" in the system
+    String SECURITY_RULE_ID = System.getenv("SECURITY_RULE_ID");
+
+    try {
+      SecurityMonitoringRuleResponse result =
+          apiInstance.restoreSecurityMonitoringRule(SECURITY_RULE_ID, 1L);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println(
+          "Exception when calling SecurityMonitoringApi#restoreSecurityMonitoringRule");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

src/main/java/com/datadog/api/client/ApiClient.java

@@ -944,6 +944,7 @@ public class ApiClient {
           put("v2.listVulnerabilities", false);
           put("v2.listVulnerableAssets", false);
           put("v2.muteFindings", false);
+          put("v2.restoreSecurityMonitoringRule", false);
           put("v2.runHistoricalJob", false);
           put("v2.searchSecurityMonitoringHistsignals", false);
           put("v2.updateFindingsAssignee", false);
@@ -990,6 +991,8 @@ public class ApiClient {
           put("v2.updateDashboardSecureEmbed", false);
           put("v2.getDashboardUsage", false);
           put("v2.listDashboardsUsage", false);
+          put("v2.getDataObservabilityMonitorRunStatus", false);
+          put("v2.runDataObservabilityMonitor", false);
           put("v2.createDataset", false);
           put("v2.deleteDataset", false);
           put("v2.getAllDatasets", false);