HostDateTimeInfo

HostDateTimeInfo
HostDateTimeInfo

This data object represents the dateTime configuration of the host.

AllOf
This class requires all of the following:
JSON Example
{
    "_typeName": "string",
    "timeZone": {
        "_typeName": "string",
        "key": "string",
        "name": "string",
        "description": "string",
        "gmtOffset": 0
    },
    "systemClockProtocol": "string",
    "ntpConfig": {
        "_typeName": "string",
        "server": [
            "string"
        ],
        "configFile": [
            "string"
        ]
    },
    "ptpConfig": {
        "_typeName": "string",
        "domain": 0,
        "port": [
            {
                "_typeName": "string",
                "index": 0,
                "deviceType": "string",
                "device": "string",
                "ipConfig": {
                    "_typeName": "string",
                    "dhcp": false,
                    "ipAddress": "string",
                    "subnetMask": "string",
                    "ipV6Config": {
                        "_typeName": "string",
                        "ipV6Address": [
                            {
                                "_typeName": "string",
                                "ipAddress": "string",
                                "prefixLength": 0,
                                "origin": "string",
                                "dadState": "string",
                                "lifetime": "string",
                                "operation": "string"
                            }
                        ],
                        "autoConfigurationEnabled": false,
                        "dhcpV6Enabled": false
                    }
                }
            }
        ]
    },
    "enabled": false,
    "disableEvents": false,
    "disableFallback": false,
    "inFallbackState": false,
    "serviceSync": false,
    "lastSyncTime": "string",
    "remoteNtpServer": "string",
    "ntpRunTime": 0,
    "ptpRunTime": 0,
    "ntpDuration": "string",
    "ptpDuration": "string"
}
timeZone
Required

The time zone of the host.

string
systemClockProtocol
Optional

The system clock synchronization protocol.

See HostDateTimeInfoProtocolEnum for possible values.

ntpConfig
Optional

Configuration information for the NTP (Network Time Protocol) service.

ptpConfig
Optional

Configuration information for the host PTP (Precision Time Protocol) service.

Since: vSphere API Release 7.0.3.0

boolean
enabled
Optional

Present state of the time services subsystem.

Since: vSphere API Release 7.0.3.0

boolean
disableEvents
Optional

When not disabled Network Time service or Precision Time service will send events to Virtual Center when service fails or recovers.

Since: vSphere API Release 7.0.3.0

boolean
disableFallback
Optional

When not disabled, if PrecisionTimeSync is configured, then the NTP configuration can run as backup.

Since: vSphere API Release 7.0.3.0

boolean
inFallbackState
Optional

Tracks if NTP is providing time to ESXi due to PTP service failure.

This is set only if disableFallback is set to false.

Since: vSphere API Release 7.0.3.0

boolean
serviceSync
Optional

Report true if time is synchronized with remote time source For PrecisionTimeSync this is obtained from PTP Port Status value.

For NetworkTimeProtocol this obtained from Leap Indicator value.

Since: vSphere API Release 7.0.3.0

string As date-time As date-time
lastSyncTime
Optional

Timestamp when time services were last in sync with remote clock.

If not set, time services have never established synchronization.

Since: vSphere API Release 7.0.3.0

string
remoteNtpServer
Optional

Provides the NTP server that the host is synced with from the set of servers configured.

Since: vSphere API Release 7.0.3.0

integer As int64 As int64
ntpRunTime
Optional

Provides the total seconds ntpd process has been running for.

Since: vSphere API Release 7.0.3.0

integer As int64 As int64
ptpRunTime
Optional

Provides the total seconds ptpd process has been running for.

Since: vSphere API Release 7.0.3.0

string
ntpDuration
Optional

Provides a duration in simplified, human-readable form for the lifetime of the ntp service.

Since: vSphere API Release 7.0.3.0

string
ptpDuration
Optional

Provides a duration in simplified, human-readable form for the lifetime of the ptp service.

Since: vSphere API Release 7.0.3.0