전역 설정 조회
지정한 키의 전역 설정 값을 조회합니다. 일부 민감한 키(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"
}