API File
Nota
Sono stati rinominati Microsoft Cloud App Security. È ora chiamato Microsoft Defender for Cloud Apps. Nelle prossime settimane verranno aggiornati gli screenshot e le istruzioni qui e nelle pagine correlate. Per altre informazioni sulla modifica, vedere questo annuncio. Per altre informazioni sulla ridenominazione recente dei servizi di sicurezza Microsoft, vedere il blog di Microsoft Ignite Security.
Microsoft Defender for Cloud Apps fa ora parte di Microsoft 365 Defender. Il portale di Microsoft 365 Defender consente agli amministratori della sicurezza di eseguire le attività di sicurezza in una posizione. Ciò semplifica i flussi di lavoro e aggiungerà la funzionalità degli altri servizi di Microsoft 365 Defender. Microsoft 365 Defender sarà la casa per il monitoraggio e la gestione della sicurezza tra le identità, i dati, i dispositivi, le app e l'infrastruttura Microsoft. Per altre informazioni su queste modifiche, vedere Microsoft Defender for Cloud Apps in Microsoft 365 Defender.
Nota
- Questa API non è disponibile per Office 365 Cloud App Security.
L'API File fornisce metadati relativi ai file e alle cartelle archiviati nelle app cloud, ad esempio l'ultima data di modifica, la proprietà e altro ancora.
Di seguito sono elencate le richieste supportate:
Filtri
Per informazioni sul funzionamento dei filtri, vedere Filtri.
La tabella seguente descrive i filtri supportati:
| Filtra | Tipo | Operatori | Descrizione |
|---|---|---|---|
| service | numero intero | eq, neq | Filtrare i file da appID app specificato, ad esempio: 11770 |
| instance | numero intero | eq, neq | Filtrare i file da istanze specificate |
| fileType | numero intero | eq, neq | Filtrare i file con il tipo di file specificato. I valori possibili sono: 0: Altro 1: Documento 2: Foglio di calcolo 3: Presentazione 4: Testo 5: Immagine 6: Cartella |
| allowDeleted | boolean | eq | I valori possibili sono: true: Restituisce file eliminati false o non impostato: restituisce file non eliminati (inclusi i file cestinati). Questa operazione verrà sostituita dall'operatore cestinato |
| Criterio | string | cabinetmatchedrulesequals, neq, isset, isnotset | Filtrare le attività correlate ai criteri specificati |
| nomefile | string | eq | Filtrare i file in base al nome file |
| modifiedDate | timestamp | lte, gte, range, lte_ndays, gte_ndays | Filtrare i file in base alla data di ultima modifica |
| createdDate | timestamp | lte, gte, range | Filtrare i file in base alla data di creazione |
| collaborators.entity | pk di entità | eq, neq | Filtrare i file condivisi con le entità specificate. Esempio: [{ "id": "entity-id", "saas": 11161, "inst": 0 }] |
| collaborators.domains | string | eq, neq | Filtrare i file condivisi con i domini specificati |
| collaborators.groups | string | eq, neq | Filtrare i file condivisi con i gruppi specificati |
| collaborators.withDomain | string | eq, neq, deq | Filtrare i file condivisi con i domini specificati |
| owner.entity | pk di entità | eq, neq | Filtrare i file di proprietà delle entità specificate. Esempio: [{ "id": "entity-id", "saas": 11161, "inst": 0 }] |
| owner.orgUnit | string | eq, neq | Filtrare i file con i proprietari dalle unità organizzative specificate |
| condivisione | numero intero | eq, neq | Filtrare i file con i livelli di condivisione specificati. I valori possibili sono: 4: Pubblico (Internet) 3: Pubblico 2: Esterno 1: Interno 0: Privato |
| fileId | string | eq, neq | Filtrare i file in base all'ID file |
| fileLabels | string | eq, neq, isset, isnotset | Filtrare i file contenenti gli ID file specificati (tag) |
| fileScanLabels | string | eq, neq, isset, isnotset | Filtrare i file contenenti gli avvisi di ispezione del contenuto specificati (tag) |
| estensione | string | eq, neq | Filtrare i file da un'estensione di file specificata |
| mimeType | string | eq, neq | Filtrare i file in base a un determinato tipo MIME, deve essere una singola stringa |
| Cestinato | boolean | eq | I valori possibili sono: true: restituisce solo file cestinati false: restituisce file non cestinati |
| parentFolder | folder | eq, neq | Filtrare i file contenuti nelle cartelle specificate |
| folder | boolean | eq | I valori possibili sono: true: Restituisce solo cartelle false: restituisce solo file |
| Quarantined | boolean | eq | I valori possibili sono: true: restituisce solo file in quarantena false: restituisce solo file non in quarantena |
| snapshotLastModifiedDate | timestamp | lte, gte, range | Filtrare i file in base alla data dell'ultima modifica dello snapshot |
Se si verificano problemi, sono disponibili assistenza e supporto. Per ottenere assistenza o supporto per il problema del prodotto, aprire un ticket di supporto.