Share via

Query - Execute

  • Odwołanie
Service:
Time Series Insights
API Version:
2020-07-31

Wykonuje zapytanie szeregów czasowych na stronach wyników — pobieranie zdarzeń, pobieranie serii lub agregacji serii.

POST https://{environmentFqdn}/timeseries/query?api-version=2020-07-31
With optional parameters: 
POST https://{environmentFqdn}/timeseries/query?api-version=2020-07-31&storeType={storeType}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
environmentFqdn
 path True

string

Na nazwę FQDN środowiska, na przykład 10000000-0000-0000-0000-100000000109.env.timeseries.azure.com. Tę nazwę domeny można uzyskać z odpowiedzi interfejsu API pobierania środowisk, Azure Portal lub usługi Azure Resource Manager.
api-version
 query True

string

Wersja interfejsu API do użycia z żądaniem klienta. Obecnie obsługiwana wersja to "2020-07-31".
storeType
 query

string

W środowiskach z włączonym ciepłym magazynem można wykonać zapytanie w magazynie "WarmStore" lub "ColdStore". Ten parametr w zapytaniu definiuje, w którym magazynie ma być wykonywane zapytanie. Jeśli nie zostanie zdefiniowana, zapytanie zostanie wykonane w magazynie zimnym.

Nagłówek żądania

Nazwa Wymagane Typ Opis
x-ms-continuation

string

Token kontynuacji z poprzedniej strony wyników, aby pobrać następną stronę wyników w wywołaniach obsługujących stronicowanie. Aby uzyskać wyniki pierwszej strony, określ token kontynuacji o wartości null jako wartość parametru. Zwrócony token kontynuacji ma wartość null, jeśli wszystkie wyniki zostały zwrócone i nie ma następnej strony wyników.
x-ms-client-request-id

string

Opcjonalny identyfikator żądania klienta. Usługa rejestruje tę wartość. Umożliwia usłudze śledzenie operacji między usługami i umożliwia klientowi kontaktowanie się z pomocą techniczną dotyczącą konkretnego żądania.
x-ms-client-session-id

string

Opcjonalny identyfikator sesji klienta. Usługa rejestruje tę wartość. Umożliwia usłudze śledzenie grupy powiązanych operacji w usługach i umożliwia klientowi kontaktowanie się z pomocą techniczną w odniesieniu do określonej grupy żądań.

Treść żądania

Nazwa Typ Opis
aggregateSeries

AggregateSeries

Zapytanie agregacji serii. Umożliwia obliczenie zagregowanych szeregów czasowych z zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.
getEvents

GetEvents

Pobierz zapytanie o zdarzenia. Umożliwia pobieranie nieprzetworzonych zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.
getSeries

GetSeries

Pobierz zapytanie serii. Umożliwia pobranie szeregów czasowych obliczonych wartości zmiennych z zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.

Odpowiedzi

Nazwa Typ Opis
200 OK

QueryResultPage

Pomyślne zapytanie.

Headers

x-ms-request-id: string
Other Status Codes

TsiError

Nieoczekiwany błąd.

Headers

x-ms-request-id: string

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

ColdStoreQueryAggregateSeriesPage1
ColdStoreQueryAggregateSeriesPage2
ColdStoreQueryGetEventsPage1
ColdStoreQueryGetEventsPage2
ColdStoreQueryGetEventsPage3
ColdStoreQueryGetEventsPage4
ColdStoreQueryGetSeriesPage1
ColdStoreQueryGetSeriesPage2
ColdStoreQueryGetSeriesPage3
QueryAggregateSeriesPage1
QueryAggregateSeriesPage2
QueryAggregateSeriesWithCategoricalInterpolatedVariable
QueryAggregateSeriesWithCategoricalVariable
QueryAggregateSeriesWithSampleInterpolation
QueryGetEventsPage1
QueryGetEventsPage2
QueryGetEventsPage3
QueryGetEventsPage4
QueryGetEventsWithTakePage1
QueryGetEventsWithTakePage2
QueryGetSeriesPage1
QueryGetSeriesPage2
QueryGetSeriesPage3
QueryGetSeriesWithTakePage1
QueryGetSeriesWithTakePage2
WarmStoreQueryAggregateSeriesPage
WarmStoreQueryGetEventsPage1
WarmStoreQueryGetEventsPage2
WarmStoreQueryGetEventsPage3
WarmStoreQueryGetEventsPage4
WarmStoreQueryGetSeriesPage1
WarmStoreQueryGetSeriesPage2
WarmStoreQueryGetSeriesPage3

ColdStoreQueryAggregateSeriesPage1

Sample Request

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

{
  "aggregateSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "interval": "PT1M",
    "inlineVariables": {
      "Count": {
        "kind": "aggregate",
        "filter": null,
        "aggregation": {
          "tsx": "count()"
        }
      },
      "MinTemperature": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "min($value)"
        }
      },
      "MaxTemperature": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "max($value)"
        }
      }
    },
    "projectedVariables": [
      "Count",
      "MinTemperature",
      "MaxTemperature"
    ]
  }
}

Sample Response

Status code:
200 
{
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAwMCwidGFrZSI6MTAwMH0="
}

ColdStoreQueryAggregateSeriesPage2

Sample Request

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

{
  "aggregateSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "interval": "PT1M",
    "inlineVariables": {
      "Count": {
        "kind": "aggregate",
        "filter": null,
        "aggregation": {
          "tsx": "count()"
        }
      },
      "MinTemperature": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "min($value)"
        }
      },
      "MaxTemperature": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "max($value)"
        }
      }
    },
    "projectedVariables": [
      "Count",
      "MinTemperature",
      "MaxTemperature"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:00Z",
    "2016-08-01T00:01:00Z",
    "2016-08-01T00:02:00Z",
    "2016-08-01T00:03:00Z",
    "2016-08-01T00:04:00Z",
    "2016-08-01T00:05:00Z",
    "2016-08-01T00:06:00Z",
    "2016-08-01T00:07:00Z",
    "2016-08-01T00:08:00Z",
    "2016-08-01T00:09:00Z",
    "2016-08-01T00:10:00Z"
  ],
  "properties": [
    {
      "name": "Count",
      "type": "Long",
      "values": [
        50,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        null
      ]
    },
    {
      "name": "AverageTemperature",
      "type": "Double",
      "values": [
        71.25,
        85,
        82.5,
        80,
        89.16666666666667,
        75,
        90,
        75.83333333333333,
        85,
        82.5,
        null
      ]
    },
    {
      "name": "MinTemperature",
      "type": "Double",
      "values": [
        65.125,
        77.625,
        65.125,
        72.625,
        65.125,
        67.625,
        82.625,
        65.125,
        77.625,
        65.125,
        null
      ]
    },
    {
      "name": "MaxTemperature",
      "type": "Double",
      "values": [
        77.375,
        92.375,
        99.875,
        87.375,
        99.875,
        82.375,
        97.375,
        99.875,
        92.375,
        99.875,
        null
      ]
    }
  ],
  "progress": 100
}

ColdStoreQueryGetEventsPage1

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAwMCwidGFrZSI6MTAwMH0="
}

