azure-sdk-for-js - このリポジトリは、Azure SDK for JavaScript (NodeJS & Browser) の積極的な開発を目的としています。SDK のコンシューマーについては、https://docs.microsoft.com/javascript/azure/ にある公開開発者ドキュメント、または https://azure.github.io/azure-sdk-for-js にあるバージョン管理された開発者ドキュメントにアクセスすることをお勧めします。 .

(This repository is for active development of the Azure SDK for JavaScript (NodeJS & Browser). For consumers of the SDK we recommend visiting our public developer docs at https://docs.microsoft.com/javascript/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-js. )

Created at: 2017-10-26 02:44:09
Language: TypeScript
License: MIT

Azure SDK for JavaScript

パッケージ 依存関係 依存グラフ

このリポジトリは、Azure SDK for JavaScript (Node.js & Browser) 用です。これには、さまざまな Azure サービス用のライブラリが含まれています。管理ライブラリは、Azure リソースのプロビジョニングと管理に使用するパッケージです。クライアント ライブラリは、これらのリソースを使用して操作するために使用するパッケージです。

入門

開始するのに役立つリソースは次のとおりです。

  • 各パッケージの readme には、コード サンプルとパッケージ情報が含まれています。
    /sdk
    この readme は、このリポジトリのフォルダー内の選択したサービスのフォルダーの下にある対応するパッケージ フォルダーにあります。npmのパッケージのランディング ページにも同じ readme ファイルがあります。
  • これらのパッケージの最新バージョンの API リファレンス ドキュメントは、公開開発者ドキュメントにあります。
  • 古いバージョンの API リファレンス ドキュメントは、バージョン管理された開発者向けドキュメントにあります。

各サービスには、次の各カテゴリから利用可能な多数のライブラリがある場合があります。

注: これらのパッケージの一部には、ベータ版があります。コードを本番環境で使用できるようにする必要がある場合は、安定した非ベータ パッケージのいずれかを使用してください。

クライアント

Azure リソースが既に存在する場合、クライアント ライブラリを使用してそれを消費し、操作します。これらのライブラリのほとんどは、JavaScript と TypeScript の Azure SDK 設計ガイドラインに従っており、再試行、ログ記録、トランスポート プロトコル、認証プロトコルなどの多くのコア機能を共有しています。他のライブラリも同様にガイドラインに従うように近い将来更新されます。

新しいガイドラインに従うすべてのクライアント ライブラリの一覧を取得するには、Azure SDK リリース ページにアクセスしてください。

管理

管理ライブラリを使用すると、Azure リソース マネージャー (ARMなど) を介して Azure リソースをプロビジョニングおよび管理できます。これらのライブラリ

@azure/arm-
は、パッケージ名で識別できます。これらは、リソース管理用の API を表す swagger ファイルに基づいて純粋に自動生成されます。

これらのライブラリの新しいバージョンは、TypeScript の Azure SDK 設計ガイドラインに従っています。これらの新しいバージョンは、直感的な Azure Identity ライブラリ、カスタム ポリシーを備えた HTTP パイプライン、エラー処理、分散トレースなど、すべての Azure SDK で共有される多くのコア機能を提供します。これらを開始するためのいくつかの役立つリソースは次のとおりです。

注: 特定のパッケージをアップグレードした後に管理ライブラリで認証の問題が発生した場合は、認証コードを変更せずに新しいバージョンの SDK にアップグレードした可能性があります。適切な手順については、上記の移行ガイドを参照してください。

助けが必要?

コミュニティ

コミュニティ リソースをお試しください。

セキュリティの問題とセキュリティ バグの報告

セキュリティの問題とバグは、電子メールで Microsoft Security Response Center (MSRC) secure@microsoft.comに非公開で報告する必要があります。24 時間以内に返信を受け取る必要があります。何らかの理由で届かない場合は、メールでフォローアップして、元のメッセージが届いていることを確認してください。MSRC PGP キーを含む詳細情報は、Security TechCenterにあります。

貢献する

このリポジトリへの貢献の詳細については、貢献ガイドを参照してください。

このプロジェクトは、貢献と提案を歓迎します。ほとんどのコントリビューションでは、コントリビューター ライセンス契約 (CLA) に同意する必要があります。これは、コントリビューションを使用する権利を私たちに付与する権利があり、実際に付与することを宣言するものです。詳細については、 https://cla.microsoft.comをご覧ください。

プル リクエストを送信すると、CLA を提供する必要があるかどうかを CLA ボットが自動的に判断し、PR を適切に装飾します (例: ラベル、コメント)。ボットが提供する指示に従うだけです。これは、CLA を使用するすべてのリポジトリで 1 回だけ行う必要があります。

このプロジェクトは、Microsoft オープン ソース行動規範を採用しています。詳細については、行動規範に関する FAQ を参照するか、 opencode@microsoft.comに連絡して追加の質問やコメントをお寄せください。

印象