Query - Get Event Schema

リファレンス

サービス:: Time Series Insights

API バージョン:: 2020-07-31

特定の検索範囲の環境イベントスキーマを返します。イベントスキーマは、一連のプロパティ定義です。プロパティが多すぎる場合、イベントスキーマにすべての永続化プロパティが含まれていない場合があります。

POST https://{environmentFqdn}/eventSchema?api-version=2020-07-31

省略可能なパラメーターを含む:

POST https://{environmentFqdn}/eventSchema?api-version=2020-07-31&storeType={storeType}

URI パラメーター

名前	/	必須	型	説明
environmentFqdn	path	True	string	環境ごとの FQDN (たとえば、10000000-0000-0000-0000-100000000109.env.timeseries.azure.com)。このドメイン名は、Get Environments API、Azure portal、または Azure Resource Manager の応答から取得できます。
api-version	query	True	string	クライアント要求で使用する API のバージョン。現在サポートされているバージョンは "2020-07-31" です。
storeType	query		string	ウォームストアが有効になっている環境の場合、クエリは "WarmStore" または "ColdStore" で実行できます。クエリ内のこのパラメーターは、クエリを実行する必要があるストアを定義します。定義されていない場合は、コールドストアでクエリが実行されます。

要求ヘッダー

名前	必須	型	説明
x-ms-client-request-id		string	オプションのクライアント要求 ID。サービスはこの値を記録します。サービスがサービス間で操作をトレースできるようにし、顧客が特定の要求に関してサポートに連絡できるようにします。
x-ms-client-session-id		string	オプションのクライアントセッション ID。サービスはこの値を記録します。サービスがサービス間で関連する操作のグループをトレースできるようにし、顧客が特定の要求グループに関するサポートに問い合わせることができます。

要求本文

名前	必須	型	説明
searchSpan	True	DateTimeRange	クエリが実行される時間の範囲。 null にすることはできません。

応答

名前	型	説明
200 OK	EventSchema	正常な操作。ヘッダー x-ms-request-id: string
Other Status Codes	TsiError	予期しないエラー。ヘッダー x-ms-request-id: string

名前

型

説明

200 OK

EventSchema

正常な操作。

ヘッダー

x-ms-request-id: string

Other Status Codes

TsiError

予期しないエラー。

ヘッダー

x-ms-request-id: string

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

ColdStoreEventSchemaGet

EventSchemaGet

EventSchemaGetEmpty

WarmStoreEventSchemaGet

ColdStoreEventSchemaGet

要求のサンプル

HTTP

POST https://10000000-0000-0000-0000-100000000109.env.timeseries.azure.com/eventSchema?api-version=2020-07-31&storeType=coldstore

{
  "searchSpan": {
    "from": "2018-08-01T00:00:00.000Z",
    "to": "2018-08-31T00:00:00.000Z"
  }
}

応答のサンプル

状態コード:: 200

{
  "properties": [
    {
      "name": "Building",
      "type": "String"
    },
    {
      "name": "Room",
      "type": "String"
    },
    {
      "name": "DeviceId",
      "type": "Double"
    },
    {
      "name": "Temperature",
      "type": "Double"
    },
    {
      "name": "Pressure",
      "type": "Double"
    },
    {
      "name": "Status",
      "type": "String"
    }
  ]
}

EventSchemaGet

要求のサンプル

HTTP

POST https://10000000-0000-0000-0000-100000000109.env.timeseries.azure.com/eventSchema?api-version=2020-07-31

{
  "searchSpan": {
    "from": "2018-08-01T00:00:00.000Z",
    "to": "2018-08-31T00:00:00.000Z"
  }
}

応答のサンプル

状態コード:: 200

{
  "properties": [
    {
      "name": "Building",
      "type": "String"
    },
    {
      "name": "Room",
      "type": "String"
    },
    {
      "name": "DeviceId",
      "type": "Double"
    },
    {
      "name": "Temperature",
      "type": "Double"
    },
    {
      "name": "Pressure",
      "type": "Double"
    },
    {
      "name": "Status",
      "type": "String"
    }
  ]
}

EventSchemaGetEmpty

要求のサンプル

HTTP

POST https://10000000-0000-0000-0000-100000000109.env.timeseries.azure.com/eventSchema?api-version=2020-07-31

{
  "searchSpan": {
    "from": "2016-08-01T00:00:00.000Z",
    "to": "2016-08-31T00:00:00.000Z"
  }
}

応答のサンプル

状態コード:: 200

{
  "properties": []
}

WarmStoreEventSchemaGet

要求のサンプル

HTTP

POST https://10000000-0000-0000-0000-100000000109.env.timeseries.azure.com/eventSchema?api-version=2020-07-31&storeType=warmstore

{
  "searchSpan": {
    "from": "2018-08-01T00:00:00.000Z",
    "to": "2018-08-31T00:00:00.000Z"
  }
}

応答のサンプル

状態コード:: 200