ColdStoreQueryGetEventsPage2

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:10Z",
    "2016-08-01T00:00:11Z",
    "2016-08-01T00:00:12Z",
    "2016-08-01T00:00:13Z",
    "2016-08-01T00:00:14Z",
    "2016-08-01T00:00:15Z",
    "2016-08-01T00:00:16Z",
    "2016-08-01T00:00:17Z",
    "2016-08-01T00:00:18Z",
    "2016-08-01T00:00:19Z"
  ],
  "properties": [
    {
      "name": "Building",
      "type": "String",
      "values": [
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium"
      ]
    },
    {
      "name": "Temperature",
      "type": "Double",
      "values": [
        65.125,
        65.375,
        65.625,
        65.875,
        66.125,
        66.375,
        66.625,
        66.875,
        67.125,
        67.375
      ]
    }
  ],
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAxYZwidGFrZSI6MTAwMH0="
}

ColdStoreQueryGetEventsPage3

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:20Z"
  ],
  "properties": [
    {
      "name": "Building",
      "type": "String",
      "values": [
        "Millenium"
      ]
    },
    {
      "name": "Temperature",
      "type": "Double",
      "values": [
        67.575
      ]
    }
  ],
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAbCDewidGFrZSI6MTAwMH0="
}

ColdStoreQueryGetEventsPage4

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [],
  "properties": [],
  "progress": 100
}

ColdStoreQueryGetSeriesPage1

Sample Request

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

{
  "getSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": null,
    "inlineVariables": {
      "temperatures": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "avg($value)"
        }
      }
    },
    "projectedVariables": [
      "temperatures"
    ]
  }
}

Sample Response

Status code:
200 
{
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAwMCwidGFrZSI6MTAwMH0="
}

ColdStoreQueryGetSeriesPage2

Sample Request

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

{
  "getSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": null,
    "inlineVariables": {
      "temperatures": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "avg($value)"
        }
      }
    },
    "projectedVariables": [
      "temperatures"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:10Z",
    "2016-08-01T00:00:11Z",
    "2016-08-01T00:00:12Z",
    "2016-08-01T00:00:13Z",
    "2016-08-01T00:00:14Z",
    "2016-08-01T00:00:15Z",
    "2016-08-01T00:00:16Z",
    "2016-08-01T00:00:17Z",
    "2016-08-01T00:00:18Z",
    "2016-08-01T00:00:19Z",
    "2016-08-01T00:00:20Z"
  ],
  "properties": [
    {
      "name": "temperatures",
      "type": "Double",
      "values": [
        65.125,
        65.375,
        65.625,
        65.875,
        66.125,
        66.375,
        66.625,
        66.875,
        67.125,
        67.375,
        67.625
      ]
    }
  ],
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAxYZwidGFrZSI6MTAwMH0="
}

ColdStoreQueryGetSeriesPage3

Sample Request

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

{
  "getSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": null,
    "inlineVariables": {
      "temperatures": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "avg($value)"
        }
      }
    },
    "projectedVariables": [
      "temperatures"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:21Z"
  ],
  "properties": [
    {
      "name": "temperatures",
      "type": "Double",
      "values": [
        67.825
      ]
    }
  ],
  "progress": 100
}

QueryAggregateSeriesPage1

Sample Request

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

{
  "aggregateSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "interval": "PT1M",
    "inlineVariables": {
      "Count": {
        "kind": "aggregate",
        "filter": null,
        "aggregation": {
          "tsx": "count()"
        }
      },
      "MinTemperature": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "min($value)"
        }
      },
      "MaxTemperature": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "max($value)"
        }
      }
    },
    "projectedVariables": [
      "Count",
      "MinTemperature",
      "MaxTemperature"
    ]
  }
}

Sample Response

Status code:
200 
{
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAwMCwidGFrZSI6MTAwMH0="
}

QueryAggregateSeriesPage2

Sample Request

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

{
  "aggregateSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "interval": "PT1M",
    "inlineVariables": {
      "Count": {
        "kind": "aggregate",
        "filter": null,
        "aggregation": {
          "tsx": "count()"
        }
      },
      "MinTemperature": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "min($value)"
        }
      },
      "MaxTemperature": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "max($value)"
        }
      }
    },
    "projectedVariables": [
      "Count",
      "MinTemperature",
      "MaxTemperature"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:00Z",
    "2016-08-01T00:01:00Z",
    "2016-08-01T00:02:00Z",
    "2016-08-01T00:03:00Z",
    "2016-08-01T00:04:00Z",
    "2016-08-01T00:05:00Z",
    "2016-08-01T00:06:00Z",
    "2016-08-01T00:07:00Z",
    "2016-08-01T00:08:00Z",
    "2016-08-01T00:09:00Z",
    "2016-08-01T00:10:00Z"
  ],
  "properties": [
    {
      "name": "Count",
      "type": "Long",
      "values": [
        50,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        null
      ]
    },
    {
      "name": "AverageTemperature",
      "type": "Double",
      "values": [
        71.25,
        85,
        82.5,
        80,
        89.16666666666667,
        75,
        90,
        75.83333333333333,
        85,
        82.5,
        null
      ]
    },
    {
      "name": "MinTemperature",
      "type": "Double",
      "values": [
        65.125,
        77.625,
        65.125,
        72.625,
        65.125,
        67.625,
        82.625,
        65.125,
        77.625,
        65.125,
        null
      ]
    },
    {
      "name": "MaxTemperature",
      "type": "Double",
      "values": [
        77.375,
        92.375,
        99.875,
        87.375,
        99.875,
        82.375,
        97.375,
        99.875,
        92.375,
        99.875,
        null
      ]
    }
  ],
  "progress": 100
}

QueryAggregateSeriesWithCategoricalInterpolatedVariable

Sample Request

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

