콘텐츠로 이동

자동 검색 구성 생성



POST /api/v1/issue_auto_discovery/add

개요

이벤트 집계 기반의 Issue 자동 검색 구성을 생성합니다.

호출 전 및 사용 단계

이 모듈은 기존 인시던트 Issue 자동 검색 구성이며, 인시던트 센터의 교대/자동 집계도, 오류 추적(ErrorTrack) 규칙도 아닙니다. 현재 공개 쓰기 dqlNamespace는 keyevent만 가능하며, rum/tracing 예전 예시는 현재 선언과 부합하지 않습니다. 백그라운드에서 이미 issueUpgrade=true로 마이그레이션된 워크스페이스는 이 v2 자동 검색 작업을 건너뛰므로, 구성 성공만으로 해당 워크스페이스에서 새 Issue가 생성된다고 보장할 수 없습니다.

권한은 trace.issueDiscovery/rum.issueDiscovery/anomaly.issueDiscovery 중 하나를 충족해야 합니다. 규칙 name과 생성되는 Issue의 config.name은 서로 다른 필드입니다. every는 300/600/900/1800/3600만 가능하며, 60은 예전 열거형에 나타나지만 사전 최소값 검사에서 거부됩니다. dimensions에는 명시적으로 비어 있지 않은 필드명을 지정하고, config에는 description, channelUUIDs, extend.text를 명시적으로 지정하십시오. 그렇지 않으면 저장에 성공하더라도 키 누락/유효하지 않은 쿼리로 인해 작업이 실패할 수 있습니다.

규칙 이름은 워크스페이스 내에서 유일하지만 멱등 키가 없습니다. 결과가 불명확하면 먼저 이름과 내용을 조회하고 중복 생성하지 마십시오.

config.extend.manager는 정규화되며, 알 수 없는 계정/대상은 조용히 제외될 수 있습니다. 명시적 null은 선언상 허용되지만 현재 감사/처리에서 바로 .get을 호출해 500이 발생하므로 전달하지 마십시오. dutyPerson을 사용하면 기존 인시던트 알림 일정을 사용하며, 인시던트 센터 교대가 아닙니다. {{변수}}는 그룹 태그/집계 count의 word 키로만 치환되며, 알 수 없는 변수는 그대로 유지되고 임의의 템플릿 코드는 실행되지 않습니다.

구성을 저장해도 쿼리가 즉시 실행되거나 생성 작업이 반환되지 않습니다. Asia/Shanghai 캘린더에 맞춰 주기적으로 정렬되어 이전 every초 구간을 처리하며, 작업 큐/쿼리 소요 시간으로 인해 지연될 수 있습니다. keyevent는 monitor 이벤트에서 집계되며 dimensions에 따라 최대 1000개 그룹을 생성하고, 광범위한 범위의 완전한 커버리지를 보장하지 않습니다. 그룹화 디멘션을 정렬한 JSON으로 중복 식별자를 생성하며 규칙 UUID는 이 식별자에 포함되지 않으므로, 동일 워크스페이스에서 동일 디멘션 값을 가진 여러 규칙이 동일한 기존 Issue에 연결될 수 있습니다. 디멘션/필터를 수정하면 그룹 결과가 달라질 수 있으니, 이를 규칙별로 독립적이며 절대 교차하지 않는 Issue 집합으로 간주하지 마십시오. Open/Pending에는 답글이 추가되고, Resolved는 재오픈되어 회귀하며, Closed는 재사용되지 않습니다. 과거 Working 분기는 실제 구현에 따라 처리되며, 작업 중 완전한 격리를 보장하지 않습니다. 알림은 비동기이므로 HTTP 200이 데이터 쿼리 성공/새 Issue 생성/알림 전달을 의미하지 않습니다.

요청 헤더

파라미터명 유형 필수 설명
DF-API-KEY string Y 워크스페이스의 OpenAPI 인증 자격 증명입니다.
예시: <DF-API-KEY>
획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 획득합니다.

