Liste-API d’enrichissement des donnéesList - Data Enrichment 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.

Exécutez la requête d’obtention ou de publication pour extraire une liste de plages d’adresses IP correspondant aux filtres spécifiés.Run the GET or POST request to fetch a list of IP ranges matching the specified filters.

Demande HTTPHTTP request

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

Paramètres du corps de la demandeRequest BODY parameters

ParamètreParameter DescriptionDescription
filtresfilters Filtrer les objets avec tous les filtres de recherche pour la demande, consultez filtres de plage d’adresses IP pour plus d’informationsFilter objects with all the search filters for the request, see IP range filters for more details
sortDirectionsortDirection Sens du tri.The sorting direction. Les valeurs possibles sont : asc et descPossible values are: asc and desc
sortFieldsortField Champs utilisés pour trier des plages d’adresses IP.Fields used to sort IP ranges. Les valeurs possibles sont les suivantes :Possible values are:
- catégorie: catégorie de la plage d’adresses IP- category: The category of the IP range
- Tags: balises de la plage d’adresses IP- tags: The tags of the IP range
- nom: nom de la plage d’adresses IP- name: The name of the IP range
skipskip Ignore le nombre spécifié d’enregistrementsSkips the specified number of records
limitlimit Nombre maximal d’enregistrements retournés par la requêteMaximum number of records returned by the request

 ExempleExample

RequêteRequest

Voici un exemple de la requête.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
  ...
}'

responseResponse

Retourne une liste de plages d’adresses IP au format JSON.Returns a list of IP ranges in JSON format. Pour plus d’informations sur les champs de réponse, consultez Propriétés.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
    }
  ]
}

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.