전역 설정 조회

지정한 키의 전역 설정 값을 조회합니다. 일부 민감한 키(SMTP 비밀번호, LDAP 바인딩 비밀번호)의 값은 ********로 마스킹되어 반환됩니다. 사용 가능한 키 목록은 전역 설정 목록 조회를 참고하세요.

필요 권한

마스터 권한이 필요합니다.

HTTP 요청

GET /api/sonar/global-configs/:key
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/global-configs/smtp_host
요청 매개변수
경로 매개변수
타입설명비고
key문자열전역 설정 키대소문자를 구분하지 않으며, 응답에서는 소문자로 표기됩니다.

정상 응답

응답 본문은 요청한 키의 소문자 형태를 키로 사용합니다.

{
  "smtp_host": "smtp.example.com"
}
  • {key} (문자열): 전역 설정 값. 설정되지 않은 경우 null이며, 마스킹 대상 키는 ********로 표시됩니다.

오류 응답

지원하지 않는 키인 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "invalid option name: foo"
}
권한이 없는 경우

HTTP 상태 코드 500 응답

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