Create Reservation | Legacy
Restriction: This API endpoint is not supported in the Free Trial cloud.
Creates a new device reservation.
URL |
Copy
|
Method |
|
Parameters
Name | Type | Default | Description |
---|---|---|---|
securityToken* | string |
|
A unique cryptographic key assigned to an authorized user. |
admin | boolean | false | true to allow users with administrative credentials to create reservations for users in their group. note: users with administrative credentials can create reservations longer than the max time-frame. note: not available on shared MCM. |
resourceIds* | string |
|
A comma separated list of deviceId. |
startTime*
|
long |
|
The reservation start time, measured in milliseconds, from midnight, January 1, 1970 UTC (standard UNIX time).** * Use -1 to indicate current time. |
endTime* | long |
|
The reservation end time, measured in milliseconds, from midnight, January 1, 1970 UTC (standard UNIX time).** |
reservedTo | string |
|
The user the device is reserved to. |
description | string |
|
The reservation description (free text). |
responseFormat | string | json | The format to use for the response: json, xml |
* Mandatory parameter
** Use this Timestamp converter to create the required time stamp.
Response
The response contains the generated reservation ids and a system timestamp of the when the reservation was registered.
Copy
JSON response
{
"reservationIds":["87640"],
"info":{
"creationTime":{
"formatted":"2016-12-04T11:51:25Z",
"millis":"1480852285681" },
"items":"1",
"modelVersion":"2.6.0.0",
"productVersion":"master",
"time":"2016-12-04T11:51:25Z" }
}