> For the complete documentation index, see [llms.txt](https://openapi-docs.exosp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://openapi-docs.exosp.com/guide/logs/application-control-cloud-file-synchronization.md).

# 애플리케이션 제어 > 클라우드 파일 동기화 제어 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/application-control/cloud-file-synchronization`

애플리케이션 제어 > 클라우드 파일 동기화 제어 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><strong>응답 데이터 타임존</strong><a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">https://en.wikipedia.org/wiki/List_of_tz_database_time_zones</a> 에서 TZ identifier 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></td></tr></tbody></table>

### Response Schema

<table><thead><tr><th width="162">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>code</td><td>int</td><td><p><strong>응답 처리 결과 코드</strong> </p><p>0 : 성공, 1 : 실패</p></td></tr><tr><td>message</td><td>string</td><td><p><strong>응답 처리 결과 메세지</strong></p><p>success : 성공, 그 외 : 실패</p></td></tr><tr><td>body</td><td>object</td><td><a data-mention href="#body">#body</a></td></tr></tbody></table>

#### **body 상세**

<table><thead><tr><th width="164">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>total</td><td>int</td><td><strong>전체 레코드 수</strong></td></tr><tr><td>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="195">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>category</td><td>string</td><td><p><strong>애플리케이션 카테고리</strong><br>Others : 미분류, </p><p>P2P : P2P, </p><p>Messenger : 메신저, </p><p>FTP Utility : FTP 유틸리티, </p><p>Media Player : 동영상 플레이어, </p><p>Email Clients : 메일 클라이언트, </p><p>Cloud Storage : 클라우드 스토리지, </p><p>Note Taking Apps : 클라우드 노트, </p><p>Screen Capture : 화면캡처, </p><p>Remote Control : 원격 제어, </p><p>Web Browser : 웹 브라우저, </p><p>Live Tiles : Live Tiles, </p><p>AirDrop : 에어드랍</p></td></tr><tr><td>productName</td><td>string</td><td><strong>제품 이름</strong></td></tr><tr><td>processName</td><td>string</td><td><strong>프로세스 이름</strong></td></tr><tr><td>companyName</td><td>string</td><td><strong>공급자</strong></td></tr><tr><td>fileName</td><td>string</td><td><strong>파일 이름</strong></td></tr><tr><td>filePath</td><td>string</td><td><strong>파일 경로</strong></td></tr><tr><td>fileSize</td><td>string</td><td><strong>파일 크기</strong></td></tr><tr><td>fileType</td><td>string</td><td><p><strong>파일 유형</strong><br>General : 일반 파일, </p><p>Sensitive : 개인(민감)정보 파일, </p><p>Not Scanned : 개인(민감)정보 검사 안 함, </p><p>Scan Failed : 개인(민감)정보 검사 실패 파일,<br>Exosphere Encrypted File : 엑소스피어 암호화 파일</p></td></tr><tr><td>sensitiveInfoCount</td><td>string</td><td><strong>개인(민감)정보 수</strong></td></tr><tr><td>sensitiveInfoDetails</td><td>array</td><td><a data-mention href="#undefined">#undefined</a></td></tr><tr><td>controlType</td><td>string</td><td><strong>제어 유형</strong><br>Allow : 파일 동기화 기록, Block : 파일 동기화 차단</td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>제어 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>제어 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

#### 개인(민감)정보 세부 내역

<table><thead><tr><th width="164">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>개인(민감)정보</strong></td></tr><tr><td>count</td><td>int</td><td><strong>레코드 수</strong></td></tr></tbody></table>

### Example

{% tabs %}
{% tab title="200 Success" %}

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/application-control/cloud-file-synchronization?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": "어벤져스 > 제품 > 개발 > 맥/크로스플랫폼",
           "osType": "macos",
           "osUserName": "user(user)",
           "computerName": "user의 MacBook Pro",
           "category": "Cloud Storage",
           "productName": "Google Drive",
           "processName": "FileProvider",
           "companyName": "Apple Inc.",
           "fileName": "암호화 테스트 파일 1234 복사본 9.csv",
           "filePath": "/Users/user/Library/CloudStorage/GoogleDrive-ㅡminji/내 드라이브/Test/암호화 테스트 파일 1234 복사본 9.csv",
           "fileSize": "10MB",
           "fileType": "Sensitive",
           "sensitiveInfoCount": "1000",
           "sensitiveInfoDetails": [
               {
                   "name": "Email",
                   "count": 1000
               }
           ],
           "controlType": "Block",
           "dateOfEntryUTC": "2024-12-10T08:32:51+00:00",
           "dateOfEntry": "2024-12-10T17:32:51+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}