Get service map status
Return ServiceMap collection status for one or more hosts, or a bounded fleet sample.
Restrictions
Usage
- ServiceMap is an optional subsystem: a deployment without
redis.servicemapconfigured returnsServiceUnavailable. - Exactly one selection mode is used per call: explicit
host_id/host_ids, orfleet=true; combiningfleet=truewith either host field is rejected. - Unlike
POST /monit/servicemap/topologyandPOST /monit/servicemap/summary, an unresolvable host does not fail the whole request — it is reported per item viaitems[].error_code. limit(default 100, max 200) bounds the number of explicit hosts accepted, and infleetmode, the number of candidate hosts sampled.
Authorizations
App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
Selects which hosts to fetch collection status for: explicit host IDs, or a bounded fleet sample.
A single host ID to check. Combine with host_ids to check several; mutually exclusive with fleet=true.
128^host_[a-z0-9_-]+$Multiple host IDs to check in one call, up to 200 combined with host_id. Mutually exclusive with fleet=true.
When true, ignore host_id/host_ids and instead sample up to limit fleet candidate hosts for the account. Default false.
In fleet mode, the number of candidate hosts to sample. Ignored otherwise. Default 100, range 1-200.
1 <= x <= 200Response
Success
Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.