Set system clock
Update the timezone, and system clock, using either separate date/time values or posixTime, which is the number of seconds since the 1st January 1970.
Any updates to date, time or timezone may cause momentary issues with accessing the system, as certificates may become outdated, or not yet valid. Access should recover within a short time, but it may not be possible to issue more REST API requests straight after changing the system clock.
Note: It is not possible to change both the timezone and the date/time in the same request. If both need to be changed, two separate requests must be made.
HTTP request syntax (URI)
PATCH <base_URI>/v8/storage/file-devices/system-clock
Parameters
| Name | Type | Required | Values | Description |
| fileOnly | BODY | N | boolean | Whether to update only the file component of a Unified system. Default is False. |
| posixTime | BODY | N | integer | Number of seconds since 1st January 1970. If supplied, will be used in preference of any supplied date and time parameters. |
| timezone | BODY | N | string | Timezone – details of acceptable timezones can be retrieved using the Get timezones API call. |
| date | BODY | N | string | Date of the form YYYY-MM-DD |
| time | BODY | N | string | Time of the form HH:MM:SS |
Return codes
| Code | Data | Description |
| 204 | No Data | System clock successfully updated. |
| 400 | Error Message | Missing or invalid request contents. |
| 403 | Error Message | Operation forbidden by access level. |
| 500 | Error message | Error associated with the storage system. |
Any HTTP status code other than 204 indicates that the API did not complete successfully.
Request example: Set the date and time
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/file-devices/system-clock -X PATCH -d '{"date":"2022-08-01", "time":"11:57:00"}'
Response example
HTTP/1.1 204 No Content
Request example: Set the timezone
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/file-devices/system-clock -X PATCH -d '{"timezone":"Europe/Andorra"}'
Response example
HTTP/1.1 204 No Content