An indicator for locating one or multiple assets with matching property. The indicator can be hostname, ip address or mac address.
JSON representation
{"namespace": string,"is_any_namespace": boolean,"filter_namespace": boolean,// Union field indicator can be only one of the following:"hostname": string,"asset_ip_address": string,"mac": string,"product_id": string// End of list of possible types for union field indicator.}
Fields
namespace
string
The namespace of this asset indicator belongs to. If 'is_any_namespace' is set to true, this field will be ignored.
is_any_namespace
boolean
False when 'namespace' refers to a valid namespace name related to the asset (both empty and non empty strings are valid namespace name values). True when the asset refers to one or more assets with the given 'indicator' across all namespaces.
filter_namespace
boolean
This field provides clients the option to enable namespace search or not. By default, this field is false and namespace will be ignored.
Union field indicator. An identifier representing an asset. indicator can be only one of the following:
hostname
string
Hostname of a device or machine.
asset_ip_address
string
IP address of a device or machine.
mac
string
Mac address of a device or machine.
product_id
string
The 'product_id' field includes a a product ID type and product ID value, e.g. "CS:1234-5678".
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-14 UTC."],[[["\u003cp\u003eThe JSON representation defines an asset indicator with fields for namespace, and a union field called \u003ccode\u003eindicator\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003enamespace\u003c/code\u003e field specifies the asset's namespace, which is ignored if \u003ccode\u003eis_any_namespace\u003c/code\u003e is true.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eis_any_namespace\u003c/code\u003e indicates whether the asset refers to one or multiple assets across all namespaces.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003efilter_namespace\u003c/code\u003e field allows clients to enable or disable namespace searching, and it defaults to being disabled.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eindicator\u003c/code\u003e union field can represent an asset by its \u003ccode\u003ehostname\u003c/code\u003e, \u003ccode\u003easset_ip_address\u003c/code\u003e, \u003ccode\u003emac\u003c/code\u003e, or \u003ccode\u003eproduct_id\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,[]]