The QueryBasedDashboardParameter datatype includes various settings.

Table: QueryBasedDashboardParameter

ParameterTypeRequired[a]DefaultDescription
queryStringstringyes The LogScale query executed to find suggestions for the parameter value.
timeWindowstringyes The time window (relative to now) in which LogScale will search for suggestions (e.g., 24h or 30d).
optionValueFieldstringyes The field in the result set used as the value of the suggestions.
optionLabelFieldstringyes The field in the result set used as the label (the text in the dropdown) of the suggestions.
useDashboardTimeIfSetbooleanyes If true, the parameters search time window will automatically change to match the dashboard's global time when active.
idstringyes The unique identifier of the parameter.
labelstringyes The label or 'name' displayed next to the input for the variable to make it more human-readable.
orderstring  A number that determines the order in which parameters are displayed on a dashboard. If null, the parameter is ordered after other parameters in alphanumerical order.

[a] Some arguments may be required, as indicated in this column. For some fields, this column indicates that a result will always be returned for it.