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

Управление профилями версий API в Azure Stack Hub

Профили API определяют поставщик ресурсов Azure и версию API для конечных точек Azure REST. С помощью профилей API можно создать пользовательские клиенты на разных языках. Каждый клиент использует профиль API для связи с правильным поставщиком ресурсов и версией API для Azure Stack Hub.

Вы можете создать приложение для работы с поставщиками ресурсов Azure без необходимости точно определять, какая версия каждого API поставщика ресурсов совместима с Azure Stack Hub. Просто сопоставьте свое приложение с профилем, и SDK будет соответствовать правильной версии API.

В этой статье содержатся сведения:

  • о профилях API для Azure Stack Hub;
  • о том, как разрабатывать решения с их помощью;
  • о том, как найти руководство по написанию кода.

Summary of API profiles (Сводка по профилям API)

  • Профили API представляют набор поставщиков ресурсов Azure и их версий API.
  • Профили API предназначены для пользователей, создающих шаблоны в нескольких облаках Azure. Профили предоставляют совместимый и стабильный интерфейс.
  • Профили выпускаются четыре раза в год.
  • Используются три соглашения об именовании профилей:
    • самый поздний
      Содержит самые последние версии API, выпущенные в глобальной среде Azure.
    • yyyy-mm-dd-гибрид
      Этот выпуск выходит два раза в год и обеспечивает согласованность и стабильность в нескольких облаках. Этот профиль предназначен для оптимальной совместимости с Azure Stack Hub.
    • гггг-mm-dd-profile
      Обеспечивает разумное соотношение между оптимальной стабильностью и новейшими функциями.

Профили API Azure и совместимость с Azure Stack Hub

Новейшие профили API Azure несовместимы с Azure Stack Hub. Можно использовать следующие соглашения об именовании для идентификации профилей, которые необходимо использовать для своих решений Azure Stack Hub:

самый поздний
Этот профиль включает в себя последние версии API, доступные в глобальной среде Azure. Эти версии не будут работать в Azure Stack Hub. последняя имеет наибольшее количество критических изменений. Он не учитывает стабильность и совместимость с другими облаками. Если вы пытаетесь использовать самые up-to-версии API, последний — это профиль, который следует использовать.

Yy-mm-dd-гибрид
Этот профиль выпускается в марте и сентябре каждого года. Он обладает оптимальной стабильностью и совместимостью с различными облаками и разрабатывается специально для глобальной платформы Azure с Azure Stack Hub. Версии API Azure, указанные в этом профиле, соответствуют версиям, указанным в Azure Stack Hub. Вы можете использовать этот профиль для разработки кода для гибридных облачных решений.

гггг-mm-dd-profile
Этот профиль выпускается в глобальной среде Azure в июне и декабре каждого года. Он не работает с Azure Stack Hub. Как правило, он будет содержать большое число критических изменений. Хотя она балансирует оптимальную стабильность и новейшие функции, разница между последними и этим профилем заключается в том, что последняя всегда состоит из новейших версий API независимо от того, когда API выпущен. Например, если новая версия API создается для API вычислений завтра, эта версия API отображается в последней версии, но не в профиле yy-mm-dd-profile , так как этот профиль уже существует. yy-mm-dd-profile охватывает самые up-to-date версии, выпущенные до июня или до декабря.

Профили API Azure Resource Manager

Azure Stack Hub не использует последнюю версию из версий API в глобальной среде Azure. При создании решения необходимо найти версию API для каждого поставщика ресурсов Azure, которая совместима с Azure Stack Hub.

Вместо исследования каждого поставщика ресурсов и определенной версии, поддерживаемой Azure Stack Hub, можно использовать профиль API. Профиль определяет набор поставщиков ресурсов и версий API. Пакет SDK или инструмент, созданный с его помощью, выполнит откат до целевой api-version, указанной в профиле. С помощью профилей API можно указать версию профиля, которая применяется ко всему шаблону. Во время выполнения Azure Resource Manager выбирает правильную версию ресурса.

Профили API работают с инструментами, которые используют Azure Resource Manager, такими как PowerShell, Azure CLI, предоставленный в пакете SDK код и Microsoft Visual Studio. Инструменты и пакеты SDK могут использовать профили, чтобы определить, какую версию модулей и библиотек следует включать при сборке приложения.

Например, если вы используете PowerShell для создания учетной записи хранения с помощью поставщика ресурсов Microsoft.Storage , который поддерживает API-версию 2016-03-30 и виртуальную машину с помощью поставщика ресурсов Microsoft.Compute с api-версии 2015-12-01, необходимо найти модуль PowerShell, поддерживающий модуль PowerShell 2016-03-30 для хранилища, и какой модуль поддерживает 2015-02-01 для вычислений, а затем установить их. Вместо этого можно использовать профиль. Используйте командлет Install-Profile <profilename>, и PowerShell загрузит правильную версию модулей.

Аналогичным образом при использовании пакета SDK для Python, чтобы создать приложение на основе Python, можно указать профиль. Пакет SDK загружает правильные модули для поставщиков ресурсов, которые указаны в сценарии.

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

Примеры кода для профиля API

Вы можете найти примеры кода, которые помогут интегрировать решение с предпочитаемым языком с помощью Azure Stack Hub, используя профили. В настоящее время руководства и примеры можно найти для следующих языков:

  • .СЕТЬ
    С помощью профиля API .NET можно получить последнюю и наиболее стабильную версию ресурса любого типа из представленных в пакете поставщика ресурсов. Дополнительные сведения см. в разделе "Использование профилей версий API" с .NET в Azure Stack Hub.
  • PowerShell
    Используйте модуль Az.Bootstrapper , доступный в коллекции PowerShell, чтобы получить командлеты PowerShell, необходимые для работы с профилями версий API. Дополнительные сведения см. в разделе "Использование профилей версий API для PowerShell". Используйте модуль AzureRM.Bootstrapper , доступный в коллекции PowerShell, чтобы получить командлеты PowerShell, необходимые для работы с профилями версий API. Дополнительные сведения см. в разделе "Использование профилей версий API для PowerShell".
  • Azure CLI
    Укажите в конфигурации среды версию API, специально предназначенную для Azure Stack Hub. Дополнительные сведения см. в разделе "Использование профилей версий API для Azure CLI".
  • Иди
    В пакете SDK для Go профиль является сочетанием различных типов ресурсов с разными версиями различных служб. Профили доступны в каталоге profiles/path с их версией в формате ГГГГ-ММ-ДД. Дополнительные сведения см. в разделе "Использование профилей версий API для Go".
  • Питон
    Пакет SDK для Python поддерживает профили версии API для разных облачных платформ, например Azure Stack Hub и глобальной среды Azure. Вы можете использовать профили API при создании решений для гибридного облака. Дополнительные сведения см. в разделе "Использование профилей версий API" с Python.
  • Node.js
    Пакет SDK Node.js для Resource Manager для Azure Stack Hub предоставляет инструменты для создания инфраструктуры и управления ею. Дополнительные сведения см. в разделе "Использование профилей версий API с Node.js".

Следующие шаги

  • Last updated on