Viewing maximum concurrent users at the space level (technical preview)

Using the REST API, space admins can view the maximum number of users working concurrently in a space for a specific date range.

Tip: In on-premises environments, usage at space level is to track the maximum number of users per space, but licenses are consumed according to site license usage. For details see Viewing on-premises site license usage (technical preview).

Prerequisite

To view the maximum number of users working concurrently in a space, you must be authenticated as the space admin.

For details, see Authenticating.

Back to top

Examples of viewing space usage

Here are examples the space admin can use to view the maximum number of licenses in use concurrently per day.

Request

GET .../api/shared_spaces/1001/license_usage/

Response

The default response includes the latest date only. To receive more data, add start and end date parameters to the REST request.

{
  "license_usage": {
       "2019-08-04:00:00.000+0000": 3,
       }
       "space_id":1001,
}

View maximum license usage for specific dates

You can add optional start_date and end_date atributes to the GET request to specify your own date range.

Request

GET .../api/shared_spaces/1001/license_usage?start_date=2019-10-17&end_date=2019-10-21

Response

{
  "license_usage": {
       "2019-10-17:00:00.000+0000": 1,
       "2019-10-18:00:00.000+0000": 2,
       "2019-10-19:00:00.000+0000": 3,
       "2019-10-20:00:00.000+0000": 4,
       "2019-10-21:00:00.000+0000": 4
       }
       "space_id":1001,
       "start_date": "2019-10-17",
       "end_date": "2019-10-21",
}

Back to top

See also: