JavaScript 用 Azure ImageBuilder クライアント ライブラリ - バージョン 4.1.0

このパッケージには、Azure ImageBuilder クライアント用の同型 SDK (Node.js とブラウザーの両方で実行されます) が含まれています。

Azure Virtual Machine Image Builder クライアント

ソース コード | パッケージ (NPM) | API リファレンス ドキュメント | サンプル

はじめ

現在サポートされている環境

  • Node.js の LTS バージョンを する
  • Safari、Chrome、Edge、Firefox の最新バージョン。

詳細については、サポート ポリシーの を参照してください。

前提 条件

@azure/arm-imagebuilder パッケージをインストールする

npmを使用して JavaScript 用 Azure ImageBuilder クライアント ライブラリをインストールします。

npm install @azure/arm-imagebuilder

ImageBuilderClient を作成して認証する

Azure ImageBuilder API にアクセスするためのクライアント オブジェクトを作成するには、Azure ImageBuilder リソースの endpointcredentialが必要です。 Azure ImageBuilder クライアントは、Azure Active Directory 資格情報を使用して認証できます。 Azure ImageBuilder リソースのエンドポイントは、Azure Portalにあります。

@azure/ID ライブラリの資格情報を使用するか、既存の AAD トークンを して、Azure Active Directory で認証できます。

以下に示す DefaultAzureCredential プロバイダー、または Azure SDK で提供されているその他の資格情報プロバイダーを使用するには、@azure/identity パッケージをインストールしてください。

npm install @azure/identity

また、サービス プリンシパルに適切なロールを割り当てることで、新しい AAD アプリケーションを登録し、Azure ImageBuilder へのアクセス権を付与 必要があります (注: などのロールは、必要なアクセス許可を付与しません)。 AAD アプリケーションのクライアント ID、テナント ID、クライアント シークレットの値を環境変数 (AZURE_CLIENT_IDAZURE_TENANT_IDAZURE_CLIENT_SECRET) として設定します。

Azure AD アプリケーションを作成する方法の詳細については、このガイド確認してください。

const { ImageBuilderClient } = require("@azure/arm-imagebuilder");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ImageBuilderClient(new DefaultAzureCredential(), subscriptionId);

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new ImageBuilderClient(credential, subscriptionId);

JavaScript バンドル

ブラウザーでこのクライアント ライブラリを使用するには、まず、バンドルを使用する必要があります。 これを行う方法の詳細については、バンドルドキュメントを参照してください。

主な概念

ImageBuilderClient

ImageBuilderClient は、Azure ImageBuilder クライアント ライブラリを使用する開発者向けの主要なインターフェイスです。 このクライアント オブジェクトのメソッドを調べて、アクセスできる Azure ImageBuilder サービスのさまざまな機能を理解します。

トラブルシューティング

伐採

ログ記録を有効にすると、エラーに関する有用な情報を明らかにするのに役立つ場合があります。 HTTP 要求と応答のログを表示するには、AZURE_LOG_LEVEL 環境変数を infoに設定します。 または、@azure/loggersetLogLevel を呼び出すことによって、実行時にログを有効にすることもできます。

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

ログを有効にする方法の詳細な手順については、@azure/logger パッケージのドキュメントを参照してください。

次の手順

このライブラリの使用方法の詳細な例については、ディレクトリ サンプルを参照してください。

貢献

このライブラリに投稿する場合は、コードをビルドしてテストする方法の詳細については、投稿ガイド を参照してください。

  • Microsoft Azure SDK for JavaScript の

インプレッション