전역 설정 입력

지정한 키에 대한 전역 설정 값을 입력합니다. 설정 값은 전역 설정 조회 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문자열전역 설정 키대소문자를 구분하지 않습니다.
요청 본문 매개변수
필수타입설명비고
valueO문자열전역 설정 값

정상 응답

{}

오류 응답

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"
}