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

Статья
10/30/2024

Важно!

Пакет 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

Установите Git. Инструкции см. в разделе по установке Git.
Сведения об установке правильных пакетов NuGet см. в разделе Доступные версии дистрибутива NuGet.

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

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

Если вы используете пакет SDK для .NET для отслеживания 2 (рекомендуется), вы можете использовать стандартные Azure.* пакеты и настроить версии API в коде. Примеры этого и этого запроса для стандартных Azure.* пакетов см. в разделе примеров.
Если вы используете пакет SDK для .NET для отслеживания 1 (не рекомендуется), необходимо скачать один из следующих пакетов, чтобы использовать службы Azure Stack Hub. Не забудьте скачать тот, который соответствует вашему профилю API:
- Microsoft.Azure.Management.Profiles.hybrid_2020_09_01.<ResourceProvider>. 1.0.0.nupkg
- Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.<ResourceProvider>. 0.9.0-preview.nupkg

Примечание

Необходимо изменить часть 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:

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