JavaScript 用 Azure PortalServices クライアントライブラリ - バージョン 1.0.0-beta.1

2025-04-30

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

Azure Portal Services API リファレンス

主要なリンク:

作業の開始

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

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

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

[前提条件]

Azure サブスクリプション。

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

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

npm install @azure/arm-portalservicescopilot

`PortalServicesClient` を作成して認証する

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

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

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

npm install @azure/identity

また、サービスプリンシパルに適切なロールを割り当てることで、 新しい AAD アプリケーションを登録し、Azure PortalServices へのアクセス 権を付与する必要があります (注: "Owner" などのロールは、必要なアクセス許可を付与しません)。

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

Node.js とノードに似た環境を使用すると、DefaultAzureCredential クラスを使用してクライアントを認証できます。

import { PortalServicesClient } from "@azure/arm-portalservicescopilot";
import { DefaultAzureCredential } from "@azure/identity";

const client = new PortalServicesClient(new DefaultAzureCredential());

ブラウザー環境では、InteractiveBrowserCredential パッケージの @azure/identity を使用して認証します。

import { InteractiveBrowserCredential } from "@azure/identity";
import { PortalServicesClient } from "@azure/arm-portalservicescopilot";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>"
 });
const client = new PortalServicesClient(credential);

JavaScript バンドル

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

重要な概念

PortalServicesClient

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

トラブルシューティング

ロギング（記録）

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

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

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

次のステップ

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

投稿

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

Microsoft Azure SDK for JavaScript の

次の方法で共有

JavaScript 用 Azure PortalServices クライアント ライブラリ - バージョン 1.0.0-beta.1