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

  • Статья

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

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

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

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

Когда мы увеличим основную версию 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.

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

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

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

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

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

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

  • Доступ только в бета-версии
  • Доступ в бета-версии отличается от доступа в версии 1.0

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

Например, обучение симуляции атаки — это функция, которая общедоступна для администраторов на портале Microsoft 365 Defender. Когда REST API для обучения имитации атак становится доступным в Microsoft Graph только в бета-версии конечной точки, документация по REST API помечается как "(предварительная версия)". Метка "(предварительная версия)" применяется к REST API и соответствующей документации в Microsoft Graph, хотя сама служба является общедоступной.

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

В настоящий момент нет устаревших версий Microsoft Graph.

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

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

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