مكتبة عميل 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
npm install @azure/identity
ستحتاج أيضا إلى تسجيل تطبيق AAD جديد ومنح حق الوصول إلى Azure CosmosDBManagement عن طريق تعيين الدور المناسب لمدير الخدمة (ملاحظة: لن تمنح الأدوار مثل "Owner"
الأذونات اللازمة).
تعيين قيم معرف العميل ومعرف المستأجر وسر العميل لتطبيق AAD كمتغيرات بيئة: 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/المسجل.
الخطوات التالية
يرجى إلقاء نظرة على نماذج الدليل للحصول على أمثلة مفصلة حول كيفية استخدام هذه المكتبة.
المساهمه
إذا كنت ترغب في المساهمة في هذه المكتبة، فيرجى قراءة دليل المساهمة لمعرفة المزيد حول كيفية إنشاء التعليمات البرمجية واختبارها.
المشاريع ذات الصلة
مرات الظهور
Azure SDK for JavaScript