Политики поддержки и внесения критических изменений в Microsoft Graph, а также доступные версии

  • Статья

В этой статье описаны политики поддержки и внесения критических изменений в Microsoft Graph, а также доступные версии API Microsoft Graph.

Политика поддержки и объявление о прекращении поддержки

Microsoft Graph придерживается политики Microsoft Lifecycle.

По мере выпуска новых версий REST API Microsoft Graph более ранние версии будут прекращены. Корпорация Майкрософт объявляет версию устаревшей по крайней мере за 24 месяца до прекращения ее поддержки. Аналогичным образом, для отдельных API, которые достигли общедоступной доступности, корпорация Майкрософт объявляет API как нерекомендуемый по крайней мере за 24 месяца до его удаления из общедоступной версии.

Для пакетов SDK Microsoft Graph поддерживается только последняя основная версия любой конкретной библиотеки и обновляется с помощью новых функций, исправлений ошибок и обходных решений. Основная версия, предшествующая последней версии, поддерживается в течение 12 месяцев с даты выпуска последней основной версии, только для исправлений безопасности. По возможности рекомендуется выполнить обновление до последней версии пакетов SDK.

Когда мы увеличим основную версию API (например, с версии 1.0 до версии 2.0), мы объявляем, что текущая версия (в этом примере версия 1.0) немедленно устарела и мы больше не будем поддерживать ее через 24 месяца после объявления. В политику могут быть внесены исключения, если возникнут проблемы с безопасностью или работоспособностью службы.

Когда API помечен как недопустимый, настоятельно рекомендуем как можно быстрее переходить на последнюю версию. В некоторых случаях мы сообщаем, что новые приложения должны будут начать использовать новые API через некоторое время после того, как исходные API будут устарели. В таких случаях только активные приложения, которые в настоящее время используют недопустимые API-интерфейсы могут продолжать их использование.

Изменения, не совместимые с контрактами API и невозмехватными

В Microsoft Graph имеется журнал изменений во всех версиях. Эти изменения перечислены в журнале изменений Microsoft Graph. По мере добавления новых функций и данных в Microsoft Graph мы увеличим номер версии API для любых изменений, не совместимых с обратной связью, в API.

Ниже приведены примеры изменений, не совместимых с обратной связью.

  • изменения URL-адреса или основного запроса/ответа, связанного с ресурсом;
  • удаление, переименование или изменение типа объявленного свойства;
  • удаление или переименование API или их параметров;
  • добавление обязательного заголовка запроса.

Примеры обратно совместимых изменений:

  • добавление свойств, которые допускают значение null или имеют значение по умолчанию;
  • добавление элемента в перечисление;
  • удаление, переименование или изменение типа открытого расширения;
  • удаление, переименование или изменение типа заметки;
  • разбиение существующих коллекций на страницы;
  • изменения кодов ошибок;
  • изменения порядка свойств;
  • изменения длины или формата непрозрачных строк, таких как идентификаторы ресурсов.

Заметка: Со временем мы обновляем список изменений, совместимых с обратной совместимостью. Если вы создаете собственные прокси-серверы клиента (например, клиенты WCF), ваши клиентские приложения должны быть готовы принимать свойства и производные типы, ранее не определенные в службе API Microsoft Graph. API Microsoft Graph соответствует принципам, описанным в разделе Управление версиями в руководстве поMicrosoft REST API .

Версии

В настоящее время доступны указанные ниже версии API Microsoft Graph.

Бета-версия

В целом API появляются в бета-версии и доступны в конечной точке https://graph.microsoft.com/beta. Документацию по API бета-версии см. в справочнике по конечной точке бета-версии Microsoft Graph. Время от времени в бета-версию могут вноситься критические изменения и API могут признаваться устаревшими. Использование бета-версий API в рабочих приложениях не поддерживается.

Мы не гарантируем, что бета-функция появится в текущей версии. Когда команда API Microsoft Graph считает, что бета-версия компонента готова к общедоступной доступности, мы добавим эту функцию в последнюю текущую версию. Если повышение уровня функции приведет к критическому изменению текущей версии, номер версии увеличивается, а новая версия становится текущей.

Текущая версия

Текущая версия Microsoft Graph: 1.0. Эти API доступны в конечной точке https://graph.microsoft.com/v1.0 . Версия API Microsoft Graph версии 1.0 содержит функции, которые являются общедоступными и готовыми к использованию в рабочей среде. Документацию по API версии 1.0 см. в справочнике по конечной точке Microsoft Graph версии 1.0.

Состояние предварительной версии

API или компонент в Microsoft Graph помечается как "(предварительная версия)", чтобы указать, что его поведение уникально в бета-версии конечной точки.

Поведение большинства API и функций в версии 1.0 аналогично поведению в бета-версии. Некоторые API помечаются как предварительные версии по одной из следующих причин:

  • API доступны только в бета-версии.
  • Поведение API в бета-версии отличается от поведения версии 1.0

Как и любой другой API в бета-версии конечной точки, мы можем внести критические изменения в API, помеченные как предварительные версии, без уведомления. Не получайте доступ к API из конечной точки бета-версии в рабочих приложениях.

Заметка: API-интерфейсы могут быть доступны в предварительной версии, даже если функция или продукт являются общедоступными.

Устаревшие и неподдерживаемые версии

В настоящее время версии Microsoft Graph не являются устаревшими или не поддерживаются.

Условия использования

Используя API Microsoft Graph, вы принимаете Условия использования API Microsoft.

Ваши отзывы важны для нас. Свяжитесь с нами через раздел Вопросы и ответы Майкрософт. Помечайте свои вопросы тегом [microsoft-graph-*].