{
  "properties": [
    {
      "name": "Building",
      "type": "String"
    },
    {
      "name": "Room",
      "type": "String"
    },
    {
      "name": "DeviceId",
      "type": "Double"
    },
    {
      "name": "Temperature",
      "type": "Double"
    },
    {
      "name": "Pressure",
      "type": "Double"
    },
    {
      "name": "Status",
      "type": "String"
    }
  ]
}

定義

名前	説明
DateTimeRange	時間の範囲。 null または負の値にすることはできません。
EventProperty	格納または計算されるイベントのプロパティ。プロパティは、名前と型の両方で識別されます。異なるイベントは、同じ名前のプロパティを持つことができますが、型は異なります。
EventSchema	特定の検索スパン内のすべてのイベントのイベントスキーマ。イベントスキーマは、一連のプロパティ定義です。プロパティは、名前と型の両方で識別されます。異なるイベントは、同じ名前のプロパティを持つことができますが、型は異なります。プロパティが多すぎる場合、イベントスキーマにすべての永続化プロパティが含まれていない場合があります。
GetEventSchemaRequest	特定の検索スパン内のすべてのイベントのイベントスキーマを取得する要求。
PropertyTypes	プロパティの型。
TsiError	API エラーに関する情報。
TsiErrorBody	エラーコードとメッセージを含む特定の API エラー。
TsiErrorDetails	追加のエラー情報。

DateTimeRange

Object

時間の範囲。 null または負の値にすることはできません。

名前	型	説明
from	string (date-time)	時間範囲の開始タイムスタンプ。開始タイムスタンプは、時系列クエリ要求で使用される場合に含まれます。このタイムスタンプを持つイベントが含まれます。
to	string (date-time)	時間範囲の終了タイムスタンプ。終了タイムスタンプは、時系列クエリ要求で使用される場合は排他的です。このタイムスタンプに一致するイベントは除外されます。 Get Availability によって返された場合、終了タイムスタンプは包括的であることに注意してください (つまり、この正確な "to" タイムスタンプを持つイベントがあることを意味します)。

EventProperty

Object

格納または計算されるイベントのプロパティ。プロパティは、名前と型の両方で識別されます。異なるイベントは、同じ名前のプロパティを持つことができますが、型は異なります。

名前	型	説明
name	string	プロパティの名前。
type	PropertyTypes	プロパティの型。

EventSchema

Object

特定の検索スパン内のすべてのイベントのイベントスキーマ。イベントスキーマは、一連のプロパティ定義です。プロパティは、名前と型の両方で識別されます。異なるイベントは、同じ名前のプロパティを持つことができますが、型は異なります。プロパティが多すぎる場合、イベントスキーマにすべての永続化プロパティが含まれていない場合があります。

名前	型	説明
properties	EventProperty[]	プロパティ定義のセット。環境にデータがない場合、返される配列は空です。

GetEventSchemaRequest

Object

特定の検索スパン内のすべてのイベントのイベントスキーマを取得する要求。

名前	型	説明
searchSpan	DateTimeRange	クエリが実行される時間の範囲。 null にすることはできません。

PropertyTypes

列挙

プロパティの型。

値	説明
Bool
DateTime
Double
Long
String
TimeSpan

TsiError

Object

API エラーに関する情報。

名前	型	説明
error	TsiErrorBody	エラーコードとメッセージを含む特定の API エラー。

TsiErrorBody

Object

エラーコードとメッセージを含む特定の API エラー。

名前	型	説明
code	string	サービス固有のエラーコードを定義する、言語に依存しない人間が判読できる文字列。このコードは、応答で指定された HTTP エラーコードのより具体的なインジケーターとして機能します。特定のエラーケースをプログラムで処理するために使用できます。
details	TsiErrorDetails[]	追加のエラー情報が含まれています。 null を指定できます。
innerError	TsiErrorBody	原因を絞り込む、より具体的なエラーが含まれています。 null を指定できます。
message	string	エラーの人間が判読できる、言語に依存しない表現。これは開発者の支援を目的としており、エンドユーザーへの公開には適していません。
target	string	特定のエラーのターゲット (たとえば、エラーのプロパティの名前)。 null を指定できます。

TsiErrorDetails

Object

追加のエラー情報。

名前	型	説明
code	string	サービス固有のエラーコードを定義する、言語に依存しない人間が判読できる文字列。このコードは、応答で指定された HTTP エラーコードのより具体的なインジケーターとして機能します。特定のエラーケースをプログラムで処理するために使用できます。
message	string	エラーの人間が判読できる、言語に依存しない表現。これは開発者の支援を目的としており、エンドユーザーへの公開には適していません。

次の方法で共有

Query - Get Event Schema

URI パラメーター

要求ヘッダー

要求本文

応答

セキュリティ

azure_auth

スコープ

例

ColdStoreEventSchemaGet

要求のサンプル

応答のサンプル

EventSchemaGet

要求のサンプル

応答のサンプル

EventSchemaGetEmpty

要求のサンプル

応答のサンプル

WarmStoreEventSchemaGet

要求のサンプル

応答のサンプル

定義

DateTimeRange

EventProperty

EventSchema

GetEventSchemaRequest

PropertyTypes

TsiError

TsiErrorBody

TsiErrorDetails