Skip to main content

1E SDK

Nomad.RunSsdQuery

Method

RunSsdQuery

Module

Nomad

Library

1E

Action

Use Nomad's SSD (single site download) feature to find on which devices the specified content is cached.

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.

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

Extent (int): Whether to search the entire site (0) or just the local subnet (1).

MaxDevices (int): The maximum number of devices to return. The range is 1 to 50.

AllSubnets (bool): Whether to return results with a good distribution of subnets (true) or allow it does not matter if the devices are clustered in a few subnets or even just one (false).

Return values

For each suitable device (and there may be none):

Fqdn (string): The fully qualified domain name of the device.

Ipv4 (string): The IPv4 address of the device.

Ipv4Subnet (string): The IPv4 subnet of the device.

Example

Find up to 10 devices that have at least 50% of (ConfigMgr) content "Content_7f368e5f-4dbe-4027-ba81-c5463e372a0c" version 1, neither compressed nor encrypted. Try to return devices from a number of subnets.

Nomad.RunSsdQuery(ContentId : "Content_7f368e5f-4dbe-4027-ba81-c5463e372a0c", Version : 1, Format : 0, Percent : 50.0, Extent: 0, MaxDevices : 10, AllSubnets : true);

Platforms

  • Windows

Notes

Nomad SSD must be enabled of course.

IPv6 addresses are not supported.