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

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

注: これらのパッケージの一部にはベータ版があります。コードが運用環境の準備ができていることを確認する必要がある場合は、安定版 (stable) の非ベータ版パッケージのいずれかを使用してください。

クライアント

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

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

管理

管理ライブラリを使用すると、Azure リソース マネージャー (ARM) を介して Azure リソースをプロビジョニングおよび管理できます。これらのライブラリは、パッケージ名で認識できます。これらは、リソース管理用のAPIを表すスワッガーファイルに基づいて純粋に自動生成されます。

@azure/arm-

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

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

ヘルプが必要ですか?

コミュニティ

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

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

セキュリティの問題とバグは、Microsoft セキュリティ レスポンス センター (MSRC) secure@microsoft.com に電子メールで非公開で報告する必要があります。24時間以内に返信が届きます。何らかの理由でそうしない場合は、電子メールでフォローアップして、元のメッセージを確実に受信してください。MSRC PGP キーを含む詳細情報は、セキュリティ テクニカル センターに記載されています。

貢献

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

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

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

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

感想