진행 중인 전송을 제어(취소, 일시중지, 재개)하고, 실패 재시도, 재실행, 모니터링합니다.
전송은 자동화(automation)로 생성합니다(Automate File Transfers 참고). 공개 API의 1회성 전송 생성 엔드포인트(
POST /api/transfers/manual)는 제거되었습니다. 아래 예시의monitorId는 생성된 전송의 식별자이며,GET /api/transfers(활성 전송 목록)로 조회할 수 있습니다.
전송할 경로 탐색#
POST /api/devices/{deviceId}/files/search — 장비 경로 탐색
소스 장비의 파일/폴더 경로를 확인합니다. 반환된 각 항목은 자동화 소스 항목 등에 넘길 hash를 포함합니다.
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 — 다음 검색 배치 조회
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
cursor |
string | 예 | 직전 응답이 반환한 nextCursor |
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 |
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
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로 식별하고, 본문에는 재시도할 파일을 나열합니다.
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로 재실행 설정을 먼저 조회합니다.
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_path |
string | 조회할 하위 경로 |
page |
integer | 페이지 번호 |
size |
integer | 페이지당 결과 수 |
idType |
string | ID 종류 (transfer / monitor) |
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>"