Condividi tramite


Query Pack Queries - Search

Cercare un elenco di query definite all'interno di un oggetto QueryPack di Log Analytics in base alle proprietà di ricerca specificate.

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}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
queryPackName
path True

string

Nome della risorsa QueryPack di Log Analytics.

resourceGroupName
path True

string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

subscriptionId
path True

string

ID della sottoscrizione di destinazione.

api-version
query True

string

Versione dell'API da usare per questa operazione.

$skipToken
query

string

Token con codifica Base64 usato per recuperare la pagina successiva di elementi. Il valore predefinito è null.

$top
query

integer

int64

Numero massimo di elementi restituiti nella pagina.

includeBody
query

boolean

Flag che indica se restituire o meno il corpo di ogni query applicabile. Se false, restituisce solo le informazioni sulla query.

Corpo della richiesta

Nome Tipo Descrizione
related

Related

Elementi di metadati correlati per la funzione.

tags

object

Tag associati alla query.

Risposte

Nome Tipo Descrizione
200 OK

LogAnalyticsQueryPackQueryListResult

Elenco contenente 0 o più query contenute in Log Analytics QueryPack.

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

QuerySearch

Esempio di richiesta

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"
    ]
  }
}

Risposta di esempio

{
  "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
}

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

IdentityType

Tipo di identità che crea/modifica le risorse

LogAnalyticsQueryPackQuery

Definizione di QueryPack-Query di Log Analytics.

LogAnalyticsQueryPackQueryListResult

Descrive l'elenco delle risorse di Log Analytics QueryPack-Query.

LogAnalyticsQueryPackQuerySearchProperties

Proprietà che definiscono un log analytics QueryPack-Query proprietà di ricerca.

Related

Elementi di metadati correlati per la funzione.

SystemData

Sola lettura dei dati di sistema

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

IdentityType

Tipo di identità che crea/modifica le risorse

Nome Tipo Descrizione
application

string

key

string

managedIdentity

string

user

string

LogAnalyticsQueryPackQuery

Definizione di QueryPack-Query di Log Analytics.

Nome Tipo Descrizione
id

string

ID risorsa di Azure

name

string

Nome risorsa di Azure

properties.author

string

ID oggetto dell'utente che crea la query.

properties.body

string

Corpo della query.

properties.description

string

Descrizione della query.

properties.displayName

string

Nome visualizzato univoco per la query all'interno di Query Pack.

properties.id

string

ID univoco dell'applicazione. Impossibile modificare questo campo.

properties.properties

object

Proprietà aggiuntive che possono essere impostate per la query.

properties.related

Related

Elementi di metadati correlati per la funzione.

properties.tags

object

Tag associati alla query.

properties.timeCreated

string

Data di creazione per la query di Log Analytics, in formato ISO 8601.

properties.timeModified

string

Data dell'ultima modifica della query di Log Analytics, in formato ISO 8601.

systemData

SystemData

Sola lettura dei dati di sistema

type

string

Tipo di risorsa di Azure

LogAnalyticsQueryPackQueryListResult

Descrive l'elenco delle risorse di Log Analytics QueryPack-Query.

Nome Tipo Descrizione
nextLink

string

URI per ottenere il set successivo di definizioni QueryPack di Log Analytics se troppi QueryPack-Queries dove restituito nel set di risultati.

value

LogAnalyticsQueryPackQuery[]

Elenco delle definizioni di query QueryPack di Log Analytics.

LogAnalyticsQueryPackQuerySearchProperties

Proprietà che definiscono un log analytics QueryPack-Query proprietà di ricerca.

Nome Tipo Descrizione
related

Related

Elementi di metadati correlati per la funzione.

tags

object

Tag associati alla query.

Elementi di metadati correlati per la funzione.

Nome Tipo Descrizione
categories

string[]

Categorie correlate per la funzione.

resourceTypes

string[]

Tipi di risorse correlati per la funzione.

solutions

string[]

Soluzioni di Log Analytics correlate per la funzione.

SystemData

Sola lettura dei dati di sistema

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC)

createdBy

string

Identificatore per l'identità che ha creato la risorsa

createdByType

IdentityType

Tipo di identità che ha creato la risorsa

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identificatore per l'identità che ha modificato l'ultima risorsa

lastModifiedByType

IdentityType

Tipo di identità che ha modificato per l'ultima volta la risorsa