{
  "aggregateSeries": {
    "searchSpan": {
      "from": "2019-10-10T23:41:04.021Z",
      "to": "2019-10-10T23:42:22.846Z"
    },
    "timeSeriesId": [
      "Sensor_58"
    ],
    "interval": "PT2S",
    "inlineVariables": {
      "Status_String": {
        "kind": "categorical",
        "value": {
          "tsx": "$event.[Status].String"
        },
        "interpolation": {
          "kind": "Step",
          "boundary": {
            "span": "PT5S"
          }
        },
        "categories": [
          {
            "label": "Good",
            "values": [
              "Good",
              "Very Good",
              "Excellent"
            ]
          },
          {
            "label": "Bad",
            "values": [
              "Bad",
              "OK"
            ]
          },
          {
            "label": "Other",
            "values": [
              "Other"
            ]
          }
        ],
        "defaultCategory": {
          "label": "Unknown"
        }
      },
      "Status_Long": {
        "kind": "categorical",
        "value": {
          "tsx": "tolong($event.[Status].Double)"
        },
        "interpolation": {
          "kind": "Step",
          "boundary": {
            "span": "PT5S"
          }
        },
        "categories": [
          {
            "label": "Good",
            "values": [
              0,
              1,
              2
            ]
          },
          {
            "label": "Bad",
            "values": [
              3,
              4
            ]
          },
          {
            "label": "Other",
            "values": [
              5
            ]
          }
        ],
        "defaultCategory": {
          "label": "Unknown"
        }
      }
    },
    "projectedVariables": [
      "Status_String",
      "Status_Long"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2019-10-10T23:41:04Z",
    "2019-10-10T23:41:06Z",
    "2019-10-10T23:41:08Z",
    "2019-10-10T23:41:10Z",
    "2019-10-10T23:41:12Z",
    "2019-10-10T23:41:14Z",
    "2019-10-10T23:41:16Z",
    "2019-10-10T23:41:18Z",
    "2019-10-10T23:41:20Z",
    "2019-10-10T23:41:22Z"
  ],
  "properties": [
    {
      "values": [
        0.203,
        0.141,
        0.268,
        0.398,
        0.402,
        0.047,
        0.1245,
        0.75,
        0.206,
        0.2635
      ],
      "name": "Status_String[Good]",
      "type": "Double"
    },
    {
      "values": [
        0.266,
        0.1955,
        0.242,
        0.148,
        0.25,
        0.055,
        0.6295,
        0.109,
        0.41,
        0.2125
      ],
      "name": "Status_String[Bad]",
      "type": "Double"
    },
    {
      "values": [
        0.5205,
        0.6635,
        0.49,
        0.454,
        0.348,
        0.898,
        0.246,
        0.141,
        0.384,
        0.524
      ],
      "name": "Status_String[Other]",
      "type": "Double"
    },
    {
      "values": [
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0
      ],
      "name": "Status_String[Unknown]",
      "type": "Double"
    },
    {
      "values": [
        0.203,
        0.141,
        0.268,
        0.398,
        0.402,
        0.047,
        0.1245,
        0.75,
        0.206,
        0.2635
      ],
      "name": "Status_Long[Good]",
      "type": "Double"
    },
    {
      "values": [
        0.266,
        0.1955,
        0.242,
        0.148,
        0.25,
        0.055,
        0.6295,
        0.109,
        0.41,
        0.2125
      ],
      "name": "Status_Long[Bad]",
      "type": "Double"
    },
    {
      "values": [
        0.5205,
        0.6635,
        0.49,
        0.454,
        0.348,
        0.898,
        0.246,
        0.141,
        0.384,
        0.524
      ],
      "name": "Status_Long[Other]",
      "type": "Double"
    },
    {
      "values": [
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0
      ],
      "name": "Status_Long[Unknown]",
      "type": "Double"
    }
  ],
  "progress": 100
}

QueryAggregateSeriesWithCategoricalVariable

Sample Request

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

{
  "aggregateSeries": {
    "searchSpan": {
      "from": "2019-10-10T23:42:00.000Z",
      "to": "2019-10-10T23:42:20.000Z"
    },
    "timeSeriesId": [
      "Sensor_58"
    ],
    "interval": "PT2S",
    "inlineVariables": {
      "Status_String": {
        "kind": "categorical",
        "value": {
          "tsx": "$event.[Status].String"
        },
        "categories": [
          {
            "label": "Good",
            "values": [
              "Good",
              "Very Good",
              "Excellent"
            ]
          },
          {
            "label": "Bad",
            "values": [
              "Bad",
              "OK"
            ]
          },
          {
            "label": "Other",
            "values": [
              "Other"
            ]
          }
        ],
        "defaultCategory": {
          "label": "Unknown"
        }
      },
      "Status_Long": {
        "kind": "categorical",
        "value": {
          "tsx": "tolong($event.[Status].Double)"
        },
        "categories": [
          {
            "label": "Good",
            "values": [
              0,
              1,
              2
            ]
          },
          {
            "label": "Bad",
            "values": [
              3,
              4
            ]
          },
          {
            "label": "Other",
            "values": [
              5
            ]
          }
        ],
        "defaultCategory": {
          "label": "Unknown"
        }
      }
    },
    "projectedVariables": [
      "Status_String",
      "Status_Long"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2019-10-10T23:42:00Z",
    "2019-10-10T23:42:02Z",
    "2019-10-10T23:42:04Z",
    "2019-10-10T23:42:06Z",
    "2019-10-10T23:42:08Z",
    "2019-10-10T23:42:10Z",
    "2019-10-10T23:42:12Z",
    "2019-10-10T23:42:14Z",
    "2019-10-10T23:42:16Z",
    "2019-10-10T23:42:18Z"
  ],
  "properties": [
    {
      "values": [
        5,
        8,
        4,
        6,
        9,
        8,
        3,
        6,
        5,
        8
      ],
      "name": "Status_String[Good]",
      "type": "Long"
    },
    {
      "values": [
        4,
        3,
        3,
        5,
        5,
        3,
        9,
        7,
        7,
        7
      ],
      "name": "Status_String[Bad]",
      "type": "Long"
    },
    {
      "values": [
        11,
        9,
        13,
        9,
        6,
        9,
        8,
        7,
        8,
        5
      ],
      "name": "Status_String[Other]",
      "type": "Long"
    },
    {
      "values": [
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0
      ],
      "name": "Status_String[Unknown]",
      "type": "Long"
    },
    {
      "values": [
        5,
        8,
        4,
        6,
        9,
        8,
        3,
        6,
        5,
        8
      ],
      "name": "Status_Long[Good]",
      "type": "Long"
    },
    {
      "values": [
        4,
        3,
        3,
        5,
        5,
        3,
        9,
        7,
        7,
        7
      ],
      "name": "Status_Long[Bad]",
      "type": "Long"
    },
    {
      "values": [
        11,
        9,
        13,
        9,
        6,
        9,
        8,
        7,
        8,
        5
      ],
      "name": "Status_Long[Other]",
      "type": "Long"
    },
    {
      "values": [
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0
      ],
      "name": "Status_Long[Unknown]",
      "type": "Long"
    }
  ],
  "progress": 100
}

QueryAggregateSeriesWithSampleInterpolation

Sample Request

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

{
  "aggregateSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "interval": "PT1M",
    "inlineVariables": {
      "LinearSampleInterpolation": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "interpolation": {
          "kind": "Linear",
          "boundary": {
            "span": "P1D"
          }
        },
        "aggregation": {
          "tsx": "left($value)"
        }
      },
      "StepSampleInterpolation": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "interpolation": {
          "kind": "Step",
          "boundary": {
            "span": "P1D"
          }
        },
        "aggregation": {
          "tsx": "left($value)"
        }
      }
    },
    "projectedVariables": [
      "LinearSampleInterpolation",
      "StepSampleInterpolation"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:00Z",
    "2016-08-01T00:01:00Z",
    "2016-08-01T00:02:00Z",
    "2016-08-01T00:03:00Z",
    "2016-08-01T00:04:00Z",
    "2016-08-01T00:05:00Z",
    "2016-08-01T00:06:00Z",
    "2016-08-01T00:07:00Z",
    "2016-08-01T00:08:00Z",
    "2016-08-01T00:09:00Z",
    "2016-08-01T00:10:00Z"
  ],
  "properties": [
    {
      "name": "LinearSampleInterpolation",
      "type": "Double",
      "values": [
        50,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        62
      ]
    },
    {
      "name": "StepSampleInterpolation",
      "type": "Double",
      "values": [
        71.25,
        85,
        82.5,
        80,
        89.16666666666667,
        75,
        90,
        75.83333333333333,
        85,
        82.5,
        84
      ]
    }
  ],
  "progress": 100
}

