{"type":"api","title":"Get tags list from a preset","meta":{"id":"/apps/pubhub/media/cisco-cyber-vision/c0cd14e5fea40ab3226a4b108db61ca3f0980faf/262737b2-b3c2-32cd-b07b-fdbdcd23918f","info":{"description":"RESTful API to manage the resources of Cisco Cyber Vision centers.","title":"Cisco Cyber Vision center v3 API.","version":"3.0.0"},"security":[{"token":[]}],"tags":[{"description":"Activities are an aggregation of flows between components.","name":"Activities"},{"description":"A baseline is used for monitor mode. They represent a snapshot of the network.","name":"Baselines"},{"description":"In monitor mode, these routes allow to retrieve and review differences between the actual network activity and the baseline description.","name":"BaselineDifferences"},{"description":"Components are logical nodes of the network.","name":"Components"},{"description":"Routes to manage network organization.","name":"CustomNetwork"},{"description":"Routes to manage custom properties that can be added to components or groups.","name":"CustomProperties"},{"description":"Routes to retrieve statistics and dashboard information. ","name":"Dashboard"},{"description":"A Device is a physical device that host a software that communicates on the network","name":"Devices"},{"description":"Routes to retrieve about external communications.","name":"ExternalCommunication"},{"description":"Flows represent a network interaction between two components.","name":"Flows"},{"description":"Routes to get a graphical representation of the components, activities, etc.","name":"Graph"},{"description":"Groups are a logical way to organize components.","name":"Groups"},{"description":"Various routes to get more information about a center.","name":"Misc"},{"description":"Routes to access the application parameters such as security options and allow to manage custom parameters.","name":"Parameters"},{"description":"Routes to retrieve information about pcap files replayed.","name":"PcapReplays"},{"description":"Presets are a way to filter data and prepare visualizations.","name":"Presets"},{"description":"Preset Based Reports","name":"Reports"},{"description":"Routes to access the configuration of the risk scores.","name":"RiskScores"},{"description":"Routes to retrieve information about the enrolled sensors.","name":"Sensors"},{"description":"Routes to browse sensor folders.","name":"SensorExplorer"},{"description":"Tags are meaningful labels applied to components and activities to describe network behaviors and device properties.","name":"Tags"},{"description":"Vulnerabilities are known security threats that could allow an attacker to gain unauthorized privileges.","name":"Vulnerabilities"},{"description":"Routes to configure the Active Discovery mode.","name":"ActiveDiscovery"},{"description":"Routes to retrieve information about the global credentials.","name":"GlobalCredentials"}],"x-parser-conf":{"overview":{"markdownPath":"reference/overview.md"}},"swagger":"2.0","basePath":"/api/3.0/","schemes":["https"],"securityDefinitions":{"token":{"description":"API token created in the Cyber Vision administration UI","type":"apiKey","name":"x-token-id","in":"header"}}},"spec":{"description":"Warning: this endpoint is cached. This means that the returned data is not necessarily the latest. So, be careful when using this endpoint with live data endpoints. The cache is automatically updated, but can also be updated at will thanks to POST /presets/{preset_id}/refreshData.\n","tags":["Tags"],"summary":"Get tags list from a preset.","operationId":"tagListFromPreset","parameters":[{"type":"string","description":"the preset id to get tags list.","name":"preset_id","in":"path","required":true},{"type":"string","description":"start time of the period of the query, in ms since January 1, 1970 UTC","name":"from","in":"query"},{"type":"string","description":"end time of the period of the query, in ms since January 1, 1970 UTC","name":"to","in":"query"},{"enum":["component","activity","both"],"type":"string","description":"the tag type","name":"type","in":"query"}],"responses":{"200":{"description":"tag list from preset successful","schema":{"type":"array","items":{"description":"DetailedTag detailed tag serialization","type":"object","properties":{"category":{"description":"Category json representation","type":"object","properties":{"id":{"type":"string","x-go-name":"Id"},"label":{"type":"string","x-go-name":"Label"},"priority_order":{"type":"integer","format":"int64","x-go-name":"PriorityOrder"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3","$$ref":"#/definitions/Category"},"description":{"type":"string","x-go-name":"Description"},"difference":{"type":"object","properties":{"detection":{"type":"integer","format":"int64","x-go-name":"DetectionTime"},"id":{"description":"A UUID is a 128 bit (16 byte) Universal Unique IDentifier as defined in RFC\n4122.","type":"array","items":{"type":"integer","format":"uint8"},"x-go-package":"code.google.com/p/go-uuid/uuid","$$ref":"#/definitions/UUID"},"key":{"type":"string","x-go-name":"Key"},"oldValue":{"type":"string","x-go-name":"OldValue"},"type":{"type":"string","x-go-name":"Type"},"value":{"type":"string","x-go-name":"Value"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3","$$ref":"#/definitions/Difference"},"domain":{"type":"string","x-go-name":"Domain"},"id":{"type":"string","x-go-name":"Id"},"important":{"type":"boolean","x-go-name":"Important"},"label":{"type":"string","x-go-name":"Label"},"nbOccurences":{"type":"integer","format":"int64","x-go-name":"NbOccurences"},"riskScoreDescription":{"type":"string","x-go-name":"RiskscoreDescription"},"type":{"type":"string","x-go-name":"Type"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3","$$ref":"#/definitions/DetailedTag"},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3","$$ref":"#/definitions/DetailedTags"}},"400":{"description":"bad request"},"401":{"description":"incorrect token"},"404":{"description":"preset not found"},"default":{"description":"unexpected error"}},"__originalOperationId":"tagListFromPreset","consumes":["application/json"],"produces":["application/json"],"security":[{"token":[]}],"method":"get","path":"/presets/{preset_id}/visualisations/tag-list"}}