INNORIX Docs | Transfer

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

전송은 자동화(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 — 다음 검색 배치 조회

파라미터	타입	필수	설명
`cursor`	string	예	직전 응답이 반환한 `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_path`	string	조회할 하위 경로
`page`	integer	페이지 번호
`size`	integer	페이지당 결과 수
`idType`	string	ID 종류 (`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>"

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

전송은 자동화(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 }'

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

파라미터	타입	필수	설명
`cursor`	string	예	직전 응답이 반환한 `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_path`	string	조회할 하위 경로
`page`	integer	페이지 번호
`size`	integer	페이지당 결과 수
`idType`	string	ID 종류 (`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>"

Control & Monitor File Transfers

전송할 경로 탐색#

전송 제어#

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

Control & Monitor File Transfers

전송할 경로 탐색#

전송 제어#

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