다음을 통해 공유


Azure Time Series Insights Gen2 모델 API

개요

시계열 모델을 만드는 세 가지 구성 요소(인스턴스, 계층 구조형식)에는 각각 CREATE,READ,UPDATEDELETE, 페이지를 매긴 및/또는 일괄 처리 작업을 지원하는 해당 REST API가 있습니다.

  • 인스턴스 API는 페이지를 매긴 GET 작업, 일괄 처리 CREATE,READ,UPDATEDELETE 작업, 검색 및 검색 작업에 대한 키워드 제안을 지원합니다.
  • 계층 API는 페이지를 매긴 GET 작업과 일괄 처리 CREATE,READ,UPDATEDELETE 작업을 지원합니다.
  • Type API는 페이지를 매긴 GET 작업과 일괄 처리 CREATE,READ,UPDATEDELETE 작업을 지원합니다.

네 번째 API는 시계열 모델 설정에 대한 REST 지원을 제공합니다.

  • 모델 설정 API는 시계열 모델 구성 설정에 대한 HTTP GETUPDATE 작업을 지원합니다. 시계열 모델 및 인스턴스, 계층 구조형식 정의에 대한 자세한 내용은 시계열 모델을 참조하세요.

인스턴스 API

인스턴스 API를 사용하면 시계열 인스턴스에서 CREATE,READ,UPDATEDELETE 작업을 수행할 수 있습니다.

  • Get Instances API는 요청과 일치하는 모든 시계열 인스턴스를 반환합니다.

  • 인스턴스 관리 API를 사용하면 인스턴스에 대한 배치 작업을 수행할 수 있습니다. 이 API에 대한 모든 작업은 HTTP POST 작업입니다. 각 작업은 페이로드를 허용합니다. 페이로드는 JSON 개체입니다. 이 개체는 단일 속성을 정의합니다. 속성 키는 API에서 허용하는 작업의 이름입니다. 지원되는 작업은 PUT, UPDATEDELETE입니다.

  • 이러한 API를 사용하면 시계열 인스턴스를 검색할 수 있습니다.

    • 제안 은 인스턴스를 검색하는 동안 자동 완성 시나리오를 사용하도록 설정합니다.
    • 검색 은 제공된 키워드를 기반으로 인스턴스를 식별하는 데 도움이 됩니다.

    팁 (조언)

    아래에서 검색어 기능에 대해 읽어보세요.

계층 API

계층 API는 시계열 계층에서 CREATE,READ,UPDATEDELETE를 사용하도록 설정합니다.

응용 프로그램 인터페이스 (API) 설명
계층 구조 API 가져오기 요청과 일치하는 모든 시계열 계층을 반환합니다.
계층 관리 API 계층 구조에 대한 일괄 처리 작업을 사용하도록 설정합니다. 이 API에 대한 모든 작업은 HTTP POST 작업입니다. 각 작업은 페이로드를 허용합니다. 페이로드는 JSON 개체입니다. 이 개체는 단일 속성을 정의합니다. 속성 키는 API에서 허용하는 작업의 이름입니다. 지원되는 작업은 PUT, UPDATEDELETE입니다.

유형 API

형식 API를 사용하면 시계열 형식 및 관련 변수에 대해 CREATE,READ,UPDATEDELETE를 사용할 수 있습니다.

응용 프로그램 인터페이스 (API) 설명
형식 가져오기 API 모든 시계열 형식 및 관련 변수를 반환합니다.
게시물 유형 API 형식에 대한 일괄 처리 작업을 사용하도록 설정합니다. 이 API에 대한 모든 작업은 HTTP POST 작업입니다. 각 작업은 페이로드를 허용합니다. 페이로드는 JSON 개체입니다. 이 개체는 단일 속성을 정의합니다. 속성 키는 API에서 허용하는 작업의 이름입니다. 지원되는 작업은 PUT, UPDATEDELETE입니다.

모델 설정 API

모델 설정 API를 사용하면 TimeSeriesIds에 의해 환경에서 자동으로 생성된 모델에 대해 CREATE,READ,UPDATEDELETE를 사용할 수 있습니다.

