プロジェクトレベルの TLS トレースエクスポート設定を保存します。認証シークレットは参照のみに使用されます (headers_secret_ref)。未加工の値は受け入れも保存もされません。生成カウンターをアップグレードし、下流への配信に対して保留中の構成をマークします。プロジェクトスコープは ルート ID パス パラメーターによって保持され、 組織はそのプロジェクトから派生します。
body
必須
型指定されたJSON構成
-
[ContentMode] では スパン コンテンツリダクションが選択されます。空の場合は metadata_only を意味します。
値は
metadata_onlyまたはfullです。 -
EgressMode は、範囲が配信される場所を選択します。空の場合はプラットフォームのみを意味します。
値は
platform_only、platform_and_customer_mirror、またはcustomer_onlyです。 -
有効になっている場合はポインターであるため、ハンドラーは省略フィールド（nil、拒否）と明示的な false（エクスポートを無効にするリクエスト）を区別できます。
-
エンドポイントは、カスタマーの TLS/ HTTPエンドポイントです。有効にする場合は必須です。 https である必要があり、内部アドレスまたはループバック アドレスを点はなりません（「 検証 」を参照してください）。
最大長は
2048です。 -
ヘッダーは、事前設定された必要のある非 SECRET エクスポート ヘッダーを保持します（例: ワークスペース ID）。秘密値はここに配置しないでください。 HeadersSecretRef を使用します。
-
HeadersSecretRef は、保存された単一の認証シークレット（通常はAPIキー）へのポインターです。これは参照であり、シークレット値ではありません。呼び出し元のプロジェクトにスコープを設定する必要があります（「 検証 」を参照してください）。
最大長は
512です。 -
InsecureSskipVerify はカスタマーエンドポイントの TLS 検証を無効にします。ポインターソース（デフォルトの）は、明示的なオプトアウトとは異なります。 UIは、セキュリティの意図的な削減としてこれを有効にします。
-
プロトコルは、アウトバウンド TLPプロトコルです。 v1 は http/protobuf のみをサポートします。
値は
http/protobufです。 -
ResourceAttributes は、カスタマーエンドポイントに送信されるすべての範囲にスタンプされる追加の TLSリソース属性（例: ターゲットが必要なプロジェクトやモデル識別子）です。特定の宛先で必要とされるキーは、そのプリセットから取得されます（ pkg/trateconfig/presets を参照）。値は常にカスタマーから提供されます。これは、通常、このプラットフォームでは検索方法がない宛先の独自のプロジェクトに名前を付けるためです。
-
SampingPolicy は、エクスポートする前に適用されるヘッドサンプルを選択します。
-
SecretheaderName は、参照先のシークレットの値が として送信されるヘッダー名（例: "api_key"）で、プリセットの secret_header_keys から取得されるか、カスタム宛先のユーザーが入力します。プラットフォームは、アウトバウンド ": " を構成します。指定します。そのため、保存されたシークレットは常に最低値（事前にフォーマットされたヘッダー行ではない）になります。 HeadersSecretRef が設定されている場合に必要です（「 検証 」を参照）。
最大長は
128です。
curl \
--request PUT 'https://agentengine.mongodb.com/api/v1/projects/{id}/trace-export/config' \
--header "Authorization: $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"content_mode": "metadata_only",
"egress_mode": "platform_only",
"enabled": true,
"endpoint": "string",
"headers": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"headers_secret_ref": "string",
"insecure_skip_verify": true,
"protocol": "http/protobuf",
"resource_attributes": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"sampling_policy": {
"ratio": 42.0,
"type": "always_on"
},
"secret_header_name": "string"
}'{
"content_mode": "metadata_only",
"egress_mode": "platform_only",
"enabled": true,
"endpoint": "string",
"headers": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"headers_secret_ref": "string",
"insecure_skip_verify": true,
"protocol": "http/protobuf",
"resource_attributes": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"sampling_policy": {
"ratio": 42.0,
"type": "always_on"
},
"secret_header_name": "string"
}{
"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"
}{
"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"
}{
"generation": 42,
"updated_at": "string"
}{
"generation": 42,
"updated_at": "string"
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}