Использование профилей версий API и .NET в Azure Stack Hub

  • Статья

Важно!

Пакет SDK для .NET обновлен с дорожки 1 до 2. Настоятельно рекомендуется как можно скорее выполнить миграцию на пакет SDK для трека 2. Инструкции см. в этом руководстве по миграции .

Пакет SDK .NET для Azure Stack Hub Resource Manager предоставляет средства для создания и администрирования инфраструктуры. В этом пакете SDK представлены поставщики ресурсов вычислений, сети, хранилища, служб приложений и Key Vault. Пакет SDK для .NET включает в себя 14 пакетов NuGet. Если вы используете нерекомендуемый пакет SDK для .NET (не рекомендуется), эти пакеты используют профили API, например 2020-09-01-hybrid и 2019-03-01-hybrid. Профили API в пакете SDK для .NET позволяют разрабатывать гибридные облака, помогая переключаться между глобальными ресурсами Azure и ресурсами Azure Stack Hub. Дополнительные сведения см. в разделе Профили версий .NET и API .

Установка пакета SDK .NET для Azure

Профили версии API и .NET

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

Примечание

Необходимо изменить часть ResourceProvider в спецификации пакета NuGet. Кроме того, пакеты для пакета SDK для трека 1 для .NET являются устаревшими, поэтому могут возникнуть ошибки. Рекомендуется как можно скорее обновить пакет SDK для .NET для трека 2.

Профили

Для профилей, содержащих даты, чтобы использовать другой профиль или версию пакета SDK, замените дату на Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManager. Например, для версии 2008 профиль имеет значение 2019_03_01, а строка становится Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager. Обратите внимание, что иногда команда sdk изменяет имя пакетов, поэтому просто заменить дату строки другой датой может не работать. Сведения о связи профилей и версий Azure Stack см. в следующей таблице.

Версия Azure Stack Профиль
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020_09_01
2102 2020_09_01
2008 2019_03_01

См. дополнительные сведения об Azure Stack Hub и профилях API.

Подписка

Если у вас еще нет подписки, создайте подписку и сохраните ее идентификатор для последующего использования. Сведения о создании подписки см. в этом документе.

Субъект-служба

Субъект-служба и связанные с ним сведения о среде должны быть созданы и сохранены. Рекомендуется использовать субъект-службу с owner ролью, но в зависимости от образца может быть достаточно роли contributor . Требуемые значения см. в файле сведений в репозитории примеров . Эти значения можно считывать в любом формате, поддерживаемом языком пакета SDK, например из JSON-файла (который используется в наших примерах). В зависимости от выполняемого примера можно использовать не все из этих значений. Обновленный пример кода или дополнительные сведения см. в репозитории примеров.

Tenant ID

Чтобы найти каталог или идентификатор клиента для Azure Stack Hub, следуйте инструкциям в этой статье.

Регистрация поставщиков ресурсов

Зарегистрируйте необходимые поставщики ресурсов, следуя этому документу. Эти поставщики ресурсов потребуются в зависимости от примеров, которые вы хотите запустить. Например, если вы хотите запустить пример виртуальной машины, Microsoft.Compute требуется регистрация поставщика ресурсов.

Конечная точка Azure Stack Resource Manager

Azure Resource Manager (ARM) — это платформа управления, которая позволяет администраторам развертывать, администрировать и отслеживать ресурсы Azure. Azure Resource Manager может обрабатывать эти задачи в рамках одной операции как группы, а не по отдельности. Получить метаданные можно из конечной точки Resource Manager. Конечная точка возвращает JSON-файл со сведениями, необходимыми для запуска вашего кода.

  • ResourceManagerEndpointUrl в пакете средств разработки Azure Stack (ASDK) имеет следующий формат: https://management.local.azurestack.external/.
  • ResourceManagerEndpointUrl в интегрированных системах имеет следующий формат: https://management.region.<fqdn>/, где <fqdn> — это полное доменное имя.
  • Чтобы получить необходимые метаданные, используйте <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Доступные версии API см. в разделе Спецификации Azure rest API. Например, в 2020-09-01 версии профиля можно изменить api-version2019-10-01 значение на для поставщика microsoft.resourcesресурсов .

Пример JSON:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Примеры

Ознакомьтесь с примером репозитория , где приведен пример кода для обновления до актуальной версии (дорожка 2). Пример кода для отслеживания 1 см. в этом репозитории . Корень README.md описывает общие требования, и каждый вложенный каталог содержит конкретный пример со своим собственным README.md , который описывает, как запустить этот пример.

См. пример , применимый к версии 2008 или профилю 2019-03-01 Azure Stack, и ниже.

Дальнейшие действия

Дополнительные сведения о профилях API: