PowerChute Network Shutdown REST API

Issue:

1. Want PowerChute Network Shutdown to trigger OS shutdown using a remote command.
2. Want to test the PowerChute configuration to verify the OS shuts down correctly.

Product:

PowerChute Network Shutdown

Environment:

All supported Operating Systems

Cause:

Informational

Solution:

PowerChute Network Shutdown offers a REST API. The REST API is used to command the operating system to shut down without requiring APC UPS intervention.

On a Windows system, open a command prompt as an administrator, or on a Linux system, open a terminal window as root and enter the command:

curl --user PowerChute Username:PowerChute Password -k -X POST "https://PowerChute System Hostname or IP address:6547/REST/remoteShutdown?source=test&reason=shutdownTest&active=true"

Replace PowerChute username:PowerChute Password with the username and password assigned when PowerChute was installed. Also, replace the PowerChute System Hostname or IP address with the host's FQDN or system IP address.

Example: curl --user PCNStester:Schneider1234! -k -X POST "https://192.168.0.100:6547/REST/remoteShutdown?source=test&reason=shutdownTest&active=true"

NOTE 1: Starting with Windows 10 version 1803 or later, curl.exe is included. You may need to install curl on your Linux system.

NOTE 2: Running the API will simulate how PowerChute responds during a power event that requires an operating system shutdown. When executed, the API will initiate the OS shutdown.

NOTE 3: If PowerChute is configured to send a shutdown signal to the UPS or outlet group, the command will be sent, causing the UPS or outlet group to power off after the set delay.

Udgivet til: Schneider Electric Danmark