Visa lista över filer-APIList - Files API

Gäller för: Microsoft Cloud App SecurityApplies to: Microsoft Cloud App Security

Viktigt

Hot skydds produkt namn från Microsoft ändras.Threat protection product names from Microsoft are changing. Läs mer om det här och andra uppdateringar här.Read more about this and other updates here. Vi kommer att uppdatera namn i produkter och i dokumenten inom en snar framtid.We'll be updating names in products and in the docs in the near future.

Anteckning

  • Detta API kommer snart att vara inaktuellt.This API will soon be deprecated. Microsoft Cloud App Security utvecklar en ny lösning för att identifiera och agera på filer som bryter mot principer.Microsoft Cloud App Security is developing a new solution for identifying and acting upon files that violate policies.
  • Den här slut punkten kan vara timeout vid filtrering och sid brytning av stora samlingar.This endpoint may time out when filtering and paginating large collections.
  • Detta API är inte tillgängligt för Office 365 Cloud App Security.This API is not available for Office 365 Cloud App Security.

Kör GET-eller POST-begäran för att hämta en lista över filer som matchar de angivna filtren.Run the GET or POST request to fetch a list of files matching the specified filters.

HTTP-begäranHTTP request

GET /api/v1/files/
POST /api/v1/files/

Begär ande text parametrarRequest BODY parameters

ParameterParameter BeskrivningDescription
filterfilters Filtrera objekt med alla Sök filter för begäran, se fil filter för mer informationFilter objects with all the search filters for the request, see file filters for more details
hoppa överskip Hoppar över det angivna antalet posterSkips the specified number of records
gränsernalimit Maximalt antal poster som returneras av begäranMaximum number of records returned by the request

ExempelExample

FörfråganRequest

Här är ett exempel på begäran.Here is an example of the request.

curl -XPOST -H "Authorization:Token <your_token_key>" "https://<tenant_id>.<tenant_region>.contoso.com/api/v1/files/" -d '{
  "filters": {
    // some filters
  },
  "skip": 5,
  "limit": 10
  ...
}'

SvarsåtgärderResponse

Returnerar en lista med filer i JSON-format.Returns a list of files in JSON format.

{
  "total": 5 // total number of records
  "hasNext": true // whether there is more data to show or not.
  "data": [
    // returned records
  ]
}

Om du stöter på problem är vi här för att hjälpa dig.If you run into any problems, we're here to help. Öppna ett support ärendeom du vill ha hjälp eller support för produkt problemet.To get assistance or support for your product issue, please open a support ticket.