프로젝트 추적 내보내기 구성 가져오기

얻다 /api/v1/projects/{id}/trace-export/config

현재 프로젝트 수준 OTLP 추적 내보내기 설정을 반환합니다. 인증 시크릿은 참조로만 반환됩니다(headers_secret_ref). 원시 값은 반환되지 않습니다. 프로젝트 범위는 경로 ID 경로 매개 변수에 의해 전달되며 조직은 해당 프로젝트 에서 파생됩니다.

경로 매개변수

id 문자열 필수 사항

프로젝트 ID

응답

406

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  HTTP status code.
- 오류 코드 문자열 필수 사항
  
  기계가 읽을 수 있는 오류 코드입니다.
- 매개변수 array[string]
  
  오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.
- 이유 문자열 필수 사항
  
  HTTP 상태 이유 구문입니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  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

확인
응답 속성 숨기기 응답 속성 표시 객체
- config 객체
  
  구성 속성 숨기기 구성 속성 표시 객체
  
  콘텐츠 모드 문자열
  
  ContentMode는 스팬 콘텐츠 편집을 선택합니다. 비어 있음은 metadata_only를 의미합니다.
  
  값은 metadata_only 또는 full입니다.
  
  egress_mode 문자열
  
  EgressMode는 스팬이 전달될 위치를 선택합니다. 비어 있음은 platform_only를 의미합니다.
  
  값은 platform_only, platform_and_customer_mirror 또는 customer_only입니다.
  
  활성화됨 부울 필수 사항
  
  Enabled는 포인터이므로 핸들러가 생략된 필드 (nil, 거부됨)와 명시적인 false(유효한 "내보내기 비활성화" 요청)를 구분할 수 있습니다.
  
  엔드포인트 문자열
  
  엔드포인트는 고객의 OTLP/ HTTP 엔드포인트입니다. 활성화된 경우 필수입니다. https여야 하며 내부/루프백 주소 점 않아야 합니다(유효성 검사 참조).
  
  최대 길이는 2048입니다.
  
  headers 객체
  
  헤더는 사전 설정에 필요한 NON-SECRET 내보내기 헤더(예: 작업 공간 ID)를 보유합니다. 시크릿 값은 여기에 배치하지 않아야 하며, HeadersSecretRef를 사용하세요.
  
  헤더 속성 숨기기 헤더 속성 표시 객체
  
  * 문자열 additionalProperties
  
  headers_secret_ref 문자열
  
  HeadersSecretRef는 저장된 단일 인증 시크릿(일반적으로 API 키)에 대한 포인터입니다. 이는 참조이며 절대 비밀 값이 아닙니다. 호출자의 프로젝트 로 범위를 지정해야 합니다(유효성 검사 참조).
  
  최대 길이는 512입니다.
  
  insecure_skip_verify 부울
  
  InsecureSkipVerify는 고객 엔드포인트의 TLS 확인을 비활성화합니다. 포인터가 있으므로 nil(verify, 기본값)은 명시적 옵트아웃과 구별됩니다. UI 표면을 통해 의도적인 보안 감소로 이를 가능하게 합니다.
  
  protocol 문자열
  
  프로토콜은 아웃바운드 OTLP 프로토콜 입니다. v1는 http/protobuf만 지원합니다.
  
  값은 http/protobuf입니다.
  
  resource_attributes 객체
  
  ResourceAttributes는 고객 엔드포인트로 전송되는 모든 범위에 스탬프 처리된 예비 OTLP 리소스 속성입니다(예: 대상 필수 프로젝트/model 식별자). 특정 대상에 필요한 키는 해당 사전 설정에서 비롯됩니다(pkg/traceexportconfig/presets 참조). 값은 일반적으로 대상 자체 측에서 이 플랫폼이 조회할 방법이 없는 프로젝트 의 이름을 지정하기 때문에 항상 고객이 제공합니다.
  
  Resource_attributes 속성 숨기기 Resource_attributes 속성 표시 객체
  
  * 문자열 additionalProperties
  
  샘플링_정책 객체
  
  SamplingPolicy는 내보내기 전에 적용된 헤드 샘플러를 선택합니다.
  
  샘플링 정책 속성 숨기기 샘플링 정책 속성 표시 객체
  
  비율 숫자
  
  비율은 샘플링 확률(0..1)입니다. 필수이며 유형이 비율인 경우에만 사용됩니다.
  
  최소값은 0, 최대값은 1입니다.
  
  유형 문자열
  
  유형은 항상 켜짐, 꺼짐, 비율, 부모 기반 중 하나입니다.
  
  값은 always_on, always_off, ratio 또는 parent_based입니다.
  
  secret_header_name 문자열
  
  SecretHeaderName은 참조된 시크릿 값이 전송되는 헤더 이름(예: 'api_key')으로, 사전 설정의 secret_header_keys에서 가져오거나 사용자 지정 대상에 대해 사용자가 입력한 헤더 이름입니다. 이 플랫폼은 아웃바운드 " 따라서 저장된 시크릿은 항상 베어 값입니다(사전 형식의 헤더 라인이 아님). HeadersSecretRef가 설정하다 경우 필수입니다(유효성 검사 참조).
  
  최대 길이는 128입니다.
