通过

什么是 Azure SDK for Rust 箱？

Azure SDK for Rust 箱使 Rust 应用程序能够访问 Azure 服务。 这些客户端库提供一致的惯用体验，使使用 Rust 和 Azure 构建安全且可缩放的云解决方案更容易。

箱子 | API 参考文档 | 源代码

用于 Rust 的 Azure SDK 箱的关键概念

  • 惯用 Rust：使用 Rust 最佳做法和约定构建。
  • 异步支持：具有可插入运行时支持的完全异步 API（默认为 tokio）。
  • 类型安全性：使用 Rust 的类型系统进行编译时安全。
  • 线程安全性：所有客户端实例方法都是线程安全的，彼此独立。
  • 内存安全：无垃圾回收开销的零成本抽象。
  • 模块化设计：仅使用所需的箱。
  • 统一配置：使用 ClientOptions.. 配置服务客户端、日志记录和重试。
  • 一致的错误处理：使用 处理跨服务的一致错误。
  • 响应处理：使用 Response<T>.. 访问详细的 HTTP 响应数据。
  • 分页支持：使用 Pager<T> 异步流处理分页 API。
  • 长时间运行的作：等待长时间运行的作 （LRO） Poller<T>
  • 身份验证抽象：通过 TokenCredential标准化凭据管理。

Rust 指南

Rust 的 Azure SDK 设计指南概述了所有 Azure SDK 箱遵循的核心设计原则和模式。 这些指南确保 SDK 是 Rust 的一致、直观和惯用的，使开发人员更容易采用和使用 Azure 服务。 通过遵循这些标准，Azure SDK 箱提供熟悉且可预测的体验，并提供与更广泛的 Azure SDK 生态系统一致的身份验证、错误处理和客户端配置的明确模式。

箱和 REST API 之间的差异

使用以下信息了解何时使用每种类型的访问。

  • Azure SDK 箱是访问 Azure 服务的首选方法。 这些箱抽象化了管理基于云的 Azure 平台 REST 请求（例如身份验证、重试和日志记录）所需的样板代码。
  • 如果采用以下方法，则 Azure REST API 是首选方法：
    • 使用尚未提供 Azure 箱的服务。 迁移代码以在箱可用时使用 Azure SDK 箱。
    • 想要直接进行 REST 调用，因为不想使用整个箱来使用单个 REST API，或者想要更深入地控制 HTTP 请求。

Rust 版本

Azure SDK 箱目前处于 beta 状态。 虽然 API 正在稳定，并且箱适合开发和测试，但 1.0 版本之前可能会发生一些中断性变更。 这些箱支持最常用的 Azure 服务，我们定期根据 社区反馈 和需求添加更多内容。

用于 Rust 的 Azure SDK 箱

使用 Azure SDK for Rust 包的索引 查找可用的包、它们的文档和源代码。

后续步骤