API de fichiersFiles API

S’applique à : Microsoft Cloud App SecurityApplies to: Microsoft Cloud App Security

Important

Les noms des produits Microsoft de protection contre les menaces changent.Threat protection product names from Microsoft are changing. Vous trouverez ici plus d’informations sur ce sujet et sur les autres mises à jour.Read more about this and other updates here. Nous allons très prochainement mettre à jour les noms des produits et des documents.We'll be updating names in products and in the docs in the near future.

Notes

  • Cette API sera bientôt dépréciée.This API will soon be deprecated. Microsoft Cloud App Security développe une nouvelle solution pour identifier et agir sur des fichiers qui violent les stratégies.Microsoft Cloud App Security is developing a new solution for identifying and acting upon files that violate policies.
  • Cette API n’est pas disponible pour Office 365 Cloud App Security.This API is not available for Office 365 Cloud App Security.

L’API Files vous fournit des métadonnées sur les fichiers et dossiers stockés dans vos applications Cloud, telles que la date de la dernière modification, la propriété, etc.The Files API provides you with metadata about the files and folders stored in your cloud apps, such as last modification date, ownership, and more.

La liste suivante répertorie les requêtes prises en charge :The following lists the supported requests:

FiltresFilters

Pour plus d’informations sur le fonctionnement des filtres, consultez filtres.For information about how filters work, see Filters.

Le tableau suivant décrit les filtres pris en charge :The following table describes the supported filters:

FiltrerFilter TypeType OpérateursOperators DescriptionDescription
serviceservice entierinteger EQ, NEQeq, neq Filtrer les fichiers à partir de l’appID d’application spécifié, par exemple : 11770Filter files from specified app appID, for example: 11770
instanceinstance entierinteger EQ, NEQeq, neq Filtrer les fichiers à partir des instances spécifiéesFilter files from specified instances
fileTypefileType entierinteger EQ, NEQeq, neq Filtrez les fichiers avec le type de fichier spécifié.Filter files with the specified file type. Les valeurs possibles incluent :Possible values include:

0: autres0: Other
1: document1: Document
2: feuille de calcul2: Spreadsheet
3: présentation3: Presentation
4: texte4: Text
5: image5: Image
6: dossier6: Folder
allowDeletedallowDeleted booleanboolean eqeq Les valeurs possibles incluent :Possible values include:

true: retourne les fichiers suppriméstrue: Returns deleted files
false ou not set : retourne les fichiers non supprimés (y compris les fichiers supprimés).false or not set: Returns non-deleted (including trashed) files. Ce sera remplacé par l’opérateur poubelleThis will be overridden by trashed operator
policypolicy stringstring cabinetmatchedrulesequals, NEQ, isset, isnotsetcabinetmatchedrulesequals, neq, isset, isnotset Filtrer les activités liées aux stratégies spécifiéesFilter activities related to the specified policies
filenamefilename stringstring eqeq Filtrer les fichiers par nom de fichierFilter files by filename
modifiedDatemodifiedDate timestamptimestamp ETL, GTE, plage, lte_ndays, gte_ndayslte, gte, range, lte_ndays, gte_ndays Filtrer les fichiers à la date de leur dernière modificationFilter files by the date they were last modified
createdDatecreatedDate timestamptimestamp ETL, GTE, plagelte, gte, range Filtrer les fichiers à la date de leur créationFilter files by the date they were created
collaborateurs. Entitycollaborators.entity CP d’entitéentity pk EQ, NEQeq, neq Filtrer les fichiers partagés avec les entités spécifiées.Filter files shared with specified entities. Exemple : [{ "id": "entity-id", "saas": 11161, "inst": 0 }]Example: [{ "id": "entity-id", "saas": 11161, "inst": 0 }]
collaborateurs. domainescollaborators.domains stringstring EQ, NEQeq, neq Filtrer les fichiers partagés avec les domaines spécifiésFilter files shared with specified domains
collaborateurs. Groupscollaborators.groups stringstring EQ, NEQeq, neq Filtrer les fichiers partagés avec les groupes spécifiésFilter files shared with specified groups
collaborateurs. withDomaincollaborators.withDomain stringstring EQ, NEQ, DEQeq, neq, deq Filtrer les fichiers partagés avec les domaines spécifiésFilter files shared with specified domains
propriétaire. entitéowner.entity CP d’entitéentity pk EQ, NEQeq, neq Filtrer les fichiers appartenant à des entités spécifiées.Filter files owned by specified entities. Exemple : [{ "id": "entity-id", "saas": 11161, "inst": 0 }]Example: [{ "id": "entity-id", "saas": 11161, "inst": 0 }]
propriétaire. unitéowner.orgUnit stringstring EQ, NEQeq, neq Filtrer les fichiers avec des propriétaires à partir d’unités d’organisation spécifiéesFilter files with owners from specified organizational units
partagersharing entierinteger EQ, NEQeq, neq Filtrer les fichiers avec les niveaux de partage spécifiés.Filter files with the specified sharing levels. Les valeurs possibles incluent :Possible values include:

4: public (Internet)4: Public (Internet)
3: public3: Public
2: externe2: External
1: interne1: Internal
0: privé0: Private
fileIdfileId stringstring EQ, NEQeq, neq Filtrer les fichiers par ID de fichierFilter files by file ID
fileLabelsfileLabels stringstring EQ, NEQ, isset, isnotseteq, neq, isset, isnotset Filtrer les fichiers contenant les identificateurs d’étiquette de fichier (balises) spécifiésFilter files containing the specified file labels (tags) IDs
fileScanLabelsfileScanLabels stringstring EQ, NEQ, isset, isnotseteq, neq, isset, isnotset Filtrer les fichiers contenant les ID d’avertissements d’inspection de contenu (balises) spécifiésFilter files containing the specified content inspection warnings (tags) IDs
extensionextension stringstring EQ, NEQeq, neq Filtrer les fichiers par une extension de fichier donnéeFilter files by a given file extension
mimeTypemimeType stringstring EQ, NEQeq, neq Filtrer les fichiers selon un type MIME donné, doit être une chaîne uniqueFilter files by a given MIME type, must be a single string
Corbeilletrashed booleanboolean eqeq Les valeurs possibles incluent :Possible values include:

true: retourne uniquement les fichiers suppriméstrue: Returns only trashed files
false: retourne les fichiers non supprimésfalse: Returns non-trashed files
parentFolderparentFolder dossierfolder EQ, NEQeq, neq Filtrer les fichiers contenus dans les dossiers spécifiésFilter files contained in the specified folders
dossierfolder booleanboolean eqeq Les valeurs possibles incluent :Possible values include:

true: retourne uniquement les dossierstrue: Returns only folders
false: retourne uniquement les fichiersfalse: Returns only files
mis en quarantainequarantined booleanboolean eqeq Les valeurs possibles incluent :Possible values include:

true: retourne uniquement les fichiers en quarantainetrue: Returns only quarantined files
false: retourne uniquement les fichiers non mis en quarantainefalse: Returns only non-quarantined files
snapshotLastModifiedDatesnapshotLastModifiedDate timestamptimestamp ETL, GTE, plagelte, gte, range Filtrer les fichiers en fonction de la date de la dernière modification de leur instantanéFilter files by the date their snapshot was last modified

Si vous rencontrez des problèmes, nous sommes là pour vous aider.If you run into any problems, we're here to help. Pour obtenir de l’aide ou une assistance concernant votre produit, veuillez ouvrir un ticket de support.To get assistance or support for your product issue, please open a support ticket.