Share via

Gen2 쿼리 API Azure Time Series Insights

  • 아티클

개요

쿼리 API는 이벤트, 계열 및 집계에 대해 각각 하나의 API인 3개의 REST API로 구성됩니다.

쿼리 API는 선택적 페이지 매김을 사용하여 HTTP GET 요청을 통해 지정된 시간 범위에 대한 이벤트 스키마 및 이벤트 수를 반환합니다. 계열 및 집계 계열 정보도 선택적 페이지 매김을 사용하여 GET 작업을 통해 노출됩니다.

API 설명
이벤트 가져오기 API 검색 범위 및 조건자와 일치하는 원시 이벤트 목록을 반환합니다.
Series API 가져오기 모델에 정의되거나 인라인으로 제공된 변수를 통해 와이어에 기록된 데이터를 사용하여 캡처된 이벤트에서 Time Series Insights 데이터를 쿼리하고 검색할 수 있습니다.
집계 시리즈 API 집계 또는 샘플 함수를 사용하여 기록된 데이터를 집계하여 캡처된 이벤트에서 Time Series Insights 데이터를 쿼리하고 검색할 수 있습니다.

또한 API는 HTTP 요청 JSON 본문을 통해 지정된 다양한 사용자 지정 작업을 지원합니다. 쿼리 정의는 일반적인 작업에 사용할 수 있습니다.

중요

오류 응답

쿼리 실행이 실패하면 JSON 응답 페이로드에 다음 구조를 준수하는 오류 응답이 포함됩니다.

{
    "error" : {
        "code" : "...",
        "message" : "...",
        "innerError" : {  
            "code" : "...",
            "message" : "...",
        }
    }
}

여기서 는 innerError 선택 사항입니다. 잘못된 형식의 요청과 같은 기본 오류 외에도 다음 오류가 반환됩니다.

Http 상태 코드 오류 코드 예제 오류 메시지 가능한 innerError 코드
400 InvalidApiVersion API 버전 '2016'은 지원되지 않습니다. 지원되는 버전은 '2016-12-12', '2018-11-01-preview'입니다. -
400 InvalidUrl 요청 URL '/a/b'를 구문 분석할 수 없습니다. -
400 InvalidInput 지정된 쿼리 '집계'가 잘못되었습니다. 지원되는 쿼리는 'getEvents', 'getSeries', 'aggregateSeries'입니다. InvalidQueryType
400 InvalidInput 'projectedVariables.temperature.value'의 '$event.temperature.Double > 0' 시계열 식은 유효한 속성 참조 식이 아닙니다. InvalidPropertyReferenceExpression
400 InvalidInput 'projectedVariables.temperature.filter'의 '$event.temperature.Double' 시계열 식이 잘못되었습니다. 부울을 반환하는 조건자 식일 수 있습니다. InvalidPredicateExpression
400 InvalidInput 'projectedVariables.temperature.aggregation'의 '$event.temperature.Double' 시계열 식이 잘못되었습니다. 집계 식을 포함하지 않았습니다. InvalidAggregateExpression
400 InvalidInput 'projectedVariables.temperature.value'의 '$event.temperature.Double > 0' 시계열 식은 'numeric' 형식의 유효한 값 식이 아닙니다. InvalidValueExpression
400 InvalidInput 'projectedVariables.temperature.value'의 값 시계열 식은 'aggregate' 종류의 변수에 대해 지정하거나 null이어야 합니다. ValueExpressionShouldNotBeSpecified
400 InvalidInput 변수 종류 'numeric'에 대해 'projectedVariables.temperature.value'의 값 시계열 식을 지정해야 합니다. ValueExpressionShouldBeSpecified
400 InvalidInput 'projectedVariables.temperature.aggregation'의 'min($value)' 식에 'aggregate' 변수 종류가 잘못되었습니다. InvalidVariableKind
400 InvalidInput 'interval'의 시간 범위 '00.00:01'이 유효한 ISO8601 시간 범위 형식이 아닙니다. InvalidTimeSpanFormat
400 InvalidInput timeSeriesId가 '[["ABC123"]'인 instance 찾을 수 없습니다. InstanceNotFound
400 InvalidInput 이름이 'timeSeriesName'인 instance 찾을 수 없습니다. InstanceNotFound
400 InvalidInput timeSeriesId가 '["ABC321"]'인 instance 삭제할 수 없습니다. 이 시계열 ID와 연결된 수집된 이벤트가 이미 있습니다. CannotDeleteInstance
400 InvalidInput ID가 '5e19f688-83fb-4aee-8321-5c123ed016b7'인 환경은 시계열 쿼리 API를 지원하지 않습니다. TimeSeriesQueryNotSupported
400 InvalidInput 이름이 'temperature'인 프로젝스된 변수가 형식 또는 인라인 변수 정의에서 찾을 수 없습니다. ProjectedVariableNotFound
400 InvalidInput ID가 '7e19g688-83fb-4aee-8321-5c123ed016b7'이고 이름이 'ABC123'인 형식을 upsert할 수 없습니다. 이 이름은 ID가 '6e19g688-83fb-4aee-8321-5c123ed016b7'인 형식에서 이미 사용됩니다. NameAlreadyExists
400 InvalidInput ID가 '4e19g688-83fb-4aee-8321-7c123ed016b7'이고 이름이 'XYZ123'인 계층 구조를 upsert할 수 없습니다. 이 이름은 ID가 '8e39g688-83fb-4aee-8321-5c123ed016b7'인 계층 구조에서 이미 사용됩니다. HierarchyNotDefined
400 InvalidInput 인스턴스 수가 '1,000,000'의 제한을 초과했습니다. NumberOfInstancesExceededLimit
400 InvalidInput 형식 수가 '1000' 제한을 초과했습니다. NumberOfTypesExceededLimit
400 InvalidInput 계층 수가 '32'의 제한을 초과했습니다. NumberOfHierarchiesExceededLimit
400 InvalidInput 엔터티 크기가 허용되는 최대 크기 '16,384'를 초과합니다. ObjectSizeExceededLimit
400 InvalidInput 길이가 '6'인 개체 이름 'ABC123'이 허용되는 최대 문자 제한인 '5'를 초과합니다. NameExceededLimit
408 RequestTimeout 요청 시간이 '30' 초 후에 초과되었습니다. BatchRequestSizeExceededLimit
503 TooManyRequests '95880732-01b9-44ea-8d2d-4d764dfe1904' 환경에 대해 '30'의 동시 요청 수가 초과되었습니다. EnvRequestLimitExceeded

추가 정보

  • 애플리케이션 등록 및 Azure Active Directory 프로그래밍 모델에 대한 자세한 내용은 개발자용 Azure Active Directory를 참조하세요.

  • 요청 및 인증 매개 변수에 대해 알아보려면 인증 및 권한 부여를 참조하세요.

  • HTTP 요청 및 응답 테스트를 지원하는 도구는 다음과 같습니다.

  • Fiddler. 이 무료 웹 디버깅 프록시는 REST 요청을 가로챌 수 있으므로 HTTP 요청 및 응답 메시지를 진단할 수 있습니다.

  • JWT.io. 이 도구를 사용하여 전달자 토큰에서 클레임을 신속하게 덤프한 다음 해당 콘텐츠의 유효성을 검사할 수 있습니다.

  • 포스트맨. REST API를 디버깅하기 위한 무료 HTTP 요청 및 응답 테스트 도구입니다.

  • Gen2 설명서를 검토하여 Gen2 Azure Time Series Insights 대해 자세히 알아보세요.