Reports/[id]/share
Description
Shares one or more specific reports (as specified by the report id(s) in the request) with the Users of specific Applications, Tenants or Sub‑tenants so that those Users can subscribe to this report in the IoT Platform Portal, as described below. The id of a report is returned in the response to the Reports/Post and Reports/Get (List) endpoints. The following provides more details.
IoT Platform Users can subscribe to automatically receive periodic IoT Platform reports by email.
To do so, either –
• Use the Reports/[id]/subscribe
– OR –
• In the IoT Platform Portal – A User can click the Reports option in the left pane and then select the Subscription tab. A list of reports to which they can subscribe is displayed. That User can then mark the Subscribed checkbox in order to start automatically receiving periodic reports by email.
The list of reports that appear for selection is determined by those that are shared by the report creator, Application User or Tenant User, as follows –
• Application Users can share with Users of the same Application.
• Tenant Users can share with all the Users of all the Applications of that Tenant or with specific Users of that Tenant.
• Sub-tenants can share with Users of all the Applications of the same Sub-tenant.
 | Tenant Users who want to share this report with all the Users of a Tenant’s Applications should select to share with the Tenant itself (and not by selecting each of the Applications of the Tenant). By selecting to share with the Tenant itself, this report will also be shared with all the new Applications added to this Tenant or to its Sub-tenants. |
For request and response details, see Request ‒ Reports/{id}/share and Response ‒ Reports/[id]/share.