Rust クレート用 Azure SDK とは

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

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

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

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

Rust バージョン

Azure SDKクレートは最も一般的に使用されるAzureサービスをサポートしており、community フィードバックと需要に基づいて定期的に追加されます。