Gen2 모델 API Azure Time Series Insights
개요
시계열 모델(인스턴스, 계층 및 형식)을 만드는 세 가지 구성 요소 각각에는 CREATE, READ, UPDATE 및 DELETE, 페이지를 매긴 및/또는 일괄 처리 작업을 지원하는 해당 REST API가 있습니다.
- 인스턴스 API는 페이지를 매긴 GET 작업, 일괄 처리 CREATE, READ, UPDATE 및 DELETE 작업, 검색 및 검색 작업에 대한 키워드(keyword) 제안을 지원합니다.
- 계층 구조 API는 페이지를 매긴 GET 작업 및 일괄 처리 CREATE, READ, UPDATE 및 DELETE 작업을 지원합니다.
- Type API는 페이지를 매긴 GET 작업 및 일괄 처리 CREATE, READ, UPDATE 및 DELETE 작업을 지원합니다.
네 번째 API는 시계열 모델 설정에 대한 REST 지원을 제공합니다.
- 모델 설정 API는 시계열 모델 구성 설정에 대한 HTTP GET 및 UPDATE 작업을 지원합니다. 시계열 모델 및 instance, 계층 구조 및 형식 정의에 대한 자세한 내용은 시계열 모델을 참조하세요.
인스턴스 API
인스턴스 API를 사용하면 TIME Series Instances에서 CREATE, READ, UPDATE 및 DELETE 작업을 수행할 수 있습니다.
인스턴스 가져오기 API는 요청과 일치하는 모든 시계열 인스턴스를 반환합니다.
인스턴스 관리 API를 사용하면 인스턴스에서 일괄 처리 작업을 수행할 수 있습니다. 이 API에 대한 모든 작업은 HTTP POST 작업입니다. 각 작업은 페이로드를 허용합니다. 페이로드는 JSON 개체입니다. 이 개체는 단일 속성을 정의합니다. 속성 키는 API에서 허용하는 작업의 이름입니다. 지원되는 작업은 PUT, UPDATE 및 DELETE입니다.
이러한 API를 사용하면 시계열 인스턴스를 검색할 수 있습니다.
팁
아래 의 검색 쿼리 기능에 대해 읽어보세요.
계층 구조 API
계층 API를 사용하면 시계열 계층 구조에서 CREATE, READ, UPDATE 및 DELETE를 사용할 수 있습니다.
| API | 설명 |
|---|---|
| 계층 API 가져오기 | 요청과 일치하는 모든 시계열 계층 구조를 반환합니다. |
| 계층 API 관리 | 계층 구조에서 일괄 처리 작업을 사용하도록 설정합니다. 이 API에 대한 모든 작업은 HTTP POST 작업입니다. 각 작업은 페이로드를 허용합니다. 페이로드는 JSON 개체입니다. 이 개체는 단일 속성을 정의합니다. 속성 키는 API에서 허용하는 작업의 이름입니다. 지원되는 작업은 PUT, UPDATE 및 DELETE입니다. |
형식 API
형식 API를 사용하면 시계열 형식 및 관련 변수에서 CREATE, READ, UPDATE 및 DELETE를 사용할 수 있습니다.
| API | 설명 |
|---|---|
| 형식 API 가져오기 | 모든 시계열 형식 및 관련 변수를 반환합니다. |
| 게시물 형식 API | 형식에 대한 일괄 처리 작업을 사용하도록 설정합니다. 이 API에 대한 모든 작업은 HTTP POST 작업입니다. 각 작업은 페이로드를 허용합니다. 페이로드는 JSON 개체입니다. 이 개체는 단일 속성을 정의합니다. 속성 키는 API에서 허용하는 작업의 이름입니다. 지원되는 작업은 PUT, UPDATE 및 DELETE입니다. |
모델 설정 API
모델 설정 API를 사용하면 TimeSeriesIds를 통해 환경에서 자동으로 생성된 모델에서 CREATE, READ, UPDATE 및 DELETE를 사용할 수 있습니다.
| API | 설명 |
|---|---|
| 모델 설정 가져오기 API | TimeSeriesIds에 대한 환경에서 자동 생성된 모델을 반환합니다. |
| 모델 설정 업데이트 API | TimeSeriesIds 환경의 모델을 요청에 제공된 새 값으로 업데이트. |
검색 기능
와일드카드 검색
단일 용어(구 검색 내 아님) 내에서 단일 및 여러 문자 와일드카드 검색을 지원합니다.
단일 문자
단일 문자 와일드카드 검색을 수행하려면 기호를 ? 사용합니다. 단일 문자 와일드카드 검색은 문자열이 대체된 단일 문자와 일치하는 용어를 찾습니다.
또는 test를 text 검색하려면 를 검색합니다te?t.
여러 문자
여러 문자 와일드카드 검색을 수행하려면 기호를 * 사용합니다. 여러 문자 와일드카드 검색은 0개 이상의 문자를 찾습니다.
, tests또는 tester를 검색test하려면 검색test*을 사용합니다.
용어 중간에 와일드카드 검색을 사용할 수도 있습니다. 를 dryer검색하려면 검색 dr*r을 사용할 수 있습니다.
부울 연산자
부울 연산자는 논리 연산자를 통해 용어를 결합할 수 있습니다. AND, OR, +, 및 -NOT을 부울 연산자로 지원합니다.
중요
- 부울 연산자는 ALL CAPS에 있어야 합니다.
- 부울 연산자는 공백을 사용하여 검색 절과 분리되어야 합니다.
dryer AND washer는 유효하지만 은 유효하지 않습니다dryer ANDwasher.
AND 연산자
AND 연산자는 두 용어가 모두 단일 문서의 텍스트에 있는 문서와 일치합니다.
를 포함하고 dryer washerfoo bar 검색을 사용하는 문서를 검색 dryer washer AND foo bar하려면 입니다.
참고
기호 && 는 연산자 AND 대신 사용할 수 있습니다.
OR 연산자
OR 연산자는 두 용어를 연결하고 문서에 두 용어 중 하나가 있는 경우 일치하는 문서를 찾습니다. OR 연산자는 기본 결합 연산자입니다. 즉, 두 용어 사이에 부울 연산자가 없으면 OR 연산자가 사용됩니다.
다음 검색 중 하나를 dryer washer 사용하거나 dryer 포함하는 문서를 검색하려면 다음 검색 중 하나를 사용합니다.
'dryer washer' dryer'dryer washer' OR dryer
참고
기호 || 는 연산자 OR 대신 사용할 수 있습니다.
+ 연산자
+ 또는 필수 연산자는 기호 뒤의 용어가 + 단일 문서의 필드 어딘가에 있어야 합니다.
포함 dryer 해야 하고 포함 washer 할 수 있는 문서를 검색하려면 검색 +dryer washer을 사용합니다.
- 연산자
- 또는 금지 연산자는 기호 뒤 - 의 용어가 포함된 문서를 제외합니다.
를 포함 dryer washer 하지만 사용하지 않는 foo bar 문서를 검색하려면 다음 dryer washer -foo bar을 수행합니다.
NOT
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 요청 및 응답 테스트를 지원하는 도구는 다음과 같습니다.
Fiddler. 이 무료 웹 디버깅 프록시는 REST 요청을 가로챌 수 있으므로 HTTP 요청 및 응답 메시지를 진단할 수 있습니다.
JWT.io. 이 도구를 사용하여 전달자 토큰에서 클레임을 신속하게 덤프한 다음 해당 콘텐츠의 유효성을 검사할 수 있습니다.
우체부. REST API를 디버깅하기 위한 무료 HTTP 요청 및 응답 테스트 도구입니다.
Gen2 설명서를 검토하여 Azure Time Series Insights Gen2에 대해 자세히 알아보세요.