Page tree
Skip to end of metadata
Go to start of metadata

Last updated: Dec 15, 2019 11:07

Creates a new device reservation.

Request syntax

https://mycloud.perfectomobile.com/services/reservations?operation=create&securityToken=value&resourceIds=value&startTime=value&endTime=value[&optionalParameter=value]

Parameters

NameTypeDefaultDescription
securityToken*string
A unique cryptographic key assigned to an authorized user.
userstring 

Deprecated. The username of the user running the operation. 

Note: Going forward, all authentication requires a security token. For information on obtaining a security token, see Generate security tokens.

passwordstring 

Deprecated. The password for the user. 

Note: Going forward, all authentication requires a security token. For information on obtaining a security token, see Generate security tokens.

admin booleanfalsetrue 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). 
responseFormatstringjsonThe format to use for the response: json, xml

* Mandatory

** 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.

Response JSON format
{
	"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"
	}
}