Lista de preajustes de proveedores para la exportación de trazas

OBTENER /api/v1/projects/{id}/trace-export/presets
Autorización del portador

Devuelve el catálogo de preajustes independiente del proveedor que controla la interfaz de usuario de configuración (plantilla de punto final, protocolo, campos de encabezado obligatorios no secretos, enlace a la documentación). No contiene información confidencial. El ámbito del proyecto se define mediante el parámetro de ruta del ID de ruta.

Parámetros de path

  • ID string Requerido

    ID del proyecto

Respuestas

  • 406

    Versión de API no compatible o con formato incorrecto, operación no disponible en el contrato publicado seleccionado o representación inaceptable (incluidos parámetros de tipo de medio no compatibles o SSE excluidos). Los fallos de autenticación, autorización y límite de velocidad existentes tienen prioridad.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.
  • 200

    OK

    Ocultar atributo de respuesta Mostrar atributo de respuesta Objeto
    • presets arreglo[objeto]
      Ocultar atributos de preajustes Mostrar atributos de preajustes Objeto
      • display_name string
      • URL de la documentación string
      • plantilla_de_punto_final string
      • encabezados Objeto

        Los encabezados son los campos NO SECRETOS que un cliente completa para este destino (por ejemplo, un ID de espacio de trabajo). Las claves se corresponden con los nombres de los encabezados; los valores son marcadores de posición.

        Atributo de ocultar encabezados Mostrar atributo de encabezados Objeto
        • * string Propiedades adicionales
      • ID string
      • protocolo string
      • resource_attributes Objeto

        ResourceAttributes especifica los atributos de recursos OTLP que requiere este destino (por ejemplo, un identificador de proyecto), como claves de marcador de posición con valores vacíos. A diferencia de Headers, estos atributos se encuentran dentro de los datos del span, no en una línea de encabezado HTTP; el cliente siempre proporciona el valor, ya que normalmente especifica un proyecto en el lado del destino.

        Ocultar atributo resource_attributes Mostrar atributo resource_attributes Objeto
        • * string Propiedades adicionales
      • claves_de_encabezado_secretas array[string]

        SecretHeaderKeys nombra los encabezados proporcionados a través de headers_secret_ref. Estos nunca se almacenan en línea.

    Ocultar atributo de respuesta Mostrar atributo de respuesta Objeto
    • presets arreglo[objeto]
      Ocultar atributos de preajustes Mostrar atributos de preajustes Objeto
      • display_name string
      • URL de la documentación string
      • plantilla_de_punto_final string
      • encabezados Objeto

        Los encabezados son los campos NO SECRETOS que un cliente completa para este destino (por ejemplo, un ID de espacio de trabajo). Las claves se corresponden con los nombres de los encabezados; los valores son marcadores de posición.

        Atributo de ocultar encabezados Mostrar atributo de encabezados Objeto
        • * string Propiedades adicionales
      • ID string
      • protocolo string
      • resource_attributes Objeto

        ResourceAttributes especifica los atributos de recursos OTLP que requiere este destino (por ejemplo, un identificador de proyecto), como claves de marcador de posición con valores vacíos. A diferencia de Headers, estos atributos se encuentran dentro de los datos del span, no en una línea de encabezado HTTP; el cliente siempre proporciona el valor, ya que normalmente especifica un proyecto en el lado del destino.

        Ocultar atributo resource_attributes Mostrar atributo resource_attributes Objeto
        • * string Propiedades adicionales
      • claves_de_encabezado_secretas array[string]

        SecretHeaderKeys nombra los encabezados proporcionados a través de headers_secret_ref. Estos nunca se almacenan en línea.
  • 401

    Credenciales faltantes o no válidas

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 403

    La persona que llama no tiene permiso de lectura.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
GET /api/v1/projects/{id}/trace-export/presets 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/trace-export/presets' \
 --header "Authorization: $API_KEY"
Ejemplos de respuesta (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
Ejemplos de respuesta (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
Ejemplos de respuesta (200) 
{
  "presets": [
    {
      "display_name": "string",
      "docs_url": "string",
      "endpoint_template": "string",
      "headers": {
        "additionalProperty1": "string",
        "additionalProperty2": "string"
      },
      "id": "string",
      "protocol": "string",
      "resource_attributes": {
        "additionalProperty1": "string",
        "additionalProperty2": "string"
      },
      "secret_header_keys": [
        "string"
      ]
    }
  ]
}
Ejemplos de respuesta (200) 
{
  "presets": [
    {
      "display_name": "string",
      "docs_url": "string",
      "endpoint_template": "string",
      "headers": {
        "additionalProperty1": "string",
        "additionalProperty2": "string"
      },
      "id": "string",
      "protocol": "string",
      "resource_attributes": {
        "additionalProperty1": "string",
        "additionalProperty2": "string"
      },
      "secret_header_keys": [
        "string"
      ]
    }
  ]
}
Ejemplos de respuesta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}