Freigeben über


Query Pack Queries - Search

Durchsuchen Sie eine Liste von Abfragen, die in einem Log Analytics QueryPack gemäß den angegebenen Sucheigenschaften definiert sind.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/queryPacks/{queryPackName}/queries/search?api-version=2019-09-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/queryPacks/{queryPackName}/queries/search?api-version=2019-09-01&$top={$top}&includeBody={includeBody}&$skipToken={$skipToken}

URI-Parameter

Name In Erforderlich Typ Beschreibung
queryPackName
path True

string

Der Name der Log Analytics QueryPack-Ressource.

resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

$skipToken
query

string

Base64-codiertes Token, das zum Abrufen der nächsten Seite von Elementen verwendet wird. Der Standardwert lautet null.

$top
query

integer

int64

Die maximale Anzahl zurückgegebener Elemente auf der Seite.

includeBody
query

boolean

Flag, das angibt, ob der Text der jeweiligen Abfrage zurückgegeben werden soll. Wenn false, geben Sie nur die Abfrageinformationen zurück.

Anforderungstext

Name Typ Beschreibung
related

Related

Die zugehörigen Metadatenelemente für die Funktion.

tags

object

Der Abfrage zugeordnete Tags.

Antworten

Name Typ Beschreibung
200 OK

LogAnalyticsQueryPackQueryListResult

Eine Liste, die 0 oder mehr Abfragen enthält, die im Log Analytics QueryPack enthalten sind.

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

QuerySearch

Beispielanforderung

POST https://management.azure.com/subscriptions/86dc51d3-92ed-4d7e-947a-775ea79b4918/resourceGroups/my-resource-group/providers/Microsoft.OperationalInsights/queryPacks/my-querypack/queries/search?api-version=2019-09-01&$top=3&includeBody=True

{
  "related": {
    "categories": [
      "other",
      "analytics"
    ]
  },
  "tags": {
    "my-label": [
      "label1"
    ]
  }
}

Beispiel für eine Antwort

{
  "value": [
    {
      "id": "/subscriptions/86dc51d3-92ed-4d7e-947a-775ea79b4918/resourceGroups/my-resource-group/providers/microsoft.operationalinsights/queryPacks/my-querypack/queries/4337bb16-d6fe-4ff7-97cf-59df25941476",
      "name": "4337bb16-d6fe-4ff7-97cf-59df25941476",
      "type": "microsoft.operationalinsights/queryPacks/queries",
      "systemData": {
        "createdBy": "string",
        "createdByType": "application",
        "createdAt": "2020-02-03T01:01:01.1075056Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "application",
        "lastModifiedAt": "2020-02-04T02:03:01.1974346Z"
      },
      "properties": {
        "id": "4337bb16-d6fe-4ff7-97cf-59df25941476",
        "timeCreated": "2019-08-15T10:29:56.1030254Z",
        "author": "1809f206-263a-46f7-942d-4572c156b7e7",
        "timeModified": "2019-08-15T10:29:56.1030254Z",
        "displayName": "Heartbeat_1",
        "description": "Thie query takes 10 entries of heartbeat 0",
        "body": "Heartbeat | take 1",
        "related": {
          "categories": [
            "other"
          ]
        },
        "tags": {
          "my-label": [
            "label1"
          ],
          "my-other-label": [
            "label2"
          ]
        }
      }
    },
    {
      "id": "/subscriptions/86dc51d3-92ed-4d7e-947a-775ea79b4918/resourceGroups/my-resource-group/providers/microsoft.operationalinsights/queryPacks/my-querypack/queries/bf015bf7-be70-49c2-8d52-4cce85c42ef1",
      "name": "bf015bf7-be70-49c2-8d52-4cce85c42ef1",
      "type": "microsoft.operationalinsights/queryPacks/queries",
      "systemData": {
        "createdBy": "string",
        "createdByType": "application",
        "createdAt": "2020-02-03T01:01:01.1075056Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "application",
        "lastModifiedAt": "2020-02-04T02:03:01.1974346Z"
      },
      "properties": {
        "id": "bf015bf7-be70-49c2-8d52-4cce85c42ef1",
        "timeCreated": "2019-08-15T10:30:26.7943629Z",
        "author": "1809f206-263a-46f7-942d-4572c156b7e7",
        "timeModified": "2019-08-15T10:30:26.7943629Z",
        "displayName": "Heartbeat_2",
        "description": "Thie query takes 10 entries of heartbeat 1",
        "body": "Heartbeat | take 1",
        "related": {
          "categories": [
            "analytics"
          ]
        },
        "tags": {
          "my-label": [
            "label1"
          ],
          "my-other-label": [
            "label2"
          ]
        }
      }
    },
    {
      "id": "/subscriptions/86dc51d3-92ed-4d7e-947a-775ea79b4918/resourceGroups/my-resource-group/providers/microsoft.operationalinsights/queryPacks/my-querypack/queries/8d91c6ca-9c56-49c6-b3ae-112a68871acd",
      "name": "8d91c6ca-9c56-49c6-b3ae-112a68871acd",
      "type": "microsoft.operationalinsights/queryPacks/queries",
      "systemData": {
        "createdBy": "string",
        "createdByType": "application",
        "createdAt": "2020-02-03T01:01:01.1075056Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "application",
        "lastModifiedAt": "2020-02-04T02:03:01.1974346Z"
      },
      "properties": {
        "id": "8d91c6ca-9c56-49c6-b3ae-112a68871acd",
        "timeCreated": "2019-08-15T10:30:29.4505584Z",
        "author": "1809f206-263a-46f7-942d-4572c156b7e7",
        "timeModified": "2019-08-15T10:30:29.4505584Z",
        "displayName": "Heartbeat_3",
        "description": "Thie query takes 10 entries of heartbeat 2",
        "body": "Heartbeat | take 1",
        "related": {
          "categories": [
            "other",
            "analytics"
          ]
        },
        "tags": {
          "my-label": [
            "label1"
          ],
          "my-other-label": [
            "label2"
          ]
        }
      }
    }
  ],
  "nextLink": null
}

