영어로 읽기

다음을 통해 공유


파일 API

참고

  • 이 API는 Microsoft 365 Cloud App Security 사용할 수 없습니다.

파일 API는 마지막 수정 날짜, 소유권 등과 같이 클라우드 앱에 저장된 파일 및 폴더에 대한 메타데이터를 제공합니다.

다음은 지원되는 요청을 나열합니다.

필터

필터 작동 방식에 대한 자세한 내용은 필터를 참조하세요.

다음 표에서는 지원되는 필터에 대해 설명합니다.

필터 유형 연산자 설명
서비스 integer eq, neq 지정된 앱 appID에서 파일 필터링(예: 11770)
인스턴스 integer eq, neq 지정된 인스턴스에서 파일 필터링
fileType integer eq, neq 지정된 파일 형식으로 파일을 필터링합니다. 가능한 값은 다음과 같습니다.

0: 기타
1: 문서
2: 스프레드시트
3: 프레젠테이션
4: 텍스트
5: 이미지
6: 폴더
allowDeleted 부울 eq 가능한 값은 다음과 같습니다.

true: 삭제된 파일을 반환합니다.
false 또는 설정 안 됨: 삭제되지 않은 파일(휴지통 포함)을 반환합니다. 이 값은 휴지통 연산자에 의해 재정의됩니다.
정책 문자열 cabinetmatchedrulesequals, neq, isset, isnotset 지정된 정책과 관련된 작업 필터링
파일 문자열 eq 파일 이름으로 파일 필터링
modifiedDate 타임 스탬프 lte, gte, range, lte_ndays, gte_ndays 파일을 마지막으로 수정한 날짜까지 필터링
createdDate 타임 스탬프 lte, gte, range 파일을 만든 날짜별로 필터링
collaborators.entity 엔터티 pk eq, neq 지정된 엔터티와 공유되는 파일을 필터링합니다. 예: [{ "id": "entity-id", "inst": 0 }]
collaborators.domains 문자열 eq, neq 지정된 도메인과 공유되는 파일 필터링
collaborators.groups 문자열 eq, neq 지정된 그룹과 공유되는 파일 필터링
collaborators.withDomain 문자열 eq, neq, deq 지정된 도메인과 공유되는 파일 필터링
owner.entity 엔터티 pk eq, neq 지정된 엔터티가 소유한 파일을 필터링합니다. 예: [{ "id": "entity-id", "saas": 11161, "inst": 0 }]
owner.orgUnit 문자열 eq, neq 지정된 조직 구성 단위에서 소유자를 사용하여 파일 필터링
공유 integer eq, neq 지정된 공유 수준으로 파일을 필터링합니다. 가능한 값은 다음과 같습니다.

4: 공용(인터넷)
3: 공용
2: 외부
1: 내부
0: 프라이빗
fileId 문자열 eq, neq 파일 ID로 파일 필터링
fileLabels 문자열 eq, neq, isset, isnotset 지정된 파일 레이블(태그) ID가 포함된 파일 필터링
fileScanLabels 문자열 eq, neq, isset, isnotset 지정된 콘텐츠 검사 경고(태그) ID가 포함된 파일 필터링
확장 문자열 eq, neq 지정된 파일 확장자를 기준으로 파일 필터링
mimeType 문자열 eq, neq 지정된 MIME 형식으로 파일 필터링, 단일 문자열이어야 합니다.
휴지통 부울 eq 가능한 값은 다음과 같습니다.

true: 휴지통 파일만 반환합니다.
false: 비트래시된 파일을 반환합니다.
parentFolder 폴더 eq, neq 지정된 폴더에 포함된 파일 필터링
폴더 부울 eq 가능한 값은 다음과 같습니다.

true: 폴더만 반환합니다.
false: 파일만 반환합니다.
격리 부울 eq 가능한 값은 다음과 같습니다.

true: 격리된 파일만 반환합니다.
false: 격리되지 않은 파일만 반환합니다.
snapshotLastModifiedDate 타임 스탬프 lte, gte, range 스냅샷 마지막으로 수정한 날짜까지 파일 필터링

문제가 발생하면 도움을 드리겠습니다. 제품 문제에 대한 지원 또는 지원을 받으려면 지원 티켓을 여세요.