APIs in Category: timezone | API version 3.8

timezone-get-defaults timezone-list-info-iter-end timezone-list-info-iter-next timezone-list-info-iter-start timezone-validate | The DataFabric Manager server allows administrators to specify the time zone where portions of datasets are physically located. This allows the internal scheduling processes to adjust backup times appropriately for storage in different locations. The time zone specifications here are the same as in Data ONTAP. Timezone specifications can be in one of several formats: Using a location string specified in Arthur David Olsen's public domain time zone database. This format identifies locations by continent or ocean and then by the name of the location, which is typically the largest city within the region. For example, "America/New_York" represents most of the eastern time zone; "America/Phoenix" represents most of Arizona, which uses mountain time without daylight savings time. A traditional time zone abbreviation incorporating default rules for daylight savings time. For example, "EST5EDT" for the US eastern zone, or "PST8PDT" for the pacific zone, or "GMT-2" for two hours east of GMT. A full POSIX time zone specification, specifying names for the standard and daylight times, and the rules for switching between them. For example, Brian's Time might be "BST8BDT,M4.1.0,M10.5.0". This family of APIs provides interfaces for listing the time zones in the server's database, and for validating that a user-supplied time zone specification is valid. Note that there are many ways of forming a valid time zone specification, so the output of the timezone-list-info iterators is not a complete list of valid time zones.

NetApp Manage ONTAP

timezone-get-defaults | [top]

> Retrieves the default time zone settings, including the time zone in which the server runs and the time zone to use for objects that don't specify their own time zone.

> Output Name | Range | Type | Description
> timezone-defaults |  | timezone-defaults | The default time zone settings.

timezone-list-info-iter-end | [top]

> Ends iteration to list time zones.

> Input Name | Range | Type | Description
> tag |  | string | Tag from a previous timezone-list-info-iter-start.

> Errno | Description
> EINVALIDTAG |  |

timezone-list-info-iter-next | [top]

> Get the next few records in the iteration started by timezone-list-info-iter-start.

> Input Name | Range | Type | Description
> maximum |  | integer | The maximum number of entries to retrieve.
> tag |  | string | Tag from a previous timezone-list-info-iter-start.
> Output Name | Range | Type | Description
> records |  | integer | The number of records actually returned.
> timezones |  | timezone-info[] | List of time zones from the built-in zoneinfo database.

> Errno | Description
> EINVALIDTAG |  |

timezone-list-info-iter-start | [top]

> Starts iteration to list time zones from the internal database of time zone information.

> Output Name | Range | Type | Description
> records |  | integer | Number which tells you how many items have been saved for future retrieval with timezone-list-info-iter-next.
> tag |  | string | Tag to be used in subsequent calls to timezone-list-info-iter-next.

timezone-validate | [top]

> Determines if a time zone specification is valid. The specification may be the name of timezone returned from timezone-list-info-iter-next(), or can be a POSIX-style time zone specification.

> Input Name | Range | Type | Description
> timezone |  | string | Proposed time zone string.
> Output Name | Range | Type | Description
> utc-offset |  | integer | Current offset, in seconds, between this time zone and UTC. Range: -43200 to 50400. Negative values are west of UTC; positive values are east of UTC.

> Errno | Description
> EINVALIDTIMEZONE |  |

Element definition: timezone-defaults | [top]

> The default time zone settings.

> Name | Range | Type | Description
> default-timezone |  | string | Name of the time zone to use for objects that do not specify a time zone. This may be empty, meaning that objects use the server's time zone by default. Set this value with the "dfm option set timezone={new-value}" command.
> server-timezone-description |  | string | Description of the time zone in which this DFM server is located. If the "default-timezone" is empty, objects without an explicit time zone setting will use the server's time zone. Example values: "Pacific Standard Time (GMT -8:00)" "US/Eastern (GMT -4:00)" "SGT (GMT +6:00)" "UTC (GMT +0:00)"

Element definition: timezone-info | [top]

> Information about a time zone.

> Name | Range | Type | Description
> timezone-name |  | string | Name of time zone.