共用方式為

什麼是適用於 Rust 的 Azure SDK Crate？

適用於 Rust 箱的 Azure SDK 可讓 Rust 應用程式存取 Azure 服務。 這些用戶端程式庫提供一致的慣用體驗，讓您更輕鬆地使用 Rust 和 Azure 建置安全且可擴展的雲端解決方案。

板條箱 | API 參考文件 | 原始程式碼

適用於 Rust 的 Azure SDK Crate 的重要概念

  • 慣用 Rust：使用 Rust 最佳實踐和約定構建。
  • 非同步支援：具有可插拔執行階段支援的完全非同步 API（預設為 tokio）。
  • 類型安全：使用 Rust 的類型系統來確保編譯時安全。
  • 執行緒安全：所有用戶端實例方法都是執行緒安全的，並且彼此獨立。
  • 記憶體安全：零成本抽象，沒有垃圾回收額外負荷。
  • 模組化設計：僅使用您需要的板條箱。
  • 統一組態：使用 ClientOptions設定服務用戶端、記錄和重試。
  • 一致的錯誤處理：使用 azure_core::Error跨服務一致地處理錯誤。
  • 回應處理： 使用 Response<T>存取詳細的 HTTP 回應資料。
  • 分頁支援：使用 用於 Pager<T> 非同步串流來使用編頁 API。
  • 長時間執行作業：使用 Poller<T>
  • 身份驗證抽象：通過 TokenCredential的標準化憑據管理。

防銹指引

Rust 的 Azure SDK 設計指導方針概述了所有 Azure SDK 箱遵循的核心設計原則和模式。 這些準則確保 Rust 的 SDK 一致、直覺且慣用，使開發人員更容易採用和使用 Azure 服務。 透過遵守這些標準，Azure SDK 套件提供了熟悉且可預測的使用體驗，並且在身份驗證、錯誤處理和用戶端配置方面具有清晰的模式，這些模式與更廣泛的 Azure SDK 生態系統保持一致。

crate 和 REST API 之間的差異

使用下列資訊來瞭解何時使用每種類型的存取。

  • Azure SDK 箱是存取 Azure 服務的慣用方法。 這些 crate 會抽象化管理雲端式 Azure 平台 REST 要求所需的樣板程式碼，例如驗證、重試和記錄。
  • 如果您符合下列條件，Azure REST API 是慣用的方法：
    • 使用尚未提供 Azure 箱的服務。 移轉程式碼，以便在 Crate 可供使用時使用 Azure SDK Crate。
    • 想要直接進行 REST 呼叫，因為您不想使用整個 crate 來使用單一 REST API，或者您想要更深入地控制 HTTP 請求。

Rust 版本

Azure SDK 板條箱目前處於 測試階段。 雖然 API 正在穩定，而且 crate 適合開發和測試，但在 1.0 版本之前可能會發生一些重大變更。 這些 crate 支援最常用的 Azure 服務，而且我們會根據 社群意見反應 和需求定期新增更多服務。

適用於 Rust 的 Azure SDK

使用 適用於 Rust 的 Azure SDK Crate 的索引 來尋找可用的 Crate、其檔和原始程式碼。

後續步驟

  • Last updated on