Freigeben über


Query Pack Queries - Update

Fügt eine bestimmte Abfrage innerhalb eines Log Analytics-Abfragepakets hinzu oder Updates.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/queryPacks/{queryPackName}/queries/{id}?api-version=2019-09-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
id
path True

string

Die ID einer bestimmten Abfrage, die im Log Analytics-Abfragepaket definiert ist.

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.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.body True

string

Text der Abfrage.

properties.displayName True

string

Eindeutiger Anzeigename für Ihre Abfrage im Abfragepaket.

properties.description

string

Die Beschreibung der Abfrage.

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.

Antworten

Name Typ Beschreibung
200 OK

LogAnalyticsQueryPackQuery

Die neue oder aktualisierte Abfrage, die im Log Analytics-Abfragepaket enthalten ist.

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

QueryPatch

Beispielanforderung

PATCH https://management.azure.com/subscriptions/86dc51d3-92ed-4d7e-947a-775ea79b4918/resourceGroups/my-resource-group/providers/Microsoft.OperationalInsights/queryPacks/my-querypack/queries/a449f8af-8e64-4b3a-9b16-5a7165ff98c4?api-version=2019-09-01

{
  "properties": {
    "displayName": "Exceptions - New in the last 24 hours",
    "description": "my description",
    "body": "let newExceptionsTimeRange = 1d;\nlet timeRangeToCheckBefore = 7d;\nexceptions\n| where timestamp < ago(timeRangeToCheckBefore)\n| summarize count() by problemId\n| join kind= rightanti (\nexceptions\n| where timestamp >= ago(newExceptionsTimeRange)\n| extend stack = tostring(details[0].rawStack)\n| summarize count(), dcount(user_AuthenticatedId), min(timestamp), max(timestamp), any(stack) by problemId  \n) on problemId \n| order by  count_ desc\n",
    "related": {
      "categories": [
        "analytics"
      ]
    },
    "tags": {
      "my-label": [
        "label1"
      ],
      "my-other-label": [
        "label2"
      ]
    }
  }
}

Beispiel für eine Antwort

{
  "id": "/subscriptions/86dc51d3-92ed-4d7e-947a-775ea79b4918/resourceGroups/my-resource-group/providers/microsoft.operationalinsights/queryPacks/my-querypack/queries/a449f8af-8e64-4b3a-9b16-5a7165ff98c4",
  "name": "a449f8af-8e64-4b3a-9b16-5a7165ff98c4",
  "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": "a449f8af-8e64-4b3a-9b16-5a7165ff98c4",
    "timeCreated": "2019-08-15T10:30:32.5742324Z",
    "author": "1809f206-263a-46f7-942d-4572c156b7e7",
    "timeModified": "2019-08-15T10:30:32.5742324Z",
    "displayName": "Exceptions - New in the last 24 hours",
    "description": "my description",
    "body": "let newExceptionsTimeRange = 1d;\nlet timeRangeToCheckBefore = 7d;\nexceptions\n| where timestamp < ago(timeRangeToCheckBefore)\n| summarize count() by problemId\n| join kind= rightanti (\nexceptions\n| where timestamp >= ago(newExceptionsTimeRange)\n| extend stack = tostring(details[0].rawStack)\n| summarize count(), dcount(user_AuthenticatedId), min(timestamp), max(timestamp), any(stack) by problemId  \n) on problemId \n| order by  count_ desc\n",
    "related": {
      "categories": [
        "analytics"
      ]
    },
    "tags": {
      "my-label": [
        "label1"
      ],
      "my-other-label": [
        "label2"
      ]
    }
  }
}

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.

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 Abfragepaket.

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

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