Schedule Demand Response (DR) for Selected Facilities¶
Schedules a Demand Response (DR) for a list of selected facilities in the organization for a specific period from the start time.
Request¶
POST https://{em_ip_address_or_hostname}/ems/api/org/dr/scheduledr/facilities/{facility_specification_list}
{
"pricelevel": "LOW",
"duration": "60",
"starttime": "2015-07-21T12:15:49+05:30",
"dridentifier": "DR16",
"pricing": "15.0"
}
Parameters¶
Path Parameters¶
Request¶
Name | Description |
---|---|
em_ip_address_or_hostname | The Manage’s IP address or hostname |
facility_specification_list | Schedules a demand response for a list of selected facilities. List of facilities separated by commas. Each facility contains facility type and facility ID: {facility type}_{facility ID}. Facility Type: Can be either a company, campus, building, or floor. Facility ID: A unique identifier that is assigned to the company or organization, campus, building or floor. (Facility ID is returned in Get All Floors API). Note: Specifying a facility other than the floor automatically assigns DR to all floors under the facility. Assigning a campus will assign DR to all floors for all buildings on the campus. For example, 1. To assign DR to the first and second floors of a building, type floor_1,floor_2. DR will be assigned to floor 1 and floor 2. 2. To assign DR to all floors in the Headquarters Building with ID 22, type Building_22. DR will be assigned to all floors in building 22. |
pricelevel | DR pricing: HIGH/ MODERATE/ LOW/ SPECIAL |
duration | The DR duration time in minutes (must be a whole number) |
starttime | Time from when DR should be in effect. Format: (yyyyMMddHHmm ) year/month/day/hour/minutes |
dridentifier | User assigned Demand Response (DR) identifier |
pricing | DR pricing that is effective for the energy consumed during the DR period (optional) |
Response¶
Name | Description |
---|---|
status | 0 – DR schedule successful. 1 – DR not scheduled |
msg | Message description |
Sample Request¶
For example, schedule a Demand Response (DR) at LOW price level for Floor 1 in Building 51, Campus 1, for 60 minutes starting at 5:30 am on 07-21-2015 at 15 cents. The response indicates that the DR schedule was successful.
If the user is accessing web service with proper session/authenticated token:
POST https://192.80.3.2/ems/api/org/dr/scheduledr
Sample Response¶
{
"pricelevel": "LOW",
"duration": "60",
"starttime": "2015-07-21T12:15:49+05:30",
"dridentifier": "DR16",
"pricing": "15.0"
}
{
"status": "0",
"msg": "DR Scheduled successful"
}