Ficheiros API
Aplica-se a: Microsoft Cloud App Security
Importante
Os nomes dos produtos de proteção contra ameaças da Microsoft estão a mudar. Leia mais sobre esta e outras atualizações aqui. Vamos atualizar nomes em produtos e nos documentos num futuro próximo.
Nota
- Esta API não está disponível para Office 365 Cloud App Security.
A API de Ficheiros fornece-lhe metadados sobre os ficheiros e pastas armazenados nas suas aplicações na nuvem, tais como a última data de modificação, propriedade e muito mais.
As seguintes listas listam os pedidos suportados:
Filtros
Para obter informações sobre como funcionam os filtros, consulte Filtros.
A tabela a seguir descreve os filtros suportados:
| Filtro | Tipo | Operadores | Descrição |
|---|---|---|---|
| serviço | número inteiro | eq, neq | Filtrar ficheiros a partir de app appID especificado, por exemplo: 11770 |
| exemplo | número inteiro | eq, neq | Filtrar ficheiros de instâncias especificadas |
| fileType | número inteiro | eq, neq | Filtrar ficheiros com o tipo de ficheiro especificado. Valores possíveis incluem: 0: Outros 1: Documento 2: Folha de cálculo 3: Apresentação 4: Texto 5: Imagem 6: Pasta |
| permitirDeleted | boolean | eq | Valores possíveis incluem: verdadeiro: Devoluções de ficheiros apagados falso ou não definido: Devoluções ficheiros não apagados (incluindo lixo). Isto será ultrapassado por um operador desondo. |
| política | string | cabinetmatchedrulesequals, neq, isset, isnotset | Filtrar atividades relacionadas com as políticas especificadas |
| filename | string | eq | Filtrar ficheiros por nome de ficheiro |
| datado modificado | carimbo de data/hora | Ite, gte, alcance, lte_ndays, gte_ndays | Filtrar ficheiros até à data em que foram modificados pela última vez |
| createdDate | carimbo de data/hora | Lte, gte, alcance | Filtrar ficheiros até à data em que foram criados |
| colaboradores.entidade | entidade pk | eq, neq | Filtrar ficheiros partilhados com entidades especificadas. Exemplo: [{ "id": "entity-id", "saas": 11161, "inst": 0 }] |
| colaboradores.domínios | string | eq, neq | Ficheiros de filtro partilhados com domínios especificados |
| colaboradores.grupos | string | eq, neq | Ficheiros de filtro partilhados com grupos especificados |
| colaboradores.comDomínio | string | eq, neq, deq | Ficheiros de filtro partilhados com domínios especificados |
| proprietário.entidade | entidade pk | eq, neq | Filtrar ficheiros pertencentes a entidades especificadas. Exemplo: [{ "id": "entity-id", "saas": 11161, "inst": 0 }] |
| proprietário.orgUnit | string | eq, neq | Filtrar ficheiros com proprietários de unidades organizacionais especificadas |
| partilha | número inteiro | eq, neq | Filtrar ficheiros com os níveis de partilha especificados. Valores possíveis incluem: 4: Público (Internet) 3: Público 2: Externo 1: Interno 0: Privado |
| fileId | string | eq, neq | Filtrar ficheiros por ID de ficheiro |
| fileLabels | string | eq, neq, isset, isnotset | Ficheiros de filtro que contenham as etiquetas de ficheiros especificadas (tags) IDs |
| arquivoSsScanLabels | string | eq, neq, isset, isnotset | Ficheiros de filtro que contenham os avisos de inspeção de conteúdo especificados (tags) IDs |
| extensão | string | eq, neq | Filtrar ficheiros por uma determinada extensão de ficheiro |
| mímicaType | string | eq, neq | Filtrar ficheiros por um determinado tipo MIME, deve ser uma única corda |
| destruído | boolean | eq | Valores possíveis incluem: verdadeiro: Devoluções apenas ficheiros destruídos falso: Devolve ficheiros não destruídos |
| parentFolder | pasta | eq, neq | Ficheiros de filtro contidos nas pastas especificadas |
| pasta | boolean | eq | Valores possíveis incluem: verdadeiro: Devolve apenas pastas falso: Devolução apenas de ficheiros |
| quarentena | boolean | eq | Valores possíveis incluem: verdadeiro: Devolve apenas ficheiros em quarentena falso: Devolve apenas ficheiros não colocados em quarentena |
| snapshotLastModifiedDate | carimbo de data/hora | Lte, gte, alcance | Filtrar ficheiros até à data em que o seu instantâneo foi modificado pela última vez |
Se tiver algum problema, estamos aqui para ajudar. Para obter assistência ou suporte para o seu problema de produto, abra um bilhete de apoio.