Liste - API d’enrichissement des données

Article
11/28/2024

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

Partager via