Partager via

Liste - API d’enrichissement des données

Exécutez la requête GET ou POST pour extraire une liste de plages d’adresses IP correspondant aux filtres spécifiés.

Requête HTTP

GET /api/v1/subnet/

POST /api/v1/subnet/

Paramètres BODY de la requête

Paramètre Description
Filtres Filtrer les objets avec tous les filtres de recherche pour la requête. Pour plus d’informations, consultez Filtres de plages d’adresses IP
sortDirection Direction du tri. Les valeurs possibles sont : asc et desc
sortField Champs utilisés pour trier les plages d’adresses IP. Les valeurs possibles sont les suivantes :
- category : catégorie de la plage d’adresses IP
- tags : balises de la plage d’adresses IP
- name : nom de la plage d’adresses IP
skip Ignore le nombre spécifié d’enregistrements
limit Nombre maximal d’enregistrements retournés par la requête

Exemple

Demande

Voici un exemple de demande.

curl -XPOST -H "Authorization:Token <your_token_key>" -H "Content-Type: application/json" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/v1/subnet/" -d '{
  "filters": {
    // some filters
  },
  "skip": 5,
  "limit": 10
  // ...
}'

Réponse

Retourne une liste de plages d’adresses IP au format JSON. Pour plus d’informations sur les champs de réponse, consultez Propriétés.

{
  "total": 1 // approximate 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. Pour obtenir de l’aide ou du support pour votre problème de produit, ouvrez un ticket de support.

  • Last updated on