추적 내보내기 벤더 사전 설정 나열

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

설정 UI (엔드포인트 템플릿, 프로토콜, 필수 비시크릿 헤더 필드, 문서 링크)를 구동하는 벤더 블라인드 사전 설정 카탈로그를 반환합니다. 비밀이 포함되어 있지 않습니다. 프로젝트 범위는 경로 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

확인
응답 속성 숨기기 응답 속성 표시 객체
- 사전 배열[객체]
  
  사전 설정 속성 숨기기 사전 설정 속성 표시 객체
  
  display_name 문자열
  
  docs_url 문자열
  
  endpoint_ Template 문자열
  
  headers 객체
  
  헤더는 고객이 이 대상에 대해 입력하는 비보안 필드(예: 작업 공간 ID)입니다. 키는 헤더 이름에 매핑됩니다. 값은 자리 표시자입니다.
  
  헤더 속성 숨기기 헤더 속성 표시 객체
  
  * 문자열 additionalProperties
  
  id 문자열
  
  protocol 문자열
  
  resource_attributes 객체
  
  ResourceAttributes는 이 대상에 필요한 OTLP 리소스 속성(예: 프로젝트 식별자)의 이름을 빈 값이 있는 자리 표시자 키로 지정합니다. 헤더와 달리 이러한 속성은 HTTP 헤더 줄이 아닌 스팬 데이터 자체 내부에 있습니다. 고객은 일반적으로 대상 자체 측에서 프로젝트 이름을 지정하기 때문에 항상 값을 제공합니다.
  
  Resource_attributes 속성 숨기기 Resource_attributes 속성 표시 객체
  
  * 문자열 additionalProperties
  
  secret_header_keys array[string]
  
  SecretHeaderKeys는 headers_secret_ref를 통해 제공된 헤더의 이름을 지정합니다. 이러한 항목은 인라인으로 저장되지 않습니다.
응답 속성 숨기기 응답 속성 표시 객체
- 사전 배열[객체]
  
  사전 설정 속성 숨기기 사전 설정 속성 표시 객체
  
  display_name 문자열
  
  docs_url 문자열
  
  endpoint_ Template 문자열
  
  headers 객체
  
  헤더는 고객이 이 대상에 대해 입력하는 비보안 필드(예: 작업 공간 ID)입니다. 키는 헤더 이름에 매핑됩니다. 값은 자리 표시자입니다.
  
  헤더 속성 숨기기 헤더 속성 표시 객체
  
  * 문자열 additionalProperties
  
  id 문자열
  
  protocol 문자열
  
  resource_attributes 객체
  
  ResourceAttributes는 이 대상에 필요한 OTLP 리소스 속성(예: 프로젝트 식별자)의 이름을 빈 값이 있는 자리 표시자 키로 지정합니다. 헤더와 달리 이러한 속성은 HTTP 헤더 줄이 아닌 스팬 데이터 자체 내부에 있습니다. 고객은 일반적으로 대상 자체 측에서 프로젝트 이름을 지정하기 때문에 항상 값을 제공합니다.
  
  Resource_attributes 속성 숨기기 Resource_attributes 속성 표시 객체
  
  * 문자열 additionalProperties
  
  secret_header_keys array[string]
  
  SecretHeaderKeys는 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
}