add suppression version history (#3277)

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

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

.generator/schemas/v2/openapi.yaml

@@ -24779,6 +24779,30 @@ components:
       required:
       - data
       type: object
+    GetSuppressionVersionHistoryData:
+      description: Data for the suppression version history.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/SuppressionVersionHistory'
+        id:
+          description: ID of the suppression.
+          type: string
+        type:
+          $ref: '#/components/schemas/GetSuppressionVersionHistoryDataType'
+      type: object
+    GetSuppressionVersionHistoryDataType:
+      description: Type of data.
+      enum:
+      - suppression_version_history
+      type: string
+      x-enum-varnames:
+      - SUPPRESSIONVERSIONHISTORY
+    GetSuppressionVersionHistoryResponse:
+      description: Response for getting the suppression version history.
+      properties:
+        data:
+          $ref: '#/components/schemas/GetSuppressionVersionHistoryData'
+      type: object
     GetTeamMembershipsSort:
       description: Specifies the order of returned team memberships
       enum:
@@ -44242,38 +44266,13 @@ components:
           description: The `RuleVersionHistory` `data`.
           type: object
       type: object
-    RuleVersionUpdate:
-      description: A change in a rule version.
-      properties:
-        change:
-          description: The new value of the field.
-          example: cloud_provider:aws
-          type: string
-        field:
-          description: The field that was changed.
-          example: Tags
-          type: string
-        type:
-          $ref: '#/components/schemas/RuleVersionUpdateType'
-      type: object
-    RuleVersionUpdateType:
-      description: The type of change.
-      enum:
-      - create
-      - update
-      - delete
-      type: string
-      x-enum-varnames:
-      - CREATE
-      - UPDATE
-      - DELETE
     RuleVersions:
       description: A rule version with a list of updates.
       properties:
         changes:
           description: A list of changes.
           items:
-            $ref: '#/components/schemas/RuleVersionUpdate'
+            $ref: '#/components/schemas/VersionHistoryUpdate'
           type: array
         rule:
           $ref: '#/components/schemas/SecurityMonitoringRuleResponse'
@@ -52833,6 +52832,32 @@ components:
           format: double
           type: number
       type: object
+    SuppressionVersionHistory:
+      description: Response object containing the version history of a suppression.
+      properties:
+        count:
+          description: The number of suppression versions.
+          format: int32
+          maximum: 2147483647
+          type: integer
+        data:
+          additionalProperties:
+            $ref: '#/components/schemas/SuppressionVersions'
+            description: A suppression version with a list of updates.
+          description: The version history of a suppression.
+          type: object
+      type: object
+    SuppressionVersions:
+      description: A suppression version with a list of updates.
+      properties:
+        changes:
+          description: A list of changes.
+          items:
+            $ref: '#/components/schemas/VersionHistoryUpdate'
+          type: array
+        suppression:
+          $ref: '#/components/schemas/SecurityMonitoringSuppressionAttributes'
+      type: object
     TableResultV2:
       description: A reference table resource containing its full configuration and
         state.
@@ -57163,6 +57188,31 @@ components:
       example: 1
       format: int64
       type: integer
+    VersionHistoryUpdate:
+      description: A change in a rule version.
+      properties:
+        change:
+          description: The new value of the field.
+          example: cloud_provider:aws
+          type: string
+        field:
+          description: The field that was changed.
+          example: Tags
+          type: string
+        type:
+          $ref: '#/components/schemas/VersionHistoryUpdateType'
+      type: object
+    VersionHistoryUpdateType:
+      description: The type of change.
+      enum:
+      - create
+      - update
+      - delete
+      type: string
+      x-enum-varnames:
+      - CREATE
+      - UPDATE
+      - DELETE
     VirusTotalAPIKey:
       description: The definition of the `VirusTotalAPIKey` object.
       properties:
@@ -69034,6 +69084,9 @@ paths:
         operator: OR
         permissions:
         - incident_read
+      x-unstable: '**Note**: This endpoint is in Preview.
+
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
     post:
       description: Create an impact for an incident.
       operationId: CreateIncidentImpact
@@ -69077,6 +69130,9 @@ paths:
         operator: OR
         permissions:
         - incident_write
+      x-unstable: '**Note**: This endpoint is in Preview.
+
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/incidents/{incident_id}/impacts/{impact_id}:
     delete:
       description: Delete an incident impact.
@@ -69107,6 +69163,9 @@ paths:
         operator: OR
         permissions:
         - incident_write
+      x-unstable: '**Note**: This endpoint is in Preview.
+
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/incidents/{incident_id}/relationships/integrations:
     get:
       description: Get all integration metadata for an incident.
@@ -82039,6 +82098,35 @@ paths:
       summary: Update a suppression rule
       tags:
       - Security Monitoring
+  /api/v2/security_monitoring/configuration/suppressions/{suppression_id}/version_history:
+    get:
+      description: Get a suppression's version history.
+      operationId: GetSuppressionVersionHistory
+      parameters:
+      - $ref: '#/components/parameters/SecurityMonitoringSuppressionID'
+      - $ref: '#/components/parameters/PageSize'
+      - $ref: '#/components/parameters/PageNumber'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetSuppressionVersionHistoryResponse'
+          description: OK
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - security_monitoring_suppressions_read
+      summary: Get a suppression's version history
+      tags:
+      - Security Monitoring
   /api/v2/security_monitoring/rules:
     get:
       description: List rules.

examples/v2/security-monitoring/GetSuppressionVersionHistory.java

@@ -0,0 +1,29 @@
+// Get a suppression's version history 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.GetSuppressionVersionHistoryResponse;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    SecurityMonitoringApi apiInstance = new SecurityMonitoringApi(defaultClient);
+
+    // there is a valid "suppression" in the system
+    String SUPPRESSION_DATA_ID = System.getenv("SUPPRESSION_DATA_ID");
+
+    try {
+      GetSuppressionVersionHistoryResponse result =
+          apiInstance.getSuppressionVersionHistory(SUPPRESSION_DATA_ID);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println(
+          "Exception when calling SecurityMonitoringApi#getSuppressionVersionHistory");
+      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

@@ -748,12 +748,14 @@ public class ApiClient {
           put("v2.updateDeploymentGate", false);
           put("v2.updateDeploymentRule", false);
           put("v2.createIncident", false);
+          put("v2.createIncidentImpact", false);
           put("v2.createIncidentIntegration", false);
           put("v2.createIncidentNotificationRule", false);
           put("v2.createIncidentNotificationTemplate", false);
           put("v2.createIncidentTodo", false);
           put("v2.createIncidentType", false);
           put("v2.deleteIncident", false);
+          put("v2.deleteIncidentImpact", false);
           put("v2.deleteIncidentIntegration", false);
           put("v2.deleteIncidentNotificationRule", false);
           put("v2.deleteIncidentNotificationTemplate", false);
@@ -766,6 +768,7 @@ public class ApiClient {
           put("v2.getIncidentTodo", false);
           put("v2.getIncidentType", false);
           put("v2.listIncidentAttachments", false);
+          put("v2.listIncidentImpacts", false);
           put("v2.listIncidentIntegrations", false);
           put("v2.listIncidentNotificationRules", false);
           put("v2.listIncidentNotificationTemplates", false);

src/main/java/com/datadog/api/client/v2/api/IncidentsApi.java

@@ -353,6 +353,13 @@ public ApiResponse<IncidentImpactResponse> createIncidentImpactWithHttpInfo(
       IncidentImpactCreateRequest body,
       CreateIncidentImpactOptionalParameters parameters)
       throws ApiException {
+    // Check if unstable operation is enabled
+    String operationId = "createIncidentImpact";
+    if (apiClient.isUnstableOperationEnabled("v2." + operationId)) {
+      apiClient.getLogger().warning(String.format("Using unstable operation '%s'", operationId));
+    } else {
+      throw new ApiException(0, String.format("Unstable operation '%s' is disabled", operationId));
+    }
     Object localVarPostBody = body;
 
     // verify the required parameter 'incidentId' is set
@@ -413,6 +420,16 @@ public ApiResponse<IncidentImpactResponse> createIncidentImpactWithHttpInfo(
           String incidentId,
           IncidentImpactCreateRequest body,
           CreateIncidentImpactOptionalParameters parameters) {
+    // Check if unstable operation is enabled
+    String operationId = "createIncidentImpact";
+    if (apiClient.isUnstableOperationEnabled("v2." + operationId)) {
+      apiClient.getLogger().warning(String.format("Using unstable operation '%s'", operationId));
+    } else {
+      CompletableFuture<ApiResponse<IncidentImpactResponse>> result = new CompletableFuture<>();
+      result.completeExceptionally(
+          new ApiException(0, String.format("Unstable operation '%s' is disabled", operationId)));
+      return result;
+    }
     Object localVarPostBody = body;
 
     // verify the required parameter 'incidentId' is set
@@ -1501,6 +1518,13 @@ public CompletableFuture<Void> deleteIncidentImpactAsync(String incidentId, Stri
    */
   public ApiResponse<Void> deleteIncidentImpactWithHttpInfo(String incidentId, String impactId)
       throws ApiException {
+    // Check if unstable operation is enabled
+    String operationId = "deleteIncidentImpact";
+    if (apiClient.isUnstableOperationEnabled("v2." + operationId)) {
+      apiClient.getLogger().warning(String.format("Using unstable operation '%s'", operationId));
+    } else {
+      throw new ApiException(0, String.format("Unstable operation '%s' is disabled", operationId));
+    }
     Object localVarPostBody = null;
 
     // verify the required parameter 'incidentId' is set
@@ -1554,6 +1578,16 @@ public ApiResponse<Void> deleteIncidentImpactWithHttpInfo(String incidentId, Str
    */
   public CompletableFuture<ApiResponse<Void>> deleteIncidentImpactWithHttpInfoAsync(
       String incidentId, String impactId) {
+    // Check if unstable operation is enabled
+    String operationId = "deleteIncidentImpact";
+    if (apiClient.isUnstableOperationEnabled("v2." + operationId)) {
+      apiClient.getLogger().warning(String.format("Using unstable operation '%s'", operationId));
+    } else {
+      CompletableFuture<ApiResponse<Void>> result = new CompletableFuture<>();
+      result.completeExceptionally(
+          new ApiException(0, String.format("Unstable operation '%s' is disabled", operationId)));
+      return result;
+    }
     Object localVarPostBody = null;
 
     // verify the required parameter 'incidentId' is set
@@ -4107,6 +4141,13 @@ public CompletableFuture<IncidentImpactsResponse> listIncidentImpactsAsync(
    */
   public ApiResponse<IncidentImpactsResponse> listIncidentImpactsWithHttpInfo(
       String incidentId, ListIncidentImpactsOptionalParameters parameters) throws ApiException {
+    // Check if unstable operation is enabled
+    String operationId = "listIncidentImpacts";
+    if (apiClient.isUnstableOperationEnabled("v2." + operationId)) {
+      apiClient.getLogger().warning(String.format("Using unstable operation '%s'", operationId));
+    } else {
+      throw new ApiException(0, String.format("Unstable operation '%s' is disabled", operationId));
+    }
     Object localVarPostBody = null;
 
     // verify the required parameter 'incidentId' is set
@@ -4158,6 +4199,16 @@ public ApiResponse<IncidentImpactsResponse> listIncidentImpactsWithHttpInfo(
   public CompletableFuture<ApiResponse<IncidentImpactsResponse>>
       listIncidentImpactsWithHttpInfoAsync(
           String incidentId, ListIncidentImpactsOptionalParameters parameters) {
+    // Check if unstable operation is enabled
+    String operationId = "listIncidentImpacts";
+    if (apiClient.isUnstableOperationEnabled("v2." + operationId)) {
+      apiClient.getLogger().warning(String.format("Using unstable operation '%s'", operationId));
+    } else {
+      CompletableFuture<ApiResponse<IncidentImpactsResponse>> result = new CompletableFuture<>();
+      result.completeExceptionally(
+          new ApiException(0, String.format("Unstable operation '%s' is disabled", operationId)));
+      return result;
+    }
     Object localVarPostBody = null;
 
     // verify the required parameter 'incidentId' is set