> ## Documentation Index > Fetch the complete documentation index at: https://docs.chronosphere.io/llms.txt > Use this file to discover all available pages before exploring further. # CreateTraceJaegerRemoteSamplingStrategy ## OpenAPI ````yaml openapi/api_v1_config_openapi3_DOCUMENTATION_ONLY.json POST /api/v1/config/trace-jaeger-remote-sampling-strategies openapi: 3.0.3 info: description: > The Config API provides standard HTTP/JSON REST endpoints for creating, reading, updating, deleting, and listing configurable Chronosphere resources. Use this link to download the raw Swagger specification: /api/v1/config/swagger.json title: Config V1 API version: v1 servers: - url: https://{tenant}.chronosphere.io variables: tenant: default: tenant description: tenant ID assigned by the service provider security: - ApiKeyAuth: [] tags: - name: ConfigV1 paths: /api/v1/config/trace-jaeger-remote-sampling-strategies: post: tags: - TraceJaegerRemoteSamplingStrategy operationId: CreateTraceJaegerRemoteSamplingStrategy requestBody: content: application/json: schema: $ref: >- #/components/schemas/configv1CreateTraceJaegerRemoteSamplingStrategyRequest required: true x-originalParamName: body responses: '200': content: application/json: schema: $ref: >- #/components/schemas/configv1CreateTraceJaegerRemoteSamplingStrategyResponse description: >- A successful response containing the created TraceJaegerRemoteSamplingStrategy. '400': content: application/json: schema: $ref: '#/components/schemas/apiError' description: >- Cannot create the TraceJaegerRemoteSamplingStrategy because the request is invalid. '409': content: application/json: schema: $ref: '#/components/schemas/apiError' description: >- Cannot create the TraceJaegerRemoteSamplingStrategy because there is a conflict with an existing TraceJaegerRemoteSamplingStrategy. '500': content: application/json: schema: $ref: '#/components/schemas/apiError' description: An unexpected error response. default: content: application/json: schema: $ref: '#/components/schemas/genericError' description: An undefined error response. components: schemas: configv1CreateTraceJaegerRemoteSamplingStrategyRequest: properties: dry_run: description: >- If `true`, validates the specified configuration without creating the TraceJaegerRemoteSamplingStrategy. If the specified configuration is valid, the endpoint returns a partial response without the TraceJaegerRemoteSamplingStrategy. If the specified configuration is invalid, the endpoint returns an error. type: boolean trace_jaeger_remote_sampling_strategy: allOf: - $ref: '#/components/schemas/configv1TraceJaegerRemoteSamplingStrategy' description: The TraceJaegerRemoteSamplingStrategy to create. type: object configv1CreateTraceJaegerRemoteSamplingStrategyResponse: properties: trace_jaeger_remote_sampling_strategy: $ref: '#/components/schemas/configv1TraceJaegerRemoteSamplingStrategy' type: object apiError: properties: message: description: An error message describing what went wrong. type: string type: object genericError: additionalProperties: true type: object configv1TraceJaegerRemoteSamplingStrategy: properties: applied_strategy: allOf: - $ref: >- #/components/schemas/TraceJaegerRemoteSamplingStrategyAppliedStrategy description: >- The strategy to apply for JaegerRemoteSampler-enabled agents running in the named service. Exactly one of the following strategies must be set. See the Observability Platform documentation for [Creating head sampling rules](https://docs.chronosphere.io/control/sampling/head-sampling#create-head-sampling-rules) for more information. created_at: description: >- Timestamp of when the TraceJaegerRemoteSamplingStrategy was created. Cannot be set by clients. format: date-time readOnly: true type: string name: description: >- The name of the TraceJaegerRemoteSamplingStrategy. You can modify this value after the TraceJaegerRemoteSamplingStrategy is created. type: string service_name: description: >- The name of the service this sampling strategy applies to. This value must match the `slug` and `name` fields. type: string slug: description: >- The unique identifier of the TraceJaegerRemoteSamplingStrategy. If a `slug` isn't provided, one is generated based on the `name` field. You can't modify this field after the TraceJaegerRemoteSamplingStrategy is created. type: string updated_at: description: >- Timestamp of when the TraceJaegerRemoteSamplingStrategy was last updated. Cannot be set by clients. format: date-time readOnly: true type: string required: - name type: object TraceJaegerRemoteSamplingStrategyAppliedStrategy: properties: per_operation_strategies: allOf: - $ref: >- #/components/schemas/TraceJaegerRemoteSamplingStrategyPerOperationSamplingStrategies description: >- Applies an operation-granularity strategy. If this strategy is set, no other strategy can be set. probabilistic_strategy: allOf: - $ref: >- #/components/schemas/TraceJaegerRemoteSamplingStrategyProbabilisticStrategy description: >- Applies a probabilistic strategy. If this strategy is set, no other strategy can be set. rate_limiting_strategy: allOf: - $ref: >- #/components/schemas/TraceJaegerRemoteSamplingStrategyRateLimitingSamplingStrategy description: >- Applies a rate-limiting strategy. If this strategy is set, no other strategy can be set. type: object TraceJaegerRemoteSamplingStrategyPerOperationSamplingStrategies: properties: default_lower_bound_traces_per_second: description: >- Defines a minimum number of traces to send for any operation in the service, regardless of matching per operation strategy. format: double type: number default_sampling_rate: description: >- Defines the service-wide sampling probability (in the range `[0, 1]`) when specific operations are not matched. format: double type: number default_upper_bound_traces_per_second: description: >- Defines a maximum number of traces to send for any operation in the service, regardless of matching per operation strategy. format: double type: number per_operation_strategies: description: >- Defines explicit operations-specific strategies that take precedence over the default sampling rate. items: $ref: >- #/components/schemas/PerOperationSamplingStrategiesPerOperationSamplingStrategy type: array type: object TraceJaegerRemoteSamplingStrategyProbabilisticStrategy: properties: sampling_rate: description: >- Value in the range `[0, 1]` that defines the percentage probability of sampling any trace, where `0` is zero percent and `1` equals 100 percent. format: double type: number type: object TraceJaegerRemoteSamplingStrategyRateLimitingSamplingStrategy: properties: max_traces_per_second: description: Maximum number of traces to sample per second. format: int32 type: integer type: object PerOperationSamplingStrategiesPerOperationSamplingStrategy: properties: operation: description: The operation to which this specific strategy applies. type: string probabilistic_sampling_strategy: allOf: - $ref: >- #/components/schemas/TraceJaegerRemoteSamplingStrategyProbabilisticStrategy description: |- Defines the probabilistic strategy to apply to traces matching this operation. type: object securitySchemes: ApiKeyAuth: description: Chronosphere API token in: header name: API-Token type: apiKey ````