Print Email PDF

Shutdown a Qumulo Cluster using the API with Curl


Outlines how to shutdown a cluster using the Qumulo API with curl


  • A computer with the curl and jq commands installed
  • Admin privileges to your Qumulo cluster

For monitoring system-based automatic shutdown, please refer to the documentation of your monitoring system on triggering script execution for specific events or alerts. 


Triggering a safe shutdown of a Qumulo cluster with automation or bash scripting is possible using the Qumulo API. We hope you never experience an HVAC failure in your data center or any other reason you may need to safely shut down your cluster due to an emergency. Should the need arise, this article will show you how you can use curl or a bash script to do so. Most modern network monitoring systems can handle event triggers or can execute a script based or shell commands based on alert criteria.

You can use the sample bash script below with your monitoring system to perform an emergency shutdown. It is important to know that shutting down a cluster while clients are writing to it may lead to the loss or corruption of data. Whenever possible, stop all client write activity before shutting down your cluster.

  • First, you will need a bearer token to place further API calls at the Bash prompt or in your script, for example:
TOKEN=$(curl -k -X "POST" "" 
-H "content: {}" -H "Content-Type: application/json; charset=utf-8" -s -S -d $'
{"username": "admin","password": "my_admin_password"}'| jq .bearer_token -r)
  • Send the command to shutdown the cluster safely with the token that was just generated, for example:
PROMPT$ curl -k -X "GET" "" \n -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json"
  • You can shut down the cluster with a single command, for example:
curl -k -X "POST" "" -H "Authorization: 
Bearer $(curl -k -X "POST" "" -H "content: {}" -H
"Content-Type: application/json; charset=utf-8" -s -S -d $'{"username": "admin","password":
"my_admin_password"}'| jq .bearer_token| sed 's/\"//g')" -H "Content-Type: application/json"

Note: You can also use the sample bash script "" to achieve the same goal or as a starting point to customize the script for your needs.


You should now be able to successfully shutdown a Qumulo Cluster using API commands with curl


QQ CLI: Comprehensive List of Commands

Ubuntu jq man page

Unbuntu curl man page


Like what you see? Share this article with your network!


Was this article helpful?
0 out of 0 found this helpful


1 comment

  • The curl 'GET' command after retrieving the token via the 2-step method should be

    The original curl 'GET' request,, would retrieve the node status.


Please sign in to leave a comment.

Have more questions?
Open a Case
Share it, if you like it.