{"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":{"required":["counts","date","time","timestamp"],"type":"object","description":"The information about the categories seen by hour.","properties":{"timestamp":{"type":"number","description":"The timestamp represented in milliseconds for the bucket.","example":1594557263000,"$$ref":"#/components/schemas/TimestampForBucket"},"date":{"type":"string","description":"The date from the timestamp based on the timezone parameter.","example":"2020-07-12","$$ref":"#/components/schemas/Date"},"time":{"type":"string","description":"The time in 24-hour format based on the timezone parameter.","example":"12:34","$$ref":"#/components/schemas/Time"},"counts":{"type":"array","description":"The list of counts for the category.","items":{"type":"object","description":"The information about the category counts.","properties":{"category":{"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"},"requests":{"type":"number","description":"The total number of requests for the category."}},"required":["category","requests"],"example":{"category":{},"requests":24},"$$ref":"#/components/schemas/CategoryCount"}}},"example":{"timestamp":1559836800000,"date":"2019","time":"16:00:00","counts":[{"category":{"id":66,"label":"Malware","type":"security","integration":true},"requests":123}]},"$$ref":"#/components/schemas/CategoryByHour","title":"CategoryByHour"}}