Limits

REST Overview
Jobs	Job Reports	Groups	Pools	Limits	Repository	Pulse	Workers	Tasks	Task Reports	Users	Balancer

Overview

Limit Group requests can be used to set and retrieve information about one or many Limit Groups.

Limit Group requests support GET, PUT, POST, and DELETE request types.

For more about these request types and their uses see the Request Formats and Responses documentation.

Requests and Responses

List of possible requests for Limit Groups.

All PUT and POST requests can return a 400 Bad Request Error message if no message body is passed, or if no command key is present in the message body.

All PUT and POST requests may also return a 500 Internal Server Error error message if the command key in the message body contained an invalid command.

Get Limit Group Names

Gets the names of all Limit Groups in the Repository.

URL:	http://hostname:portnumber/api/limitgroups?NamesOnly=true
Request Type:	GET
Message Body:	N/A
Response:	JSON object containing all the Limit Group names.
Possible Errors:	500 Internal Server Error: An exception occurred within the Deadline code.

Get Limit Groups

Gets the Limit Groups for the provided Limit Group names.

URL:	http://hostname:portnumber/api/limitgroups?Names=list,Of,One,Or,More,LimitGroup,Names http://hostname:portnumber/api/limitgroups?Name=aSingleLimitGroupName
Request Type:	GET
Message Body:	N/A
Response:	JSON object containing the requested Limit Group/s
Possible Errors:	404 Not Found: There is no Limit Group with provided Name (this can only occur if a single name is passed) 500 Internal Server Error: An exception occurred within the Deadline code.

Get All Limit Groups

Gets the names of all Limit Groups in the Repository.

URL:	http://hostname:portnumber/api/limitgroups
Request Type:	GET
Message Body:	N/A
Response:	JSON object containing all the Limit Groups.
Possible Errors:	500 Internal Server Error: An exception occurred within the Deadline code.

Set Limit Group

Sets the Limit, Worker List, Allow List Flag, Release Percentage and/or Excluded Workers for an existing Limit Group, or creates a new Limit Group with the provided properties. Allow list flag is boolean

URL:	http://hostname:portnumber/api/limitgroups
Request Type:	PUT/POST
Message Body:	JSON object where the following keys are mandatory: Command = set Name = name of Limit Group The following keys are optional: Limit= integer limit Slaves = list of Worker names to include for limit SlavesEx = list of Worker names to exclude from limit RelPer = floating point number for release percentage White = boolean flag. True for allow list and false for deny list.
Put Response:	“Success”
Post Response:	“Success.” Note: the dot will be removed in the future.
Possible Errors:	400 Bad Request: No name provided for the Limit Group 500 Internal Server Error: An exception occurred within the Deadline code.

Save Limit Group

Updates a Limit Group using a JSON object containing all the Limit Group information.

URL:	http://hostname:portnumber/api/limitgroups
Request Type:	PUT
Message Body:	JSON object where the following keys are mandatory: Command = save LimitGroup = JSON object containing all relevant Limit Group information
Response:	“Success”
Possible Errors:	400 Bad Request: No valid Limit Group object provided. 500 Internal Server Error: An exception occurred within the Deadline code.

Reset Limit Group

Resets the counts for a Limit Group.

URL:	http://hostname:portnumber/api/limitgroups
Request Type:	PUT
Message Body:	JSON object where the following keys are mandatory: Command = reset Name = name of Limit Group
Response:	“Success”
Possible Errors:	400 Bad Request: No name provided for the Limit Group 404 Not Found: Provided Limit Group name does not correspond to a Limit Group in the Repository. 500 Internal Server Error: An exception occurred within the Deadline code.

Delete Limit Groups

Deletes the Limit Groups for the provided Limit Group names.

URL:	http://hostname:portnumber/api/limitgroups?Names=list,Of,One,Or,More,LimitGroup,Names
Request Type:	DELETE
Message Body:	N/A
Response:	“Success”
Possible Errors:	400 Bad Request: Must provide at least one Limit Group name to delete. 500 Internal Server Error: An exception occurred within the Deadline code.

Limit Group Property Values

Values for some Limit Group properties are represented by numbers. Those properties and their possible values are listed below.

Type (LimitGroupType)

• 0 = General

• 1 = JobSpecific

• 2 = MachineSpecific

StubLevel (currently not used)

• 0 = Slave

• 1 = Task

• 2 = Machine