매체 제어 > 파일 반출 제어 내역
GET https://openapi.exosp.com/logs/v1/device-control/file-transfer-control
매체 제어 > 파일 반출 제어 내역을 조회하는 API 입니다.
Query Parameters
offset*
int
((현재 페이지 번호 -1)*tableSize) 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.
tableSize*
int
페이지 사이즈
startTimeUTC*
string
응답 데이터 시작 시각
UTC 기준, ISO 8601포맷 ✅ 최신 3개월 이내의 시각만 입력해주세요.
endTimeUTC*
string
응답 데이터 종료 시각 UTC 기준, ISO 8601포맷
sortType*
string
응답 데이터 정렬 유형 (제어 시각 기준) ASC : 오름차순, DESC : 내림차순
timezone
string
응답 데이터 타임존https://en.wikipedia.org/wiki/List_of_tz_database_time_zones 에서 TZ identifier 참고
기본값 : UTC
search
string
검색어
검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름
기본값 : 빈값
Response Schema
body 상세
total
int
전체 레코드 수
data 상세
name
string
사용자 이름
departmentName
string
그룹 이름
departmentFull
string
그룹 전체 경로
osType
string
os 유형 windows : 윈도우 , macos : 맥
osUserName
string
os 계정
computerName
string
컴퓨터 이름
category
string
디바이스 카테고리 Others : 미분류,
CD-ROM/DVD/BD : CD-ROM/DVD,
Mobile Devices : 휴대용 장치,
Wireless LAN : 무선랜,
Bluetooth : 블루투스,
USB Tethering : USB 테더링,
Infrared Ports : 적외선 포트,
1394 Port : 1394 포트,
Modem : 모뎀,
PCMCIA Port : PCMCIA,
Image Capture Devices : 이미지 캡처 장치,
Serial/Parallel Port : Serial/Parallel 포트,
USB Port : USB 포트,
Removable Disk : 이동식 디스크
deviceDescription
string
디바이스 설명
deviceSerial
string
디바이스 시리얼
deviceHardwareId
string
디바이스 하드웨어 ID
deviceInstanceId
string
디바이스 인스턴스 경로
deviceClassGuid
string
디바이스 클래스 GUID
deviceClassName
string
디바이스 클래스
volumeUUID
string
볼륨 UUID(macos)
volumeName
string
볼륨 이름(macos)
volumeSize
string
볼륨 용량(macos)
fileName
string
파일 이름
filePath
string
파일 경로
fileSize
string
파일 크기
controlType
string
제어 유형 Allow : 파일 반출 기록, Block : 파일 반출 차단
dateOfEntryUTC
string
제어 시각
UTC 기준, ISO 8601포맷
dateOfEntry
string
제어 시각
요청 타임존 기준, ISO 8601포맷
Example
curl -X 'GET' \
'https://openapi.exosp.com/logs/v1/device-control/file-transfer-control?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&timezone=Asia%2FSeoul&sortType=DESC' \
-H 'accept: application/json' \
-H 'x-exosp-access: YOUR_ACCESS_KEY' \
-H 'x-exosp-secret: YOUR_ACCESS_SECRET'
{
"code": 0,
"message": "success",
"body": {
"total": 18,
"data": [
{
"name": "최수지",
"departmentName": "최수지",
"departmentFull": "어벤져스 > 제품 > CX > 최수지",
"osType": "windows",
"osUserName": "suzy",
"computerName": "suzy",
"category": "Removable Disk",
"deviceDescription": "Generic Flash Disk USB Device",
"deviceSerial": "USB\\VID_058F&PID_6387\\79085C0C",
"deviceHardwareId": "USBSTOR\\DiskGeneric_Flash_Disk______8.07",
"deviceInstanceId": "USBSTOR\\DISK&VEN_GENERIC&PROD_FLASH_DISK&REV_8.07\\79085C0C&0",
"deviceClassGuid": "{4d36e967-e325-11ce-bfc1-08002be10318}",
"deviceClassName": "DiskDrive",
"volumeUUID": "-",
"volumeName": "-",
"volumeSize": "-",
"fileName": "스크린샷 2024-10-07 165903.png",
"filePath": "D:\\스크린샷 2024-10-07 165903.png",
"fileSize": "143KB",
"controlType": "Allow",
"dateOfEntryUTC": "2024-10-07T08:00:07+00:00",
"dateOfEntry": "2024-10-07T17:00:07+09:00"
}
]
}
}
Last updated