Regenerate client from commit 03e1e7bc of spec repo

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.5",
-            "regenerated": "2023-09-06 15:59:41.504730",
-            "spec_repo_commit": "f65a8312"
+            "regenerated": "2023-09-07 00:50:53.693907",
+            "spec_repo_commit": "03e1e7bc"
         },
         "v2": {
             "apigentools_version": "1.6.5",
-            "regenerated": "2023-09-06 15:59:41.521256",
-            "spec_repo_commit": "f65a8312"
+            "regenerated": "2023-09-07 00:50:53.735334",
+            "spec_repo_commit": "03e1e7bc"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -377,6 +377,13 @@ components:
       required: true
       schema:
         type: string
+    RetentionFilterIdParam:
+      description: The ID of the retention filter.
+      in: path
+      name: filter_id
+      required: true
+      schema:
+        type: string
     RoleID:
       description: The unique identifier of the role.
       in: path
@@ -11817,6 +11824,124 @@ components:
       required:
       - data
       type: object
+    RetentionFilter:
+      description: The definition of the retention filter.
+      properties:
+        created_at:
+          description: The creation timestamp of the retention filter.
+          format: int64
+          type: integer
+        created_by:
+          description: The creator of the retention filter.
+          type: string
+        enabled:
+          description: The status of the retention filter (Enabled/Disabled).
+          example: true
+          type: boolean
+        execution_order:
+          description: The execution order of the retention filter.
+          format: int64
+          type: integer
+        filter:
+          $ref: '#/components/schemas/SpansFilter'
+        id:
+          description: The ID of the retention filter.
+          type: string
+        modified_at:
+          description: The modification timestamp of the retention filter.
+          format: int64
+          type: integer
+        modified_by:
+          description: The modifier of the retention filter.
+          type: string
+        name:
+          description: The name of the retention filter.
+          example: my retention filter
+          type: string
+        rate:
+          description: 'Sample rate to apply to spans going through this retention
+            filter,
+
+            a value of 1.0 keeps all spans matching the query.'
+          example: 1.0
+          format: double
+          type: number
+        type:
+          $ref: '#/components/schemas/RetentionFilterType'
+      type: object
+    RetentionFilterConfigurationCreate:
+      description: The object describing the configuration of the retention filter
+        to create.
+      properties:
+        enabled:
+          description: Enable/Disable the retention filter.
+          example: true
+          type: boolean
+        filter:
+          $ref: '#/components/schemas/SpansFilterCreate'
+        name:
+          description: The name of the retention filter.
+          example: my retention filter
+          type: string
+        rate:
+          description: 'Sample rate to apply to spans going through this retention
+            filter,
+
+            a value of 1.0 keeps all spans matching the query.'
+          example: 1.0
+          format: double
+          type: number
+        type:
+          $ref: '#/components/schemas/RetentionFilterType'
+      required:
+      - name
+      - filter
+      - enabled
+      - type
+      type: object
+    RetentionFilterCreateRequest:
+      description: The body of the retention filter to be created.
+      properties:
+        configuration:
+          $ref: '#/components/schemas/RetentionFilterConfigurationCreate'
+      required:
+      - configuration
+      type: object
+    RetentionFilterResponse:
+      description: The retention filters definition.
+      properties:
+        configuration:
+          $ref: '#/components/schemas/RetentionFilter'
+      type: object
+    RetentionFilterType:
+      default: spans-sampling-processor
+      description: The type of retention filter. The value should always be spans-sampling-processor.
+      enum:
+      - spans-sampling-processor
+      example: spans-sampling-processor
+      type: string
+      x-enum-varnames:
+      - spans_sampling_processor
+    RetentionFiltersReorderRequest:
+      description: The request must include a list of retention filters IDs in the
+        new order.
+      properties:
+        filterIds:
+          description: A list of retention filters IDs in their new order.
+          items:
+            description: Retention filter ID.
+            type: string
+          type: array
+      type: object
+    RetentionFiltersResponse:
+      description: The response will include a list of retention filters.
+      properties:
+        retention_filters:
+          description: A list of retention filters objects.
+          items:
+            $ref: '#/components/schemas/RetentionFilter'
+          type: array
+      type: object
     Role:
       description: Role object returned by the API.
       properties:
@@ -15446,6 +15571,25 @@ components:
       x-enum-varnames:
       - TIMESERIES
       - TOTAL
+    SpansFilter:
+      description: The spans filter used to index spans.
+      properties:
+        query:
+          description: The search query - following the span search syntax.
+          example: '@http.status_code:200 service:my-service'
+          type: string
+      type: object
+    SpansFilterCreate:
+      description: The spans filter. Spans matching this filter will be indexed and
+        stored.
+      properties:
+        query:
+          description: The search query - following the span search syntax.
+          example: '@http.status_code:200 service:my-service'
+          type: string
+      required:
+      - query
+      type: object
     SpansGroupBy:
       description: A group by rule.
       properties:
@@ -17586,6 +17730,149 @@ paths:
       tags:
       - Spans Metrics
       x-codegen-request-body-name: body
+  /api/v2/apm/config/retention-filters:
+    get:
+      description: Get the list of APM retention filters.
+      operationId: ListApmRetentionFilters
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RetentionFiltersResponse'
+          description: OK
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: List all APM retention filters
+      tags:
+      - APM Retention Filters
+    post:
+      description: 'Create a retention filter to index spans in your organization.
+
+        Returns the retention filter definition when the request is successful.'
+      operationId: CreateApmRetentionFilter
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RetentionFilterCreateRequest'
+        description: The definition of the newly created retention filter.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RetentionFilterResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '409':
+          $ref: '#/components/responses/ConflictResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: Create a retention filter
+      tags:
+      - APM Retention Filters
+      x-codegen-request-body-name: body
+  /api/v2/apm/config/retention-filters-execution-order:
+    put:
+      description: Re-order the execution order of retention filters.
+      operationId: ReorderApmRetentionFilters
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RetentionFiltersReorderRequest'
+        description: New definition of the retention filter to be updated.
+        required: true
+      responses:
+        '200':
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: Re-order retention filters
+      tags:
+      - APM Retention Filters
+      x-codegen-request-body-name: body
+  /api/v2/apm/config/retention-filters/{filter_id}:
+    delete:
+      description: Delete a specific retention filter from your organization.
+      operationId: DeleteApmRetentionFilter
+      parameters:
+      - $ref: '#/components/parameters/RetentionFilterIdParam'
+      responses:
+        '200':
+          description: OK
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: Delete a retention filter
+      tags:
+      - APM Retention Filters
+    put:
+      description: Update a retention filter from your organization.
+      operationId: UpdateApmRetentionFilter
+      parameters:
+      - $ref: '#/components/parameters/RetentionFilterIdParam'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RetentionFilterCreateRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RetentionFilterResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: Update a retention filters
+      tags:
+      - APM Retention Filters
+      x-codegen-request-body-name: body
   /api/v2/application_keys:
     get:
       description: List all application keys available for your org
@@ -27776,6 +28063,13 @@ servers:
       default: api
       description: The subdomain where the API is deployed.
 tags:
+- description: Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters)
+    for your organization. You need an API and application key with Admin rights to
+    interact with this endpoint.
+  externalDocs:
+    description: Find out more at
+    url: https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/
+  name: APM Retention Filters
 - description: Search your Audit Logs events over HTTP.
   name: Audit
 - description: '[AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example)

docs/datadog_api_client.v2.api.rst

@@ -1,6 +1,13 @@
 datadog\_api\_client.v2.api
 ===========================
 
+apm\_retention\_filters\_api
+----------------------------
+
+.. automodule:: datadog_api_client.v2.api.apm_retention_filters_api
+   :members:
+   :show-inheritance:
+
 audit\_api
 ----------