파일 API
참고
Microsoft Cloud App Security 이름이 바뀌었습니다. 이제 Microsoft Defender for Cloud Apps 호출되었습니다. 앞으로 몇 주 안에 여기와 관련 페이지에서 스크린샷과 지침을 업데이트할 예정입니다. 변경 내용에 대한 자세한 내용은 이 공지 사항을 참조하세요. Microsoft 보안 서비스의 최근 이름 바꾸기에 대한 자세한 내용은 Microsoft Ignite 보안 블로그를 참조하세요.
Microsoft Defender for Cloud Apps 이제 Microsoft 365 Defender 일부입니다. Microsoft 365 Defender 포털을 사용하면 보안 관리자가 한 위치에서 보안 작업을 수행할 수 있습니다. 이렇게 하면 워크플로가 간소화되고 다른 Microsoft 365 Defender 서비스의 기능이 추가됩니다. Microsoft 365 Defender Microsoft ID, 데이터, 디바이스, 앱 및 인프라 전반에서 보안을 모니터링하고 관리하기 위한 홈이 될 것입니다. 이러한 변경 내용에 대한 자세한 내용은 Microsoft 365 Defender Microsoft Defender for Cloud Apps 참조하세요.
참고
- 이 API는 Office 365 Cloud App Security 사용할 수 없습니다.
Files API는 클라우드 앱에 저장된 파일 및 폴더에 대한 메타데이터(예: 마지막 수정 날짜, 소유권 등)를 제공합니다.
다음은 지원되는 요청을 나열합니다.
필터
필터의 작동 방식에 대한 자세한 내용은 필터를 참조하세요.
다음 표에서는 지원되는 필터에 대해 설명합니다.
| 필터 | 유형 | 연산자 | 설명 |
|---|---|---|---|
| service | integer | eq, neq | 지정된 앱 appID에서 파일 필터링(예: 11770) |
| 인스턴스 | integer | eq, neq | 지정된 인스턴스에서 파일 필터링 |
| fileType | integer | eq, neq | 지정된 파일 형식의 파일을 필터링합니다. 가능한 값은 다음과 같습니다. 0: 기타 1: 문서 2: 스프레드시트 3: 프레젠테이션 4: 텍스트 5: 이미지 6: 폴더 |
| allowDeleted | boolean | eq | 가능한 값은 다음과 같습니다. true: 삭제된 파일을 반환합니다. false 또는 설정 안 됨: 삭제되지 않은(휴지통 포함) 파일을 반환합니다. 휴지통 연산자에 의해 재정의됩니다. |
| policy | 문자열 | cabinetmatchedrulesequals, neq, isset, isnotset | 지정된 정책과 관련된 작업 필터링 |
| 파일 이름 | 문자열 | eq | 파일 이름으로 파일 필터링 |
| modifiedDate | timestamp | lte, gte, range, lte_ndays, gte_ndays | 파일을 마지막으로 수정한 날짜까지 필터링 |
| createdDate | timestamp | lte, gte, range | 만든 날짜별로 파일 필터링 |
| collaborators.entity | 엔터티 pk | eq, neq | 지정된 엔터티와 공유되는 파일을 필터링합니다. 예: [{ "id": "entity-id", "saas": 11161, "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 형식으로 파일을 필터링합니다. 단일 문자열이어야 합니다. |
| 휴지통 | boolean | eq | 가능한 값은 다음과 같습니다. true: 휴지통 파일만 반환합니다. false: 휴지통이 아닌 파일을 반환합니다. |
| parentFolder | 폴더 | eq, neq | 지정된 폴더에 포함된 파일 필터링 |
| 폴더 | boolean | eq | 가능한 값은 다음과 같습니다. true: 폴더만 반환합니다. false: 파일만 반환합니다. |
| 격리 | boolean | eq | 가능한 값은 다음과 같습니다. true: 격리된 파일만 반환합니다. false: 격리되지 않은 파일만 반환합니다. |
| snapshotLastModifiedDate | timestamp | lte, gte, range | 스냅샷이 마지막으로 수정된 날짜까지 파일 필터링 |
문제가 발생하는 경우 지원받을 수 있습니다. 제품 문제에 대해 도움이나 지원을 받으려면 지원 티켓을 여세요.