다음을 통해 공유


Query Pack Queries - Search

지정된 검색 속성에 따라 Log Analytics QueryPack 내에 정의된 쿼리 목록을 검색합니다.

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 매개 변수

Name In(다음 안에) 필수 형식 Description
queryPackName
path True

string

Log Analytics QueryPack 리소스의 이름입니다.

resourceGroupName
path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

subscriptionId
path True

string

대상 구독의 ID입니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

$skipToken
query

string

항목의 다음 페이지를 가져오는 데 사용되는 Base64로 인코딩된 토큰입니다. 기본값은 null입니다.

$top
query

integer

int64

페이지에 반환된 최대 항목입니다.

includeBody
query

boolean

해당하는 각 쿼리의 본문을 반환할지 여부를 나타내는 플래그입니다. false이면 쿼리 정보만 반환합니다.

요청 본문

Name 형식 Description
related

Related

함수에 대한 관련 메타데이터 항목입니다.

tags

object

쿼리와 연결된 태그입니다.

응답

Name 형식 Description
200 OK

LogAnalyticsQueryPackQueryListResult

Log Analytics QueryPack에 포함된 0개 이상의 쿼리가 포함된 목록입니다.

Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

QuerySearch

샘플 요청

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

샘플 응답

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

정의

Name Description
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

IdentityType

리소스를 만들/수정하는 ID 유형

LogAnalyticsQueryPackQuery

Log Analytics QueryPack-Query 정의입니다.

LogAnalyticsQueryPackQueryListResult

Log Analytics QueryPack-Query 리소스 목록을 설명합니다.

LogAnalyticsQueryPackQuerySearchProperties

Log Analytics QueryPack-Query 검색 속성을 정의하는 속성입니다.

Related

함수에 대한 관련 메타데이터 항목입니다.

SystemData

시스템 데이터만 읽기

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

IdentityType

리소스를 만들/수정하는 ID 유형

Name 형식 Description
application

string

key

string

managedIdentity

string

user

string

LogAnalyticsQueryPackQuery

Log Analytics QueryPack-Query 정의입니다.

Name 형식 Description
id

string

Azure 리소스 ID

name

string

Azure 리소스 이름

properties.author

string

쿼리를 만드는 사용자의 개체 ID입니다.

properties.body

string

쿼리의 본문입니다.

properties.description

string

쿼리에 대한 설명입니다.

properties.displayName

string

쿼리 팩 내의 쿼리에 대한 고유한 표시 이름입니다.

properties.id

string

애플리케이션의 고유 ID입니다. 이 필드는 변경할 수 없습니다.

properties.properties

object

쿼리에 대해 설정할 수 있는 추가 속성입니다.

properties.related

Related

함수에 대한 관련 메타데이터 항목입니다.

properties.tags

object

쿼리와 연결된 태그입니다.

properties.timeCreated

string

Log Analytics 쿼리의 생성 날짜(ISO 8601 형식)입니다.

properties.timeModified

string

Log Analytics 쿼리의 마지막 수정 날짜(ISO 8601 형식)입니다.

systemData

SystemData

시스템 데이터만 읽기

type

string

Azure 리소스 종류

LogAnalyticsQueryPackQueryListResult

Log Analytics QueryPack-Query 리소스 목록을 설명합니다.

Name 형식 Description
nextLink

string

결과 집합에 반환된 QueryPack-Queries 너무 많은 경우 Log Analytics QueryPack 정의의 다음 집합을 가져올 URI입니다.

value

LogAnalyticsQueryPackQuery[]

Log Analytics QueryPack 쿼리 정의 목록입니다.

LogAnalyticsQueryPackQuerySearchProperties

Log Analytics QueryPack-Query 검색 속성을 정의하는 속성입니다.

Name 형식 Description
related

Related

함수에 대한 관련 메타데이터 항목입니다.

tags

object

쿼리와 연결된 태그입니다.

함수에 대한 관련 메타데이터 항목입니다.

Name 형식 Description
categories

string[]

함수에 대한 관련 범주입니다.

resourceTypes

string[]

함수에 대한 관련 리소스 종류입니다.

solutions

string[]

함수에 대한 관련 Log Analytics 솔루션입니다.

SystemData

시스템 데이터만 읽기

Name 형식 Description
createdAt

string

리소스 만들기의 타임스탬프(UTC)

createdBy

string

리소스를 만든 ID의 식별자

createdByType

IdentityType

리소스를 만든 ID 유형

lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID의 식별자

lastModifiedByType

IdentityType

리소스를 마지막으로 수정한 ID 유형