수집기 수정
지정한 수집기를 수정합니다. 이 작업은 관리자 권한을 요구합니다.
필요 권한
관리자 이상의 계정으로 이용할 수 있습니다.
HTTP 요청
PUT /api/sonar/loggers/:guid
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
-d name="WTMP" \
-d description="demo" \
-d interval=10000 \
-d 'configs={"path": "/var/log/wtmp"}' \
-X PUT https://HOSTNAME/api/sonar/loggers/b90ea540-4f47-4bcf-b708-af610a649c50
요청 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| guid | O | 문자열 | 수집기 식별자 | 36자 GUID |
| name | O | 문자열 | 수집기 이름 | 최소 1자, 최대 50자 |
| description | X | 문자열 | 수집기 설명 | 최대 2,000자 |
| interval | X | 32비트 정수 | 수집 간격 | 최소 1000 (단위: 밀리초) |
| cron_schedule | X | 문자열 | 수집 주기 | |
| asset_guid | X | 문자열 | 자산 식별자 | 자산 IP 및 사이트 연결 |
| configs | X | 문자열 키/값 | 설정 | 수집 유형별 설정 명세 확인 |
정상 응답
{}
오류 응답
필수 매개변수가 누락된 경우
HTTP 상태 코드 400 응답.
{
"error_code": "null-argument",
"error_msg": "name should be not null"
}
식별자가 GUID 형식이 아닌 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-param-type",
"error_msg": "asset_guid should be guid type."
}
매개변수 값의 길이가 잘못된 경우
HTTP 상태 코드 400 응답.
{
"error_code": "invalid-argument",
"error_msg": "'name' must be less than or equal to 50 characters."
}
수집 일정 문법이 잘못된 경우
HTTP 상태 코드 400 응답.
{
"error_code": "invalid-argument",
"error_msg": "wrong cron expression format: * * * *"
}
자산이 존재하지 않는 경우
HTTP 상태 코드 500 응답.
{
"error_code": "illegal-state",
"error_msg": "asset not found: cd09ae6f-fbc3-11ed-9320-02d178f999a6"
}
수집기가 존재하지 않는 경우
{
"error_code": "illegal-state",
"error_msg": "logger not found: c90ea540-4f47-4bcf-b708-af610a649c50"
}
관리 권한이 없는 경우
HTTP 상태 코드 500 응답.
{
"error_code": "illegal-state",
"error_msg": "no-permission"
}