Visa lista över data anriknings-APIList - Data Enrichment 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.

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

HTTP-begäranHTTP request

GET /api/v1/subnet/
POST /api/v1/subnet/

Begär ande text parametrarRequest BODY parameters

ParameterParameter BeskrivningDescription
filterfilters Filtrera objekt med alla Sök filter för begäran, se filter för IP-intervall för mer informationFilter objects with all the search filters for the request, see IP range filters for more details
sortDirectionsortDirection Sorterings riktningen.The sorting direction. Möjliga värden är: asc och descPossible values are: asc and desc
sortFieldsortField Fält som används för att sortera IP-intervall.Fields used to sort IP ranges. Möjliga värden:Possible values are:
- kategori: kategorin för IP-intervallet- category: The category of the IP range
- taggar: taggarna för IP-intervallet- tags: The tags of the IP range
- namn: namnet på IP-intervallet- name: The name of the IP range
hoppa överskip Hoppar över det angivna antalet posterSkips the specified number of records
gränslimit 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/subnet/" -d '{
  "filters": {
    // some filters
  },
  "skip": 5,
  "limit": 10
  ...
}'

SvarsåtgärderResponse

Returnerar en lista med IP-intervall i JSON-format.Returns a list of IP ranges in JSON format. Information om svars fälten finns i Egenskaper.For information about the response fields, see Properties.

{
  "total": 1 // total number of records
  "hasNext": false // whether there is more data to show or not.
  "data": [
    {
      // returned records
      "_id": "5fd767259cd24bb563567d7c",
      "name": "range name",
      "subnets": [
        {
          "mask": 112,
          "address": "0000:0000:0000:0000:0000:ffff:c5c6:0000",
          "originalString": "197.198.192.20/16"
        }
      ],
      "location": {
        "name": "United States",
        "latitude": 39.5035514831543,
        "longitude": -99.01830291748047,
        "countryCode": "US",
        "countryName": "United States"
      },
      "organization": "isp name",
      "tags": [
        {
          "_id": "5ce2aaf42207ad108c76fa3a",
          "id": "000000290000000000000000",
          "target": 1,
          "type": 2,
          "name": "Contoso",
          "nameTemplate": {
            "template": "SAGE_BUILTIN_TAG_CONTOSO_NAME"
          },
          "description": "IP addresses used by Contoso",
          "descriptionTemplate": {
            "template": "SAGE_BUILTIN_TAG_CONTOSO_DESCRIPTION"
          },
          "visibility": 0,
          "status": 0,
          "_tid": 113348336
        }
      ],
      "category": 5,
      "lastModified": 1607952165309.8032,
      "_tid": 113348336
    }
  ]
}

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.