QueryGetEventsPage1

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAwMCwidGFrZSI6MTAwMH0="
}

QueryGetEventsPage2

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:10Z",
    "2016-08-01T00:00:11Z",
    "2016-08-01T00:00:12Z",
    "2016-08-01T00:00:13Z",
    "2016-08-01T00:00:14Z",
    "2016-08-01T00:00:15Z",
    "2016-08-01T00:00:16Z",
    "2016-08-01T00:00:17Z",
    "2016-08-01T00:00:18Z",
    "2016-08-01T00:00:19Z"
  ],
  "properties": [
    {
      "name": "Building",
      "type": "String",
      "values": [
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium"
      ]
    },
    {
      "name": "Temperature",
      "type": "Double",
      "values": [
        65.125,
        65.375,
        65.625,
        65.875,
        66.125,
        66.375,
        66.625,
        66.875,
        67.125,
        67.375
      ]
    }
  ],
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAxYZwidGFrZSI6MTAwMH0="
}

QueryGetEventsPage3

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:20Z"
  ],
  "properties": [
    {
      "name": "Building",
      "type": "String",
      "values": [
        "Millenium"
      ]
    },
    {
      "name": "Temperature",
      "type": "Double",
      "values": [
        67.575
      ]
    }
  ],
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAbCDewidGFrZSI6MTAwMH0="
}

QueryGetEventsPage4

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [],
  "properties": [],
  "progress": 100
}

QueryGetEventsWithTakePage1

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ],
    "take": 10
  }
}

Sample Response

Status code:
200 
{
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAwMCwidGFrZSI6MTAwMH0="
}

QueryGetEventsWithTakePage2

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ],
    "take": 10
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:10Z",
    "2016-08-01T00:00:11Z",
    "2016-08-01T00:00:12Z",
    "2016-08-01T00:00:13Z",
    "2016-08-01T00:00:14Z",
    "2016-08-01T00:00:15Z",
    "2016-08-01T00:00:16Z",
    "2016-08-01T00:00:17Z",
    "2016-08-01T00:00:18Z",
    "2016-08-01T00:00:19Z"
  ],
  "properties": [
    {
      "name": "Building",
      "type": "String",
      "values": [
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium"
      ]
    },
    {
      "name": "Temperature",
      "type": "Double",
      "values": [
        65.125,
        65.375,
        65.625,
        65.875,
        66.125,
        66.375,
        66.625,
        66.875,
        67.125,
        67.375
      ]
    }
  ],
  "progress": 100
}

QueryGetSeriesPage1

Sample Request

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

{
  "getSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": null,
    "inlineVariables": {
      "temperatures": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "avg($value)"
        }
      }
    },
    "projectedVariables": [
      "temperatures"
    ]
  }
}

Sample Response

Status code:
200 
{
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAwMCwidGFrZSI6MTAwMH0="
}

QueryGetSeriesPage2

Sample Request

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

{
  "getSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": null,
    "inlineVariables": {
      "temperatures": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "avg($value)"
        }
      }
    },
    "projectedVariables": [
      "temperatures"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:10Z",
    "2016-08-01T00:00:11Z",
    "2016-08-01T00:00:12Z",
    "2016-08-01T00:00:13Z",
    "2016-08-01T00:00:14Z",
    "2016-08-01T00:00:15Z",
    "2016-08-01T00:00:16Z",
    "2016-08-01T00:00:17Z",
    "2016-08-01T00:00:18Z",
    "2016-08-01T00:00:19Z",
    "2016-08-01T00:00:20Z"
  ],
  "properties": [
    {
      "name": "temperatures",
      "type": "Double",
      "values": [
        65.125,
        65.375,
        65.625,
        65.875,
        66.125,
        66.375,
        66.625,
        66.875,
        67.125,
        67.375,
        67.625
      ]
    }
  ],
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAxYZwidGFrZSI6MTAwMH0="
}

QueryGetSeriesPage3

Sample Request

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

{
  "getSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": null,
    "inlineVariables": {
      "temperatures": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "avg($value)"
        }
      }
    },
    "projectedVariables": [
      "temperatures"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:21Z"
  ],
  "properties": [
    {
      "name": "temperatures",
      "type": "Double",
      "values": [
        67.825
      ]
    }
  ],
  "progress": 100
}

QueryGetSeriesWithTakePage1

Sample Request

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

{
  "getSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": null,
    "inlineVariables": {
      "temperatures": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "avg($value)"
        }
      }
    },
    "projectedVariables": [
      "temperatures"
    ],
    "take": 10
  }
}

Sample Response

Status code:
200 
{
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAwMCwidGFrZSI6MTAwMH0="
}

QueryGetSeriesWithTakePage2

Sample Request

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

{
  "getSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": null,
    "inlineVariables": {
      "temperatures": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "avg($value)"
        }
      }
    },
    "projectedVariables": [
      "temperatures"
    ],
    "take": 10
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:10Z",
    "2016-08-01T00:00:11Z",
    "2016-08-01T00:00:12Z",
    "2016-08-01T00:00:13Z",
    "2016-08-01T00:00:14Z",
    "2016-08-01T00:00:15Z",
    "2016-08-01T00:00:16Z",
    "2016-08-01T00:00:17Z",
    "2016-08-01T00:00:18Z",
    "2016-08-01T00:00:19Z",
    "2016-08-01T00:00:20Z"
  ],
  "properties": [
    {
      "name": "temperatures",
      "type": "Double",
      "values": [
        65.125,
        65.375,
        65.625,
        65.875,
        66.125,
        66.375,
        66.625,
        66.875,
        67.125,
        67.375,
        67.625
      ]
    }
  ],
  "progress": 100
}

WarmStoreQueryAggregateSeriesPage

Sample Request

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

{
  "aggregateSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "interval": "PT1M",
    "inlineVariables": {
      "Count": {
        "kind": "aggregate",
        "filter": null,
        "aggregation": {
          "tsx": "count()"
        }
      },
      "MinTemperature": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "min($value)"
        }
      },
      "MaxTemperature": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "max($value)"
        }
      }
    },
    "projectedVariables": [
      "Count",
      "MinTemperature",
      "MaxTemperature"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:00Z",
    "2016-08-01T00:01:00Z",
    "2016-08-01T00:02:00Z",
    "2016-08-01T00:03:00Z",
    "2016-08-01T00:04:00Z",
    "2016-08-01T00:05:00Z",
    "2016-08-01T00:06:00Z",
    "2016-08-01T00:07:00Z",
    "2016-08-01T00:08:00Z",
    "2016-08-01T00:09:00Z",
    "2016-08-01T00:10:00Z"
  ],
  "properties": [
    {
      "name": "Count",
      "type": "Long",
      "values": [
        50,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        60,
        null
      ]
    },
    {
      "name": "AverageTemperature",
      "type": "Double",
      "values": [
        71.25,
        85,
        82.5,
        80,
        89.16666666666667,
        75,
        90,
        75.83333333333333,
        85,
        82.5,
        null
      ]
    },
    {
      "name": "MinTemperature",
      "type": "Double",
      "values": [
        65.125,
        77.625,
        65.125,
        72.625,
        65.125,
        67.625,
        82.625,
        65.125,
        77.625,
        65.125,
        null
      ]
    },
    {
      "name": "MaxTemperature",
      "type": "Double",
      "values": [
        77.375,
        92.375,
        99.875,
        87.375,
        99.875,
        82.375,
        97.375,
        99.875,
        92.375,
        99.875,
        null
      ]
    }
  ],
  "progress": 100
}