- 생성 integer
- Received_generation integer
- updated_at 문자열
응답 속성 숨기기 응답 속성 표시 객체
- config 객체
  
  구성 속성 숨기기 구성 속성 표시 객체
  
  콘텐츠 모드 문자열
  
  ContentMode는 스팬 콘텐츠 편집을 선택합니다. 비어 있음은 metadata_only를 의미합니다.
  
  값은 metadata_only 또는 full입니다.
  
  egress_mode 문자열
  
  EgressMode는 스팬이 전달될 위치를 선택합니다. 비어 있음은 platform_only를 의미합니다.
  
  값은 platform_only, platform_and_customer_mirror 또는 customer_only입니다.
  
  활성화됨 부울 필수 사항
  
  Enabled는 포인터이므로 핸들러가 생략된 필드 (nil, 거부됨)와 명시적인 false(유효한 "내보내기 비활성화" 요청)를 구분할 수 있습니다.
  
  엔드포인트 문자열
  
  엔드포인트는 고객의 OTLP/ HTTP 엔드포인트입니다. 활성화된 경우 필수입니다. https여야 하며 내부/루프백 주소 점 않아야 합니다(유효성 검사 참조).
  
  최대 길이는 2048입니다.
  
  headers 객체
  
  헤더는 사전 설정에 필요한 NON-SECRET 내보내기 헤더(예: 작업 공간 ID)를 보유합니다. 시크릿 값은 여기에 배치하지 않아야 하며, HeadersSecretRef를 사용하세요.
  
  헤더 속성 숨기기 헤더 속성 표시 객체
  
  * 문자열 additionalProperties
  
  headers_secret_ref 문자열
  
  HeadersSecretRef는 저장된 단일 인증 시크릿(일반적으로 API 키)에 대한 포인터입니다. 이는 참조이며 절대 비밀 값이 아닙니다. 호출자의 프로젝트 로 범위를 지정해야 합니다(유효성 검사 참조).
  
  최대 길이는 512입니다.
  
  insecure_skip_verify 부울
  
  InsecureSkipVerify는 고객 엔드포인트의 TLS 확인을 비활성화합니다. 포인터가 있으므로 nil(verify, 기본값)은 명시적 옵트아웃과 구별됩니다. UI 표면을 통해 의도적인 보안 감소로 이를 가능하게 합니다.
  
  protocol 문자열
  
  프로토콜은 아웃바운드 OTLP 프로토콜 입니다. v1는 http/protobuf만 지원합니다.
  
  값은 http/protobuf입니다.
  
  resource_attributes 객체
  
  ResourceAttributes는 고객 엔드포인트로 전송되는 모든 범위에 스탬프 처리된 예비 OTLP 리소스 속성입니다(예: 대상 필수 프로젝트/model 식별자). 특정 대상에 필요한 키는 해당 사전 설정에서 비롯됩니다(pkg/traceexportconfig/presets 참조). 값은 일반적으로 대상 자체 측에서 이 플랫폼이 조회할 방법이 없는 프로젝트 의 이름을 지정하기 때문에 항상 고객이 제공합니다.
  
  Resource_attributes 속성 숨기기 Resource_attributes 속성 표시 객체
  
  * 문자열 additionalProperties
  
  샘플링_정책 객체
  
  SamplingPolicy는 내보내기 전에 적용된 헤드 샘플러를 선택합니다.
  
  샘플링 정책 속성 숨기기 샘플링 정책 속성 표시 객체
  
  비율 숫자
  
  비율은 샘플링 확률(0..1)입니다. 필수이며 유형이 비율인 경우에만 사용됩니다.
  
  최소값은 0, 최대값은 1입니다.
  
  유형 문자열
  
  유형은 항상 켜짐, 꺼짐, 비율, 부모 기반 중 하나입니다.
  
  값은 always_on, always_off, ratio 또는 parent_based입니다.
  
  secret_header_name 문자열
  
  SecretHeaderName은 참조된 시크릿 값이 전송되는 헤더 이름(예: 'api_key')으로, 사전 설정의 secret_header_keys에서 가져오거나 사용자 지정 대상에 대해 사용자가 입력한 헤더 이름입니다. 이 플랫폼은 아웃바운드 " 따라서 저장된 시크릿은 항상 베어 값입니다(사전 형식의 헤더 라인이 아님). HeadersSecretRef가 설정하다 경우 필수입니다(유효성 검사 참조).
  
  최대 길이는 128입니다.
- 생성 integer
- Received_generation integer
- updated_at 문자열
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 부울
404

애플리케이션/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/config

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/trace-export/config' \
 --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)

{
  "config": {
    "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"
  },
  "generation": 42,
  "received_generation": 42,
  "updated_at": "string"
}

응답 예시(200)

{
  "config": {
    "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"
  },
  "generation": 42,
  "received_generation": 42,
  "updated_at": "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
}

응답 예시(404)

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

응답 예시(404)

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