このパッケージには、AzureStackHCIVMManagement クライアント用の同型 SDK (Node.js とブラウザーの両方で実行) が含まれています。
Azure Stack HCI 管理サービス
主なリンク:
作業の開始
現在サポートされている環境
- Node.js の LTS バージョン
- Safari、Chrome、Edge、Firefoxの最新バージョン。
詳細については、 サポートポリシー を参照してください。
[前提条件]
@azure/arm-azurestackhcivm パッケージをインストールする
JavaScript 用の AzureStackHCIVMManagement クライアント ライブラリを npm でインストールします。
npm install @azure/arm-azurestackhcivm
の作成と認証 AzureStackHCIVMManagementClient
AzureStackHCIVMManagement API にアクセスするためのクライアント オブジェクトを作成するには、AzureStackHCIVMManagement リソースと credential のendpointが必要です。 AzureStackHCIVMManagement クライアントは、Azure Active Directory 資格情報を使用して認証できます。
AzureStackHCIVMManagement リソースのエンドポイントは、 Azure Portal で確認できます。
Azure Active Directory では、 @azure/ID ライブラリの資格情報または 既存の AAD トークンを使用して認証できます。
次に示す DefaultAzureCredential プロバイダー、または Azure SDK で提供される他の資格情報プロバイダーを使用するには、 @azure/identity パッケージをインストールしてください。
npm install @azure/identity
また、新しい AAD アプリケーションを登録し、サービス プリンシパルに適切なロールを割り当てて AzureStackHCIVMManagement へのアクセス 権を付与する必要があります (注: "Owner" などのロールでは、必要なアクセス許可は付与されません)。
Azure AD アプリケーションの作成方法の詳細については、 このガイドを参照してください。
Node.js および Node のような環境を使用すると、 DefaultAzureCredential クラスを使用してクライアントを認証できます。
import { AzureStackHCIVMManagementClient } from "@azure/arm-azurestackhcivm";
import { DefaultAzureCredential } from "@azure/identity";
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AzureStackHCIVMManagementClient(new DefaultAzureCredential(), subscriptionId);
ブラウザ環境の場合は、@azure/identity パッケージのInteractiveBrowserCredentialを使用して認証します。
import { InteractiveBrowserCredential } from "@azure/identity";
import { AzureStackHCIVMManagementClient } from "@azure/arm-azurestackhcivm";
const credential = new InteractiveBrowserCredential({
tenantId: "<YOUR_TENANT_ID>",
clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AzureStackHCIVMManagementClient(credential, subscriptionId);
JavaScriptバンドル
このクライアントライブラリをブラウザで使用するには、まずバンドラーを使用する必要があります。 これを行う方法の詳細については、 バンドルのドキュメントを参照してください。
重要な概念
AzureStackHCIVMManagementClient
AzureStackHCIVMManagementClient は、AzureStackHCIVMManagement クライアント ライブラリを使用する開発者向けのプライマリ インターフェイスです。 このクライアント オブジェクトのメソッドを調べて、アクセスできる AzureStackHCIVMManagement サービスのさまざまな機能を理解します。
トラブルシューティング
ロギング(記録)
ログを有効にすると、障害に関する有用な情報を発見するのに役立つ場合があります。 HTTP 要求と応答のログを表示するには、 AZURE_LOG_LEVEL 環境変数を info に設定します。 または、@azure/loggerで setLogLevel を呼び出して、実行時にログ記録を有効にすることもできます。
import { setLogLevel } from "@azure/logger";
setLogLevel("info");
ログを有効にする方法の詳細については、 @azure/logger パッケージのドキュメントを参照してください。
次のステップ
このライブラリの詳細な使用例については、 サンプル ディレクトリをご覧ください。
Contributing
このライブラリに投稿する場合は、コードをビルドしてテストする方法の詳細については、投稿ガイド を参照してください。
関連プロジェクト
- Microsoft Azure SDK for JavaScript の
Azure SDK for JavaScript