APIs in Category: clock | 7-Mode API version 1.21

clock-get-clock clock-get-timezone clock-set-clock clock-set-timezone | These APIs allow for manipulation of timezone and date on the filer. Timezone and date can be set on the filer as well as we can get the current date, timezone and compliance clock time on the filer.

NetApp Manage ONTAP

clock-get-clock | [top]

> gets current date and time from filer.

> Input Name | Range | Type | Description
> is-compliance-clock |  | boolean optional | If true, then local-time and utc-time are values for the compliance clock, otherwise they are values for the local clock. Default is false. Note: This field is deprecated in Data ONTAP 8.1 and later. If true, the operation will fail with error EOPNOTSUPPORTED. Clients should use the API snaplock-get-system-compliance-clock or snaplock-get-volume-compliance-clock as applicable to get the compliance clock time.
> Output Name | Range | Type | Description
> local-time | [-43200..2^31-1] | integer | Local date and time of the filer in seconds since Midnight, 1/1/1970. Depending on the time zone and clock settings, this might be negative by up to 12 hours.
> utc-time | [0..2^31-1] | integer | Current date and time of the filer in seconds since Midnight, 1/1/1970.

> Errno | Description
> EINTERNALERROR |  |
> EOPNOTSUPPORTED |  |

clock-get-timezone | [top]

> Gets current timezone and timezone file version.

> Output Name | Range | Type | Description
> timezone |  | string | Current timezone name where the storage system is operating. A timezone can have one of the two formats: "Using a location string specified in Arthur David Olsen's public domain time zone database. For example, "Americas/New_York" represents most of the Eastern Time Zone."; "A traditional time zone abbreviation incorporating default rules for daylight savings time. For example, "EST5EDT" for the US Eastern Time Zone.";
> timezone-UTC |  | string | Current timezone of the storage system in UTC +/-hhmm format. This indicates that the local time zone is hh hours and mm minutes ahead or behind UTC. For example, Central European Time(CET) is +0100 and U.S./Canadian Eastern Standard Time(EST) is -0500.
> timezone-version |  | string | Version of the time zone database. "YYYY" is the year the data base was released and "v" is the version within that year. "YYYY" will be four decimal digits and "v" will be an ASCII letter starting with "a" and increasing with each version. For example, the second 2007 version is "2007b".

> Errno | Description
> ENOTIMEZONESET |  |
> ENOTIMEZONEVERSION |  |

clock-set-clock | [top]

> Set current date and time to the specified date and time.

> Input Name | Range | Type | Description
> is-utc-clock |  | boolean | If this is true, then clock is given in UTC (universal time) instead of local time.
> time | [-43200..2^31-1] | integer | Actual value of the date and time which has to be set as the current date and time on filer. Value will be seconds since Midnight, 1/1/1970. Depending on the time zone and clock settings, this might be negative by up to 12 hours.

> Errno | Description
> EINVALIDINPUTERROR |  |
> EINTERNALERROR |  |
> ETAKENOVER |  |
> EDATENOTSETONPARTNER |  |

clock-set-timezone | [top]

> Set current timezone to the specified timezone.

> Input Name | Range | Type | Description
> timezone |  | string | Name of the timezone value which has to be set as current timezone value. A timezone can have one of the two formats: "Using a location string specified in Arthur David Olsen's public domain time zone database. For example, "Americas/New_York" represents most of the Eastern Time Zone."; "A traditional time zone abbreviation incorporating default rules for daylight savings time. For example, "EST5EDT" for the US Eastern Time Zone.";

> Errno | Description
> EINVALIDTIMEZONE |  |
> EINTERNALERROR |  |
> ETIMEZONEDIFFERENTINRC |  |