--- title: Solicitar filtros de retención RUM description: Solicita filtros de retención RUM para una solicitud RUM. breadcrumbs: Documentación > API > Solicitar filtros de retención RUM --- > For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/llms.txt). # Solicitar filtros de retención RUM ## v2 (latest) | Datadog site | API endpoint | | ----------------- | ---------------------------------------------------------------------------------------------------- | | app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/rum/applications/{app_id}/relationships/retention_filters | | us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/rum/applications/{app_id}/relationships/retention_filters | | us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/rum/applications/{app_id}/relationships/retention_filters | | app.datadoghq.eu | PATCH https://api.datadoghq.eu/api/v2/rum/applications/{app_id}/relationships/retention_filters | | ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/rum/applications/{app_id}/relationships/retention_filters | | ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/rum/applications/{app_id}/relationships/retention_filters | | uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/rum/applications/{app_id}/relationships/retention_filters | | app.ddog-gov.com | PATCH https://api.ddog-gov.com/api/v2/rum/applications/{app_id}/relationships/retention_filters | | us2.ddog-gov.com | PATCH https://api.us2.ddog-gov.com/api/v2/rum/applications/{app_id}/relationships/retention_filters | ### Overview Solicita filtros de retención RUM para una solicitud RUM. Devuelve objetos de filtro de retención RUM sin atributos del cuerpo de la solicitud cuando la solicitud tiene éxito. ### Arguments #### Path Parameters | Field | Type | Description | | ------------------- | ------ | ------------------- | | app_id [*required*] | string | RUM application ID. | ### Request #### Body Data (required) Nueva definición del filtro de retención RUM. {% tabs %} {% tab label="Model" %} | Parent field | Field | Type | Description | | ------------ | ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | data | [object] | La lista de los IDs de filtro de retención RUM junto con su tipo correspondiente para reordenar. Todos los ID de filtro de retención deben incluirse en la lista creada para una aplicación RUM. | | data | id [*required*] | string | ID of retention filter in UUID. | | data | type [*required*] | enum | The type of the resource. The value should always be retention_filters. Allowed enum values: `retention_filters`. Default: `retention_filters`. | {% /tab %} {% tab label="Example" %} ```json { "data": [ { "type": "retention_filters", "id": "325631eb-94c9-49c0-93f9-ab7e4fd24529" }, { "type": "retention_filters", "id": "42d89430-5b80-426e-a44b-ba3b417ece25" }, { "type": "retention_filters", "id": "bff0bc34-99e9-4c16-adce-f47e71948c23" } ] } ``` {% /tab %} {% /tabs %} ### Response {% tabs %} {% tab label="200" %} Ordered {% tabs %} {% tab label="Model" %} The list of RUM retention filter IDs along with type. | Parent field | Field | Type | Description | | ------------ | ----------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | | data | [object] | A list of RUM retention filter IDs along with type. | | data | id [*required*] | string | ID of retention filter in UUID. | | data | type [*required*] | enum | The type of the resource. The value should always be retention_filters. Allowed enum values: `retention_filters`. Default: `retention_filters`. | {% /tab %} {% tab label="Example" %} ```json { "data": [ { "id": "051601eb-54a0-abc0-03f9-cc02efa18892", "type": "retention_filters" } ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="400" %} Bad Request {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="403" %} Not Authorized {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="429" %} Too many requests {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% /tabs %} ### Code Example {% tabs %} {% tab label="Curl" %} ```bash # Path parameters export app_id="CHANGE_ME" # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com # Use a Personal Access Token or Service Access Token export DD_BEARER_TOKEN="" curl -X PATCH "https://api.${DD_SITE}/api/v2/rum/applications/${app_id}/relationships/retention_filters" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" \ -d @- << EOF { "data": [ { "type": "retention_filters", "id": "325631eb-94c9-49c0-93f9-ab7e4fd24529" }, { "type": "retention_filters", "id": "42d89430-5b80-426e-a44b-ba3b417ece25" }, { "type": "retention_filters", "id": "bff0bc34-99e9-4c16-adce-f47e71948c23" } ] } EOF ``` {% /tab %} {% tab label="Go" %} ```go // Order RUM retention filters returns "Ordered" response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2" ) func main() { body := datadogV2.RumRetentionFiltersOrderRequest{ Data: []datadogV2.RumRetentionFiltersOrderData{ { Type: datadogV2.RUMRETENTIONFILTERTYPE_RETENTION_FILTERS, Id: "325631eb-94c9-49c0-93f9-ab7e4fd24529", }, { Type: datadogV2.RUMRETENTIONFILTERTYPE_RETENTION_FILTERS, Id: "42d89430-5b80-426e-a44b-ba3b417ece25", }, { Type: datadogV2.RUMRETENTIONFILTERTYPE_RETENTION_FILTERS, Id: "bff0bc34-99e9-4c16-adce-f47e71948c23", }, }, } ctx := datadog.NewDefaultContext(context.Background()) ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN")) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewRumRetentionFiltersApi(apiClient) resp, r, err := api.OrderRetentionFilters(ctx, "1d4b9c34-7ac4-423a-91cf-9902d926e9b3", body) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `RumRetentionFiltersApi.OrderRetentionFilters`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `RumRetentionFiltersApi.OrderRetentionFilters`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" go run "main.go" ``` {% /tab %} {% tab label="Java" %} ```java // Order RUM retention filters returns "Ordered" 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.RumRetentionFilterType; import com.datadog.api.client.v2.model.RumRetentionFiltersOrderData; import com.datadog.api.client.v2.model.RumRetentionFiltersOrderRequest; import com.datadog.api.client.v2.model.RumRetentionFiltersOrderResponse; import java.util.Arrays; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN")); RumRetentionFiltersApi apiInstance = new RumRetentionFiltersApi(defaultClient); RumRetentionFiltersOrderRequest body = new RumRetentionFiltersOrderRequest() .data( Arrays.asList( new RumRetentionFiltersOrderData() .type(RumRetentionFilterType.RETENTION_FILTERS) .id("325631eb-94c9-49c0-93f9-ab7e4fd24529"), new RumRetentionFiltersOrderData() .type(RumRetentionFilterType.RETENTION_FILTERS) .id("42d89430-5b80-426e-a44b-ba3b417ece25"), new RumRetentionFiltersOrderData() .type(RumRetentionFilterType.RETENTION_FILTERS) .id("bff0bc34-99e9-4c16-adce-f47e71948c23"))); try { RumRetentionFiltersOrderResponse result = apiInstance.orderRetentionFilters("1d4b9c34-7ac4-423a-91cf-9902d926e9b3", body); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling RumRetentionFiltersApi#orderRetentionFilters"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" java "Example.java" ``` {% /tab %} {% tab label="Python" %} ```python """ Order RUM retention filters returns "Ordered" response """ from os import environ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.rum_retention_filters_api import RumRetentionFiltersApi from datadog_api_client.v2.model.rum_retention_filter_type import RumRetentionFilterType from datadog_api_client.v2.model.rum_retention_filters_order_data import RumRetentionFiltersOrderData from datadog_api_client.v2.model.rum_retention_filters_order_request import RumRetentionFiltersOrderRequest body = RumRetentionFiltersOrderRequest( data=[ RumRetentionFiltersOrderData( type=RumRetentionFilterType.RETENTION_FILTERS, id="325631eb-94c9-49c0-93f9-ab7e4fd24529", ), RumRetentionFiltersOrderData( type=RumRetentionFilterType.RETENTION_FILTERS, id="42d89430-5b80-426e-a44b-ba3b417ece25", ), RumRetentionFiltersOrderData( type=RumRetentionFilterType.RETENTION_FILTERS, id="bff0bc34-99e9-4c16-adce-f47e71948c23", ), ], ) configuration = Configuration() configuration.access_token = environ["DD_BEARER_TOKEN"] with ApiClient(configuration) as api_client: api_instance = RumRetentionFiltersApi(api_client) response = api_instance.order_retention_filters(app_id="1d4b9c34-7ac4-423a-91cf-9902d926e9b3", body=body) print(response) ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" python3 "example.py" ``` {% /tab %} {% tab label="Ruby" %} ```ruby # Order RUM retention filters returns "Ordered" response require "datadog_api_client" DatadogAPIClient.configure do |config| config.access_token = ENV["DD_BEARER_TOKEN"] end api_instance = DatadogAPIClient::V2::RumRetentionFiltersAPI.new body = DatadogAPIClient::V2::RumRetentionFiltersOrderRequest.new({ data: [ DatadogAPIClient::V2::RumRetentionFiltersOrderData.new({ type: DatadogAPIClient::V2::RumRetentionFilterType::RETENTION_FILTERS, id: "325631eb-94c9-49c0-93f9-ab7e4fd24529", }), DatadogAPIClient::V2::RumRetentionFiltersOrderData.new({ type: DatadogAPIClient::V2::RumRetentionFilterType::RETENTION_FILTERS, id: "42d89430-5b80-426e-a44b-ba3b417ece25", }), DatadogAPIClient::V2::RumRetentionFiltersOrderData.new({ type: DatadogAPIClient::V2::RumRetentionFilterType::RETENTION_FILTERS, id: "bff0bc34-99e9-4c16-adce-f47e71948c23", }), ], }) p api_instance.order_retention_filters("1d4b9c34-7ac4-423a-91cf-9902d926e9b3", body) ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" rb "example.rb" ``` {% /tab %} {% tab label="Rust" %} ```rust // Order RUM retention filters returns "Ordered" response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_rum_retention_filters::RumRetentionFiltersAPI; use datadog_api_client::datadogV2::model::RumRetentionFilterType; use datadog_api_client::datadogV2::model::RumRetentionFiltersOrderData; use datadog_api_client::datadogV2::model::RumRetentionFiltersOrderRequest; #[tokio::main] async fn main() { let body = RumRetentionFiltersOrderRequest::new().data(vec![ RumRetentionFiltersOrderData::new( "325631eb-94c9-49c0-93f9-ab7e4fd24529".to_string(), RumRetentionFilterType::RETENTION_FILTERS, ), RumRetentionFiltersOrderData::new( "42d89430-5b80-426e-a44b-ba3b417ece25".to_string(), RumRetentionFilterType::RETENTION_FILTERS, ), RumRetentionFiltersOrderData::new( "bff0bc34-99e9-4c16-adce-f47e71948c23".to_string(), RumRetentionFilterType::RETENTION_FILTERS, ), ]); let configuration = datadog::Configuration::new(); let api = RumRetentionFiltersAPI::with_config(configuration); let resp = api .order_retention_filters("1d4b9c34-7ac4-423a-91cf-9902d926e9b3".to_string(), body) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ``` {% /tab %} {% tab label="TypeScript" %} ```typescript /** * Order RUM retention filters returns "Ordered" response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration({ authMethods: { AuthZ: { accessToken: process.env.DD_BEARER_TOKEN as string, }, }, }); const apiInstance = new v2.RumRetentionFiltersApi(configuration); const params: v2.RumRetentionFiltersApiOrderRetentionFiltersRequest = { body: { data: [ { type: "retention_filters", id: "325631eb-94c9-49c0-93f9-ab7e4fd24529", }, { type: "retention_filters", id: "42d89430-5b80-426e-a44b-ba3b417ece25", }, { type: "retention_filters", id: "bff0bc34-99e9-4c16-adce-f47e71948c23", }, ], }, appId: "1d4b9c34-7ac4-423a-91cf-9902d926e9b3", }; apiInstance .orderRetentionFilters(params) .then((data: v2.RumRetentionFiltersOrderResponse) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" tsc "example.ts" ``` {% /tab %} {% /tabs %}