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.