수집기 수정

지정한 수집기를 수정합니다. 이 작업은 관리자 권한을 요구합니다.

필요 권한

관리자 이상의 계정으로 이용할 수 있습니다.

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
요청 매개변수
필수타입설명비고
guidO문자열수집기 식별자36자 GUID
nameO문자열수집기 이름최소 1자, 최대 50자
descriptionX문자열수집기 설명최대 2,000자
intervalX32비트 정수수집 간격최소 1000 (단위: 밀리초)
cron_scheduleX문자열수집 주기
asset_guidX문자열자산 식별자자산 IP 및 사이트 연결
configsX문자열 키/값설정수집 유형별 설정 명세 확인

정상 응답

{}

오류 응답

필수 매개변수가 누락된 경우

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