トレースエクスポートベンダーの事前設定を一覧表示する

GET /api/v1/projects/{id}/tace-export/presets

設定UI （エンドポイントテンプレート、プロトコル、必須非シークレットヘッダーフィールド、ドキュメントリンク）を操作するベンダーフィールドのプリセットカタログを返します。秘密は含まれていません。プロジェクトスコープは、ルート ID パスパラメーターによって保持されます。

path パラメータ

id string 必須

プロジェクトID

応答

406

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

サポートされていないAPIバージョンまたは不正な API バージョン、選択した公開契約で利用できない操作、または受け入れができない表現（サポートされていないメディアタイプのパラメーター、または除外された SSE を含む）。既存の認証、認可、およびレート制限の失敗が優先されます。
応答属性の非表示応答属性の表示オブジェクト
- validRequestDetail オブジェクト
  
  標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエートエラーでは、このフィールドは出力されません。
  
  validRequestDetail 属性を非表示にする validRequestDetail 属性の表示オブジェクト
  
  フィールド array[オブジェクト]
  
  検証に失敗したフィールド。
  
  フィールド属性を非表示にするフィールド属性の表示オブジェクト
  
  フィールドとその検証の失敗。
  
  説明 string 必須
  
  人間が判読できる検証の失敗。
  
  フィールド string 必須
  
  無効なリクエストフィールドの名前またはパス。
- 詳細 string 必須
  
  人間が判読できるエラーの詳細。
- エラー integer 必須
  
  HTTP status code.
- errorCode string 必須
  
  マシンが判読できるエラーコード。
- パラメーター array[string]
  
  エラーに関連付けられたリクエストパラメータ名。該当しない場合は省略します。
- 理由 string 必須
  
  HTTPステータス理由フレーズ。
応答属性の非表示応答属性の表示オブジェクト
- validRequestDetail オブジェクト
  
  標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエートエラーでは、このフィールドは出力されません。
  
  validRequestDetail 属性を非表示にする validRequestDetail 属性の表示オブジェクト
  
  フィールド array[オブジェクト]
  
  検証に失敗したフィールド。
  
  フィールド属性を非表示にするフィールド属性の表示オブジェクト
  
  フィールドとその検証の失敗。
  
  説明 string 必須
  
  人間が判読できる検証の失敗。
  
  フィールド string 必須
  
  無効なリクエストフィールドの名前またはパス。
- 詳細 string 必須
  
  人間が判読できるエラーの詳細。
- エラー integer 必須
  
  HTTP status code.
- errorCode string 必須
  
  マシンが判読できるエラーコード。
- パラメーター array[string]
  
  エラーに関連付けられたリクエストパラメータ名。該当しない場合は省略します。
- 理由 string 必須
  
  HTTPステータス理由フレーズ。
200

アプリケーション/vnd.agent- engine-2026-09-20-preview+json

アプリケーション/vnd.agent- engine-2026-09-20-preview+json application/ JSON

OK
応答属性を非表示応答属性の表示オブジェクト
- プリセット array[オブジェクト]
  
  プリセット属性を非表示プリセット属性の表示オブジェクト
  
  display_name string
  
  dos_url string
  
  endpoint_template string
  
  ヘッダーオブジェクト
  
  ヘッダーは、この宛先のためにカスタマーが入力する非 SECRET フィールドです（例: ワークスペース ID）。キーはヘッダー名にマップされます。値はプレースホルダーです。
  
  ヘッダー属性を非表示ヘッダー属性を表示オブジェクト
  
  * string additionalProperties
  
  id string
  
  プロトコル string
  
  resource_attributes オブジェクト
  
  ResourceAttributes は、この宛先が必要とする TLSリソース属性（例:プロジェクト識別子）を、空の値を持つプレースホルダーキーとして名前付けします。ヘッダーとは異なり、これらの属性はHTTPヘッダー行ではなく、範囲データ自体に存在します。カスタマーは通常、宛先側のプロジェクトに名前を付けるため、常に値を提供します。
  
  resource_attributes 属性を非表示 resource_attributes 属性の表示オブジェクト
  
  * string additionalProperties
  
  secret_header_keys array[string]
  
  Secretヘッダーキーは、 headers_secret_ref 経由で提供されるヘッダーに名前を付けます。これらはインラインでは保存されません。
応答属性を非表示応答属性の表示オブジェクト
- プリセット array[オブジェクト]
  
  プリセット属性を非表示プリセット属性の表示オブジェクト
  
  display_name string
  
  dos_url string
  
  endpoint_template string
  
  ヘッダーオブジェクト
  
  ヘッダーは、この宛先のためにカスタマーが入力する非 SECRET フィールドです（例: ワークスペース ID）。キーはヘッダー名にマップされます。値はプレースホルダーです。
  
  ヘッダー属性を非表示ヘッダー属性を表示オブジェクト
  
  * string additionalProperties
  
  id string
  
  プロトコル string
  
  resource_attributes オブジェクト
  
  ResourceAttributes は、この宛先が必要とする TLSリソース属性（例:プロジェクト識別子）を、空の値を持つプレースホルダーキーとして名前付けします。ヘッダーとは異なり、これらの属性はHTTPヘッダー行ではなく、範囲データ自体に存在します。カスタマーは通常、宛先側のプロジェクトに名前を付けるため、常に値を提供します。
  
  resource_attributes 属性を非表示 resource_attributes 属性の表示オブジェクト
  
  * string additionalProperties
  
  secret_header_keys array[string]
  
  Secretヘッダーキーは、 headers_secret_ref 経由で提供されるヘッダーに名前を付けます。これらはインラインでは保存されません。
401

アプリケーション/vnd.agent- engine-2026-09-20-preview+json

アプリケーション/vnd.agent- engine-2026-09-20-preview+json application/ JSON

認証情報が欠落しているか無効である
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
403

アプリケーション/vnd.agent- engine-2026-09-20-preview+json

アプリケーション/vnd.agent- engine-2026-09-20-preview+json application/ JSON

呼び出し元に読み取り権限がない
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値

GET /api/v1 /projects/{id}/tace-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
}