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


Что такое пакет SDK Azure для rust?

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

Ящики | Справочная документация по | 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

В настоящее время ящики пакета SDK Azure находятся в бета-версии. Хотя API стабилизируются и ящики подходят для разработки и тестирования, некоторые критические изменения могут произойти до выпуска 1.0. Эти ящики поддерживают наиболее часто используемые службы Azure, и мы регулярно добавляем больше на основе отзывов и запросов сообщества .

Пакет SDK Azure для Rust

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

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