Azure SDK для сети

Azure SDK для .NET

Этот репозиторий предназначен для активной разработки Azure SDK для .NET. Потребителям SDK мы рекомендуем посетить нашу общедоступную документацию для разработчиков или нашу документацию для разработчиков с указанием версий.

Начиная

Чтобы начать работу с библиотекой, просмотрите файл README.md, расположенный в папке проекта библиотеки. Вы можете найти эти папки библиотеки, сгруппированные по службам, в каталоге /sdk.

Учебные пособия, примеры, краткое руководство и другую документацию можно найти на сайте Azure для разработчиков .NET.

Доступные пакеты

Каждая служба может иметь несколько библиотек, доступных из каждой из следующих категорий:

• Клиент – Новые релизы

• Клиент – предыдущие версии

• Менеджмент – Новые релизы

• Управление – предыдущие версии

Клиент: Новые релизы

Новая волна пакетов, которые мы анонсируем как общедоступные , а также несколько пакетов, которые в настоящее время выпускаются в предварительной версии . Эти библиотеки соответствуют рекомендациям по проектированию Azure SDK для .NET и имеют ряд общих функций, таких как повторные попытки HTTP, ведение журнала, транспортные протоколы, протоколы аутентификации и т. д., поэтому, как только вы научитесь использовать эти функции в одной клиентской библиотеке, вы сможете будет знать, как использовать их в других клиентских библиотеках. Вы можете узнать об этих общих функциях на сайте Azure.Core.

Эти новые клиентские библиотеки можно идентифицировать по именам, используемым для их папок, пакетов и пространств имен. Каждый из них начинается с Azure , за которым следует категория службы, а затем имя службы. Например Azure.Storage.Blobs .

Полный список доступных пакетов см. на странице последних доступных пакетов.

ПРИМЕЧАНИЕ. Если вам необходимо убедиться, что ваш код готов к работе, мы настоятельно рекомендуем использовать одну из стабильных библиотек без предварительной версии.

Клиент: предыдущие версии

Последние стабильные версии пакетов, готовые к использованию. Эти библиотеки предоставляют функциональные возможности, аналогичные пакетам предварительной версии, поскольку они позволяют использовать существующие ресурсы и взаимодействовать с ними, например: отправлять BLOB-объекты хранилища. Каталоги стабильных библиотек обычно содержат «Microsoft.Azure» в своих именах, например «Microsoft.Azure.KeyVault». Они могут не соответствовать рекомендациям или иметь тот же набор функций, что и ноябрьские выпуски. Однако они предлагают более широкий спектр услуг.

Управление: Новые релизы

Новый набор библиотек управления, соответствующий рекомендациям по проектированию Azure SDK для .NET и основанный на библиотеках Azure.Core, теперь находится в общедоступной предварительной версии. Эти новые библиотеки предоставляют ряд основных возможностей, которые используются всеми пакетами SDK Azure, включая интуитивно понятную библиотеку Azure Identity, конвейер HTTP с настраиваемыми политиками, обработку ошибок, распределенную трассировку и многое другое. Список новых пакетов вы можете найти на этой странице.

Чтобы начать работу с этими новыми библиотеками, ознакомьтесь с кратким руководством здесь. Эти новые библиотеки можно идентифицировать по пространствам имен, которые начинаются с Azure.ResourceManager , например Azure.ResourceManager.Network

ПРИМЕЧАНИЕ. Если вам нужно убедиться, что ваш код готов к работе, используйте одну из стабильных библиотек без предварительной версии.

Управление: Предыдущие версии

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

Документацию и примеры кода для этих библиотек можно найти здесь.

Нужна помощь?

• Справочную документацию можно найти в справочнике по Azure SDK для .NET API.

• Учебные пособия, примеры, краткое руководство и другую документацию можно найти на сайте Azure для разработчиков .NET.

• Сообщите о проблеме через Github Issues.

• Проверьте предыдущие вопросы или задайте новые в StackOverflow, используя теги azure и .net .

Сообщество

• Общайтесь с другими участниками сообщества

Сообщение о проблемах безопасности и ошибках безопасности

О проблемах безопасности и ошибках следует сообщать в частном порядке по электронной почте в Центр реагирования на безопасность Microsoft (MSRC) [email protected]. Вы должны получить ответ в течение 24 часов. Если по какой-то причине вы этого не сделали, пожалуйста, свяжитесь с нами по электронной почте, чтобы убедиться, что мы получили ваше исходное сообщение. Дополнительную информацию, включая ключ MSRC PGP, можно найти в Техцентре безопасности.

Нам нужны ваши мысли!

Запросы функций

Какие функции для вас важны? Вы можете сообщить нам об этом, просмотрев наши открытые запросы на функции и поделившись своими мыслями, поставив проблеме палец вверх или вниз. (Обратите внимание, что список отсортирован по количеству лайков вверх в порядке убывания.)

Обсуждения дизайна

Мы хотели бы включить вклад сообщества в процесс проектирования нашей библиотеки. Вот список обсуждений дизайна, которые мы сейчас ведем. Участвуйте в обсуждениях, оставляя свои комментарии в выпуске!