thing.sectag.cloud

The thing.sectag.cloud command is used to generate a security tag cloud for things.

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 security tag cloud object is returned. Otherwise, an error and error message will be returned.


                        {
  "cmd": {
    "success": true,
    "params": {
      "result": [
        {
          "sectag1": 8
        },
        {
          "sectag2": 3
        }
      ]
    }
  }
}

Response Parameters


Name	Type	Description
result	Array	An array of objects. Each object will be a security tag and the number of things that have that security tag. In the above example, 8 things have sectag1, and 3 things have sectag2.