Azure ConnectedCache client library for JavaScript - バージョン 1.0.0

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

Microsoft Connected Cache Rest Api バージョン 2023-05-01-preview

主要なリンク:

作業の開始

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

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

前提条件

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

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

npm install @azure/arm-connectedcache

ConnectedCacheClient を作成して認証する

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

Azure Active Directory認証は、@azure/identityライブラリの認証情報や、既存のAADトークン>で認証できます。

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

npm install @azure/identity

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

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

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

import { ConnectedCacheClient } from "@azure/arm-connectedcache";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { ConnectedCacheClient } from "@azure/arm-connectedcache";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new ConnectedCacheClient(credential, subscriptionId);

JavaScript バンドル

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

主な概念

ConnectedCacheClient

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

Troubleshooting

Logging

ログ記録を有効にすると、エラーに関する有用な情報を明らかにするのに役立つ場合があります。 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 の
  • Last updated on