JavaScript 用 Azure CosmosDBManagement クライアント ライブラリ - バージョン 16.1.0
このパッケージには、Azure CosmosDBManagement クライアント用の同型 SDK (Node.js とブラウザーの両方で実行されます) が含まれています。
Azure Cosmos DB データベース サービス リソース プロバイダー REST API
ソース コード | パッケージ (NPM) | API リファレンス ドキュメント | サンプル
はじめ
現在サポートされている環境
- Node.js の LTS バージョンを
する - Safari、Chrome、Edge、Firefox の最新バージョン。
詳細については、サポート ポリシーの を参照してください。
前提 条件
@azure/arm-cosmosdb パッケージをインストールする
npmを使用して JavaScript 用 Azure CosmosDBManagement クライアント ライブラリをインストールします。
npm install @azure/arm-cosmosdb
CosmosDBManagementClient を作成して認証する
Azure CosmosDBManagement API にアクセスするためのクライアント オブジェクトを作成するには、Azure CosmosDBManagement リソースの endpoint と credentialが必要です。 Azure CosmosDBManagement クライアントは、Azure Active Directory 資格情報を使用して認証できます。
Azure CosmosDBManagement リソースのエンドポイントは、Azure Portalにあります。
以下に示す DefaultAzureCredential プロバイダー、または Azure SDK で提供されているその他の資格情報プロバイダーを使用するには、@azure/identity パッケージをインストールしてください。
npm install @azure/identity
また、サービス プリンシパルに適切なロールを割り当てることで、新しい AAD アプリケーションを登録し、Azure CosmosDBManagement へのアクセス権を付与する AZURE_CLIENT_ID、AZURE_TENANT_ID、AZURE_CLIENT_SECRET) として設定します。
Azure AD アプリケーションを作成する方法の詳細については、このガイド
const { CosmosDBManagementClient } = require("@azure/arm-cosmosdb");
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 CosmosDBManagementClient(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 CosmosDBManagementClient(credential, subscriptionId);
JavaScript バンドル
ブラウザーでこのクライアント ライブラリを使用するには、まず、バンドルを使用する必要があります。 これを行う方法の詳細については、
主な概念
CosmosDBManagementClient
CosmosDBManagementClient は、Azure CosmosDBManagement クライアント ライブラリを使用する開発者向けの主要なインターフェイスです。 このクライアント オブジェクトのメソッドを調べて、アクセスできる Azure CosmosDBManagement サービスのさまざまな機能を理解します。
トラブルシューティング
伐採
ログ記録を有効にすると、エラーに関する有用な情報を明らかにするのに役立つ場合があります。 HTTP 要求と応答のログを表示するには、AZURE_LOG_LEVEL 環境変数を infoに設定します。 または、setLogLevelで @azure/logger を呼び出すことによって、実行時にログを有効にすることもできます。
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
ログを有効にする方法の詳細な手順については、@azure/logger パッケージのドキュメントを参照してください。
次の手順
このライブラリの使用方法の詳細な例については、ディレクトリ
貢献
このライブラリに投稿する場合は、コードをビルドしてテストする方法の詳細については、投稿ガイド を参照してください。
関連プロジェクト
- Microsoft Azure SDK for JavaScript の
Azure SDK for JavaScript