v5

latestSwagger 2.0raw.githubusercontent.com2022-02-252573110.3 KB
Machines

Returns a collection of machines matching the specified conditions. The returned collection represents either machines that are active/live during the specified interval of time (live=true and startTime/endTime are specified) or that are known to have existed at or some time prior to the specified point in time (live=false and timestamp is specified).

get/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines

Path parameters

subscriptionIdstring required

Azure subscription identifier.

resourceGroupNamestring required

Resource group name within the specified subscriptionId.

workspaceNamestring required

OMS workspace containing the resources of interest.

Query parameters

api-versionstring required

API version.

liveboolean

Specifies whether to return live resources (true) or inventory resources (false). Defaults to true. When retrieving live resources, the start time (startTime) and end time (endTime) of the desired interval should be included. When retrieving inventory resources, an optional timestamp (timestamp) parameter can be specified to return the version of each resource closest (not-after) that timestamp.

startTimestring date-time

UTC date and time specifying the start time of an interval. When not specified the service uses DateTime.UtcNow - 10m

endTimestring date-time

UTC date and time specifying the end time of an interval. When not specified the service uses DateTime.UtcNow

timestampstring date-time

UTC date and time specifying a time instance relative to which to evaluate each machine resource. Only applies when live=false. When not specified, the service uses DateTime.UtcNow.

$topinteger

Page size to use. When not specified, the default page size is 100 records.

Response

The operation completed successfully.

nextLinkstring

The URL to the next set of resources.

All 25 operations