콘텐츠로 이동

생성



POST /api/v1/pipeline/add

개요

Pipeline을 생성하고 스크립트 구문을 동기적으로 검증합니다.

호출 전 및 사용 단계

먼저 스크립트와 샘플을 검증하고, testData를 명시적으로 제공하며(샘플 없음 W10=), 실제 소스/카테고리에 따라 생성합니다. 새 설정의 기본값은 status=0, configVersion=1입니다. 복제가 필요한 경우에도 전체 새 본문을 제출해야 하며, versionAction 및 소스 필드로 출처만 기록하고 자동 복사하지 않습니다.

기본값 충돌 시 먼저 HTTP 200과 비어 있지 않은 content.confirm을 반환하며 정상 엔터티는 없습니다. 수동 확인 후에만 동일 설정으로 isForce=true를 사용해 재시도합니다. 강제 교체는 기존 기본값을 비기본값으로 전환하고 보관합니다.

저장 시 구문을 동기적으로 검증하고 설정/버전을 갱신합니다. 실제 수집 또는 중앙 처리 적용 여부는 이후 설정 조회 및 데이터 흐름에 따라 달라집니다. 과거 데이터를 다시 실행하지 않으며 파싱 샘플 결과를 반환하지 않습니다. 수정 전에 상세 정보를 백업하고, 오류/시간 초과 후에는 먼저 현재 버전을 다시 읽은 뒤 재시도합니다.

요청 헤더

매개변수 이름 유형 필수 설명
DF-API-KEY string Y 워크스페이스의 OpenAPI 인증 자격 증명입니다.
예: <DF-API-KEY>
가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다.

Body 요청 매개변수

