Этот репозиторий предназначен для Azure SDK для JavaScript (Node.js и браузер). Он содержит библиотеки для широкого спектра сервисов Azure. Библиотеки управления — это пакеты, которые вы можете использовать для подготовки ресурсов Azure и управления ими. Клиентские библиотеки — это пакеты, которые вы будете использовать для использования этих ресурсов и взаимодействия с ними.
Несколько полезных ресурсов для начала:
/sdk
этого репозитория. Тот же файл readme можно найти на целевой странице пакета в npm.Каждая служба может иметь несколько библиотек, доступных из каждой из следующих категорий:
ПРИМЕЧАНИЕ. Некоторые из этих пакетов имеют бета-версии. Если вам нужно убедиться, что ваш код готов к производству, используйте один из стабильных пакетов, не являющихся бета-версиями.
Учитывая, что ресурс Azure уже существует, вы можете использовать клиентские библиотеки для его использования и взаимодействия с ним. Большинство этих библиотек соответствуют рекомендациям по проектированию Azure SDK для JavaScript и TypeScript и совместно используют ряд основных функций, таких как повторные попытки, ведение журнала, транспортные протоколы, протоколы аутентификации и т. д. Другие будут обновлены в ближайшем будущем, чтобы также следовать этим рекомендациям.
Чтобы получить список всех клиентских библиотек, соответствующих новым рекомендациям, посетите нашу страницу выпусков Azure SDK.
Библиотеки управления позволяют предоставлять ресурсы Azure и управлять ими через Azure Resource Manager, т. е. ARM. Вы можете узнать эти библиотеки по @azure/arm-
в именах их пакетов. Они генерируются автоматически на основе файлов swagger, которые представляют API для управления ресурсами.
Более новые версии этих библиотек соответствуют рекомендациям по проектированию Azure SDK для TypeScript. Эти новые версии предоставляют ряд основных возможностей, общих для всех пакетов Azure SDK, включая интуитивно понятную библиотеку Azure Identity, конвейер HTTP с настраиваемыми политиками, обработку ошибок, распределенную трассировку и многое другое. Вот несколько полезных ресурсов для начала:
ПРИМЕЧАНИЕ. Если у вас возникли проблемы с аутентификацией в библиотеках управления после обновления определенных пакетов, возможно, вы обновились до новых версий SDK без изменения кода аутентификации. Для получения правильных инструкций обратитесь к упомянутому выше руководству по миграции.
azure-sdk-js
.Попробуйте наши ресурсы сообщества.
О проблемах безопасности и ошибках следует сообщать в частном порядке по электронной почте в Центр реагирования на безопасность Microsoft (MSRC) [email protected]. Вы должны получить ответ в течение 24 часов. Если по какой-то причине вы этого не сделали, пожалуйста, свяжитесь с нами по электронной почте, чтобы убедиться, что мы получили ваше исходное сообщение. Дополнительную информацию, включая ключ MSRC PGP, можно найти в Техцентре безопасности.
Подробную информацию о вкладе в этот репозиторий см. в руководстве по вкладу.
Этот проект приветствует вклад и предложения. Большинство вкладов требуют от вас согласия с Лицензионным соглашением для авторов (CLA), в котором говорится, что вы имеете право и действительно предоставляете нам права на использование вашего вклада. Подробную информацию можно найти на сайте https://cla.microsoft.com.
Когда вы отправляете запрос на включение, CLA-бот автоматически определяет, нужно ли вам предоставить CLA, и соответствующим образом оформляет PR (например, метку, комментарий). Просто следуйте инструкциям бота. Вам нужно будет сделать это только один раз для всех репозиториев, использующих наш CLA.
В этом проекте принят Кодекс поведения Microsoft с открытым исходным кодом. Для получения дополнительной информации ознакомьтесь с часто задаваемыми вопросами по Кодексу поведения или свяжитесь с нами по адресу [email protected], если у вас возникнут дополнительные вопросы или комментарии.