로고 설정
지정한 유형의 로고 이미지를 설정합니다. 이미지는 PNG 형식이어야 하며 Base64로 인코딩하여 전달합니다.
필요 권한
클러스터 관리자 계정으로 이용할 수 있습니다.
HTTP 요청
POST /api/sonar/logos/:type
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
--data-urlencode "image=$(base64 -w0 logo.png)" \
-X POST \
https://HOSTNAME/api/sonar/logos/login
요청 매개변수
경로 매개변수
| 키 | 타입 | 설명 | 비고 |
|---|---|---|---|
| type | 문자열 | 로고 유형 | login, gnb, mail-header, mail-footer 중 하나. 하단 표 참고 |
| type 값 | 설명 |
|---|---|
login | 로그인 화면 로고 |
gnb | 웹 콘솔 상단 메뉴(GNB) 로고 |
mail-header | 알림 메일 상단 로고 |
mail-footer | 알림 메일 하단 로고 |
요청 본문 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| image | O | 문자열 | Base64 인코딩된 PNG 이미지 | PNG 형식만 지원 |
Note
설정한 로고는 인증 없이 정적 이미지로 제공됩니다. login, gnb 로고는 GET /logo/login_logo.png, GET /logo/gnb_logo.png로, mail-header, mail-footer 로고는 GET /logo/mail_header_logo.png, GET /logo/mail_footer_logo.png로 각각 조회할 수 있습니다.
정상 응답
{}
오류 응답
필수 매개변수가 누락된 경우
HTTP 상태 코드 400 응답
{
"error_code": "null-argument",
"error_msg": "type should be not null"
}
type 값이 지원되는 유형이 아닌 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "type should be one of login, gnb, mail-header, mail-footer."
}
image 값이 올바른 Base64 형식이 아닌 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "Length of Base64 encoded input string is not a multiple of 4."
}
image가 PNG 형식이 아닌 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "image must be a PNG file."
}
권한이 없는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "no-permission"
}