WarmStoreQueryGetEventsPage1

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAwMCwidGFrZSI6MTAwMH0="
}

WarmStoreQueryGetEventsPage2

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:10Z",
    "2016-08-01T00:00:11Z",
    "2016-08-01T00:00:12Z",
    "2016-08-01T00:00:13Z",
    "2016-08-01T00:00:14Z",
    "2016-08-01T00:00:15Z",
    "2016-08-01T00:00:16Z",
    "2016-08-01T00:00:17Z",
    "2016-08-01T00:00:18Z",
    "2016-08-01T00:00:19Z"
  ],
  "properties": [
    {
      "name": "Building",
      "type": "String",
      "values": [
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium",
        "Millenium"
      ]
    },
    {
      "name": "Temperature",
      "type": "Double",
      "values": [
        65.125,
        65.375,
        65.625,
        65.875,
        66.125,
        66.375,
        66.625,
        66.875,
        67.125,
        67.375
      ]
    }
  ],
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAxYZwidGFrZSI6MTAwMH0="
}

WarmStoreQueryGetEventsPage3

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:20Z"
  ],
  "properties": [
    {
      "name": "Building",
      "type": "String",
      "values": [
        "Millenium"
      ]
    },
    {
      "name": "Temperature",
      "type": "Double",
      "values": [
        67.575
      ]
    }
  ],
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAbCDewidGFrZSI6MTAwMH0="
}

WarmStoreQueryGetEventsPage4

Sample Request

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

{
  "getEvents": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": {
      "tsx": "($event.Value.Double != null) OR ($event.Status.String = 'Good')"
    },
    "projectedProperties": [
      {
        "name": "Building",
        "type": "String"
      },
      {
        "name": "Temperature",
        "type": "Double"
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [],
  "properties": [],
  "progress": 100
}

WarmStoreQueryGetSeriesPage1

Sample Request

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

{
  "getSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": null,
    "inlineVariables": {
      "temperatures": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "avg($value)"
        }
      }
    },
    "projectedVariables": [
      "temperatures"
    ]
  }
}

Sample Response

Status code:
200 
{
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAwMCwidGFrZSI6MTAwMH0="
}

WarmStoreQueryGetSeriesPage2

Sample Request

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

{
  "getSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": null,
    "inlineVariables": {
      "temperatures": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "avg($value)"
        }
      }
    },
    "projectedVariables": [
      "temperatures"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:10Z",
    "2016-08-01T00:00:11Z",
    "2016-08-01T00:00:12Z",
    "2016-08-01T00:00:13Z",
    "2016-08-01T00:00:14Z",
    "2016-08-01T00:00:15Z",
    "2016-08-01T00:00:16Z",
    "2016-08-01T00:00:17Z",
    "2016-08-01T00:00:18Z",
    "2016-08-01T00:00:19Z",
    "2016-08-01T00:00:20Z"
  ],
  "properties": [
    {
      "name": "temperatures",
      "type": "Double",
      "values": [
        65.125,
        65.375,
        65.625,
        65.875,
        66.125,
        66.375,
        66.625,
        66.875,
        67.125,
        67.375,
        67.625
      ]
    }
  ],
  "progress": 50,
  "continuationToken": "aXsic2tpcCI6MTAxYZwidGFrZSI6MTAwMH0="
}

WarmStoreQueryGetSeriesPage3

Sample Request

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

{
  "getSeries": {
    "timeSeriesId": [
      "006dfc2d-0324-4937-998c-d16f3b4f1952",
      "T1"
    ],
    "searchSpan": {
      "from": "2016-08-01T00:00:00Z",
      "to": "2016-08-01T00:16:50Z"
    },
    "filter": null,
    "inlineVariables": {
      "temperatures": {
        "kind": "numeric",
        "value": {
          "tsx": "$event.Temperature"
        },
        "filter": null,
        "aggregation": {
          "tsx": "avg($value)"
        }
      }
    },
    "projectedVariables": [
      "temperatures"
    ]
  }
}

Sample Response

Status code:
200 
{
  "timestamps": [
    "2016-08-01T00:00:21Z"
  ],
  "properties": [
    {
      "name": "temperatures",
      "type": "Double",
      "values": [
        67.825
      ]
    }
  ],
  "progress": 100
}

Definicje

Nazwa Opis
AggregateSeries

Zapytanie agregacji serii. Umożliwia obliczenie zagregowanych szeregów czasowych z zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.
AggregateVariable

Zmienna agregacji reprezentuje dowolne obliczenie agregacji. Zmienne zagregowane nie obsługują interpolacji.
Boundary

Zakres czasu po lewej i prawej stronie zakresu wyszukiwania, który ma być używany do interpolacji. Jest to przydatne w scenariuszach, w których brakuje punktów danych w pobliżu początku lub końca zakresu wyszukiwania wejściowego. Może mieć wartość null.
CategoricalVariable

Zmienna kategorii reprezentuje sygnał, który musi być analizowany na podstawie liczby lub czasu trwania wystąpienia ograniczonego zestawu zdefiniowanych wartości.
DateTimeRange

Zakres czasu. Nie można mieć wartości null ani ujemnej.
EventProperty

Właściwość zdarzenia, które jest przechowywane lub obliczane. Właściwości są identyfikowane przez nazwę i typ. Różne zdarzenia mogą mieć właściwości o tej samej nazwie, ale inny typ.
GetEvents

Pobierz zapytanie o zdarzenia. Umożliwia pobieranie nieprzetworzonych zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.
GetSeries

Pobierz zapytanie serii. Umożliwia pobranie szeregów czasowych obliczonych wartości zmiennych z zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.
Interpolation

Operacja interpolacji, która ma być wykonywana na nieprzetworzonych punktach danych. Obecnie dozwolone jest tylko próbkowanie interpolowanych szeregów czasowych. Dozwolona funkcja agregacji — np. left($value). Może mieć wartość null, jeśli nie trzeba stosować interpolacji.
InterpolationKind

Typ techniki interpolacji : "Liniowy" lub "Krok".
NumericVariable

Zmienna liczbowa reprezentuje pojedynczy ciągły sygnał liczbowy, który można odtworzyć przy użyciu interpolacji.
PropertyTypes

