개발자API 레퍼런스Control & Monitor File Transfers
개발자 센터

Control & Monitor File Transfers

진행 중인 전송을 제어(취소·일시중지·재개)하고, 실패 재시도·재실행·모니터링합니다.

전송은 자동화(automation)로 생성합니다(Automate File Transfers 참고). 공개 API의 1회성 전송 생성 엔드포인트(POST /api/transfers/manual)는 제거되었습니다. 아래 예시의 monitorId는 생성된 전송의 식별자이며, GET /api/transfers(활성 전송 목록)로 조회할 수 있습니다.

전송할 경로 탐색

POST /api/devices/{deviceId}/files/search — 장비 경로 탐색

소스 장비의 파일/폴더 경로를 확인합니다. 반환된 각 항목은 자동화 소스 항목 등에 넘길 hash를 포함합니다.

bash
curl -X POST https://app.innorix.com/api/devices/dev_a1/files/search \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>" \
  -H "Content-Type: application/json" \
  -d '{ "path": "/data/export", "onlyFolder": false }'

검색은 페이지네이션됩니다. POST가 첫 배치와 함께 nextCursor를 반환하면, hasMore가 true인 동안 아래 GET으로 다음 배치를 이어서 가져옵니다. 같은 cursor로 재요청하면 동일 배치를 반환하며(멱등), nextCursor를 요청하면 이전 배치가 확인 처리됩니다.

GET /api/devices/{deviceId}/files/search — 다음 검색 배치 조회

파라미터타입필수설명
cursorstring예직전 응답이 반환한 nextCursor
bash
curl "https://app.innorix.com/api/devices/dev_a1/files/search?cursor=<NEXT_CURSOR>" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>"

전송 제어

각 제어 동작은 이제 전송별 하위 리소스에 대한 POST입니다(요청 본문 없음).

목적메서드 · 경로
전송 취소POST /api/transfers/{monitorId}/cancel
일시 중지POST /api/transfers/{monitorId}/pause
재개POST /api/transfers/{monitorId}/resume
bash
curl -X POST https://app.innorix.com/api/transfers/mon_7788/pause \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>"

다중 취소 · 실패 재시도 · 재실행

목적메서드 · 경로
여러 전송 취소POST /api/transfers/bulk-cancel
실패 파일 재시도POST /api/transfers/{monitorId}/retry
이전 전송 재실행POST /api/transfers/{monitorId}/replay
전송 파일 목록 조회GET /api/transfers/{monitorId}/files
큐 우선순위 변경PATCH /api/transfers/{monitorId}/priority

여러 전송 취소 — POST /api/transfers/bulk-cancel

bash
curl -X POST https://app.innorix.com/api/transfers/bulk-cancel \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>" \
  -H "Content-Type: application/json" \
  -d '{ "monitorIds": ["mon_123", "mon_456"] }'

실패 파일 재시도 — POST /api/transfers/{monitorId}/retry

전송은 경로의 monitorId로 식별하고, 본문에는 재시도할 파일을 나열합니다.

bash
curl -X POST https://app.innorix.com/api/transfers/mon_7788/retry \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>" \
  -H "Content-Type: application/json" \
  -d '{
    "filesRetry": [
      { "filePath": "C:/Users/MY PC/Downloads/test/file.txt", "isDir": false }
    ]
  }'

이전 전송 재실행 — POST /api/transfers/{monitorId}/replay

이전 전송을 동일 설정으로 다시 실행합니다(요청 본문 없음). 필요하면 GET /api/transfers/{monitorId}/replay-data로 재실행 설정을 먼저 조회합니다.

bash
curl -X POST https://app.innorix.com/api/transfers/mon_7788/replay \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>"

전송 파일 목록 조회 — GET /api/transfers/{monitorId}/files

파라미터타입설명
current_pathstring조회할 하위 경로
pageinteger페이지 번호
sizeinteger페이지당 결과 수
idTypestringID 종류 (transfer / monitor)
bash
curl "https://app.innorix.com/api/transfers/mon_7788/files?page=1&size=50" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>"