cdp.connection.tag.cloud

The cdp.connection.tag.cloud command is used to generate a Connection tag cloud. Filtering by tags and/or ids will generate a tag cloud containing the different tags associated to the request params (tags/ids). For more detail use cases, see thing.tag.cloud.

TR50 Request

{
  "cmd" : {
    "command": "cdp.connection.tag.cloud",
    "params": {
      "tags": ["tag1", "tag2"],
      "ids": [
        "5413264000ad5e898b48408e",
        "548408413264de05e898b00a",
        "5264005e84130ade898b4840"
      ]
    }
  }
}

Request Parameters

Name	Type	Required	Description
tags	Array		An array of tags. The result will be limited to the tags associated with connections that already have the indicated tags.
One of the following Identifier* parameter is required.
ids	Array	Yes*	An array of connection ids that will be tagged
esn	Array		An array of connection esns that will be tagged
iccid	Array		An array of connection iccids that will be tagged
imei	Array		An array of connection imeis that will be tagged
imsi	Array		An array of connection imsis that will be tagged
meid	Array		An array of connection meids that will be tagged
msisdn	Array		An array of connection msisdns that will be tagged

TR50 Response

If the command is sent successfully a success message and the tag cloud object is returned. Otherwise, an error and error message will be returned.

{
  "cmd": {
    "success": true,
    "params": {
      "result": [
        {
          "tag3": 1
        },
        {
          "tag4": 1
        },
      ]
    }
  }
}

Response Parameters

Name	Type	Description
result	Array	An array of objects. Each object will list the tags count associated to the input tags and/or keys. In the above example, 1 Thing have tag3 along with tag1 or tag2 and the listed ids, and 1 Thing have tag4 along with tag1 or tag2 and the listed ids.