Body 요청 파라미터

파라미터명 유형 필수 설명
dimensions[*] string 단일 필드명 문자열입니다. 소스 선언은 하위 항목을 제약하지 않습니다. 문자열이 아니면 동기 감사 자료 조합 시 500이 발생합니다. add는 보통 제출 전에 실패하고, modify는 첫 제출 후에 실패할 수 있습니다. 문자열이지만 필드가 존재하지 않으면 백그라운드 쿼리 시 실패하거나 데이터가 없을 수 있습니다. 백틱/전체 쿼리 조각을 필드명으로 사용하지 마십시오.
예시: service
획득 또는 입력 방법: 이벤트 필드/태그명이며, 모든 대상 데이터에 해당 필드가 있는지 확인하십시오.
config.channelUUIDs[*] string 단일 활성 채널 UUID입니다. 디멘션 필드/팀 UUID가 아니며, 알 수 없거나 비활성화된 경우 404입니다.
예시: chan_example
획득 또는 입력 방법: 현재 워크스페이스 채널 목록의 uuid입니다.
config.extend.text string 명시적 문자열을 권장합니다. 작업이 읽어서 템플릿 치환하며, 누락/비문자열이면 비동기적으로 실패할 수 있습니다. config.description과 각각 별도로 저장되는 텍스트 필드입니다.
예시: 서비스{{service}}에서 {{count}}개 이벤트 발견
획득 또는 입력 방법: dimensions 태그 및 집계 count에 따라 Issue 본문 템플릿을 구성합니다.
config.extend.manager array 선택적 담당자 문자열 배열입니다. 유효한 acnt_/현재 워크스페이스 팀/이메일/dutyPerson은 유지되며, 알 수 없는 계정/알 수 없는 값은 조용히 제외될 수 있고 항목별 오류를 보장하지 않습니다. 무료/체험 워크스페이스는 외부 이메일을 지원하지 않으며 400이 발생할 수 있습니다. 담당자가 없으면 미할당 에스컬레이션 절차로 진행될 수 있습니다.
예시: []
획득 또는 입력 방법: 워크스페이스 멤버에서 acnt_를, 팀 목록에서 group_을 가져오거나, 멤버/허용된 외부 이메일을 사용합니다. 기존 인시던트의 오늘 온콜 담당자가 필요하면 리터럴 값 dutyPerson을 사용하며, 구성은 알림 일정을 참조하십시오.
config.extend.manager[*] string 유효한 주체, 이메일 또는 dutyPerson 하나입니다. 문자열이 아니면 문자열 startswith 처리 시 500이 발생할 수 있습니다.
예시: acnt_example
획득 또는 입력 방법: 워크스페이스 멤버에서 acnt_를, 팀 목록에서 group_을 가져오거나, 멤버/허용된 외부 이메일을 사용합니다. 기존 인시던트의 오늘 온콜 담당자가 필요하면 리터럴 값 dutyPerson을 사용하며, 구성은 알림 일정을 참조하십시오.
config.extend.conditionsInputFilters any 선택적 임의 JSON으로, 과거 Issue/알림 이벤트 이동 시 보충 필터를 되돌려 표시하기 위한 것입니다. 실제 쿼리는 여전히 최상위 conditions를 사용하며, 이 키만 수정해 대체할 수 없습니다.
예시: {}
획득 또는 입력 방법: 인시던트 조건 편집기에서 표시용 구조를 제공할 수 있습니다.
config.extend.variable json 요청에 입력하지 않는 것을 권장합니다. 작업이 실제 쿼리 컬럼으로 해당 객체를 덮어쓰며, 일반적인 count는 구간 내 건수입니다.
예시: {"count": 8}
획득 또는 입력 방법: 생성 작업 실행 시 집계 변수를 계산합니다.
config.extend.variable.count integer 런타임 발생 횟수이며, 호출자가 입력한 값은 신뢰할 수 있는 고정 값으로 적용되지 않습니다.
예시: 8
획득 또는 입력 방법: 백그라운드에서 이 구간의 count(*) 쿼리로 계산합니다.
config.extend.tags json 요청에 입력하지 않는 것을 권장합니다. 작업이 실제 그룹 태그로 덮어쓰며, Issue 중복 제거 및 템플릿 변수에 사용됩니다.
예시: {"service": "payment"}
획득 또는 입력 방법: 생성 작업이 그룹 태그로부터 가져옵니다.
config.extend.tags.필드 any 동적 JSON 태그 값이며, 호출자가 직접 입력한 값으로 그룹 생성을 고정할 수 없습니다.
예시: payment
획득 또는 입력 방법: dimensions에 대응하는 이벤트 태그 값에서 가져옵니다.
config.extend.channelUUIDs array 런타임에 유효한 구성 채널로 덮어써지며, 이 확장 필드로 config.channelUUIDs를 대체하지 마십시오.
예시: []
획득 또는 입력 방법: 작업이 config.channelUUIDs에 따라 현재 유효한 채널을 필터링한 후 기록합니다.
config.extend.channelUUIDs[*] string 런타임에 유효한 채널 식별자 하나입니다.
예시: chan_example
획득 또는 입력 방법: 현재 워크스페이스의 유효한 채널 uuid입니다.
config.extend.사용자 정의 키 any 임의 JSON 저장 값이며, 이 페이지에서 공개된 추가 실행 보장은 없습니다. 자격 증명을 넣지 마십시오.
예시: value
획득 또는 입력 방법: 호출자 비즈니스 표시용 확장입니다.
conditions string 선택적 문자열로, 필터 표현식만이며 전체 DQL/JSON이 아닙니다. 생성 시 생략하면 비어 있고, 수정 시 생략하면 유지, 빈 값이면 제거됩니다. 현재 저장 시 DQL을 파싱하지 않으므로 구문/필드 유효성을 보장하지 않고, 비동기 작업 실패가 이번 인터페이스 오류로 변환되지 않습니다. 엔터티 컬럼은 48자이며 선언에는 길이 제한이 없으므로 짧은 표현식을 권장하고 관리자가 배포 컬럼 제한을 확인해야 합니다.
빈 문자열 허용: True
null 허용: False
예시: `df_status` = 'error'
획득 또는 입력 방법: 대상 monitor 이벤트의 실제 필드로 DQL 필터 조건을 구성하며, 먼저 쿼리 도구에서 동일한 시간 범위로 검증할 수 있습니다.
config json Y 필수 객체이며, 수정 시 매번 전체 교체되고 재귀 병합되지 않습니다. name/level/channelUUIDs/description/extend 5개의 선언된 키만 허용됩니다. 이후 작업의 안정적인 실행을 위해 선택 사항이라도 description, channelUUIDs 배열, extend 객체 및 extend.text 문자열을 명시적으로 제공할 것을 권장합니다. 누락 시 저장은 성공하지만 작업이 실패할 수 있습니다.
null 허용: False
예시: {"name": "서비스{{service}} 알림", "description": "이 구간 {{count}}개 이벤트", "channelUUIDs": [], "extend": {"text": "서비스{{service}}에서 {{count}}개 이벤트 발견", "manager": []}}
획득 또는 입력 방법: 이 페이지의 템플릿 구성에 따라 Issue 제목, 본문, 채널 및 담당자를 생성합니다.
config.channelUUIDs array 선택적 채널 UUID 배열이며, 명시된 항목은 현재 활성이어야 합니다. 항상 [] 또는 유효한 배열을 전달할 것을 권장하며, 생략하면 저장은 가능하지만 작업에서 None을 순회하다 실패할 수 있습니다. 작업이 자동으로 기본 채널 연결을 보충하지만, 저장 자체는 []여도 워크스페이스에 최소 하나의 활성 채널이 있어야 합니다.
null 허용: False
예시: []
획득 또는 입력 방법: 채널 목록에서 현재 워크스페이스의 활성 chan_ UUID를 가져옵니다.
config.description string 선언상 선택적 문자열이지만 이후 작업이 이 키를 직접 읽으므로 항상 명시적으로 제공할 것을 권장합니다(빈 문자열 가능). config 수정 시 전체 교체되므로 하위 키를 생략해도 이전 값이 유지되지 않습니다.
null 허용: False
예시: 이 구간 {{count}}개 이벤트
획득 또는 입력 방법: 동일한 템플릿 변수로 Issue 설명을 구성합니다.
config.extend json 선택적 객체 또는 null입니다. 실제 생성/수정 감사 자료는 extend.get을 직접 호출하므로 명시적 null은 500을 발생시키며, 생성은 보통 제출 전, 수정의 과거 감사는 제출 후 실패할 수 있습니다. 항상 text를 포함한 객체를 전달할 것을 권장하며, 생략해도 저장 후 extend/text 누락으로 작업이 실패할 수 있습니다. 객체가 나타나면 전체 교체되며 임의의 하위 값은 유효한 구조를 유지해야 합니다.
null 허용: True
예시: {"text": "서비스{{service}}에서 {{count}}개 이벤트 발견", "manager": []}
획득 또는 입력 방법: Issue 생성의 표시 확장을 참조하되, 이 페이지에서 확인된 소비 필드를 기준으로 하십시오.
config.level string 선택적 등급 UUID 또는 빈 문자열이며, 비어 있지 않으면 현재 유효해야 하고 그렇지 않으면 406입니다. 생략하면 지정 등급이 없습니다. 인시던트 센터 등급 UUID의 범용 대체 필드가 아닙니다.
빈 문자열 허용: True
null 허용: False
예시: system_level_0
획득 또는 입력 방법: Issue 등급 목록에서 uuid를 가져오며, 백그라운드에서 전역 등급을 활성화한 경우 관리자 구성이 우선합니다.
config.name string Y 필수 문자열 최대 256자이며, Issue 제목 템플릿으로 규칙 name과 다릅니다. {{service}}/{{count}} 등 word 변수명을 지원하고 알 수 없는 변수는 그대로 유지됩니다. 임의의 Python/Jinja 표현식은 지원하지 않으며, 점/하이픈이 있는 필드는 치환이 보장되지 않습니다.
null 허용: False
최대 길이: 256
예시: 서비스{{service}} 알림
획득 또는 입력 방법: dimensions 필드 및 집계 변수 count에 따라 제목 템플릿을 구성합니다.
description string 선택적 문자열이며 빈 값을 허용합니다. 생성 시 생략하면 비어 있고, 수정 시 생략하면 유지, 명시적 빈 값이면 제거됩니다. Issue 본문 템플릿으로 사용되지 않습니다.
빈 문자열 허용: True
null 허용: False
예시: 서비스별 프로덕션 알림 집계
획득 또는 입력 방법: 호출자가 규칙 용도 설명을 작성합니다.
dimensions array 선택적 배열이며, 나타나면 최소 한 항목입니다. 생성 시 생략하면 []로 저장되지만 작업이 by 문을 구성할 때 유효하지 않을 수 있으므로 항상 비어 있지 않은 실제 필드를 제공할 것을 권장합니다. 수정 시 생략하면 유지되고, []는 사전 검사에서 406이므로 비우는 데 사용할 수 없습니다. 채널 UUID가 아닌 필드명이며, 필드 순서/집합이 그룹 쿼리에 영향을 주고 df_label은 집합 기준으로 집계됩니다.
null 허용: False
최소 길이: 1
예시: ["service"]
획득 또는 입력 방법: 이벤트의 실제 태그 필드에서 그룹 중복 제거에 사용할 필드명을 선택합니다(예: service, host 또는 df_label).
dqlNamespace string Y 필수이며, 공개 열거형은 keyevent 하나입니다. rum/tracing이 아니며, 과거 엔터티/예시에서 다른 값을 허용했다고 해서 전달할 수 없습니다.
null 허용: False
허용 값: ['keyevent']
예시: keyevent
획득 또는 입력 방법: 현재 공개 범위는 keyevent 이벤트 범위로 고정되어 있습니다.
every integer Y 필수 정수이며, 300/600/900/1800/3600만 가능합니다. 과거 열거형에 60이 포함되어 있지만 최소값 300이 동시에 적용되어 60은 공개 라우트에서 406이며, 1분은 선택할 수 없습니다.
null 허용: False
허용 값: [60, 300, 600, 900, 1800, 3600]
$maxValue: 3600
$minValue: 300
예시: 300
획득 또는 입력 방법: 발견 지연과 쿼리량에 따라 주기 초 수를 선택합니다.
name string Y 필수 문자열 최대 256자입니다. 선언상 비어 있지 않음을 강제하지 않지만 비어 있지 않게 권장합니다. 동일 워크스페이스에서 삭제되지 않은 규칙 이름은 중복될 수 없습니다. 수정 시에도 필수이며, 규칙 이름이지 생성되는 Issue 제목이 아닙니다.
null 허용: False
최대 길이: 256
예시: 프로덕션 이벤트 자동 검색
획득 또는 입력 방법: 유지 관리자가 워크스페이스 내에서 유일한 규칙 이름을 작성합니다.