Typ właściwości.
PropertyValues

Wartości pojedynczej właściwości odpowiadającej znacznikom czasu. Może zawierać wartości null. Typ wartości jest zgodny z typem właściwości.
QueryRequest

Żądanie wykonania zapytania szeregów czasowych względem zdarzeń. Należy ustawić dokładnie jedną z opcji "getEvents", "getSeries" lub "aggregateSeries".
QueryResultPage

Pojedyncza strona wyników zapytania. Jeśli zapytanie nie zostało jeszcze zakończone, strona będzie miała ustawiony token kontynuacji. W tym przypadku, aby uzyskać następną stronę wyników, wyślij to samo żądanie ponownie za pomocą parametru tokenu kontynuacji. Jeśli zapytanie zostało ukończone, token kontynuacji ma wartość null. Istnieje również możliwość pobrania pustej strony z ustawionym tokenem kontynuacji tylko wtedy, gdy żadne wyniki zapytania nie zostały jeszcze obliczone. Jeśli stronicowanie zostało ukończone (token kontynuacji ma wartość null), znaczniki czasu i właściwości mogą być puste, jeśli nie ma danych do zwrócenia.
TimeSeriesAggregateCategory

Kategoria używana w zmiennych kategorii. Kategoria jest definiowana przez etykietę i "wartości", które są przypisane do tej etykiety.
TimeSeriesDefaultCategory

Reprezentuje kategorię domyślną.
TsiError

Informacje o błędzie interfejsu API.
TsiErrorBody

Określony błąd interfejsu API z kodem błędu i komunikatem.
TsiErrorDetails

Dodatkowe informacje o błędzie.
Tsx

Wyrażenie szeregów czasowych (TSX) napisane jako pojedynczy ciąg. Przykłady: "$event. Status.String='Good'", "avg($event. Temperatura)". Zapoznaj się z dokumentacją dotyczącą sposobu pisania wyrażeń szeregów czasowych.

AggregateSeries

Zapytanie agregacji serii. Umożliwia obliczenie zagregowanych szeregów czasowych z zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.

Nazwa Typ Opis
filter

Tsx

Filtr najwyższego poziomu dla zdarzeń, które ograniczają liczbę zdarzeń, które są brane pod uwagę do obliczeń. Ten filtr ma wartość AND'ed z filtrem w każdej zmiennej. Przykład: "$event. Status.String='Good'". Opcjonalny.
inlineVariables

object

Umożliwia to użytkownikowi opcjonalne definiowanie zmiennych wbudowanych poza tymi, które zostały już zdefiniowane w modelu. Gdy nazwy zmiennych wbudowanych mają taką samą nazwę jak model, definicja zmiennej wbudowanej ma pierwszeństwo. Może mieć wartość null.
interval

string

Rozmiar interwału jest określony w formacie czasu trwania ISO-8601. Wszystkie interwały są takie same. Jeden miesiąc jest zawsze konwertowany na 30 dni, a jeden rok to zawsze 365 dni. Przykłady: 1 minuta to "PT1M", 1 milisekunda to "PT0.001S". Aby uzyskać więcej informacji, zobacz https://www.w3.org/TR/xmlschema-2/#duration.
projectedVariables

string[]

Dzięki temu użytkownik może opcjonalnie wybrać zmienne, które należy projektować. Gdy wartość ma wartość null lub nie jest ustawiona, zwracane są wszystkie zmienne z wbudowanych zmiennych i modelu. Może mieć wartość null.
searchSpan

DateTimeRange

Zakres czasu wykonywania zapytania. Nie może mieć wartości null.
timeSeriesId

TimeSeriesId[]

Pojedyncza wartość identyfikatora szeregów czasowych, która jednoznacznie identyfikuje pojedyncze wystąpienie szeregów czasowych (np. urządzenie). Należy pamiętać, że pojedynczy identyfikator szeregów czasowych może być złożony, jeśli wiele właściwości jest określonych jako identyfikator szeregów czasowych w czasie tworzenia środowiska. Pozycja i typ wartości muszą być zgodne z właściwościami identyfikatora szeregów czasowych określonymi w środowisku i zwracanymi przez interfejs API pobierania ustawień modelu. Nie może mieć wartości null.

AggregateVariable

Zmienna agregacji reprezentuje dowolne obliczenie agregacji. Zmienne zagregowane nie obsługują interpolacji.

Nazwa Typ Opis
aggregation

Tsx

Agregacja wyrażenia szeregów czasowych, gdy rodzaj jest "agregacja" jest używany do reprezentowania agregacji, która musi być wykonywana bezpośrednio przy użyciu właściwości zdarzeń, takich jak "$event. Temperatura". Na przykład agregacja do obliczania zakresu zmian temperatury może być zapisywana jako "max($event). Temperatura)-min($event. Temperatura)".
filter

Tsx

Odfiltruj zdarzenia, które ograniczają liczbę zdarzeń, które są brane pod uwagę do obliczeń. Przykład: "$event. Status.String='Good'". Opcjonalny.
kind string:

aggregate

Dozwolone wartości "kind" to : "numeryczne" lub "agregacja". Chociaż wyrażenie "liczbowe" umożliwia określenie wartości zrekonstruowanego sygnału i wyrażenia w celu ich zagregowania, rodzaj "agregacji" umożliwia bezpośrednie agregowanie właściwości zdarzenia bez określania wartości.

Boundary

Zakres czasu po lewej i prawej stronie zakresu wyszukiwania, który ma być używany do interpolacji. Jest to przydatne w scenariuszach, w których brakuje punktów danych w pobliżu początku lub końca zakresu wyszukiwania wejściowego. Może mieć wartość null.

Nazwa Typ Opis
span

string

CategoricalVariable

Zmienna kategorii reprezentuje sygnał, który musi być analizowany na podstawie liczby lub czasu trwania wystąpienia ograniczonego zestawu zdefiniowanych wartości.

Nazwa Typ Opis
categories

TimeSeriesAggregateCategory[]

Kategoria używana w zmiennych kategorii. Kategoria jest definiowana przez etykietę i "wartości", które są przypisane do tej etykiety.
defaultCategory

TimeSeriesDefaultCategory

Reprezentuje kategorię domyślną.
filter

Tsx

Odfiltruj zdarzenia, które ograniczają liczbę zdarzeń, które są brane pod uwagę do obliczeń. Przykład: "$event. Status.String='Good'". Opcjonalny.
interpolation

Interpolation

Zmienna kategoryczna obsługuje tylko interpolację "kroków".
kind string:

categorical

Dozwolone wartości "kind" to : "numeryczne" lub "agregacja". Chociaż wyrażenie "liczbowe" umożliwia określenie wartości zrekonstruowanego sygnału i wyrażenia w celu ich zagregowania, rodzaj "agregacji" umożliwia bezpośrednie agregowanie właściwości zdarzenia bez określania wartości.
value

Tsx

Wyrażenie szeregów czasowych wartości służy do reprezentowania wartości sygnału, który będzie kategoryzowany. Może to ocenić tylko typ "String" lub "Long" dla zmiennych kategorii.