응용 프로그램 인터페이스 (API) 설명
모델 설정 API 가져오기 TimeSeriesIds에 대한 환경에서 자동으로 생성된 모델을 반환합니다.
모델 설정 업데이트 API TimeSeriesIds 환경의 모델을 요청에 제공된 새 값으로 업데이트합니다.

검색 기능

와일드카드 검색

단일 용어 내에서 단일 및 다중 문자 와일드카드 검색을 지원합니다(구문 검색이 아님).

단일 문자

단일 문자 와일드카드 검색을 수행하려면 기호를 ? 사용합니다. 단일 문자 와일드카드 검색은 단일 문자가 대체된 문자열과 일치하는 용어를 찾습니다.

또는 test을 검색 text 하려면 다음을 검색합니다. te?t

여러 문자

여러 문자 와일드카드 검색을 수행하려면 기호를 * 사용합니다. 여러 문자 와일드카드 검색은 0개 이상의 문자를 찾습니다.

, tests, 또는 tester를 검색test하려면 검색: test*을 사용합니다.

용어 중간에 와일드카드 검색을 사용할 수도 있습니다. 를 검색 dryer하려면 검색: dr*r을 사용할 수 있습니다.

부울 연산자

부울 연산자를 사용하면 논리 연산자를 통해 용어를 결합할 수 있습니다. AND, OR, +, -NOT를 부울 연산자로 지원합니다.

중요합니다

  • 부울 연산자는 모두 대문자여야 합니다.
  • 부울 연산자는 공백을 사용하여 검색 절과 구분해야 합니다.
  • dryer AND washer 는 유효하지만 그렇지 않습니다 dryer ANDwasher.

AND 연산자

AND 연산자는 단일 문서의 텍스트에서 두 용어가 모두 존재하는 문서와 일치합니다.

검색을 포함 dryer washer 하고 foo bar 사용하는 문서를 검색하려면: dryer washer AND foo bar.

비고

이 기호 && 는 연산자 AND 대신 사용할 수 있습니다.

OR 연산자

OR 연산자는 두 용어를 연결하고 문서에 용어 중 하나가 있는 경우 일치하는 문서를 찾습니다. OR 연산자는 기본 접속 연산자입니다. 즉, 두 용어 사이에 부울 연산자가 없으면 OR 연산자가 사용됩니다.

다음 검색 중 하나를 dryer washer 포함하거나 다음 검색 중 하나만 dryer 사용하는 문서를 검색하려면 다음을 수행합니다.

  1. 'dryer washer' dryer
  2. 'dryer washer' OR dryer

비고

기호 || 는 연산자 OR 대신 사용할 수 있습니다.

+ 연산자

또는 필수 연산자를 사용하려면 + 기호 뒤 + 의 용어가 단일 문서의 필드 어딘가에 있어야 합니다.

포함 dryer 해야 하고 포함할 washer 수 있는 문서를 검색하려면 다음 +dryer washer검색을 사용합니다.

-연산자

- 또는 금지 연산자는 기호 뒤에 용어가 포함된 문서를 제외합니다-.

검색을 포함 dryer washer 하지만 사용하지 않는 foo bar 문서를 검색하려면: dryer washer -foo bar.

아님

NOT 연산자는 NOT.

검색을 포함 dryer washer 하지만 사용하지 않는 foo bar 문서를 검색하려면: dryer washer NOT foo bar.

NOT 연산자는 하나의 용어에만 사용할 수 없습니다.

다음 검색은 결과를 반환하지 않습니다. NOT dryer washer

비고

기호 ! 는 연산자 NOT 대신 사용할 수 있습니다.

  • 제외된 검색어 바로 앞에 와야 합니다.
  • dryer !washer 는 유효하지만 그렇지 않습니다 dryer ! washer.

참고하십시오

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

  • 요청 및 인증 매개변수에 대한 자세한 내용은 인증 및 권한 부여를 참조하세요.

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

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

  • JWT.io. 이 도구를 사용하여 전달자 토큰의 클레임을 빠르게 덤프한 다음 해당 내용의 유효성을 검사할 수 있습니다.

  • 우체부. REST API 디버깅을 위한 무료 HTTP 요청 및 응답 테스트 도구입니다.

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