파라미터 추가 설명

현재 공개 범위는 keyevent입니다. 구성 저장, 정기 실행, 알림 전달은 서로 다른 단계이며, 파라미터와 전체 응답/오류 경계는 아래를 참조하십시오.

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/issue_auto_discovery/add' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"name":"生产事件自动发现","description":"按服务聚合生产告警","dqlNamespace":"keyevent","every":300,"conditions":"`df_status` = '"'"'error'"'"'","dimensions":["service"],"config":{"name":"服务{{service}}告警","description":"本窗口{{count}}条事件","channelUUIDs":[],"extend":{"text":"服务{{service}}发现{{count}}条事件","manager":[]}}}'

응답

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

필드 유형 설명
content object 제출 전 구성 스냅샷이며, 생성/업데이트 주체 요약이 첨부되지 않고 생성된 Issue/실행 결과도 포함되지 않습니다.
content.id integer 또는 null 데이터베이스 행 ID이며 경로 위치 지정에 사용되지 않습니다. 제출 전 스냅샷에서는 null일 수 있습니다.
content.uuid string 자동 검색 규칙 UUID, iatdc_ 접두사입니다.
content.status integer 0 활성화, 2 비활성화, 3 소프트 삭제이며, 조회 시 3은 제외됩니다.
content.creator string 생성 주체 UUID이며, 현재 공개 진입점은 보통 wsak_입니다.
content.updator string 또는 null 업데이트 주체이며, 생성 스냅샷에서는 비어 있거나 null일 수 있습니다.
content.createAt integer Unix 초 단위 생성 시간입니다.
content.updateAt integer 또는 null Unix 초 단위 업데이트 시간이며, 제출 전 생성 스냅샷에서는 null일 수 있고, 이후 데이터베이스 기본값/업데이트 값은 -1 또는 실제 시간일 수 있습니다.
content.deleteAt integer Unix 초 단위 삭제 시간이며, 삭제되지 않은 경우 보통 -1입니다.
content.workspaceUUID string 현재 Key가 속한 워크스페이스입니다.
content.name string 규칙 이름입니다.
content.description string 규칙 설명이며, Issue 본문 템플릿이 아닙니다.
content.dqlNamespace string 현재 공개 쓰기는 keyevent이며, 과거 레코드는 다른 네임스페이스일 수 있으나 공개 인터페이스로 다시 쓸 수 있음을 의미하지 않습니다.
content.every integer 주기 초 수입니다.
content.conditions string 저장된 DQL 필터 표현식이며, 실행 성공이 검증되었음을 의미하지 않습니다.
content.dimensions array<string> 그룹 필드명 배열이며, 과거 오류 유형은 허용 오차가 필요합니다.
content.dimensions[] string 이벤트 필드명 하나입니다.
content.config object 생성 Issue 정의 템플릿입니다.
content.config.name string 필수 문자열 최대 256자이며, Issue 제목 템플릿으로 규칙 name과 다릅니다. {{service}}/{{count}} 등 word 변수명을 지원하고 알 수 없는 변수는 그대로 유지됩니다. 임의의 Python/Jinja 표현식은 지원하지 않으며, 점/하이픈이 있는 필드는 치환이 보장되지 않습니다.
content.config.level string 선택적 등급 UUID 또는 빈 문자열이며, 비어 있지 않으면 현재 유효해야 하고 그렇지 않으면 406입니다. 생략하면 지정 등급이 없습니다. 인시던트 센터 등급 UUID의 범용 대체 필드가 아닙니다.
content.config.channelUUIDs array 선택적 채널 UUID 배열이며, 명시된 항목은 현재 활성이어야 합니다. 항상 [] 또는 유효한 배열을 전달할 것을 권장하며, 생략하면 저장은 가능하지만 작업에서 None을 순회하다 실패할 수 있습니다. 작업이 자동으로 기본 채널 연결을 보충하지만, 저장 자체는 []여도 워크스페이스에 최소 하나의 활성 채널이 있어야 합니다.
content.config.channelUUIDs[] string 단일 활성 채널 UUID입니다. 디멘션 필드/팀 UUID가 아니며, 알 수 없거나 비활성화된 경우 404입니다.
content.config.description string 선언상 선택적 문자열이지만 이후 작업이 이 키를 직접 읽으므로 항상 명시적으로 제공할 것을 권장합니다(빈 문자열 가능). config 수정 시 전체 교체되므로 하위 키를 생략해도 이전 값이 유지되지 않습니다.
content.config.extend.text string 명시적 문자열을 권장합니다. 작업이 읽어서 템플릿 치환하며, 누락/비문자열이면 비동기적으로 실패할 수 있습니다. config.description과 각각 별도로 저장되는 텍스트 필드입니다.
content.config.extend.manager array 선택적 담당자 문자열 배열입니다. 유효한 acnt_/현재 워크스페이스 팀/이메일/dutyPerson은 유지되며, 알 수 없는 계정/알 수 없는 값은 조용히 제외될 수 있고 항목별 오류를 보장하지 않습니다. 무료/체험 워크스페이스는 외부 이메일을 지원하지 않으며 400이 발생할 수 있습니다. 담당자가 없으면 미할당 에스컬레이션 절차로 진행될 수 있습니다.
content.config.extend.manager[] string 유효한 주체, 이메일 또는 dutyPerson 하나입니다. 문자열이 아니면 문자열 startswith 처리 시 500이 발생할 수 있습니다.
content.config.extend.conditionsInputFilters any 선택적 임의 JSON으로, 과거 Issue/알림 이벤트 이동 시 보충 필터를 되돌려 표시하기 위한 것입니다. 실제 쿼리는 여전히 최상위 conditions를 사용하며, 이 키만 수정해 대체할 수 없습니다.
content.config.extend.variable json 요청에 입력하지 않는 것을 권장합니다. 작업이 실제 쿼리 컬럼으로 해당 객체를 덮어쓰며, 일반적인 count는 구간 내 건수입니다.
content.config.extend.variable.count integer 런타임 발생 횟수이며, 호출자가 입력한 값은 신뢰할 수 있는 고정 값으로 적용되지 않습니다.
content.config.extend.tags json 요청에 입력하지 않는 것을 권장합니다. 작업이 실제 그룹 태그로 덮어쓰며, Issue 중복 제거 및 템플릿 변수에 사용됩니다.
content.config.extend.tags.필드 any 동적 JSON 태그 값이며, 호출자가 직접 입력한 값으로 그룹 생성을 고정할 수 없습니다.
content.config.extend.channelUUIDs array 런타임에 유효한 구성 채널로 덮어써지며, 이 확장 필드로 config.channelUUIDs를 대체하지 마십시오.
content.config.extend.channelUUIDs[] string 런타임에 유효한 채널 식별자 하나입니다.
content.config.extend.사용자 정의 키 any 임의 JSON 저장 값이며, 이 페이지에서 공개된 추가 실행 보장은 없습니다. 자격 증명을 넣지 마십시오.
content.config.extend object 또는 null 저장된 확장입니다. 새 요청에서는 객체를 사용해야 하며, null은 동기 감사 또는 이후 작업 예외를 유발합니다.
content.declaration object 또는 null 현재 워크스페이스의 공통 선언입니다.
{
  "code": 200,
  "content": {
    "id": null,
    "uuid": "iatdc_example",
    "status": 0,
    "creator": "wsak_example",
    "updator": "",
    "createAt": 1785427200,
    "updateAt": null,
    "deleteAt": -1,
    "workspaceUUID": "wksp_example",
    "name": "生产事件自动发现",
    "description": "按服务聚合生产告警",
    "dqlNamespace": "keyevent",
    "every": 300,
    "conditions": "`df_status` = 'error'",
    "dimensions": [
      "service"
    ],
    "config": {
      "name": "服务{{service}}告警",
      "description": "本窗口{{count}}条事件",
      "channelUUIDs": [],
      "extend": {
        "text": "服务{{service}}发现{{count}}条事件",
        "manager": []
      }
    },
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

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

HTTP 상태 errorCode 발생 조건 메시지 또는 응답 설명 처리 방법
406 ft.ParameterValidationFailed 요청 필드 누락 또는 필드 값이 선언된 검증 조건 위반 파라미터 파싱 실패 파라미터 위치, 필드명, 유형 및 값을 확인하십시오.
400 ft.RequestJsonFormatError 요청 JSON 구문이 유효하지 않음 요청 JSON 형식 오류 content.reason, line, column에 따라 JSON을 수정하십시오.
400 ft.JsonFormatError 요청 JSON 최상위가 객체가 아님 일부 json 파일 형식 오류 파라미터 객체를 제출하십시오.
400 ft.IssueAutoDiscoveryCfgNameExists 현재 워크스페이스에서 삭제되지 않은 규칙 이름 중복 동일한 이름의 규칙 이름이 이미 존재함 사용하지 않은 이름을 선택하고, 실패/타임아웃 시 먼저 기존 구성을 조회하십시오.
406 ft.IssueLevelNotExists config.level이 비어 있지 않고 현재 적용되는 Issue 등급에 없음 등급 구성이 존재하지 않음 Issue 등급 목록으로 uuid를 확인하고, 표시 이름/인시던트 센터 등급을 혼용하지 마십시오.
404 ft.NotFoundChannel 워크스페이스에 활성 채널이 없거나 지정된 channelUUIDs 항목이 활성 채널에 없음 지정된 채널을 찾을 수 없음 워크스페이스에 활성 채널이 있는지 확인하고 채널 목록에서 UUID를 선택하십시오. []도 워크스페이스의 최소 1개 채널 요구 사항을 우회하지 않습니다.
400 ft.UnsupportFreeIssueManager 무료/체험 워크스페이스 담당자가 비멤버 외부 이메일 사용 체험판 워크스페이스에서는 인시던트 담당자를 외부 이메일로 지원하지 않습니다 현재 워크스페이스 멤버를 사용하거나 관리자가 제품 버전을 확인하도록 하십시오.
500 ft.InternalServerError 템플릿/담당자/디멘션 동기 감사 자료 구성, 구성 데이터베이스 쓰기 또는 컨텍스트 제출 등 처리되지 않은 예외 내부 오류 먼저 이름으로 구성을 읽어 저장되었는지 확인하십시오. 하위 구조/비문자열 디멘션은 보통 저장 전에 실패하며, 결과가 불명확하면 중복 생성하지 말고 traceId를 보관하여 확인하십시오.

문서 평가

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