용어 수정

기존 용어를 수정합니다. 이 작업은 관리자 권한을 요구합니다.

필요 권한

관리자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

PUT /api/sonar/glossary/terms/:guid
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     -d term="시각" \
     -d code="_time" \
     -d category="field" \
     -d type="DATE" \
     -d locale="ko" \
     -d description="로그 생성 시각" \
     -X PUT "https://HOSTNAME/api/sonar/glossary/terms/a07e6bd4-5ca2-11f0-ad90-acde48001122"
요청 매개변수
필수타입설명비고
guidO문자열용어 GUIDURL 경로 매개변수, GUID 형식 36자
termO문자열용어최소 1자, 최대 50자. 특수문자나 공백 불허
codeO문자열용어 식별 코드최소 1자, 최대 50자. 영숫자와 언더스코어만 허용, 숫자로 시작 불가
categoryO문자열용어 사용 대상 분류table, field 중 하나
type-문자열데이터 유형category가 field일 때 필수
localeO문자열언어ko, en, zh 중 하나
descriptionX문자열용어 설명최대 2,000자
  • typeDATE, STRING, IP, PORT, SHORT, INT, LONG, COUNTRY, FLOAT, DOUBLE, BOOL, MD5, SHA1, URL, SHA256, DOMAIN 중 하나입니다.

정상 응답

{}

오류 응답

필수 매개 변수가 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "term should be not null"
}
매개변수 값의 길이가 잘못된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'term' must be less than or equal to 50 characters."
}
guid가 GUID 형식이 아닌 경우

HTTP 상태코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "guid should be guid type."
}
guid가 존재하지 않는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "term-not-found [guid: GUID]"
}
term 매개변수가 잘못된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'term' must be 1 to 50 characters and must not contain special characters or spaces."
}
term이 중복된 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "duplicated-term [term: term, locale: locale]"
}
code가 잘못된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'code' must be 1 to 50 characters, alphanumeric or underscore characters only, and must not start with a number"
}
code가 중복된 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "duplicated-code [code: code, locale: locale]"
}
category가 잘못된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "invalid-category: invalid-category"
}
type이 잘못된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "type should be one of IP, SHA256, BOOL, DATE, INT, URL, STRING, DOUBLE, COUNTRY, SHORT, LONG, FLOAT, MD5, PORT, DOMAIN, SHA1"
}
권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}