매개변수 이름 유형 필수 설명
source[*] string 비어 있지 않은 문자열을 권장하며, 배열은 각 항목을 엄격하게 검증하지 않습니다. 관련 없는 데이터 영역을 섞지 마세요.
예: nginx
가져오기 또는 입력 방법: 단일 실제 소스 식별자 또는 수집 측에서 지원하는 와일드카드 패턴을 사용합니다.
extend.appID[*] string 비어 있지 않은 문자열을 권장합니다.
예: appid_example
가져오기 또는 입력 방법: 애플리케이션 설정에서 단일 appId를 가져옵니다.
extend.measurement[*] string 비어 있지 않은 문자열을 권장합니다.
예: view
가져오기 또는 입력 방법: 실제 measurement 원본 이름을 사용합니다.
asDefault int 선택 사항, 기본값 0, 0/1만 지정하는 것을 권장합니다. 기본값이 이미 있고 isForce가 아닌 경우 HTTP 200으로 confirm 배열을 반환하며, 이번 대상 설정은 저장되지 않으므로 생성/수정 성공으로 간주하지 않습니다.
null 허용: False
예: 0
가져오기 또는 입력 방법: 동일 category/type의 폴백 규칙으로 사용하려면 1, 아니면 0을 지정합니다.
category string Y 필수: lineage/logging/object/custom_object/network/tracing/rum/llm/agent_monitor/security/keyevent/metric/profiling/dialtesting/cloud_billing이며, billing은 이전 버전 호환 값입니다. 수정 시 카테고리를 변경할 수 있으며 스크립트, source, extend를 함께 검토해야 합니다.
빈 문자열 허용: False
null 허용: False
선택 가능한 값: ['lineage', 'logging', 'object', 'custom_object', 'network', 'tracing', 'rum', 'llm', 'agent_monitor', 'security', 'keyevent', 'metric', 'profiling', 'dialtesting', 'billing', 'cloud_billing', 'keyevent']
예: logging
가져오기 또는 입력 방법: 대상 데이터 영역 및 수집 설정에 따라 선택합니다.
content string Y 필수 base64 문자열이며, 생성 시 디코딩 후 비어 있지 않아야 합니다. 디코딩된 스크립트 전체가 UI 문자 수 ≤1048576 및 UTF8 바이트 ≤1048576을 동시에 충족해야 합니다. BMP 비ASCII는 2로, 보충 문자는 4로 계산합니다. 둘 중 하나라도 초과하면 ft.ContextExceedLimit입니다. 저장 시 샘플 없이 동기적으로 컴파일하고 동일 카테고리의 활성화된 스크립트 참조를 검사합니다. 성공이 실제 데이터 디버깅 통과 또는 적용 완료를 의미하지는 않습니다.
null 허용: False
예: YWRkX2tleSgiZW52IiwgInByb2R1Y3Rpb24iKQ==
가져오기 또는 입력 방법: 먼저 UTF8 Pipeline 스크립트를 작성한 뒤 표준 base64로 인코딩합니다. 예시 디코딩 결과는 add_key("env", "production")입니다.
dataType string 선택 사항, 기본값 line_protocol; line_protocol/json/message를 지원합니다. 수정 시 생략하면 line_protocol로 복원됩니다. category가 아닙니다. 빈 문자열이 호환된다고 선언되어 있지만 지원되는 값을 명시적으로 선택해야 합니다.
빈 문자열 허용: True
null 허용: False
선택 가능한 값: ['line_protocol', 'json', 'message']
예: json
가져오기 또는 입력 방법: testData 샘플과 스크립트 입력에 따라 선택합니다.
enableByLogBackup int 선택 사항, 기본값 0, 0/1을 권장합니다. 저장 플래그가 기존 전송 데이터의 자동 재실행을 보장하지 않습니다.
null 허용: False
예: 0
가져오기 또는 입력 방법: 규칙으로 전송 데이터를 처리해야 할 때 1로 설정하며, 실제 데이터 전송 체인에서 지원 여부를 확인합니다.
extend json 선택 사항, 기본값 {}; 수정 시 전체를 교체하며 병합하지 않습니다. rum/llm은 appID×measurement 조합으로 소스 관계를 생성합니다. 알 수 없는 하위 필드는 공개 검증에서 거부됩니다.
null 허용: False
예: {"loggingIndex": "default"}
가져오기 또는 입력 방법: 카테고리 및 기존 상세 정보에 따라 아래 선언 필드를 구성합니다.
extend.aiTargetStructure string 선택적 문자열이며 저장 및 응답 표시만 합니다. 이 API는 스크립트를 생성하지 않습니다.
빈 문자열 허용: True
null 허용: True
예:
가져오기 또는 입력 방법: AI 생성 시의 대상 구조 설명이며, 필요하지 않으면 생략할 수 있습니다.
extend.appID array rum/llm은 measurement와 함께 비어 있지 않은 배열을 제공해야 합니다. 둘 다 비어 있으면 전용 소스가 없어도 되지만, appID가 있고 measurement가 없으면 매개변수 누락 오류가 발생합니다.
null 허용: True
예: ["appid_example"]
가져오기 또는 입력 방법: 해당 RUM/LLM 애플리케이션 관리에서 실제 appId를 가져옵니다.
extend.exampleSource string 선택적 응답 표시 필드이며 source 연결을 대신하지 않습니다.
빈 문자열 허용: True
null 허용: True
예: nginx
가져오기 또는 입력 방법: 샘플 소스 표시 값이며 실제 source와 대응해야 합니다.
extend.exampleType string 선택적 응답 표시 문자열이며 서버에서 고정 열거형을 제공하지 않습니다.
빈 문자열 허용: True
null 허용: True
예: custom
가져오기 또는 입력 방법: 샘플 유형 표시 값이며 클라이언트 비즈니스에서 정의합니다.
extend.ifAiCreate boolean 선택적 응답 표시 필드이며 AI 작업을 트리거하지 않습니다.
null 허용: True
예: false
가져오기 또는 입력 방법: AI 보조 생성 여부를 기록하며, 이 표시가 필요 없으면 생략할 수 있습니다.
extend.loggingIndex string 선택적 로그 인덱스 응답 표시 필드이며 기본적으로 값을 채우지 않습니다. 수정 시 생략하면 extend와 함께 제거됩니다. source 배열이 아닙니다.
null 허용: True
예: default
가져오기 또는 입력 방법: 적용 가능한 인덱스 식별자를 로그 인덱스 목록에서 가져옵니다.
extend.measurement array rum/llm은 appID와 카티션 조합을 생성합니다. measurement가 있고 appID가 없으면 매개변수 누락 오류가 발생하며, 저장 시 각 애플리케이션/measurement에 실제 데이터가 있는지 검증하지 않습니다.
null 허용: True
예: ["view"]
가져오기 또는 입력 방법: 해당 애플리케이션 실제 데이터의 measurement에서 가져오며, RUM view/action 등 실제 카테고리에 맞게 입력합니다.
isForce boolean 선택 사항, 기본값 false. 기본값 충돌 확인에만 사용되며 구문, 소스, 이름, 버전 등의 검증을 건너뛸 수 없습니다. 강제 교체 시 기존 기본값을 비기본값으로 전환하고 해당 버전을 보관합니다.
null 허용: False
예: false
가져오기 또는 입력 방법: content.confirm을 받은 후 기존 기본 Pipeline 교체를 확인한 뒤 true로 설정합니다.
name string Y 필수, 최대 256 계산 단위(ASCII/반각 가타카나 1, 기타 문자 2), 영숫자, 밑줄, 중국어 U+4e00..9fa5 및 하이픈을 허용합니다. 비어 있지 않은 문자열을 권장합니다. 동일 category에서는 local/central이 다르거나 기존 항목이 비활성화되어 있어도 중복을 허용하지 않습니다. 입력 로그 source가 아닙니다.
null 허용: False
최대 길이: 256
$notSearchRegExp: [^a-zA-Z0-9_\u4e00-\u9fa5-]+
예: production_parser
가져오기 또는 입력 방법: 비즈니스에서 정의한 파일 이름을 사용하며, 먼저 Pipeline 목록에서 동일 카테고리의 삭제되지 않은 이름을 확인합니다.
source array 선택 사항, 기본값 []; 수정 시 생략하면 모든 소스 관계가 제거됩니다. * 또는 ?를 포함하는 소스는 정확한 유일성 충돌 검사에 참여하지 않으며, 모든 일치 항목의 런타임 동작을 보장하지 않습니다. 일반 정확한 소스는 동일 category/type 내에서 다른 삭제되지 않은 Pipeline이 점유할 수 없습니다. rum/llm 생성/수정 시 이 배열은 무시되고 extend.appID와 measurement를 사용합니다.
null 허용: False
예: ["nginx"]
가져오기 또는 입력 방법: 해당 수집 데이터의 source 또는 소스 선택기에서 값을 가져오며 Pipeline 이름이 아닙니다. 로그는 실제 로그 source를 참고할 수 있습니다.
sourceConfigVersion integer current_clone 조건에서 필수, ≥1; 소스 버전 확인에 사용하며 충돌 시 HTTP 409가 반환됩니다. 대상의 새 버전이 아닙니다.
null 허용: False
$minValue: 1
예: 1
가져오기 또는 입력 방법: 소스의 현재 상세 정보에서 configVersion을 읽습니다.
sourcePipelineUUID string current_clone 조건에서 필수, 소스는 삭제되지 않은 상태여야 하며 이번에도 새 객체를 생성합니다.
빈 문자열 허용: False
null 허용: False
예: pl_example
가져오기 또는 입력 방법: Pipeline 목록에서 이 워크스페이스의 소스 uuid를 가져옵니다.
sourceTemplateName string official_clone 조건에서 필수, 템플릿 존재 여부를 확인합니다. 새 name이 아니며 템플릿 본문을 자동으로 복사하지 않습니다.
빈 문자열 허용: False
null 허용: False
예: nginx
가져오기 또는 입력 방법: 공식 템플릿 표시에서 가져온 실제 템플릿 이름이며 현재 언어 기준의 폴백으로 해석합니다.
testData string 선언상 선택 사항이지만, 생성 시 생략하면 controller가 None을 디코딩하여 InvalidBase64를 반환할 수 있으므로 항상 W10= 또는 빈 문자열을 명시적으로 제공해야 합니다. 수정 시 생략하면 빈 문자열로 복원됩니다. 공개 add/modify는 빈 문자열 또는 엄격한 base64 디코딩 후 비어 있거나 JSON 배열인 값만 허용하며, 단일 객체를 직접 인코딩할 수 없습니다. 배열 구성원은 문자열 또는 객체를 권장합니다. 숫자/null은 이전 버전의 항목별 길이 검증에서 500을 유발할 수 있습니다. 각 항목의 이전 버전 제한은 약 20480이며(객체는 직렬화된 객체 메모리 크기, 문자열은 이전 버전 가중 길이 기준), 스크립트의 1MiB 제한과 다릅니다.
빈 문자열 허용: True
null 허용: False
예: W3sibWVzc2FnZSI6ImV4YW1wbGUgbG9nIn1d
가져오기 또는 입력 방법: 먼저 샘플 배열을 JSON으로 직렬화한 뒤 UTF8로 인코딩하고 base64로 변환합니다. 빈 배열 []는 W10=입니다.
type string Y 필수 local/central; 신서틱 테스트(dialtesting)는 생성/수정 시 central만 가능합니다. 워크스페이스 버전에 따라 central이 제한될 수 있습니다. 수정 시 기존 실행 유형을 대체합니다.
null 허용: False
선택 가능한 값: ['local', 'central']
예: local
가져오기 또는 입력 방법: 로컬 수집기에서 처리하려면 local, 플랫폼 중앙에서 처리하려면 central을 선택하고 실제 데이터 진입점을 확인합니다.
versionAction string 생성 시 선택 사항이며 생략하면 create로 기록됩니다. 이 매개변수는 소스를 확인하고 기록할 뿐 content/source/extend 등을 대신 복사하지 않으므로 전체 새 설정을 제출해야 합니다.
null 허용: False
선택 가능한 값: ['official_clone', 'current_clone']
예: current_clone
가져오기 또는 입력 방법: 복제 소스만 기록해야 할 때 official_clone 또는 current_clone을 선택합니다.

