Skip to main content

Cloud

The cloud component is called Cloud. It handles cloud services of a device. It supports the following methods:

Cloud.GetStatus#

This method returns the status of the component instance.

Request#

This method takes no parameters.

http://192.168.33.1/rpc/Cloud.GetStatus

Response#

Attributes in the result:

  • connected: boolean, true if the device is connected to the Shelly cloud, false otherwise
{
"connected": false
}

Cloud.GetConfig#

This method returns the configuration of the component instance.

Request#

This method takes no parameters.

http://192.168.33.1/rpc/Cloud.GetConfig

Response#

Attributes in the result:

  • enable: boolean, true if cloud connection is enabled, false otherwise
  • server: string or null, name of the server to which the device is connected
{
"enable": false,
"server": "iot.shelly.cloud:6012/jrpc"
}

Cloud.SetConfig#

This method makes changes in the configuration of the component instance.

Request#

Parameters:

  • config: JSON object, configuration to be applied. This object should be identical in structure to the JSON returned by Cloud.GetConfig, containing only the keys that need to be modified. Required
Enable cloud connection for this device.
curl -X POST -d '{"id":1, "src":"user_1", "method":"Cloud.SetConfig",
"params":{"config":{"enable":true}}}' http://${SHELLY}/rpc

Response#

Attributes in the result:

  • restart_required: boolean, true if restart is required to apply the changes, false otherwise
{
"id": 1,
"src": "shellypro4pm-f008d1d8b8b8",
"dst": "user_1",
"result": {
"restart_required": false
}
}