uip insights filter-machines

Syntax and options for `uip insights filter-machines`, which discovers machines with recent Insights activity for use with --machine-name filters.

uip insights filter-machines discovers machines that have had Insights activity recently, across the current tenant. Use it to find the --machine-name values that jobs accepts.

注:

"Recent" is a fixed 30-day window set by the backend — it cannot be changed with a flag. This route is also feature-gated to Cloud and Dedicated SaaS deployments; on other deployment types the command fails with a ConfigError rather than an empty result.

概要

uip insights filter-machines list [-l <n>] [-o <n>]

This verb honors the global options and the standard exit codes. It does not accept -t, --tenant — it uses the tenant selected during uip login.

uip insights filter-machines list

List machines with Insights activity in the backend's fixed 30-day window, across the current tenant (unlike filter-folders and filter-processes, this isn't restricted to folders the caller can access).

オプション

フラグ	説明
-l, --limit <number>	Maximum rows to return. Defaults to 50.
-o, --offset <number>	Rows to skip before returning results.

Rows are deduplicated and sorted after fetching. Pagination is client-side, over the full unpaginated backend response.

例

uip insights filter-machines list

データシェイプ

{
  "Code": "InsightsFilterMachinesList",
  "Data": [
    {
      "machineName": "prod-worker-01",
      "machineKey": "m0m0m0m0-0000-0000-0000-000000000001"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}

An empty Data array means no matching activity in the 30-day window — it is not proof the machine doesn't exist.

関連

• jobs — accepts --machine-name values discovered here.
• filter-folders, filter-processes, filter-queues — sibling discovery commands.

参照

• Insights overview