업로드 스트림 목록 조회

현재 열려 있는 모든 파일 업로드 스트림 목록을 조회합니다.

필요 권한

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

HTTP 요청

GET /api/sonar/upload-streams

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/upload-streams

요청 매개변수

요청 매개변수가 없습니다.

정상 응답

{
  "streams": [
    {
      "token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "remote_addr": "192.0.2.10",
      "login_name": "admin",
      "file_name": "users.csv",
      "file_size": 1048576,
      "uploaded_size": 524288,
      "created": "2026-01-15 10:30:25+0900",
      "last_upload": "2026-01-15 10:30:40+0900",
      "metadata": {
        "lookup_name": "users"
      }
    }
  ]
}

streams (배열): 업로드 스트림 목록
- token (문자열): GUID 형식의 업로드 스트림 식별자
- remote_addr (문자열): 업로드 스트림을 생성한 클라이언트 IP 주소
- login_name (문자열): 업로드 스트림을 생성한 계정의 로그인 이름
- file_name (문자열): 업로드 대상 파일 이름
- file_size (64비트 정수): 업로드 대상 파일의 전체 바이트 크기
- uploaded_size (64비트 정수): 현재까지 업로드된 바이트 크기
- created (문자열): 업로드 스트림 생성 시각 (yyyy-MM-dd HH:mm:ssZ 형식)
- last_upload (문자열): 마지막 청크 업로드 시각. 아직 청크가 한 번도 도착하지 않은 경우 null
- metadata (객체): 업로드 스트림 생성 시 전달된 메타데이터 키-값 쌍

오류 응답

권한이 없는 경우

HTTP 상태 코드 500 응답

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