thing.sectag.cloud
The thing.sectag.cloud command is used to generate a Things security tag cloud. Filtering by sectags and/or keys will generate a sectag cloud containing the different sectags associated to the request params (sectags/keys). For more detail use cases, see thing.tag.cloud.
TR50 Request
{
"cmd": {
"command": "thing.sectag.cloud",
"params": {
"secTags": ["sectag1", "sectag2"],
"keys": ["mything1", "mything2"]
}
}
}
Request Parameters
Name | Type | Required | Description |
---|---|---|---|
secTags | Array | An array of security tags. The result will be limited to the security tags associated with Things that already have the indicated security tags. | |
keys | Array | An array of thing keys. The result will be limited to the security tags associated with Things identified by the submitted thing keys. |
TR50 Response
If the command is sent successfully a success message and the counts of security tags associated to the input params in displayed. 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 things has sectag3 along with sectag1 or sectag2 and along with mything1 or mything2, and 1 thing have sectag4 along with sectag1 or sectag2 and along with mything1 or mything2. |