생성¶
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 설정이 업데이트되었습니다. 새로 고친 후 다시 시도하세요 | 소스의 현재 버전을 다시 읽은 후 새 설정을 다시 구성합니다. |