Definitionen

Name Beschreibung
ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

IdentityType

Der Identitätstyp, der Ressourcen erstellt/ändert

LogAnalyticsQueryPackQuery

Eine Log Analytics-QueryPack-Query Definition.

LogAnalyticsQueryPackQueryListResult

Beschreibt die Liste der Log Analytics-QueryPack-Query-Ressourcen.

LogAnalyticsQueryPackQuerySearchProperties

Eigenschaften, die eine Log Analytics-QueryPack-Query Sucheigenschaften definieren.

Related

Die zugehörigen Metadatenelemente für die Funktion.

SystemData

Schreibgeschützte Systemdaten

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

IdentityType

Der Identitätstyp, der Ressourcen erstellt/ändert

Name Typ Beschreibung
application

string

key

string

managedIdentity

string

user

string

LogAnalyticsQueryPackQuery

Eine Log Analytics-QueryPack-Query Definition.

Name Typ Beschreibung
id

string

Azure-Ressourcen-ID

name

string

Name der Azure-Ressource

properties.author

string

Objekt-ID des Benutzers, der die Abfrage erstellt.

properties.body

string

Text der Abfrage.

properties.description

string

Die Beschreibung der Abfrage.

properties.displayName

string

Eindeutiger Anzeigename für Ihre Abfrage im Query Pack.

properties.id

string

Die eindeutige ID Ihrer Anwendung. Dieses Feld kann nicht geändert werden.

properties.properties

object

Zusätzliche Eigenschaften, die für die Abfrage festgelegt werden können.

properties.related

Related

Die zugehörigen Metadatenelemente für die Funktion.

properties.tags

object

Der Abfrage zugeordnete Tags.

properties.timeCreated

string

Erstellungsdatum für die Log Analytics-Abfrage im ISO 8601-Format.

properties.timeModified

string

Datum der letzten Änderung der Log Analytics-Abfrage im ISO 8601-Format.

systemData

SystemData

Schreibgeschützte Systemdaten

type

string

Azure-Ressourcentyp

LogAnalyticsQueryPackQueryListResult

Beschreibt die Liste der Log Analytics-QueryPack-Query-Ressourcen.

Name Typ Beschreibung
nextLink

string

Der URI, um den nächsten Satz von Log Analytics QueryPack-Definitionen abzurufen, wenn zu viele QueryPack-Queries im Resultset zurückgegeben werden.

value

LogAnalyticsQueryPackQuery[]

Liste der Log Analytics QueryPack-Abfragedefinitionen.

LogAnalyticsQueryPackQuerySearchProperties

Eigenschaften, die eine Log Analytics-QueryPack-Query Sucheigenschaften definieren.

Name Typ Beschreibung
related

Related

Die zugehörigen Metadatenelemente für die Funktion.

tags

object

Der Abfrage zugeordnete Tags.

Die zugehörigen Metadatenelemente für die Funktion.

Name Typ Beschreibung
categories

string[]

Die zugehörigen Kategorien für die Funktion.

resourceTypes

string[]

Die zugehörigen Ressourcentypen für die Funktion.

solutions

string[]

Die zugehörigen Log Analytics-Lösungen für die Funktion.

SystemData

Schreibgeschützte Systemdaten

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC)

createdBy

string

Ein Bezeichner für die Identität, die die Ressource erstellt hat

createdByType

IdentityType

Der Identitätstyp, der die Ressource erstellt hat

lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Ein Bezeichner für die Identität, die die Ressource zuletzt geändert hat

lastModifiedByType

IdentityType

Der Identitätstyp, der die Ressource zuletzt geändert hat