DateTimeRange

Zakres czasu. Nie można mieć wartości null ani ujemnej.

Nazwa Typ Opis
from

string

Znacznik czasu rozpoczęcia zakresu czasu. Sygnatura czasowa rozpoczęcia jest uwzględniana w przypadku użycia w żądaniach zapytań szeregów czasowych. Uwzględniane są zdarzenia, które mają ten znacznik czasu.
to

string

Znacznik czasu zakończenia zakresu czasu. Sygnatura czasowa zakończenia jest wyłączna w przypadku użycia w żądaniach zapytań szeregów czasowych. Zdarzenia pasujące do tego znacznika czasu są wykluczone. Należy pamiętać, że sygnatura czasowa zakończenia jest uwzględniana po powrocie przez polecenie Pobierz dostępność (co oznacza, że istnieje zdarzenie z tym dokładnym znacznikiem czasu "do").

EventProperty

Właściwość zdarzenia, które jest przechowywane lub obliczane. Właściwości są identyfikowane przez nazwę i typ. Różne zdarzenia mogą mieć właściwości o tej samej nazwie, ale inny typ.

Nazwa Typ Opis
name

string

Nazwa właściwości.
type

PropertyTypes

Typ właściwości.

GetEvents

Pobierz zapytanie o zdarzenia. Umożliwia pobieranie nieprzetworzonych zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.

Nazwa Typ Opis
filter

Tsx

Opcjonalny filtr najwyższego poziomu dla zapytania, który zostanie zastosowany do wszystkich zmiennych w zapytaniu. Przykład: "$event. Status.String='Good'". Może mieć wartość null.
projectedProperties

EventProperty[]

Przewidywane właściwości to tablica właściwości, które chcesz projektować. Te właściwości muszą pojawić się w zdarzeniach; w przeciwnym razie nie są zwracane.
searchSpan

DateTimeRange

Zakres czasu wykonywania zapytania. Nie może mieć wartości null.
take

integer

Maksymalna liczba wartości właściwości w całym zestawie odpowiedzi, a nie maksymalna liczba wartości właściwości na stronę. Wartość domyślna to 10 000, jeśli nie zostanie ustawiona. Maksymalna wartość 250 000 może wynosić 250 000.
timeSeriesId

TimeSeriesId[]

Pojedyncza wartość identyfikatora szeregów czasowych, która jednoznacznie identyfikuje pojedyncze wystąpienie szeregów czasowych (np. urządzenie). Należy pamiętać, że pojedynczy identyfikator szeregów czasowych może być złożony, jeśli wiele właściwości jest określonych jako identyfikator szeregów czasowych w czasie tworzenia środowiska. Pozycja i typ wartości muszą być zgodne z właściwościami identyfikatora szeregów czasowych określonymi w środowisku i zwracanymi przez interfejs API pobierania ustawień modelu. Nie może mieć wartości null.

GetSeries

Pobierz zapytanie serii. Umożliwia pobranie szeregów czasowych obliczonych wartości zmiennych z zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.

Nazwa Typ Opis
filter

Tsx

Filtr najwyższego poziomu dla zdarzeń, które ograniczają liczbę zdarzeń, które są brane pod uwagę do obliczeń. Ten filtr ma wartość AND'ed z filtrem w każdej zmiennej. Przykład: "$event. Status.String='Good'". Opcjonalny.
inlineVariables

object

Opcjonalne zmienne wbudowane oprócz tych, które zostały już zdefiniowane w typie szeregów czasowych w modelu. Gdy nazwa zmiennej wbudowanej ma taką samą nazwę jak w modelu, pierwszeństwo ma definicja zmiennej wbudowanej. Może mieć wartość null.
projectedVariables

string[]

Wybrane zmienne, które muszą być przewidywane w wyniku zapytania. Gdy wartość ma wartość null lub nie jest ustawiona, zwracane są wszystkie zmienne z wbudowanych zmiennych i typu szeregów czasowych w modelu. Może mieć wartość null.
searchSpan

DateTimeRange

Zakres czasu wykonywania zapytania. Nie może mieć wartości null.
take

integer

Maksymalna liczba wartości właściwości w całym zestawie odpowiedzi, a nie maksymalna liczba wartości właściwości na stronę. Wartość domyślna to 10 000, jeśli nie zostanie ustawiona. Maksymalna wartość 250 000 może wynosić 250 000.
timeSeriesId

TimeSeriesId[]

Pojedyncza wartość identyfikatora szeregów czasowych, która jednoznacznie identyfikuje pojedyncze wystąpienie szeregów czasowych (np. urządzenie). Należy pamiętać, że pojedynczy identyfikator szeregów czasowych może być złożony, jeśli wiele właściwości jest określonych jako identyfikator szeregów czasowych w czasie tworzenia środowiska. Pozycja i typ wartości muszą być zgodne z właściwościami identyfikatora szeregów czasowych określonymi w środowisku i zwracanymi przez interfejs API pobierania ustawień modelu. Nie może mieć wartości null.

Interpolation

Operacja interpolacji, która ma być wykonywana na nieprzetworzonych punktach danych. Obecnie dozwolone jest tylko próbkowanie interpolowanych szeregów czasowych. Dozwolona funkcja agregacji — np. left($value). Może mieć wartość null, jeśli nie trzeba stosować interpolacji.

Nazwa Typ Opis
boundary

Boundary

Zakres czasu po lewej i prawej stronie zakresu wyszukiwania, który ma być używany do interpolacji. Jest to przydatne w scenariuszach, w których brakuje punktów danych w pobliżu początku lub końca zakresu wyszukiwania wejściowego. Może mieć wartość null.
kind

InterpolationKind

Typ techniki interpolacji : "Liniowy" lub "Krok".

InterpolationKind

Typ techniki interpolacji : "Liniowy" lub "Krok".

Nazwa Typ Opis
Linear

string

Step

string

NumericVariable

Zmienna liczbowa reprezentuje pojedynczy ciągły sygnał liczbowy, który można odtworzyć przy użyciu interpolacji.

Nazwa Typ Opis
aggregation

Tsx

Agregacja wyrażenia szeregów czasowych, gdy rodzaj jest "liczbowy" służy do reprezentowania agregacji, która musi być wykonywana w wyrażeniu $value. Wymaga to określenia $value i może używać tylko $value wewnątrz funkcji agregujących. Na przykład agregacja do obliczania minimum $value jest zapisywana jako: "min($value)".
filter

Tsx

Odfiltruj zdarzenia, które ograniczają liczbę zdarzeń, które są brane pod uwagę do obliczeń. Przykład: "$event. Status.String='Good'". Opcjonalny.
interpolation

Interpolation

Operacja interpolacji, która ma być wykonywana na nieprzetworzonych punktach danych. Obecnie dozwolone jest tylko próbkowanie interpolowanych szeregów czasowych. Dozwolona funkcja agregacji — np. left($value). Może mieć wartość null, jeśli nie trzeba stosować interpolacji.
kind string:

numeric

