Az Azure Monitor REST API szűrőszintaxisa
Számos Azure Monitor API olyan paramétert használ, {filter-expression}
amellyel szűrheti vagy korlátozhatja az összegyűjtött adatok készletét.
A(z) "*" szűrő használata több erőforrás kérésében
Fontos
A *
több erőforrásra vonatkozó szűrő nem helyettesítő karakter. Ez egy literális sztring, amely több erőforrás lekérésére szolgál. A *
használatával több erőforrást is lekérhet egyetlen idősorban.
Az alábbi $filter=Microsoft.ResourceId eq '*'
mintában arra utasítja az API-t, hogy adjon vissza egy külön idősort virtuálisgép-erőforrásonként az előfizetésben és a régióban. A szűrő nélkül az API egyetlen idősort ad vissza, amely az összes virtuális gép átlagos processzorhasználatát összesítené. Az egyes erőforrások idősorát a Microsoft.ResourceId metaadat-értéke különbözteti meg az egyes idősor-bejegyzésekben.
Ha használ $filter=Microsoft.ResourceId eq '*'
, és nincsenek erőforrások, ebben az esetben a megadott idősor virtuális gépei, a rendszer az üres idősorokat timeseries:[]
adja vissza, mivel nincsenek eredmények a kért dimenziókészlethez, amely tartalmazza ResourceId
Ugyanaz a szűrő nélküli lekérdezés egyetlen idősort ad vissza, amely az összes virtuális gép összesített átlagos CPU-értékét adja vissza, 0
mivel ez az összeg az összes kért dimenzióban.
GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.Insights/metrics?timespan=2023-06-25T22:20:00.000Z/2023-06-26T22:25:00.000Z&interval=PT5M&metricnames=Percentage CPU&aggregation=average&api-version=2021-05-01®ion=eastus&metricNamespace=microsoft.compute/virtualmachines&$filter=Microsoft.ResourceId eq '*'
Példa a következő használatával: $filter
Íme a lehetséges kifejezési sztringek, amelyeket átadhat a következőként {filter-expression}
: . Más szintaxis nem engedélyezett.
Erőforráscsoport eseményeinek listázása
$filter=eventTimestamp ge <Start Time> and eventTimestamp le <End Time> and eventChannels eq 'Admin, Operation' and resourceGroupName eq '<ResourceGroupName>'
Példa:
$filter=eventTimestamp ge 2014-12-29T22:00:37Z and eventTimestamp le 2014-12-29T23:36:37Z and eventChannels eq 'Rendszergazda, Operation' és resourceGroupName eq 'CloudLab'
Erőforrás eseményeinek listázása
$filter=eventTimestamp ge <Start Time> and eventTimestamp le <End Time> and eventChannels eq 'Admin, Operation' and resourceUri eq '<ResourceURI>'
Példa:
$filter=eventTimestamp ge 2014-12-29T22:00:37Z and eventTimestamp le 2014-12-29T23:36:37Z and eventChannels eq 'Rendszergazda, Művelet" és resourceUri eq '/subscriptions/089bd33f-d4ec-47fe-8ba5-0753aa5c5b33/resourcegroups/CloudLab/providers/Microsoft.Web/sites/mytestweb004'
Azure-előfizetés eseményeinek listázása
$filter=eventTimestamp ge <Start Time> and eventTimestamp le <End Time> and eventChannels eq 'Admin, Operation'
Példa:
$filter=eventTimestamp ge 2014-12-29T22:00:37Z and eventTimestamp le 2014-12-29T23:36:37Z and eventChannels eq 'Rendszergazda, Operation'
Azure-erőforrás-szolgáltató eseményeinek listázása
$filter=eventTimestamp ge <Start Time> and eventTimestamp le <End Time> and eventChannels eq 'Admin, Operation' and resourceProvider eq '<ResourceProviderName>'
Példa:
$filter=eventTimestamp ge 2014-12-29T22:00:37Z and eventTimestamp le 2014-12-29T23:36:37Z and eventChannels eq 'Rendszergazda, Operation' és resourceProvider eq 'Microsoft.Web'
Korrelációs azonosító eseményeinek listázása
api-version=2014-04-01&$filter=eventTimestamp ge 2014-07-16T04:36:37.6407898Z and eventTimestamp le 2014-07-20T04:36:37.6407898Z and eventChannels eq 'Admin, Operation' and correlationId eq '<CorrelationID>'
Példa: api-version=2014-04-01&$filter=eventTimestamp ge 2014-12-29T22:00:37Z és eventTimestamp le 2014-12-29T23:36:37Z és eventChannels eq 'Rendszergazda, Művelet" és correlationId eq '07c85493-5e87-4efd-9200-0c64d904d878'