APIs in Category: Timezone
 API version 5.0

 
TimezoneGetDefaults
TimezoneListInfoIterEnd
TimezoneListInfoIterNext
TimezoneListInfoIterStart
TimezoneValidate
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 API version 5.0
 
TimezoneGetDefaults (supported) [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.
Input Name Type
TimezoneGetDefaults TimezoneGetDefaults
 
Output Name Type
TimezoneGetDefaultsResult TimezoneGetDefaultsResult

 
TimezoneListInfoIterEnd (supported) [top]
Ends iteration To list time zones.
Input Name Type
TimezoneListInfoIterEnd TimezoneListInfoIterEnd
 
Output Name Type
TimezoneListInfoIterEndResult TimezoneListInfoIterEndResult
 Error Name  Description
 EINVALIDTAG

 
TimezoneListInfoIterNext (supported) [top]
Get the next few Records in the iteration started by TimezoneListInfoIterStart.
Input Name Type
TimezoneListInfoIterNext TimezoneListInfoIterNext
 
Output Name Type
TimezoneListInfoIterNextResult TimezoneListInfoIterNextResult
 Error Name  Description
 EINVALIDTAG

 
TimezoneListInfoIterStart (supported) [top]
Starts iteration To list time zones From the internal database of time zone information.
Input Name Type
TimezoneListInfoIterStart TimezoneListInfoIterStart
 
Output Name Type
TimezoneListInfoIterStartResult TimezoneListInfoIterStartResult

 
TimezoneValidate (supported) [top]
Determines if a time zone specification is valid. The specification may be the Name of Timezone returned From TimezoneListInfoIterNext(), or can be a POSIX-style time zone specification.
Input Name Type
TimezoneValidate TimezoneValidate
 
Output Name Type
TimezoneValidateResult TimezoneValidateResult
 Error Name  Description
 EINVALIDTIMEZONE

 
Element definition: TimezoneGetDefaults [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.
[none]

 
Element definition: TimezoneGetDefaultsResult [top]
Name Type Description
TimezoneDefaults TimezoneDefaults
The default time zone settings.

 
Element definition: TimezoneListInfoIterEnd [top]
Ends iteration To list time zones.
Name Type Description
Tag xsd:string
Tag From a previous TimezoneListInfoIterStart.

 
Element definition: TimezoneListInfoIterEndResult [top]
[none]

 
Element definition: TimezoneListInfoIterNext [top]
Get the next few Records in the iteration started by TimezoneListInfoIterStart.
Name Type Description
Maximum xsd:integer
The Maximum number of entries To retrieve.
Tag xsd:string
Tag From a previous TimezoneListInfoIterStart.

 
Element definition: TimezoneListInfoIterNextResult [top]
Name Type Description
Records xsd:integer
The number of Records actually returned.
Timezones ArrayOfTimezoneInfo
List of time zones From the built-in zoneinfo database.

 
Element definition: TimezoneListInfoIterStart [top]
Starts iteration To list time zones From the internal database of time zone information.
[none]

 
Element definition: TimezoneListInfoIterStartResult [top]
Name Type Description
Records xsd:integer
Number which tells you how many items have been saved for future retrieval with TimezoneListInfoIterNext.
Tag xsd:string
Tag To be used in subsequent calls To TimezoneListInfoIterNext.

 
Element definition: TimezoneValidate [top]
Determines if a time zone specification is valid. The specification may be the Name of Timezone returned From TimezoneListInfoIterNext(), or can be a POSIX-style time zone specification.
Name Type Description
Timezone xsd:string
Proposed time zone string.

 
Element definition: TimezoneValidateResult [top]
Name Type Description
UtcOffset xsd: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.

 
Element definition: ArrayOfTimezoneInfo [top]
Name Type Description
TimezoneInfo TimezoneInfo[]

 
Element definition: TimezoneDefaults [top]
The default time zone settings.
Name Type Description
DefaultTimezone xsd: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.
ServerTimezoneDescription xsd:string
Description of the time zone in which this DFM server is located. If the "DefaultTimezone" 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: TimezoneInfo [top]
Information about a time zone.
Name Type Description
TimezoneName xsd:string
Name of time zone.