Query - Resource Execute

참조

서비스:: Log Analytics

API 버전:: 2022-10-27_Preview

리소스 ID를 사용하여 분석 쿼리 실행
리소스 컨텍스트에서 데이터에 대한 분석 쿼리를 실행합니다. 다음은 Analytics 쿼리와 함께 POST를 사용하는 예제입니다.

POST https://api.loganalytics.io/v1/{resourceId}/query

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceId	path	True	string	리소스의 식별자입니다.

요청 헤더

Name	필수	형식	Description
Prefer		string	선택 사항입니다. 서버 시간 제한, 쿼리 통계 및 시각화 정보를 설정하는 데 선호 헤더입니다.

요청 본문

Name	필수	형식	Description
query	True	string	실행할 쿼리입니다.
timespan		string	선택 사항입니다. 데이터를 쿼리할 시간 범위입니다. 이는 ISO8601 기간 값입니다. 이 시간 범위는 쿼리 식에 지정된 시간 범위 외에 적용됩니다.
workspaces		string[]	쿼리에 포함된 작업 영역 목록입니다.

응답

Name	형식	Description
200 OK	queryResults	OK. API 호출이 성공하고 분석 쿼리 결과가 응답 페이로드에 있습니다.
Other Status Codes	errorResponse	오류 응답 개체입니다.

보안

oauth2

Azure Active Directory OAuth2 Flow

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

simple-query

샘플 요청

HTTP

POST https://api.loganalytics.io/v1//subscriptions/fffa080af-c2d8-40ad-9cce-e1a450bawb57/resourceGroups/test-resourcegroup/providers/Microsoft.Storage/storageAccounts/storageaccountname/query

{
  "query": "StorageBlobLogs | summarize count() by OperationName | top 10 by count_ desc",
  "timespan": "PT24H"
}

샘플 응답

상태 코드:: 200

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "OperationName",
          "type": "string"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "operation1",
          "10"
        ]
      ]
    }
  ]
}

정의

Name	Description
column	테이블 열입니다.
errorDetail	오류 세부 정보입니다.
errorInfo	오류에 대한 코드 및 메시지입니다.
errorResponse	오류 세부 정보입니다.
logsColumnType	이 열의 데이터 형식입니다.
queryBody	분석 쿼리입니다. Analytics 쿼리 구문에 대해 자세히 알아보기
queryResults	쿼리 응답입니다.
Render	JSON 형식의 시각화 데이터입니다.
Statistics	JSON 형식으로 표시된 통계입니다.
table	쿼리 응답 테이블입니다.

column

테이블 열입니다.

Name	형식	Description
name	string	이 열의 이름입니다.
type	logsColumnType	이 열의 데이터 형식입니다.

errorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalProperties	object	오류 세부 정보 개체에 제공할 수 있는 추가 속성
code	string	오류의 코드입니다.
message	string	사람이 읽을 수 있는 오류 메시지입니다.
resources	string[]	오류를 담당한 리소스를 나타냅니다.
target	string	요청에서 오류를 담당하는 속성을 나타냅니다.
value	string	오류를 담당하는 '대상'의 값을 나타냅니다.

errorInfo

오류에 대한 코드 및 메시지입니다.

Name	형식	Description
additionalProperties	object	오류 정보 개체에 제공할 수 있는 추가 속성
code	string	컴퓨터에서 읽을 수 있는 오류 코드입니다.
details	errorDetail[]	오류 세부 정보입니다.
innererror	errorInfo	오류에 대한 코드 및 메시지입니다. 내부 오류 세부 정보(있는 경우)
message	string	사람이 읽을 수 있는 오류 메시지입니다.

errorResponse

오류 세부 정보입니다.

Name	형식	Description
error	errorInfo	오류에 대한 코드 및 메시지입니다. 오류 세부 정보입니다.

logsColumnType

이 열의 데이터 형식입니다.

Name	형식	Description
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryBody

분석 쿼리입니다. Analytics 쿼리 구문에 대해 자세히 알아보기

Name	형식	Description
query	string	실행할 쿼리입니다.
timespan	string	선택 사항입니다. 데이터를 쿼리할 시간 범위입니다. 이는 ISO8601 기간 값입니다. 이 시간 범위는 쿼리 식에 지정된 시간 범위 외에 적용됩니다.
workspaces	string[]	쿼리에 포함된 작업 영역 목록입니다.

queryResults

쿼리 응답입니다.

Name	형식	Description
error	errorInfo	오류에 대한 코드 및 메시지입니다.
render	Render	JSON 형식의 시각화 데이터입니다.
statistics	Statistics	JSON 형식으로 표시된 통계입니다.
tables	table[]	테이블, 열 및 행 목록입니다.

Render

JSON 형식의 시각화 데이터입니다.

Statistics

JSON 형식으로 표시된 통계입니다.

table

쿼리 응답 테이블입니다.

Name	형식	Description
columns	column[]	이 테이블의 열 목록입니다.
name	string	테이블의 이름입니다.
rows	object[]	이 쿼리의 결과 행입니다.

다음을 통해 공유