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.

Related Topics Link IconRelated Topics