Rust クレート用 Azure SDK とは

Azure SDK for Rust クレートを使用すると、Rust アプリケーションから Azure サービスにアクセスできます。これらのクライアントライブラリは、一貫性のある慣用的なエクスペリエンスを提供し、Rust と Azure を使用してセキュリティで保護されたスケーラブルなクラウドソリューションを簡単に構築できるようにします。

クレート | API リファレンスドキュメント | ソースコード

Rust クレート用 Azure SDK の主要な概念

慣用的な Rust: Rust のベストプラクティスと規則を使用して構築されています。
非同期サポート: プラグ可能なランタイムサポートを備えた完全な非同期 API (既定では東京)
タイプセーフ: Rust の型システムを使用してコンパイル時の安全性を確保します。
スレッドセーフ: すべてのクライアントインスタンスメソッドはスレッドセーフであり、相互に独立しています。
メモリの安全性: ガベージコレクションのオーバーヘッドのないゼロコストの抽象化。
モジュール設計:必要なクレートのみを使用します。
統合構成: ClientOptionsを使用してサービスクライアント、ログ記録、再試行を構成します。
一貫性のあるエラー処理: azure_core::Errorを使用してサービス間で一貫してエラーを処理します。
応答処理: 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 クレートを使用するようにコードを移行します。
- 1 つの REST API を使用するためにクレート全体を使用したくないか、HTTP 要求をより詳細に制御する必要があるため、REST 呼び出しを直接行う必要があります。

Rust バージョン

Azure SDK クレートは現在 ベータ版です。 API は安定しており、クレートは開発とテストに適していますが、1.0 リリース前にいくつかの破壊的変更が発生する可能性があります。これらのクレートは、最も一般的に使用される Azure サービスをサポートしており、コミュニティのフィードバックと需要に基づいて定期的に追加されます。