Regenerate client from commit 37954eaf of spec repo (#997)

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.2",
-            "regenerated": "2022-05-19 19:13:20.804693",
-            "spec_repo_commit": "da8834e1"
+            "regenerated": "2022-05-20 17:09:27.185404",
+            "spec_repo_commit": "37954eaf"
         },
         "v2": {
             "apigentools_version": "1.6.2",
-            "regenerated": "2022-05-19 19:13:20.815894",
-            "spec_repo_commit": "da8834e1"
+            "regenerated": "2022-05-20 17:09:27.202969",
+            "spec_repo_commit": "37954eaf"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -4,6 +4,13 @@ components:
   headers: {}
   links: {}
   parameters:
+    SignalID:
+      description: The ID of the signal.
+      in: path
+      name: signal_id
+      required: true
+      schema:
+        type: string
     SlackAccountNamePathParameter:
       description: Your Slack account name.
       in: path
@@ -360,6 +367,23 @@ components:
       - ADMIN
       - READ_ONLY
       - ERROR
+    AddSignalToIncidentRequest:
+      description: Attributes describing which incident to add the signal to.
+      properties:
+        add_to_signal_timeline:
+          description: Whether to post the signal on the incident timeline.
+          type: boolean
+        incident_id:
+          description: Public ID attribute of the incident to which the signal will
+            be added.
+          example: 2066
+          format: int64
+          type: integer
+        version:
+          $ref: '#/components/schemas/Version'
+      required:
+      - incident_id
+      type: object
     AgentCheck:
       description: Array of strings.
       example:
@@ -9766,6 +9790,59 @@ components:
       type: string
       x-enum-varnames:
       - TRACE_SERVICE
+    SignalArchiveReason:
+      description: Reason why a signal has been archived.
+      enum:
+      - none
+      - false_positive
+      - testing_or_maintenance
+      - other
+      type: string
+      x-enum-varnames:
+      - NONE
+      - FALSE_POSITIVE
+      - TESTING_OR_MAINTENANCE
+      - OTHER
+    SignalAssigneeUpdateRequest:
+      description: Attributes describing an assignee update operation over a security
+        signal.
+      properties:
+        assignee:
+          description: The UUID of the user being assigned. Use empty string to return
+            signal to unassigned.
+          example: 773b045d-ccf8-4808-bd3b-955ef6a8c940
+          type: string
+        version:
+          $ref: '#/components/schemas/Version'
+      required:
+      - assignee
+      type: object
+    SignalStateUpdateRequest:
+      description: Attributes describing the change of state for a given state.
+      properties:
+        archiveComment:
+          description: Optional comment to explain why a signal is being archived.
+          type: string
+        archiveReason:
+          $ref: '#/components/schemas/SignalArchiveReason'
+        state:
+          $ref: '#/components/schemas/SignalTriageState'
+        version:
+          $ref: '#/components/schemas/Version'
+      required:
+      - state
+      type: object
+    SignalTriageState:
+      description: The new triage state of the signal.
+      enum:
+      - open
+      - archived
+      - under_review
+      type: string
+      x-enum-varnames:
+      - OPEN
+      - ARCHIVED
+      - UNDER_REVIEW
     SlackIntegrationChannel:
       description: The Slack channel configuration.
       properties:
@@ -9814,6 +9891,13 @@ components:
       items:
         $ref: '#/components/schemas/SlackIntegrationChannel'
       type: array
+    SuccessfulSignalUpdateResponse:
+      description: Updated signal data following a successfully performed update.
+      properties:
+        status:
+          description: Status of the response.
+          type: string
+      type: object
     SunburstWidgetDefinition:
       description: Sunbursts are spot on to highlight how groups contribute to the
         total of a query.
@@ -15717,6 +15801,11 @@ components:
         user:
           $ref: '#/components/schemas/User'
       type: object
+    Version:
+      description: Version of the updated signal. If server side version is higher,
+        update will be rejected.
+      format: int64
+      type: integer
     WebhooksIntegration:
       description: Datadog-Webhooks integration.
       properties:
@@ -16636,6 +16725,8 @@ components:
               downtimes.
             monitors_read: View monitors.
             monitors_write: Edit, mute, and delete individual monitors.
+            security_monitoring_signals_read: View Security Signals.
+            security_monitoring_signals_write: Modify Security Signals.
             synthetics_global_variable_read: View, search, and use in tests the list
               of global variables available for Synthetics.
             synthetics_global_variable_write: Create, edit, and delete global variables
@@ -23207,6 +23298,161 @@ paths:
       x-menu-order: 4
       x-undo:
         type: safe
+  /api/v1/security_analytics/signals/{signal_id}/add_to_incident:
+    patch:
+      description: Add a security signal to an incident. This makes it possible to
+        search for signals by incident within the signal explorer and to view the
+        signals on the incident timeline.
+      operationId: AddSecurityMonitoringSignalToIncident
+      parameters:
+      - $ref: '#/components/parameters/SignalID'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AddSignalToIncidentRequest'
+        description: Attributes describing the signal update.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SuccessfulSignalUpdateResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - AuthZ:
+        - security_monitoring_signals_write
+        apiKeyAuth: []
+        appKeyAuth: []
+      summary: Add a security signal to an incident
+      tags:
+      - Security Monitoring
+      x-codegen-request-body-name: body
+      x-undo:
+        type: idempotent
+  /api/v1/security_analytics/signals/{signal_id}/assignee:
+    patch:
+      description: Modify the triage assignee of a security signal.
+      operationId: EditSecurityMonitoringSignalAssignee
+      parameters:
+      - $ref: '#/components/parameters/SignalID'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SignalAssigneeUpdateRequest'
+        description: Attributes describing the signal update.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SuccessfulSignalUpdateResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - AuthZ:
+        - security_monitoring_signals_write
+        apiKeyAuth: []
+        appKeyAuth: []
+      summary: Modify the triage assignee of a security signal
+      tags:
+      - Security Monitoring
+      x-codegen-request-body-name: body
+      x-undo:
+        type: idempotent
+  /api/v1/security_analytics/signals/{signal_id}/state:
+    patch:
+      description: Change the triage state of a security signal.
+      operationId: EditSecurityMonitoringSignalState
+      parameters:
+      - $ref: '#/components/parameters/SignalID'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SignalStateUpdateRequest'
+        description: Attributes describing the signal update.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SuccessfulSignalUpdateResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - AuthZ:
+        - security_monitoring_signals_write
+        apiKeyAuth: []
+        appKeyAuth: []
+      summary: Change the triage state of a security signal
+      tags:
+      - Security Monitoring
+      x-codegen-request-body-name: body
+      x-undo:
+        type: idempotent
   /api/v1/series:
     post:
       description: "The metrics end-point allows you to post time-series data that
@@ -28461,6 +28707,10 @@ tags:
   externalDocs:
     url: https://docs.datadoghq.com/api/?lang=bash#integration-pagerduty
   name: PagerDuty Integration
+- description: 'Detection rules for generating signals and listing of generated
+
+    signals.'
+  name: Security Monitoring
 - description: 'The service check endpoint allows you to post check statuses for use
     with monitors.
 

docs/datadog_api_client.v1.api.rst

@@ -161,6 +161,14 @@ pager\_duty\_integration\_api
    :undoc-members:
    :show-inheritance:
 
+security\_monitoring\_api
+-------------------------
+
+.. automodule:: datadog_api_client.v1.api.security_monitoring_api
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
 service\_checks\_api
 --------------------