{"type":"model","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/9d37d008417d562ab46d4b67547a68457ce288d2/cba65c33-1da3-3556-a885-2c67eb61196b","info":{"title":"Cisco Umbrella Reporting API","description":"The Reporting API provides the data to generate the Umbrella reports.","version":"2.0.0","contact":{"name":"Cloud Security Developer Community"}},"security":[{"oauthFlow":[]}],"tags":[{"name":"Activity"},{"name":"Top Identities"},{"name":"Identity Distribution"},{"name":"Top Destinations"},{"name":"Top Categories"},{"name":"Top Event Types"},{"name":"Top DNS Query Types"},{"name":"Organization Requests by Hour"},{"name":"Organization Requests by Timerange"},{"name":"Organization Requests by Hour and Category"},{"name":"Organization Requests by Timerange and Category"},{"name":"Deployment Status"},{"name":"Provider Deployment Status"},{"name":"Provider Requests by Hour"},{"name":"Provider Requests by Timerange"},{"name":"Provider Requests by Organization"},{"name":"Provider Requests by Category"},{"name":"Provider Requests by Destination"},{"name":"Provider Category Requests by Organization"},{"name":"Bandwidth by Hour"},{"name":"Bandwidth by Timerange"},{"name":"Top Files"},{"name":"Total Requests"},{"name":"Top Threats"},{"name":"Top Threat Types"},{"name":"Utility"},{"name":"Top IPs"},{"name":"Summary"},{"name":"Summaries by Category"},{"name":"Summaries by Destination"},{"name":"Summaries by Rule (Intrusion)"},{"name":"Umbrella"}],"x-parser-conf":{"overview":{"markdownPath":"reference/reports/reporting-overview.md","uri":"umbrella-api-reference-reporting-overview"}},"openapi":"3.0.1","servers":[{"url":"https://api.umbrella.com/{basePath}","variables":{"basePath":{"default":"reports/v2"}}}],"securitySchemes":{"oauthFlow":{"type":"oauth2","description":"client credential flow","flows":{"clientCredentials":{"tokenUrl":"https://api.umbrella.com/auth/v2/token","scopes":{"reports.granularEvents:read":"Read reports granular events","reports.utilities:read":"Read reports utilities","reports.aggregations:read":"Read reports aggregations","reports.summariesByRule:read":"Read reports for the summaries of the rule","reports.customers:read":"Read reports for the customers"}}}}}},"spec":{"type":"object","description":"The information about the top file requests.","properties":{"requests":{"type":"number","description":"The number of requests for the file."},"sha256":{"type":"string","description":"The SHA256 hash for the entry.","$$ref":"#/components/schemas/sha256"},"categories":{"type":"array","description":"The list of categories.","items":{"type":"object","description":"The properties of the category.","properties":{"id":{"type":"number","description":"The ID of the category."},"label":{"type":"string","description":"The descriptive label for the category."},"type":{"type":"string","description":"The type of the category."},"integration":{"type":"boolean","description":"Specifies whether the category is an integration.","example":true},"deprecated":{"type":"boolean","description":"Specifies whether the category is a legacy category.","example":true}},"$$ref":"#/components/schemas/Category"},"$$ref":"#/components/schemas/categories"},"identitycount":{"type":"number","description":"The count of the identities for the entry."},"filenames":{"type":"array","description":"The list of filenames for the entry.","items":{"type":"string"}},"filetypes":{"type":"array","description":"The list of filetypes for the entry.","items":{"type":"string"}}},"required":["categories","filenames","filetypes","identitycount","requests","sha256"],"example":{"requests":123,"sha256":"9495b6c155044053953efe30ebaf804780c114e7b721b14f6a5b0a782769696e","categories":[{"id":66,"label":"Malware","type":"security","integration":true}],"identitycount":1,"filenames":[],"filetypes":[]},"$$ref":"#/components/schemas/TopFile","title":"TopFile"}}