전역 설정 입력
지정한 키에 대한 전역 설정 값을 입력합니다. 설정 값은 전역 설정 조회 API로 확인하고, 전역 설정 해제 API로 제거할 수 있습니다.
필요 권한
클러스터 관리자 권한이 필요합니다.
HTTP 요청
PUT /api/sonar/global-configs/:key
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
-d value=smtp.example.com \
-X PUT \
https://HOSTNAME/api/sonar/global-configs/smtp_host
요청 매개변수
경로 매개변수
| 키 | 타입 | 설명 | 비고 |
|---|---|---|---|
| key | 문자열 | 전역 설정 키 | 대소문자를 구분하지 않습니다. |
요청 본문 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| value | O | 문자열 | 전역 설정 값 |
정상 응답
{}
오류 응답
version 키를 수정하려는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "cannot change value of version"
}
유효하지 않은 설정 키인 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "global option key should be not null"
}
권한이 없는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "no-permission"
}