Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Method

Anchor
RunPkgStatusRequest
RunPkgStatusRequest
RunPkgStatusRequest

ModuleNomad
Library1E
Action

Excerpt
Test whether any other SSD (single site download) device has more content than the local Nomad cache.

Parameters

ContentId (string): The ID of the content to query.

Version (int): The version of the content to query.

Format (int; optional, default 0): How the content is stored in the cache. 0 = original Nomad format (neither compressed nor encrypted), 1 = compressed, 2 = compressed and encrypted.

DeviceIdType (string): What the following DeviceId parameter represents. Either "FQDN" (DeviceId is a fully qualified domain name) or "IPv4" (DeviceId is an IPv4 address). Case is not significant. IPv6 addresses are not supported.

DeviceId (string): Either the FQDN or the IPv4 address (see DeviceIdType) of the SSD site master.

Percent (float): The minimum desired percentage of content in the cache.

Return valuesPercent (float): If there is more content on any other SSD device, the percentage which is available through SSD, which will be greater than the input Percent value. if no SSD device has a greater percentage than that specified, the same value as in the input Percent is returned. The input Percent value is also returned on error, e.g. if the DeviceId parameter is an unknown device.
Example
Does an SSD device have more than 50% of (ConfigMgr) content "Content_7f368e5f-4dbe-4027-ba81-c5463e372a0c" at version 1, neither compressed nor encrypted, using BIGNOMADCACHESERVER.ACME.LOCAL as the SSD site master?

 

Code Block
Nomad.RunPkgStatusRequest(ContentId : "Content_7f368e5f-4dbe-4027-ba81-c5463e372a0c", Version : 1, Format : 0, DeviceIdType : "FQDN", DeviceId : "BIGNOMADCACHESERVER.ACME.LOCAL", Percent : 50.0

If the returned Percent is greater than 50.0 then an SSD device does have more content than is in the local cache.

Platforms
  • Windows
Notes

Requires Nomad v6.3.200 or later.

Available from Tachyon v3.2.

Please contact the Nomad team for more information about the Nomad COM API to which this method is a wrapper.

This method is unusual in that the parameters do not match the internal Nomad provider API. DeviceIdType and DeviceId are replaced there by PeerFqdn and PeerIpv4 strings, matching the Nomad COM API.