Lista: API de enriquecimiento de datos

  • Artículo

Ejecuta la solicitud GET o POST para capturar una lista de intervalos IP que coincidan con los filtros especificados.

Solicitud HTTP

GET /api/v1/subnet/

POST /api/v1/subnet/

Parámetros del CUERPO de la solicitud

Parámetro Descripción
filtros Si deseas filtrar objetos con todos los filtros de búsqueda de la solicitud, consulta Filtros de intervalos IP para obtener más detalles
sortDirection Dirección de ordenación. Los valores posibles son asc y desc
sortField Campos usados para ordenar intervalos IP. Los valores posibles son:
- category: categoría del intervalo IP
- tags: las etiquetas del intervalo IP
- name: el nombre del intervalo IP
skip Omite el número de registros especificado
limit Número máximo de registros que se van a devolver en la solicitud

Ejemplo

Solicitar

Este es un ejemplo de la solicitud.

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

Respuesta

Devuelve una lista de intervalos IP en formato JSON. Para obtener información sobre los campos de respuesta, consulta Propiedades.

{
  "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 tienes algún problema, estamos aquí para ayudar. Para obtener ayuda o soporte técnico para el problema del producto, abre una incidencia de soporte técnico.