cdp.connection.sectag.cloud
The cdp.connection.sectag.cloud command is used to generate a Connections security tag cloud. Filtering by sectags and/or Ids will generate a sectag cloud containing the different sectags associated to the request params (sectags/ids). For more detail use cases, see thing.tag.cloud.
TR50 Request
{
"cmd" : {
"command": "cdp.connection.sectag.cloud",
"params": {
"secTags": ["sectag1", "sectag2"],
"ids": [
"5413264000ad5e898b48408e",
"548408413264de05e898b00a",
"5264005e84130ade898b4840"
]
}
}
}
Request Parameters
Name | Type | Required | Description |
---|---|---|---|
secTags | Array | An array of security tags. The result will be limited to the security tags associated with connections that already have the indicated security tags. | |
ids | Array | An array of connection ids. The result will be limited to the tags that are associated to the specified connections. |
TR50 Response
If the command is sent successfully a success message and the security tag cloud object is returned. Otherwise, an error and error message will be returned.
{
"cmd": {
"success": true,
"params": {
"result": [
{
"sectag3": 2
},
{
"sectag4": 1
}
]
}
}
}
Response Parameters
Name
|
Type
|
Description
|
---|---|---|
result | Array | An array of objects. Each object will list the sectags count associated to the input sectags and/or keys. In the above example, 3 connections has sectag3 along with sectag1 or sectag2 and the listed Ids, and 1 thing have sectag4 along with sectag1 or sectag2 and and the listed Ids. |