@azure/core-client package

تهيئة مثيل جديد من ServiceClient.

يستخدم لتكوين نهج إضافية تمت إضافتها إلى البنية الأساسية لبرنامج ربط العمليات التجارية عند الإنشاء.

التعريف الأساسي للمخطط. يمكن استخدامها لعناصر XML وJavaScript العادية.

من المتوقع أن تعرض المجموعة الشائعة من الخيارات التي من المتوقع أن يعرضها العملاء عاليو المستوى.

معين يتكون من معينين آخرين.

يساعد في إنشاء معين يصف كيفية تعيين مجموعة من خصائص كائن استنادا إلى معينين آخرين.

يجب أن تكون إحدى الخصائص التالية موجودة فقط: classNamemodelPropertiesadditionalProperties.

أنواع المحتوى التي تشير إلى أنه يجب إلغاء تسلسل استجابة العملية بطريقة معينة.

خيارات لتكوين إلغاء تسلسل استجابة واجهة برمجة التطبيقات.

مخطط يصف كائنات JavaScript العادية المستخدمة كأزواج مفاتيح/قيمة.

يساعد في إنشاء معين يصف كيفية تحليل قاموس القيم المعينة.

معين يصف قيمة قائمة تعداد.

يساعد في إنشاء معين يصف كيفية تحليل قيمة قائمة تعداد.

كائن برنامج التضمين لطلب واستجابة http. يتم تخزين الكائن الذي تم إلغاء تسلسله في الخاصية parsedBody عند تلقي نص الاستجابة في JSON أو XML.

خيارات لإنشاء مسار لاستخدامه مع ServiceClient. غالبا لتخصيص نهج المصادقة (إذا كنت تستخدم مصادقة الرمز المميز) أو خيارات إلغاء التسلسل عند استخدام XML.

وصف قيود القيمة المختلفة مثل نطاقات الأعداد الصحيحة وسلسلة regex.

مجموعة من الخصائص التي تنطبق على استدعاء واحد لعملية.

نوع الخيارات الأساسية لكافة العمليات.

واجهة شائعة تقوم كافة معلمة العملية بتوسيعها.

معلمة لعملية ستتم إضافتها كمعلمة استعلام إلى طلب HTTP الخاص بالعملية.

بيانات التعريف المستخدمة لتحليل استجابة بشكل صحيح.

الخيارات المستخدمة عند إنشاء طلبات HTTP وإرسالها لهذه العملية.

OperationResponse الذي يمكن إرجاعه من طلب عملية لرمز حالة واحد.

مواصفات تحدد عملية.

معلمة لعملية سيتم استبدالها في عنوان URL لطلب العملية.

تستخدم لإزالة الغموض عن اتحادات النوع التمييزي. على سبيل المثال، إذا كان يمكن أن تحتوي الاستجابة على العديد من الأشكال ولكنها تتضمن أيضا حقل "نوع" (أو ما شابه ذلك)، يمكن استخدام هذا الحقل لتحديد كيفية إلغاء تسلسل الاستجابة إلى النوع الصحيح.

معين يصف الصفائف.

يساعد في إنشاء معين يصف كيفية توزيع تسلسل من القيم المعينة.

خيارات لتكوين تسلسل طلب واجهة برمجة التطبيقات.

يستخدم لتعيين كائنات الاستجابة الأولية إلى الأشكال النهائية. يساعد على تعبئة التواريخ وفك حزمها والأنواع الأخرى المشفرة التي ليست مضمنة في JSON. يسمح أيضا بسحب القيم من الرؤوس، بالإضافة إلى إدراج القيم والثوابت الافتراضية.

خيارات لتكوين سلوك التسلسل/إلغاء التسلسل.

الخيارات التي سيتم توفيرها أثناء إنشاء العميل.

نوع معين بسيط.

تكوين لإنشاء امتداد تتبع جديد

خيارات لتنظيم سلوك محلل xml ومنشئه.

Mappers هي تعريفات لنماذج البيانات المستخدمة في المكتبة. نماذج البيانات هذه هي جزء من تعريفات العملية أو العميل في الاستجابات أو المعلمات.

نوع المعين. يتضمن المخططين المعروفين.

اسم مستعار للنوع للتدقيق المستقبلي.

ترميز كيفية الوصول إلى خاصية معينة على كائن.

التنسيق الذي سيتم استخدامه لضم صفيف من القيم معا لقيمة معلمة استعلام.

دالة سيتم استدعاؤها في كل مرة يتم فيها تلقي استجابة من الخادم أثناء تنفيذ العملية المطلوبة. قد يتم استدعاؤه عدة مرات.

يمكن استخدام هذه الدالة كرد اتصال bearerTokenAuthenticationPolicy@azure/core-rest-pipeline، لدعم تحديات CAE: تقييم الوصول المستمر.

اتصل bearerTokenAuthenticationPolicy بالخيارات التالية:

import { bearerTokenAuthenticationPolicy } from "@azure/core-rest-pipeline";
import { authorizeRequestOnClaimChallenge } from "@azure/core-client";

const policy = bearerTokenAuthenticationPolicy({
  challengeCallbacks: {
    authorizeRequestOnChallenge: authorizeRequestOnClaimChallenge,
  },
  scopes: ["https://service/.default"],
});

بمجرد توفيرها، سيتعامل نهج bearerTokenAuthenticationPolicy داخليا مع تحديات تقييم الوصول المستمر (CAE). عندما لا يتمكن من إكمال تحدي، فإنه سيعيد استجابة 401 (غير مصرح به) من ARM.

مثال على الطعن في المطالبات:

Bearer authorization_uri="https://login.windows-ppe.net/", error="invalid_token",
error_description="User session has been revoked",
claims="eyJhY2Nlc3NfdG9rZW4iOnsibmJmIjp7ImVzc2VudGlhbCI6dHJ1ZSwgInZhbHVlIjoiMTYwMzc0MjgwMCJ9fX0="

يحدد رد الاتصال للتعامل مع تحدي المصادقة لواجهات برمجة تطبيقات التخزين. هذا ينفذ عملية تحدي الحامل الموضحة هنا: https://learn.microsoft.com/rest/api/storageservices/authorize-with-azure-active-directory#bearer-challenge معالجة لها ميزات محددة للتخزين الذي يغادر إلى مستندات تحدي AAD العامة.

إنشاء مسار جديد للاستخدام مع عميل الخدمة. يضيف في إلغاء التسلسلPolicy بشكل افتراضي. يضيف أيضا في bearerTokenAuthenticationPolicy إذا تم تمرير TokenCredential.

الأسلوب الذي يقوم بإنشاء جهاز تسلسل وإرجاعه.

يعالج هذا النهج تحليل الاستجابات وفقا ل OperationSpecs عند الطلب.

يعالج هذا النهج تجميع نص الطلب والعناوين باستخدام OperationSpec و OperationArguments عند الطلب.