Contents

Nomad.RunPkgStatusRequest

Method

RunPkgStatusRequest

ModuleNomad
Library1E
Action

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? 
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

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.