このパッケージにはAzure Marketplaceクライアント用の同型SDKが含まれており(Node.js とブラウザの両方で動作します)。
プライベートマーケットプレイス向けのREST API
主要なリンク:
作業の開始
現在サポートされている環境
- Node.js の LTS バージョン
- Safari、Chrome、Edge、Firefox の最新バージョン。
詳細はsupportポリシーをご覧ください。
前提条件
@azure/arm-marketplace パッケージをインストールする
JavaScript用のAzure Marketplaceクライアントライブラリを npmインストールしてください:
npm install @azure/arm-marketplace
MarketplaceClient を作成して認証する
Azure Marketplace APIにアクセスするクライアントオブジェクトを作成するには、Azure Marketplaceリソースの endpoint と credentialが必要です。 Azure MarketplaceクライアントはAzure Active Directoryの認証情報を使用できます。
Azure Marketplaceリソースのエンドポイントは Azure Portalで見つけることができます。
Azure Active Directory認証は、
以下に示すDefaultAzureCredentialプロバイダー、またはAzure SDKに付属する他の認証情報提供者を使用するには、@azure/identityパッケージをインストールしてください:
npm install @azure/identity
また、 新しいAADアプリケーションを登録し、 サービス担当に適切な役割を割り当ててAzure Marketplaceへのアクセスを許可する必要があります(注: "Owner" のような役割は必要な権限を付与しません)。
Azure ADアプリケーションの作成方法についての詳細は、このガイドをご覧ください。
Node.js とノードに似た環境を使用すると、DefaultAzureCredential クラスを使用してクライアントを認証できます。
import { MarketplaceClient } from "@azure/arm-marketplace";
import { DefaultAzureCredential } from "@azure/identity";
const client = new MarketplaceClient(new DefaultAzureCredential());
ブラウザ環境では、InteractiveBrowserCredentialパッケージの @azure/identity を使って認証します。
import { InteractiveBrowserCredential } from "@azure/identity";
import { MarketplaceClient } from "@azure/arm-marketplace";
const credential = new InteractiveBrowserCredential({
tenantId: "<YOUR_TENANT_ID>",
clientId: "<YOUR_CLIENT_ID>",
});
const client = new MarketplaceClient(credential);
JavaScriptバンドル
ブラウザーでこのクライアント ライブラリを使用するには、まず、バンドルを使用する必要があります。 そのto doの詳細については、当社のバンドリングドキュメントをご参照ください。
主な概念
マーケットプレイスクライアント
MarketplaceClient はAzure Marketplaceクライアントライブラリを使用する開発者の主要なインターフェースです。 このクライアントオブジェクトのメソッドを探索して、アクセス可能なAzure Marketplaceサービスのさまざまな機能を理解しましょう。
Troubleshooting
ログ記録
ログ記録を有効にすると、エラーに関する有用な情報を明らかにするのに役立つ場合があります。 HTTP 要求と応答のログを表示するには、AZURE_LOG_LEVEL 環境変数を infoに設定します。 あるいは、実行時にsetLogLevelで@azure/loggerを呼び出すことでログログを有効にすることもできます:
import { setLogLevel } from "@azure/logger";
setLogLevel("info");
ログを有効にする方法の詳細な手順については、 @azure/logger パッケージのドキュメントを参照してください。
次のステップ
このライブラリの使用方法の詳細な例については、ディレクトリ
Contributing
このライブラリに貢献したい場合は、コードのビルドやテスト方法について詳しく知るために、contributing guideをお読みください。
関連プロジェクト
- Microsoft Azure SDK for JavaScript の
Azure SDK for JavaScript