Поделиться через

API модели Аналитика временных рядов Azure 2-го поколения

  • Статья

Общие сведения

Каждый из трех компонентов, составляющих модель временных рядов (экземпляры, иерархии и типы), имеет соответствующие REST API, поддерживающие операции CREATE, READ, UPDATE и DELETE, с разбивкой на страницы и (или) пакетные операции.

  • API экземпляра поддерживает операции GET с разбивкой на страницы, операции batch CREATE, READ, UPDATE и DELETE, поиск и ключевое слово для операций поиска.
  • API иерархии поддерживает операции GET с разбивкой на страницы и операции пакетных операций CREATE, READ, UPDATE и DELETE.
  • API типов поддерживает операции GET с разбивкой на страницы и операции пакетных операций CREATE, READ, UPDATE и DELETE.

Четвертый API обеспечивает поддержку REST для параметров модели временных рядов:

  • API параметров модели поддерживает операции HTTP GET и UPDATE для параметров конфигурации модели временных рядов. Подробные сведения о модели временных рядов и определениях экземпляров, иерархии и типов см. в статье Модель временных рядов.

API экземпляров

API экземпляров позволяет выполнять операции 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 типов post Включает пакетные операции с типами. Все операции с этим API являются операциями HTTP POST . Каждая операция принимает полезные данные. Полезные данные — это объект JSON. Этот объект определяет одно свойство. Ключ свойства — это имя операции, разрешенной API. Поддерживаемые операции: PUT, UPDATE и DELETE.

API параметров модели

API параметров модели включает функции CREATE, READ, UPDATE и DELETE для автоматически создаваемых моделей в среде с помощью TimeSeriesIds.

API Описание
API получения параметров модели Возвращает автоматически созданную модель в среде для TimeSeriesIds.
API обновления параметров модели Обновления модель в среде для TimeSeriesIds с новыми значениями, указанными в запросе.

Функции поиска

Поиск с подстановочными знаками

Мы поддерживаем поиск с подстановочными знаками с одним и несколькими символами в рамках одного термина (не в рамках поиска фраз).

Отдельный знак

Чтобы выполнить поиск с подстановочными знаками с одним символом ? , используйте символ . Поиск с подстановочными знаками с одним символом ищет термины, соответствующие строке с заменой одного символа.

Чтобы выполнить поиск по запросу или test, выполните поиск по следующим причинамtext: te?t.

Несколько символов

Чтобы выполнить поиск с подстановочными знаками из нескольких символов, используйте * символ . Поиск с подстановочными знаками с несколькими символами ищет ноль или более символов.

Для поиска test, testsили testerиспользуйте поиск: test*.

Вы также можете использовать поиск с подстановочными знаками в середине термина. Для поиска dryerможно использовать поиск: dr*r.

Логические операторы

Логические операторы позволяют объединять термины с помощью операторов логики. Мы поддерживаем операторы AND, OR, +, -, и NOT в качестве логических операторов.

Важно!

  • Логические операторы должны иметь значение ALL CAPS.
  • Логические операторы должны отделяться от предложений поиска с помощью пробелов.
  • 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.

Оператор +

Оператор + или требует, чтобы термин после символа + существовал где-то в поле одного документа.

Для поиска документов, которые должны содержать и могут содержать dryerwasher , используйте поиск: +dryer washer.

Оператор "-"

Оператор - или prohibit исключает документы, содержащие термин после символа - .

Для поиска документов, содержащих 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. Это средство можно использовать для быстрого дампа утверждений в маркере носителя, а затем проверки их содержимого.

  • Почтальо. Это бесплатное средство тестирования HTTP-запросов и ответов для отладки REST API.

  • Дополнительные сведения о Аналитика временных рядов Azure 2-го поколения см. в документации 2-го поколения.