Dozwolone wartości "kind" to : "numeryczne" lub "agregacja". Chociaż wyrażenie "liczbowe" umożliwia określenie wartości zrekonstruowanego sygnału i wyrażenia w celu ich zagregowania, rodzaj "agregacji" umożliwia bezpośrednie agregowanie właściwości zdarzenia bez określania wartości.
value

Tsx

Wyrażenie szeregów czasowych wartości służy do reprezentowania wartości sygnału, który będzie agregowany lub interpolowany. Na przykład wartości temperatury z zdarzenia są reprezentowane w następujący sposób: "$event. Temperature.Double".

PropertyTypes

Typ właściwości.

Nazwa Typ Opis
Bool

string

DateTime

string

Double

string

Long

string

String

string

TimeSpan

string

PropertyValues

Wartości pojedynczej właściwości odpowiadającej znacznikom czasu. Może zawierać wartości null. Typ wartości jest zgodny z typem właściwości.

Nazwa Typ Opis
name

string

Nazwa właściwości.
type

PropertyTypes

Typ właściwości.
values

Values[]

Wartości pojedynczej właściwości odpowiadającej znacznikom czasu. Może zawierać wartości null. Typ wartości jest zgodny z typem właściwości.

QueryRequest

Żądanie wykonania zapytania szeregów czasowych względem zdarzeń. Należy ustawić dokładnie jedną z opcji "getEvents", "getSeries" lub "aggregateSeries".

Nazwa Typ Opis
aggregateSeries

AggregateSeries

Zapytanie agregacji serii. Umożliwia obliczenie zagregowanych szeregów czasowych z zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.
getEvents

GetEvents

Pobierz zapytanie o zdarzenia. Umożliwia pobieranie nieprzetworzonych zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.
getSeries

GetSeries

Pobierz zapytanie serii. Umożliwia pobranie szeregów czasowych obliczonych wartości zmiennych z zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania.

QueryResultPage

Pojedyncza strona wyników zapytania. Jeśli zapytanie nie zostało jeszcze zakończone, strona będzie miała ustawiony token kontynuacji. W tym przypadku, aby uzyskać następną stronę wyników, wyślij to samo żądanie ponownie za pomocą parametru tokenu kontynuacji. Jeśli zapytanie zostało ukończone, token kontynuacji ma wartość null. Istnieje również możliwość pobrania pustej strony z ustawionym tokenem kontynuacji tylko wtedy, gdy żadne wyniki zapytania nie zostały jeszcze obliczone. Jeśli stronicowanie zostało ukończone (token kontynuacji ma wartość null), znaczniki czasu i właściwości mogą być puste, jeśli nie ma danych do zwrócenia.

Nazwa Typ Opis
continuationToken

string

Jeśli zostanie zwrócona, oznacza to, że bieżące wyniki reprezentują częściowy wynik. Token kontynuacji umożliwia uzyskanie następnej strony wyników. Aby uzyskać następną stronę wyników zapytania, wyślij to samo żądanie z parametrem tokenu kontynuacji w nagłówku HTTP "x-ms-continuation".
progress

number

Przybliżony postęp zapytania w procentach. Może to być od 0 do 100. Gdy token kontynuacji w odpowiedzi ma wartość null, postęp powinien wynosić 100.
properties

PropertyValues[]

Kolekcja właściwości i wartości szeregów czasowych dla każdego znacznika czasu. Może mieć wartość null, jeśli serwer nie może wypełnić strony w tym żądaniu lub może być pusty, jeśli nie ma więcej obiektów, gdy token kontynuacji ma wartość null.
timestamps

string[]

Sygnatury czasowe wartości szeregów czasowych. Jeśli jest używana agregacja w interwałach, znaczniki czasu reprezentują początek odpowiednich interwałów. Jeśli są pobierane zdarzenia, znaczniki czasu są wartościami znacznika czasu $ts właściwości zdarzenia. Może mieć wartość null, jeśli serwer nie może wypełnić strony w tym żądaniu lub może być pusty, jeśli nie ma więcej obiektów, gdy token kontynuacji ma wartość null.

TimeSeriesAggregateCategory

Kategoria używana w zmiennych kategorii. Kategoria jest definiowana przez etykietę i "wartości", które są przypisane do tej etykiety.

Nazwa Typ Opis
label

string

Nazwa kategorii, która będzie używana w konstruowaniu nazw zmiennych wyjściowych.
values

object[]

Lista wartości, do których jest mapowana kategoria. Może być unikatową listą ciągów lub listą długich.

TimeSeriesDefaultCategory

Reprezentuje kategorię domyślną.

Nazwa Typ Opis
label

string

Nazwa kategorii domyślnej, która zostanie przypisana do wartości, które nie są zgodne z żadną z kategorii zdefiniowanych w kategorii.

TsiError

Informacje o błędzie interfejsu API.

Nazwa Typ Opis
error

TsiErrorBody

Określony błąd interfejsu API z kodem błędu i komunikatem.

TsiErrorBody

Określony błąd interfejsu API z kodem błędu i komunikatem.

Nazwa Typ Opis
code

string

Niezależny od języka ciąg czytelny dla człowieka, który definiuje kod błędu specyficzny dla usługi. Ten kod służy jako bardziej szczegółowy wskaźnik kodu błędu HTTP określonego w odpowiedzi. Może służyć do programowego obsługi określonych przypadków błędów.
details

TsiErrorDetails[]

Zawiera dodatkowe informacje o błędzie. Może mieć wartość null.
innerError

TsiErrorBody

Zawiera bardziej szczegółowy błąd, który zawęża przyczynę. Może mieć wartość null.
message

string

Czytelna dla człowieka, niezależna od języka reprezentacja błędu. Jest ona przeznaczona jako pomoc dla deweloperów i nie nadaje się do ujawnienia użytkownikom końcowym.
target

string

Element docelowy określonego błędu (na przykład nazwa właściwości w błędzie). Może mieć wartość null.

TsiErrorDetails

Dodatkowe informacje o błędzie.

Nazwa Typ Opis
code

string

Niezależny od języka ciąg czytelny dla człowieka, który definiuje kod błędu specyficzny dla usługi. Ten kod służy jako bardziej szczegółowy wskaźnik kodu błędu HTTP określonego w odpowiedzi. Może służyć do programowego obsługi określonych przypadków błędów.
message

string

Czytelna dla człowieka, niezależna od języka reprezentacja błędu. Jest ona przeznaczona jako pomoc dla deweloperów i nie nadaje się do ujawnienia użytkownikom końcowym.

Tsx

Wyrażenie szeregów czasowych (TSX) napisane jako pojedynczy ciąg. Przykłady: "$event. Status.String='Good'", "avg($event. Temperatura)". Zapoznaj się z dokumentacją dotyczącą sposobu pisania wyrażeń szeregów czasowych.

Nazwa Typ Opis
tsx

string

Wyrażenie szeregów czasowych (TSX) napisane jako pojedynczy ciąg. Przykłady: "$event. Status.String='Good'", "avg($event. Temperatura)". Zapoznaj się z dokumentacją dotyczącą sposobu pisania wyrażeń szeregów czasowych.