Liste - API d’enrichissement des données

Article
01/23/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 du CORPS de la demande

Paramètre	Description
filters	Filtrer les objets avec tous les filtres de recherche pour la demande, consultez les Filtres plage d’adresses IP pour plus d’informations
sortDirection	Le sens 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 : La catégorie de la plage d’adresse IP - balises : Les balises de la plage d’adresses IP - nom : Le nom de la plage d’adresses IP
skip	Ignore le nombre spécifié d’enregistrements
limit	Nombre maximal d'enregistrements à retourner dans la demande

Exemple

Requête

Voici un exemple de la requête.

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
  // ...
}'

Response

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, veuillez ouvrir un ticket de support.

Partager via