列出跟踪导出供应商预设

获取 /api/v1/projects/{id}/trace-export/presets

持有者身份验证

返回用于驱动设置用户用户界面的供应商盲预设目录（端点模板、协议、必需的非密钥标头字段、文档链接）。不包含任何秘密。项目范围由路由 ID 路径参数承载。

路径参数

id 字符串必需

项目 ID

响应

406

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

不支持或格式不正确的API版本、所选已发布合约中不可用的操作或不可接受的表示形式（包括不支持的媒体类型参数或排除的 SSE）。现有的身份验证、授权和速率限制失败优先。
隐藏响应属性显示响应属性对象
- badRequestDetail 对象
  
  标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。
  
  隐藏 BadRequestDetail 属性显示 BadRequestDetail 属性对象
  
  字段大量[对象]
  
  验证失败的字段。
  
  隐藏字段属性显示字段属性对象
  
  字段及其验证失败。
  
  描述字符串必需
  
  人类可读的验证失败。
  
  字段字符串必需
  
  无效请求字段的名称或路径。
- 详细信息字符串必需
  
  人类可读的错误详细信息。
- 错误整型必需
  
  HTTP status code.
- 错误代码字符串必需
  
  机器可读的错误代码。
- 参数 array[string]
  
  与错误相关的请求参数名称；不应用时省略。
- 原因字符串必需
  
  HTTP状态原因短语。
隐藏响应属性显示响应属性对象
- badRequestDetail 对象
  
  标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。
  
  隐藏 BadRequestDetail 属性显示 BadRequestDetail 属性对象
  
  字段大量[对象]
  
  验证失败的字段。
  
  隐藏字段属性显示字段属性对象
  
  字段及其验证失败。
  
  描述字符串必需
  
  人类可读的验证失败。
  
  字段字符串必需
  
  无效请求字段的名称或路径。
- 详细信息字符串必需
  
  人类可读的错误详细信息。
- 错误整型必需
  
  HTTP status code.
- 错误代码字符串必需
  
  机器可读的错误代码。
- 参数 array[string]
  
  与错误相关的请求参数名称；不应用时省略。
- 原因字符串必需
  
  HTTP状态原因短语。
200

应用程序/vnd.agent-engine-2026-09-20-preview+json

应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

正常
隐藏响应属性显示响应属性对象
- 预设大量[对象]
  
  隐藏预设属性显示预设属性对象
  
  显示名称字符串
  
  docs_url 字符串
  
  endpoint_template 字符串
  
  headers 对象
  
  标头是客户为此目标填写的非秘密字段（例如工作区 ID）。键映射到标头名称；值是占位符。
  
  隐藏标头属性显示标头属性对象
  
  * 字符串 additionalProperties
  
  id 字符串
  
  protocol 字符串
  
  resource_attributes 对象
  
  ResourceAttributes 将此目标所需的 OTLP资源属性（例如项目标识符）命名为具有空值的占位符键。与标头不同，这些属性位于跨度数据本身中，而不是HTTP标头行中；客户始终提供该值，因为它通常为目标方自己的项目命名。
  
  隐藏resource_attributes 属性显示resource_attributes 属性对象
  
  * 字符串 additionalProperties
  
  secret_header_keys array[string]
  
  Secret headerKeys 命名通过 headers_secret_ref 提供的标头。这些永远不会内联存储。
隐藏响应属性显示响应属性对象
- 预设大量[对象]
  
  隐藏预设属性显示预设属性对象
  
  显示名称字符串
  
  docs_url 字符串
  
  endpoint_template 字符串
  
  headers 对象
  
  标头是客户为此目标填写的非秘密字段（例如工作区 ID）。键映射到标头名称；值是占位符。
  
  隐藏标头属性显示标头属性对象
  
  * 字符串 additionalProperties
  
  id 字符串
  
  protocol 字符串
  
  resource_attributes 对象
  
  ResourceAttributes 将此目标所需的 OTLP资源属性（例如项目标识符）命名为具有空值的占位符键。与标头不同，这些属性位于跨度数据本身中，而不是HTTP标头行中；客户始终提供该值，因为它通常为目标方自己的项目命名。
  
  隐藏resource_attributes 属性显示resource_attributes 属性对象
  
  * 字符串 additionalProperties
  
  secret_header_keys array[string]
  
  Secret headerKeys 命名通过 headers_secret_ref 提供的标头。这些永远不会内联存储。
401

应用程序/vnd.agent-engine-2026-09-20-preview+json

应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

凭证缺失或无效
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
403

应用程序/vnd.agent-engine-2026-09-20-preview+json

应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

调用者缺乏读取权限
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔

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"

响应示例 (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"
}

响应示例 (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"
}

响应示例 (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"
      ]
    }
  ]
}

响应示例 (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"
      ]
    }
  ]
}

响应示例 (401)

{
  "code": "string",
  "error": "string",
  "success": true
}

响应示例 (401)

{
  "code": "string",
  "error": "string",
  "success": true
}

响应示例 (403)

{
  "code": "string",
  "error": "string",
  "success": true
}

响应示例 (403)

{
  "code": "string",
  "error": "string",
  "success": true
}