このリポジトリは、Azure SDK for Java のアクティブな開発用です。 SDK の利用者は、公開されている開発者ドキュメントまたはバージョン付きの開発者ドキュメントにアクセスすることをお勧めします。
特定のサービス ライブラリの使用を開始するには、ライブラリのプロジェクト フォルダにあるREADME.mdファイルを参照してください。サービス ライブラリは/sdk
ディレクトリにあります。私たちがサポートするすべてのサービスのリストについては、既存のすべてのライブラリのリストにアクセスしてください。
チュートリアル、サンプル、クイック スタート、その他のドキュメントについては、Azure for Java Developers にアクセスしてください。
すべてのライブラリは Java 8 をベースラインとしており、最新の Java 長期サポート リリース (現在は Java 17) までのテストとフォワード サポートが提供されます。
各サービスは、「クライアント」ライブラリと「管理」ライブラリの両方を持つことができます。 「クライアント」ライブラリはサービスの利用に使用され、「管理」ライブラリはサービスの構成と管理に使用されます。
当社のクライアント ライブラリは、Java 用の Azure SDK 設計ガイドラインに従っており、HTTP 再試行、ログ記録、トランスポート プロトコル、認証プロトコルなどの多くのコア機能を共有しているため、1 つのクライアント ライブラリでこれらの機能の使用方法を学習すれば、他のクライアント ライブラリでそれらを使用する方法がわかります。これらの共有機能については、こちらでご覧いただけます。これらのライブラリは、 azure-
で始まるフォルダー、パッケージ、名前空間の名前 ( azure-keyvault
など) によって簡単に識別できます。
すべての新しいパッケージの最新リストは、当社のページで見つけることができます。このリストには、安定版とベータ版の両方の最新リリースが含まれています。
注: コードが実稼働環境に対応していることを確認する必要がある場合は、ベータ版ではない安定したライブラリのいずれかを使用してください。
クライアント ライブラリと同様に、管理ライブラリは Java 用の Azure SDK 設計ガイドラインに従っています。これらのライブラリは、使いやすさ、簡潔さ、一貫性を考慮して最適化された、Azure リソースを管理するための高レベルのオブジェクト指向 API を提供します。管理ライブラリのリストはこのページにあります。
Azure Resource Management の新しいライブラリの使用方法に関する一般的なドキュメントについては、ここを参照してください。以前のバージョンからアップグレードする場合に備えて、豊富なコード サンプルと移行ガイドも用意しました。
管理ライブラリは、 azure-resourcemanager
で始まる名前空間 ( azure-resourcemanager-compute
など) によって識別できます。
Microsoft の最新ライブラリはcom.azure
Maven グループ ID にあり、 com.azure
で始まるパッケージ命名パターンを持つことに注意してください。 com.microsoft.azure
Maven グループ ID 内のライブラリを使用している場合、またはこれをパッケージ構造として使用している場合は、最新のライブラリへの移行を検討してください。これらの過去のリリースから同等のリリースへのマッピング表は、ここで見つけることができます。
azure-java-sdk
タグを使用して StackOverflow で新しい質問をしてください。 メイン ブランチには、新機能とバグ修正を備えた最新のコードが含まれています。これは、最新リリースの安定したSDK を表すものではありません。
私たちがリリースするパッケージごとに、パッケージを生成したコードのコミットをマークするために、パッケージの名前とバージョンを含む固有の git タグが作成されます。このタグは、ホットフィックス ブランチを介したサービスや、特定のベータ版または安定版リリース バージョンのコードのデバッグに使用されます。リリースタグの形式は<package-name>_<package-version>
です。詳細については、分岐戦略を参照してください。
このリポジトリへの貢献の詳細については、貢献ガイドを参照してください。
このプロジェクトは貢献と提案を歓迎します。ほとんどの投稿では、投稿を使用する権利をお客様が有しており、実際に当社に付与することを宣言する投稿者ライセンス契約 (CLA) に同意する必要があります。詳細については、Microsoft の CLA を参照してください。
プル リクエストを送信すると、CLA ボットが CLA を提供する必要があるかどうかを自動的に判断し、PR を適切に装飾します (ラベル、コメントなど)。ボットが提供する指示に従ってください。 CLA を使用するすべてのリポジトリでこれを 1 回行うだけで済みます。
このプロジェクトはマイクロソフトのオープンソース行動規範を採用しています。詳細については、行動規範に関する FAQ を参照するか、追加の質問やコメントがあれば [email protected] までお問い合わせください。
世界中の多くの人々がこのプロジェクトの改善に協力してくれました。ぜひチェックしてみてください:
セキュリティの問題とバグは、電子メールで Microsoft セキュリティ レスポンス センター (MSRC) [email protected] に非公開で報告する必要があります。 24 時間以内に返信が届くはずです。何らかの理由で届かない場合は、元のメッセージを受信したことを確認するために電子メールでフォローアップしてください。 MSRC PGP キーなどの詳細情報は、Security TechCenter で参照できます。
Azure SDK for Java は、MIT ライセンスに基づいてライセンスされています。