مشاركة عبر

مكتبة عميل Azure CosmosDBManagement ل JavaScript - الإصدار 16.1.0

  • مقالة

تحتوي هذه الحزمة على SDK غير متحول (يعمل في كل من Node.js والمستعرضات) لعميل Azure CosmosDBManagement.

واجهة برمجة تطبيقات REST لموفر موارد خدمة قاعدة بيانات Azure Cosmos DB

وثائق مرجع | التعليمات البرمجية المصدر (NPM) | API | عينات

الشروع

البيئات المدعومة حاليا

  • إصدارات LTS من Node.js
  • أحدث إصدارات Safari وChrome وEdge وFirefox.

راجع نهج دعم للحصول على مزيد من التفاصيل.

المتطلبات المسبقه

  • اشتراك Azure .

تثبيت حزمة @azure/arm-cosmosdb

تثبيت مكتبة عميل Azure CosmosDBManagement ل JavaScript مع npm:

npm install @azure/arm-cosmosdb

إنشاء CosmosDBManagementClient ومصادقته

لإنشاء كائن عميل للوصول إلى Azure CosmosDBManagement API، ستحتاج إلى endpoint لمورد Azure CosmosDBManagement الخاص بك credential. يمكن لعميل Azure CosmosDBManagement استخدام بيانات اعتماد Azure Active Directory للمصادقة. يمكنك العثور على نقطة النهاية لمورد Azure CosmosDBManagement في مدخل Azure.

يمكنك المصادقة باستخدام Azure Active Directory باستخدام بيانات اعتماد من مكتبة @azure/الهوية أو رمز AAD المميز الموجود.

لاستخدام موفر الافتراضي AzureCredential الموضح أدناه، أو موفري بيانات الاعتماد الآخرين المقدمين مع Azure SDK، يرجى تثبيت حزمة :

npm install @azure/identity

ستحتاج أيضا إلى تسجيل تطبيق AAD جديد ومنح حق الوصول إلى Azure CosmosDBManagement عن طريق تعيين الدور المناسب لمدير الخدمة (ملاحظة: لن تمنح الأدوار مثل "Owner" الأذونات اللازمة). تعيين قيم معرف العميل ومعرف المستأجر وسر العميل لتطبيق AAD كمتغيرات بيئة: AZURE_CLIENT_IDAZURE_TENANT_IDAZURE_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/المسجل.

الخطوات التالية

يرجى إلقاء نظرة على نماذج الدليل للحصول على أمثلة مفصلة حول كيفية استخدام هذه المكتبة.

المساهمه

إذا كنت ترغب في المساهمة في هذه المكتبة، فيرجى قراءة دليل المساهمة لمعرفة المزيد حول كيفية إنشاء التعليمات البرمجية واختبارها.

مرات الظهور