Azure Monitor REST API szűrő szintaxisa

Számos Azure Monitor API egy paramétert {filter-expression}használ, amellyel szűrheti vagy korlátozhatja az összegyűjtött adatkészletet.

A "*" szűrő használata több erőforrás kérésében

Fontos

A * több erőforrás szűrője nem helyettesítő karakter. Ez egy konstans sztring, amely több erőforrás kérésére szolgál. A * több erőforrás kérésére használható egyetlen idősorban.

Az alábbi $filter=Microsoft.ResourceId eq '*' mintában az API arra utasítja, hogy az előfizetés és a régió virtuálisgép-erőforrásonként külön idősort adjon vissza. A szűrő nélkül az API egyetlen idősort ad vissza, amely az összes virtuális gép átlagos processzorát összesítené. Az egyes erőforrások idősorait az egyes idősorozat-bejegyzések Microsoft.ResourceId metaadatértéke különbözteti meg.

Ha erőforrásokat használ $filter=Microsoft.ResourceId eq '*' , és nincsenek erőforrások, ebben az esetben a megadott idősorban lévő virtuális gépek, a rendszer az üres idősort timeseries:[] adja vissza, mivel a kért dimenziókészlethez nincsenek eredmények, amelyek tartalmazzák ResourceId
Ugyanaz a lekérdezés a szűrő nélkül egyetlen idősort ad vissza, amely összesített átlagos CPU = 0 értéket ad vissza az összes virtuális géphez, mivel ez az összes kért dimenzió összege.

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&region=eastus&metricNamespace=microsoft.compute/virtualmachines&$filter=Microsoft.ResourceId eq '*'

Példa $filter használatával

Itt vannak a lehetséges kifejezési karakterláncok, amelyeket .{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 és eventTimestamp le 2014-12-29T23:36:37Z és eventChannels eq 'Admin, 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 és eventTimestamp le 2014-12-29T23:36:37Z és eventChannels eq 'Admin, Operation' é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 és eventTimestamp le 2014-12-29T23:36:37Z és eventChannels eq 'Admin, 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 és eventTimestamp le 2014-12-29T23:36:37Z és eventChannels eq 'Admin, 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 'Admin, Operation' és correlationId eq '07c85493-5e87-4efd-9200-0c64d904d878'