요청 예

curl --request POST 'https://openapi.guance.com/api/v1/pipeline/add' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"name":"production_parser","type":"local","category":"logging","content":"YWRkX2tleSgiZW52IiwgInByb2R1Y3Rpb24iKQ==","testData":"W3sibWVzc2FnZSI6ImV4YW1wbGUgbG9nIn1d","dataType":"json","asDefault":0,"enableByLogBackup":0,"extend":{"loggingIndex":"default"},"source":["nginx"]}'

응답

HTTP 200, application/json. 아래 예는 바로 읽을 수 있는 주요 필드를 보여줍니다.

필드 유형 설명
content.id integer 데이터베이스 번호이며 uuid로 작업합니다.
content.uuid string pl_ 객체 UUID입니다.
content.workspaceUUID string 소속 워크스페이스이며 시스템 템플릿은 빈 문자열입니다.
content.isSysTemplate string / integer / boolean 시스템 템플릿 여부입니다. 엔터티는 Text 컬럼이며 문자열 표시가 반환될 수 있습니다. 실제 표시에 따라 파싱하고 문자열이 비어 있지 않은지만으로 직접 판단하지 않습니다.
content.isCustomSysTemp integer 또는 boolean 사용자 정의 시스템 템플릿 여부입니다.
content.language string 템플릿/설정 언어이며 빈 문자열일 수 있습니다.
content.status integer 0 활성화, 2 비활성화, 3 삭제.
content.creator string 생성 주체입니다.
content.updator string 최근 업데이트 주체입니다.
content.createAt integer 생성 Unix 초입니다.
content.updateAt integer 업데이트 Unix 초입니다.
content.deleteAt integer 삭제 Unix 초이며 삭제되지 않은 경우 -1입니다.
content.name string 저장 설정: 필수, 최대 256 계산 단위(ASCII/반각 가타카나 1, 기타 문자 2), 영숫자, 밑줄, 중국어 U+4e00..9fa5 및 하이픈을 허용합니다. 비어 있지 않은 문자열을 권장합니다. 동일 category에서는 local/central이 다르거나 기존 항목이 비활성화되어 있어도 중복을 허용하지 않습니다. 입력 로그 source가 아닙니다.
content.type string 저장 설정: 필수 local/central; 신서틱 테스트(dialtesting)는 생성/수정 시 central만 가능합니다. 워크스페이스 버전에 따라 central이 제한될 수 있습니다. 수정 시 기존 실행 유형을 대체합니다.
content.category string 저장 설정: 필수: lineage/logging/object/custom_object/network/tracing/rum/llm/agent_monitor/security/keyevent/metric/profiling/dialtesting/cloud_billing이며, billing은 이전 버전 호환 값입니다. 수정 시 카테고리를 변경할 수 있으며 스크립트, source, extend를 함께 검토해야 합니다.
content.content string 저장 설정: 필수 base64 문자열이며, 생성 시 디코딩 후 비어 있지 않아야 합니다. 디코딩된 스크립트 전체가 UI 문자 수 ≤1048576 및 UTF8 바이트 ≤1048576을 동시에 충족해야 합니다. BMP 비ASCII는 2로, 보충 문자는 4로 계산합니다. 둘 중 하나라도 초과하면 ft.ContextExceedLimit입니다. 저장 시 샘플 없이 동기적으로 컴파일하고 동일 카테고리의 활성화된 스크립트 참조를 검사합니다. 성공이 실제 데이터 디버깅 통과 또는 적용 완료를 의미하지는 않습니다.
content.testData string 저장 설정: 선언상 선택 사항이지만, 생성 시 생략하면 controller가 None을 디코딩하여 InvalidBase64를 반환할 수 있으므로 항상 W10= 또는 빈 문자열을 명시적으로 제공해야 합니다. 수정 시 생략하면 빈 문자열로 복원됩니다. 공개 add/modify는 빈 문자열 또는 엄격한 base64 디코딩 후 비어 있거나 JSON 배열인 값만 허용하며, 단일 객체를 직접 인코딩할 수 없습니다. 배열 구성원은 문자열 또는 객체를 권장합니다. 숫자/null은 이전 버전의 항목별 길이 검증에서 500을 유발할 수 있습니다. 각 항목의 이전 버전 제한은 약 20480이며(객체는 직렬화된 객체 메모리 크기, 문자열은 이전 버전 가중 길이 기준), 스크립트의 1MiB 제한과 다릅니다.
content.dataType string 저장 설정: 선택 사항, 기본값 line_protocol; line_protocol/json/message를 지원합니다. 수정 시 생략하면 line_protocol로 복원됩니다. category가 아닙니다. 빈 문자열이 호환된다고 선언되어 있지만 지원되는 값을 명시적으로 선택해야 합니다.
content.asDefault integer 저장 설정: 선택 사항, 기본값 0, 0/1만 지정하는 것을 권장합니다. 기본값이 이미 있고 isForce가 아닌 경우 HTTP 200으로 confirm 배열을 반환하며, 이번 대상 설정은 저장되지 않으므로 생성/수정 성공으로 간주하지 않습니다.
content.enableByLogBackup integer 저장 설정: 선택 사항, 기본값 0, 0/1을 권장합니다. 저장 플래그가 기존 전송 데이터의 자동 재실행을 보장하지 않습니다.
content.extend json 저장 설정: 선택 사항, 기본값 {}; 수정 시 전체를 교체하며 병합하지 않습니다. rum/llm은 appID×measurement 조합으로 소스 관계를 생성합니다. 알 수 없는 하위 필드는 공개 검증에서 거부됩니다.
content.extend.appID array 저장 설정: rum/llm은 measurement와 함께 비어 있지 않은 배열을 제공해야 합니다. 둘 다 비어 있으면 전용 소스가 없어도 되지만, appID가 있고 measurement가 없으면 매개변수 누락 오류가 발생합니다.
content.extend.measurement array 저장 설정: rum/llm은 appID와 카티션 조합을 생성합니다. measurement가 있고 appID가 없으면 매개변수 누락 오류가 발생하며, 저장 시 각 애플리케이션/measurement에 실제 데이터가 있는지 검증하지 않습니다.
content.extend.loggingIndex string 저장 설정: 선택적 로그 인덱스 응답 표시 필드이며 기본적으로 값을 채우지 않습니다. 수정 시 생략하면 extend와 함께 제거됩니다. source 배열이 아닙니다.
content.extend.ifAiCreate boolean 저장 설정: 선택적 응답 표시 필드이며 AI 작업을 트리거하지 않습니다.
content.extend.aiTargetStructure string 저장 설정: 선택적 문자열이며 저장 및 응답 표시만 합니다. 이 API는 스크립트를 생성하지 않습니다.
content.extend.exampleSource string 저장 설정: 선택적 응답 표시 필드이며 source 연결을 대신하지 않습니다.
content.extend.exampleType string 저장 설정: 선택적 응답 표시 문자열이며 서버에서 고정 열거형을 제공하지 않습니다.
content.extend.appID[] string 저장 설정: 비어 있지 않은 문자열을 권장합니다.
content.extend.measurement[] string 저장 설정: 비어 있지 않은 문자열을 권장합니다.
content.configVersion integer 현재 설정 버전, 초기 1; 설정에 실제 변경이 발생하면 증가하며, 시작/중지는 설정 스냅샷 필드가 아닙니다.
content.configVersionAt integer 해당 설정 버전 적용 기록 시간, Unix 초입니다.
content.configVersionOperator string 해당 버전 작업자 주체입니다.
content.configVersionSource string 소스입니다(예: openapi/console/history/workspace_restore/legacy/system).
content.configVersionAction string 예: create/modify/import/official_clone/current_clone/history_restore/history_clone/default_replace/baseline.
content.configVersionSourceInfo object 소스 작업 정보이며 소스가 없으면 {}이고, 필드는 작업에 따라 생략할 수 있습니다.
content.configVersionSourceInfo.templateName string 공식 복제 소스 템플릿 이름입니다.
content.configVersionSourceInfo.pipelineUUID string 소스 Pipeline UUID입니다.
content.configVersionSourceInfo.configVersion integer 소스 설정 버전 번호입니다.
content.configVersionSourceInfo.pipelineHistoryUUID string 이력 복제/복구 소스 이력 UUID입니다.
content.configVersionSourceInfo.replacedByName string 기본값 교체로 인해 발생한 새 파일 이름입니다.
content.configVersionSourceInfo.replacedByPipelineUUID string 기본값 교체로 인해 발생한 Pipeline UUID입니다.
content.declaration object 공통 선언입니다.
content.confirm array<string> 기본값 충돌 시 정상 엔터티를 대체하며, 교체 확인이 필요한 카테고리를 나열합니다. 이 분기에서는 이번 대상이 저장되지 않습니다.
content.confirm[] string 단일 카테고리입니다.
content.pl_errors array<object> ft.PipelineSyntaxError 오류의 content에서만 반환되는 컴파일 오류 배열입니다.
content.pl_errors[].error string 컴파일 오류 설명입니다.
content.pl_errors[].pos_chain array<object> 참조/위치 체인입니다.
content.pl_errors[].pos_chain[].file string 파일 이름입니다.
content.pl_errors[].pos_chain[].ln integer 음수가 아닌 위치 인덱스이며 컴파일러에서 정의합니다. 원래 값을 보존하여 문제를 조사합니다.
content.pl_errors[].pos_chain[].col integer 음수가 아닌 위치 인덱스이며 컴파일러에서 정의합니다. 원래 값을 보존하여 문제를 조사합니다.
content.pl_errors[].pos_chain[].pos integer 음수가 아닌 위치 인덱스이며 컴파일러에서 정의합니다. 원래 값을 보존하여 문제를 조사합니다.
{
  "code": 200,
  "content": {
    "id": 100,
    "uuid": "pl_example",
    "workspaceUUID": "wksp_example",
    "name": "production_parser",
    "type": "local",
    "category": "logging",
    "content": "YWRkX2tleSgiZW52IiwgInByb2R1Y3Rpb24iKQ==",
    "testData": "W3sibWVzc2FnZSI6ImV4YW1wbGUgbG9nIn1d",
    "dataType": "json",
    "asDefault": 0,
    "enableByLogBackup": 0,
    "extend": {
      "loggingIndex": "default"
    },
    "isSysTemplate": 0,
    "isCustomSysTemp": 0,
    "language": "",
    "status": 0,
    "creator": "wsak_example",
    "updator": "wsak_example",
    "createAt": 1785427200,
    "updateAt": 1785427200,
    "deleteAt": -1,
    "configVersion": 1,
    "configVersionAt": 1785427200,
    "configVersionOperator": "wsak_example",
    "configVersionSource": "openapi",
    "configVersionAction": "create",
    "configVersionSourceInfo": {},
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

기본값 교체 확인 대기:

{
  "code": 200,
  "content": {
    "confirm": [
      "logging"
    ],
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.

HTTP 상태 errorCode 발생 조건 메시지 또는 응답 설명 처리 방법
406 ft.ParameterValidationFailed 요청 필드 누락 또는 필드 값이 선언된 검증 조건 위반 매개변수 파싱 실패 매개변수 위치, 필드 이름, 유형 및 값을 확인합니다.
400 ft.RequestJsonFormatError 요청 JSON 구문이 유효하지 않음 요청 JSON 형식 오류 content.reason, line, column에 따라 JSON을 수정합니다.
406 ft.InvalidBase64 스크립트/테스트 샘플이 디코딩 가능한 UTF8 base64가 아님, 생성 시 testData를 생략해도 발생할 수 있음 유효하지 않은 base64 내용 content와 testData를 완전히 제공하고 먼저 UTF8로 인코딩한 뒤 base64로 변환합니다.
406 ft.ContextExceedLimit 스크립트가 UI 문자 수 또는 UTF8 바이트 1MiB를 초과하거나 add/modify 단일 테스트 샘플이 이전 버전 길이를 초과함 텍스트 내용이 제한을 초과했습니다, 제한 {}개 문자 스크립트/단일 샘플을 줄이고 message에 표시된 단위를 확인합니다.
406 ft.PipelineSyntaxError 동기 샘플 없는 컴파일에서 스크립트 또는 참조 구문 오류 반환 Pipeline 스크립트 구문 오류, 오류 위치를 확인하세요 content.pl_errors의 error 및 pos_chain에 따라 위치를 찾아 수정한 뒤 재시도합니다.
400 ft.PipelineNameExists 같은 워크스페이스, 같은 category에 삭제되지 않은 같은 이름의 스크립트가 존재 같은 이름의 Pipeline이 이미 존재합니다 이름을 변경하거나 기존 UUID를 업데이트합니다.
400 ft.PipelineSourceExists 동일 category/type에 이미 삭제되지 않은 규칙이 동일한 정확한 source를 점유 해당 유형 Pipeline의 source 소스가 이미 존재합니다 소스 바인딩을 확인하고 적절한 소스로 변경합니다. 와일드카드 항목은 이 검사에 참여하지 않습니다.
403 ft.ForbiddenFreeEditionWorkspace 워크스페이스 버전의 Pipeline 실행 유형 제한에서 해당 type을 허용하지 않음 무료 플랜 워크스페이스는 이 기능을 지원하지 않습니다. 상용 플랜을 활성화하여 제한을 해제할 수 있습니다 관리자가 워크스페이스 버전 및 지원 실행 방식을 확인합니다.
500 ft.InternalServerError 동기 컴파일 서비스 사용 불가/시간 초과/형식 이상(내부 PipelineValidationUnavailable이 최종적으로 통합 래핑됨), 데이터베이스, 구조 오류 또는 제출 후 포맷팅 실패 내부 오류 잠시 후 재시도하기 전에 현재 설정과 버전을 읽어 저장 여부를 확인합니다. 계속 실패하면 traceId를 제공합니다.
406 ft.DialingPipelineOnlyCentral dialtesting에서 local 선택 신서틱 테스트 pipeline은 중앙 pipeline 설정만 지원합니다 지원되는 central로 변경하고 워크스페이스 버전을 확인합니다.
406 ft.MissingNeededParmeterAppID rum/llm의 appID와 measurement 중 한쪽만 제공 appID를 지정해야 합니다 둘 다 제공하거나 둘 다 비워 둡니다. 수정과 생성의 오류 키에는 이전 버전 호환 차이가 있습니다.
406 ft.InvalidPipelineContent 생성 시 디코딩된 스크립트가 비어 있음 유효하지 않은 pipeline content 비어 있지 않은 유효한 스크립트를 제공합니다.
406 ft.InvalidPipelineTestData 공개 testData 디코딩 결과가 JSON 배열이 아님 유효하지 않은 pipeline testData이며 base64 디코딩 후 비어 있거나 JSON 배열이어야 합니다 먼저 배열을 JSON으로 직렬화한 뒤 base64로 변환합니다.
403 ft.ForbiddenFreeWKSPCentralPipeline 무료/체험 워크스페이스에서 central 생성 체험 워크스페이스는 중앙 pipeline 설정을 지원하지 않습니다 중앙 처리를 지원하는 버전인지 확인합니다.
406 ft.MissingNeededParmeterSource 생성 시 rum/llm에 measurement가 있지만 appID가 없음 appID가 있는 경우 source는 필수 항목입니다 두 배열을 모두 제공합니다.
406 ft.InvalidParameter 복제 소스 추적 작업에 소스 이름/UUID/버전 누락 매개변수 {}가 유효하지 않습니다 versionAction에 따라 해당 소스 필드를 보완합니다.
404 ft.NotFoundPipelineCfg 이 워크스페이스의 Pipeline/이력이 없거나 삭제되었거나 해당 주 설정이 삭제됨 지정된 Pipeline 설정을 찾을 수 없습니다 현재 목록/이력 목록에서 UUID를 다시 가져옵니다.
409 ft.PipelineConfigVersionConflict current_clone 소스 버전이 변경됨 Pipeline 설정이 업데이트되었습니다. 새로 고친 후 다시 시도하세요 소스의 현재 버전을 다시 읽은 후 새 설정을 다시 구성합니다.

문서 평가

이 페이지가 도움이 되었나요?