Что такое крейты Azure SDK для Rust?

Пакеты AZURE SDK для Rust позволяют приложениям Rust получать доступ к службам Azure. Эти клиентские библиотеки обеспечивают согласованный и идиоматический интерфейс, что упрощает создание безопасных и масштабируемых облачных решений с помощью Rust и Azure.

Crates | Справочная документация по API | Исходный код

Основные понятия для пакета SDK Azure для Rust

  • Идиоматический Rust: создан с использованием рекомендаций и соглашений Rust.
  • Поддержка async: полностью асинхронные API с поддержкой подключаемой среды выполнения (по умолчанию используется tokio).
  • Безопасность типов: использует систему типов Rust для обеспечения безопасности во время компиляции.
  • Безопасность потоков. Все методы экземпляра клиента являются потокобезопасны и не зависят друг от друга.
  • Безопасность памяти: абстракции с нулевой стоимостью без накладных расходов на сборку мусора.
  • Модульная конструкция: используйте только необходимые ящики.
  • Единая конфигурация: настройте клиентов служб, ведение журнала и повторные попытки с помощью ClientOptions.
  • Единообразная обработка ошибок: Обрабатывайте ошибки единообразно во всех службах с помощью azure_core::Error.
  • Обработка ответов: Получите доступ к подробным данным HTTP-ответа с помощью Response<T>.
  • Поддержка постраничного вывода: работа с API с постраничным выводом, используя Pager<T> для асинхронных потоков.
  • Длительные операции: дождитесь завершения длительной операции (LRO) с помощью Poller<T>
  • Абстракции проверки подлинности: Стандартизированное управление учетными данными с помощью TokenCredential.

Руководство по Rust

Рекомендации по проектированию пакета SDK Azure для Rust описывают основные принципы и шаблоны проектирования, которые соответствуют всем пакетам SDK Azure. Эти рекомендации гарантируют согласованность, интуитивно понятные и идиоматические пакеты SDK для Rust, что упрощает внедрение и использование служб Azure разработчиками. Следуя этим стандартам, библиотеки Azure SDK предоставляют знакомый и предсказуемый опыт, с четкими шаблонами для аутентификации, обработки ошибок и конфигурации клиента, которые соответствуют более широкой экосистеме Azure SDK.

Различия между крейтами и REST API

Используйте следующие сведения, чтобы понять, когда следует использовать каждый тип доступа.

  • Ящики пакета SDK Azure являются предпочтительным способом доступа к службе Azure. Эти контейнеры абстрагируют стандартный код, необходимый для управления облачными запросами REST платформы Azure, такими как проверка подлинности, повторные попытки и ведение журнала.
  • Интерфейсы REST API Azure — это предпочтительный метод, если вы:
    • Работа со службами, для которых крейты Azure пока недоступны. Перенос кода для использования контейнеров Azure SDK после того, как они становятся доступными.
    • Если вы хотите выполнять REST-запросы напрямую, потому что не хотите использовать всю библиотеку ради обращения к одному REST API или вам нужен более тонкий контроль над HTTP-запросами.

Версия Rust

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

Пакеты Rust для Azure SDK

Используйте индекс крейтов SDK Azure для Rust, чтобы найти доступные крейты, их документацию и исходный код.

Дальнейшие шаги

  • Last updated on