Regenerate client from commit 6a02de5 of spec repo (#3890)

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

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

.generator/schemas/v2/openapi.yaml

@@ -1558,6 +1558,13 @@ components:
       required: true
       schema:
         type: string
+    RumPermanentRetentionFilterIDParameter:
+      description: The identifier of the permanent RUM retention filter.
+      in: path
+      name: permanent_rf_id
+      required: true
+      schema:
+        $ref: "#/components/schemas/RumPermanentRetentionFilterID"
     RumRetentionFilterIDParameter:
       description: Retention filter ID.
       in: path
@@ -71551,6 +71558,100 @@ components:
             $ref: "#/components/schemas/RumMetricResponseData"
           type: array
       type: object
+    RumPermanentRetentionFilterAttributes:
+      description: The attributes of a permanent RUM retention filter.
+      properties:
+        cross_product_sampling:
+          $ref: "#/components/schemas/RumCrossProductSampling"
+        description:
+          description: A description of what the filter retains.
+          example: "All sessions generated by Synthetics are retained at 100%."
+          type: string
+        editability:
+          $ref: "#/components/schemas/RumPermanentRetentionFilterEditability"
+        name:
+          description: The display name of the permanent retention filter.
+          example: "Synthetics Sessions"
+          type: string
+      type: object
+    RumPermanentRetentionFilterData:
+      description: A permanent RUM retention filter.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/RumPermanentRetentionFilterAttributes"
+        id:
+          $ref: "#/components/schemas/RumPermanentRetentionFilterID"
+        type:
+          $ref: "#/components/schemas/RumPermanentRetentionFilterType"
+      type: object
+    RumPermanentRetentionFilterEditability:
+      description: Indicates which cross-product fields of a permanent RUM retention filter can be updated.
+      properties:
+        trace_editable:
+          description: Whether the APM trace cross-product configuration of the filter can be updated.
+          example: true
+          type: boolean
+      type: object
+    RumPermanentRetentionFilterID:
+      description: The identifier of a permanent RUM retention filter.
+      enum:
+        - rum_apm_flat_sampling
+        - synthetics_sessions
+        - forced_replay_sessions
+      example: synthetics_sessions
+      type: string
+      x-enum-varnames: ["RUM_APM_FLAT_SAMPLING", "SYNTHETICS_SESSIONS", "FORCED_REPLAY_SESSIONS"]
+    RumPermanentRetentionFilterResponse:
+      description: A permanent RUM retention filter object.
+      properties:
+        data:
+          $ref: "#/components/schemas/RumPermanentRetentionFilterData"
+      type: object
+    RumPermanentRetentionFilterType:
+      default: permanent_retention_filters
+      description: The type of the resource. The value should always be `permanent_retention_filters`.
+      enum:
+        - permanent_retention_filters
+      example: permanent_retention_filters
+      type: string
+      x-enum-varnames: ["PERMANENT_RETENTION_FILTERS"]
+    RumPermanentRetentionFilterUpdateAttributes:
+      description: The configuration to update on a permanent RUM retention filter.
+      properties:
+        cross_product_sampling:
+          $ref: "#/components/schemas/RumCrossProductSamplingUpdate"
+      type: object
+    RumPermanentRetentionFilterUpdateData:
+      description: The new permanent RUM retention filter configuration to update.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/RumPermanentRetentionFilterUpdateAttributes"
+        id:
+          $ref: "#/components/schemas/RumPermanentRetentionFilterID"
+        type:
+          $ref: "#/components/schemas/RumPermanentRetentionFilterType"
+      required:
+        - id
+        - type
+        - attributes
+      type: object
+    RumPermanentRetentionFilterUpdateRequest:
+      description: The permanent RUM retention filter body to update.
+      properties:
+        data:
+          $ref: "#/components/schemas/RumPermanentRetentionFilterUpdateData"
+      required:
+        - data
+      type: object
+    RumPermanentRetentionFiltersResponse:
+      description: All permanent RUM retention filters for a RUM application.
+      properties:
+        data:
+          description: A list of permanent RUM retention filters.
+          items:
+            $ref: "#/components/schemas/RumPermanentRetentionFilterData"
+          type: array
+      type: object
     RumRetentionFilterAttributes:
       description: The object describing attributes of a RUM retention filter.
       properties:
@@ -146732,6 +146833,159 @@ paths:
       tags:
         - Rum Retention Filters
       x-codegen-request-body-name: body
+  /api/v2/rum/applications/{app_id}/retention_filters/permanent:
+    get:
+      description: |-
+        Get the list of permanent RUM retention filters for a RUM application.
+        Permanent retention filters are predefined filters that cannot be created or deleted.
+        For each filter, the `editability` block indicates which cross-product fields can be updated.
+      operationId: ListPermanentRetentionFilters
+      parameters:
+        - $ref: "#/components/parameters/RumApplicationIDParameter"
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      - attributes:
+                          cross_product_sampling:
+                            trace_enabled: true
+                            trace_sample_rate: 100.0
+                          description: RUM retains all Synthetics sessions.
+                          editability:
+                            trace_editable: true
+                          name: Synthetics Sessions
+                        id: synthetics_sessions
+                        type: permanent_retention_filters
+                      - attributes:
+                          cross_product_sampling:
+                            trace_enabled: true
+                            trace_sample_rate: 100.0
+                          description: RUM retains all sessions with forced replays.
+                          editability:
+                            trace_editable: true
+                          name: Forced Replay Sessions
+                        id: forced_replay_sessions
+                        type: permanent_retention_filters
+                      - attributes:
+                          cross_product_sampling:
+                            trace_enabled: true
+                            trace_sample_rate: 100.0
+                          description: Configures APM trace sampling for RUM sessions using flat sampling.
+                          editability:
+                            trace_editable: false
+                          name: RUM APM Flat Sampling
+                        id: rum_apm_flat_sampling
+                        type: permanent_retention_filters
+              schema:
+                $ref: "#/components/schemas/RumPermanentRetentionFiltersResponse"
+          description: OK
+        "403":
+          $ref: "#/components/responses/NotAuthorizedResponse"
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      summary: Get all permanent RUM retention filters
+      tags:
+        - Rum Retention Filters
+  /api/v2/rum/applications/{app_id}/retention_filters/permanent/{permanent_rf_id}:
+    get:
+      description: Get a permanent RUM retention filter for a RUM application by its identifier.
+      operationId: GetPermanentRetentionFilter
+      parameters:
+        - $ref: "#/components/parameters/RumApplicationIDParameter"
+        - $ref: "#/components/parameters/RumPermanentRetentionFilterIDParameter"
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      attributes:
+                        cross_product_sampling:
+                          trace_enabled: true
+                          trace_sample_rate: 75.0
+                        description: RUM retains all Synthetics sessions.
+                        editability:
+                          trace_editable: true
+                        name: Synthetics Sessions
+                      id: synthetics_sessions
+                      type: permanent_retention_filters
+              schema:
+                $ref: "#/components/schemas/RumPermanentRetentionFilterResponse"
+          description: OK
+        "403":
+          $ref: "#/components/responses/NotAuthorizedResponse"
+        "404":
+          $ref: "#/components/responses/NotFoundResponse"
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      summary: Get a permanent RUM retention filter
+      tags:
+        - Rum Retention Filters
+    patch:
+      description: |-
+        Update the cross-product sampling configuration of a permanent RUM retention filter for a RUM application.
+        Only fields marked as editable in the `editability` block of the filter can be updated.
+        Updating a non-editable field returns a `400` response.
+      operationId: UpdatePermanentRetentionFilter
+      parameters:
+        - $ref: "#/components/parameters/RumApplicationIDParameter"
+        - $ref: "#/components/parameters/RumPermanentRetentionFilterIDParameter"
+      requestBody:
+        content:
+          application/json:
+            examples:
+              default:
+                value:
+                  data:
+                    attributes:
+                      cross_product_sampling:
+                        trace_enabled: true
+                        trace_sample_rate: 50.0
+                    id: synthetics_sessions
+                    type: permanent_retention_filters
+            schema:
+              $ref: "#/components/schemas/RumPermanentRetentionFilterUpdateRequest"
+        description: New configuration of the permanent RUM retention filter.
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      attributes:
+                        cross_product_sampling:
+                          trace_enabled: true
+                          trace_sample_rate: 50.0
+                        description: RUM retains all Synthetics sessions.
+                        editability:
+                          trace_editable: true
+                        name: Synthetics Sessions
+                      id: synthetics_sessions
+                      type: permanent_retention_filters
+              schema:
+                $ref: "#/components/schemas/RumPermanentRetentionFilterResponse"
+          description: Updated
+        "400":
+          $ref: "#/components/responses/BadRequestResponse"
+        "403":
+          $ref: "#/components/responses/NotAuthorizedResponse"
+        "404":
+          $ref: "#/components/responses/NotFoundResponse"
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      summary: Update a permanent RUM retention filter
+      tags:
+        - Rum Retention Filters
+      x-codegen-request-body-name: body
   /api/v2/rum/applications/{app_id}/retention_filters/{rf_id}:
     delete:
       description: Delete a RUM retention filter for a RUM application.

examples/v2/rum-retention-filters/GetPermanentRetentionFilter.java

@@ -0,0 +1,28 @@
+// Get a permanent RUM retention filter returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.RumRetentionFiltersApi;
+import com.datadog.api.client.v2.model.RumPermanentRetentionFilterID;
+import com.datadog.api.client.v2.model.RumPermanentRetentionFilterResponse;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    RumRetentionFiltersApi apiInstance = new RumRetentionFiltersApi(defaultClient);
+
+    try {
+      RumPermanentRetentionFilterResponse result =
+          apiInstance.getPermanentRetentionFilter(
+              "app_id", RumPermanentRetentionFilterID.SYNTHETICS_SESSIONS);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println(
+          "Exception when calling RumRetentionFiltersApi#getPermanentRetentionFilter");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/rum-retention-filters/ListPermanentRetentionFilters.java

@@ -0,0 +1,26 @@
+// Get all permanent RUM retention filters returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.RumRetentionFiltersApi;
+import com.datadog.api.client.v2.model.RumPermanentRetentionFiltersResponse;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    RumRetentionFiltersApi apiInstance = new RumRetentionFiltersApi(defaultClient);
+
+    try {
+      RumPermanentRetentionFiltersResponse result =
+          apiInstance.listPermanentRetentionFilters("app_id");
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println(
+          "Exception when calling RumRetentionFiltersApi#listPermanentRetentionFilters");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/rum-retention-filters/UpdatePermanentRetentionFilter.java

@@ -0,0 +1,46 @@
+// Update a permanent RUM retention filter returns "Updated" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.RumRetentionFiltersApi;
+import com.datadog.api.client.v2.model.RumCrossProductSamplingUpdate;
+import com.datadog.api.client.v2.model.RumPermanentRetentionFilterID;
+import com.datadog.api.client.v2.model.RumPermanentRetentionFilterResponse;
+import com.datadog.api.client.v2.model.RumPermanentRetentionFilterType;
+import com.datadog.api.client.v2.model.RumPermanentRetentionFilterUpdateAttributes;
+import com.datadog.api.client.v2.model.RumPermanentRetentionFilterUpdateData;
+import com.datadog.api.client.v2.model.RumPermanentRetentionFilterUpdateRequest;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    RumRetentionFiltersApi apiInstance = new RumRetentionFiltersApi(defaultClient);
+
+    RumPermanentRetentionFilterUpdateRequest body =
+        new RumPermanentRetentionFilterUpdateRequest()
+            .data(
+                new RumPermanentRetentionFilterUpdateData()
+                    .attributes(
+                        new RumPermanentRetentionFilterUpdateAttributes()
+                            .crossProductSampling(
+                                new RumCrossProductSamplingUpdate()
+                                    .traceEnabled(true)
+                                    .traceSampleRate(25.0)))
+                    .id(RumPermanentRetentionFilterID.SYNTHETICS_SESSIONS)
+                    .type(RumPermanentRetentionFilterType.PERMANENT_RETENTION_FILTERS));
+
+    try {
+      RumPermanentRetentionFilterResponse result =
+          apiInstance.updatePermanentRetentionFilter(
+              "app_id", RumPermanentRetentionFilterID.SYNTHETICS_SESSIONS, body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println(
+          "Exception when calling RumRetentionFiltersApi#updatePermanentRetentionFilter");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}