용어 수정
기존 용어를 수정합니다. 이 작업은 관리자 권한을 요구합니다.
필요 권한
관리자 이상의 계정으로 이용할 수 있습니다.
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"
요청 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| guid | O | 문자열 | 용어 GUID | URL 경로 매개변수, GUID 형식 36자 |
| term | O | 문자열 | 용어 | 최소 1자, 최대 50자. 특수문자나 공백 불허 |
| code | O | 문자열 | 용어 식별 코드 | 최소 1자, 최대 50자. 영숫자와 언더스코어만 허용, 숫자로 시작 불가 |
| category | O | 문자열 | 용어 사용 대상 분류 | table, field 중 하나 |
| type | - | 문자열 | 데이터 유형 | category가 field일 때 필수 |
| locale | O | 문자열 | 언어 | ko, en, zh 중 하나 |
| description | X | 문자열 | 용어 설명 | 최대 2,000자 |
type은DATE,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"
}