Liste - API d’enrichissement des données

  • Article

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.