Switching an Outlet On or Off

Use the Cloud API to control a connected Synaccess PDU's state.

PDUs require internet connection and basic setup before you can use the API for outlet control. Use this guide to get setup if you haven't already.

Utilize the following REST API endpoint to modify outlet state.

Update An Outlet .

You will need to know ahead of time, the unique outlet ID. You can identify this on the cloud.synaccess.com web interface, or by using the GET /api/v1/outlets endpoint.

Options for state are: "ON", "OFF", "REBOOT".

Example Request

cURL

curl --request PUT \
     --url https://api.synaccess.com/api/v1/outlet/1-98756323 \
     --data '{ "state":"ON" }'
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json'

Example Output

JSON

{
  "id": "1-286331153",
  "outletName": "Nas Server 1",
  "pwrOnState": "OFF",
  "outletIndex": 1,
  "receptacle": "IEC 60320 C19",
  "currentRms": 1.1,
  "state": "ON",
  "bankId": "286331153",
  "customRebootTimeEnabled": false,
  "customRebootTime": 12,
  "voltageDetection": true,
  "relayHealth": "OK"
}