مكتبة عملاء Azure iotDps for JavaScript - الإصدار 6.0.0

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

واجهة برمجة التطبيقات لاستخدام ميزات خدمة توفير جهاز Azure IoT Hub.

الارتباطات الرئيسية:

الشروع

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

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

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

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

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

قم بتثبيت مكتبة عميل Azure iotDps لجافا سكريبت باستخدام npm:

npm install @azure/arm-deviceprovisioningservices

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

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

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

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

npm install @azure/identity

ستحتاج أيضا إلى تسجيل تطبيق AAD جديد ومنح حق الوصول إلى Azure iotDps عن طريق تعيين الدور المناسب لكيان الخدمة (ملاحظة: الأدوار مثل "Owner" التي لن تمنح الأذونات اللازمة).

لمزيد من المعلومات حول كيفية إنشاء تطبيق Azure AD، راجع هذا الدليل.

باستخدام بيئات Node.js والعقدة، يمكنك استخدام فئة DefaultAzureCredential لمصادقة العميل.

import { IotDpsClient } from "@azure/arm-deviceprovisioningservices";
import { DefaultAzureCredential } from "@azure/identity";

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

بالنسبة لبيئات المستعرض، استخدم InteractiveBrowserCredential من حزمة @azure/identity للمصادقة.

import { InteractiveBrowserCredential } from "@azure/identity";
import { IotDpsClient } from "@azure/arm-deviceprovisioningservices";

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

حزمة JavaScript

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

المفاهيم الرئيسية

عميل إنترنت نت Dps

IotDpsClient هي الواجهة الأساسية للمطورين الذين يستخدمون مكتبة عميل Azure iotDps. استكشف الأساليب الموجودة على عنصر العميل هذا لفهم الميزات المختلفة لخدمة Azure iotDps التي يمكنك الوصول إليها.

استكشاف الأخطاء وإصلاحها

تسجيل

قد يساعد تمكين التسجيل في الكشف عن معلومات مفيدة حول حالات الفشل. لمشاهدة سجل طلبات واستجابات HTTP، قم بتعيين متغير البيئة AZURE_LOG_LEVEL إلى info. بدلا من ذلك، يمكن تمكين التسجيل في وقت التشغيل عن طريق استدعاء setLogLevel في @azure/logger:

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

setLogLevel("info");

للحصول على إرشادات أكثر تفصيلا حول كيفية تمكين السجلات، يمكنك إلقاء نظرة على مستندات حزمة @azure/المسجل.

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

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

المساهمه

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