روابط إخراج Azure وظائف HTTP

استخدم ربط البيانات إخراج HTTP للاستجابة إلى مرسل طلب HTTP (مشغل HTTP). يتطلب هذا الربط مشغل بروتوكول نقل نص تشعبي ويسمح لك بتخصيص الاستجابة المقترنة بطلب المشغّل.

القيمة المرجعة الافتراضية لدالة مشغّل HTTP هي:

• HTTP 204 No Content مع وجود نص فارغ في دالات 2.x وأعلى
• HTTP 200 OK مع وجود نص فارغ في دالات 1.x

السمة

نموذج عامل معزول

سمة القيمة المرجعة غير مطلوبة عند استخدام HttpResponseData. ومع ذلك، عند استخدام تكامل ASP.NET Core وعناصر الإخراج متعددة الربط، يجب تطبيق السمة [HttpResultAttribute] على خاصية الكائن. لا تأخذ السمة أي معلمات. لمعرفة المزيد، راجع الاستخدام.

نموذج قيد المعالجة

هام

سينتهي الدعم للنموذج قيد التنفيذ في 10 نوفمبر 2026. نوصي بشدة بترحيل تطبيقاتك إلى نموذج العامل المعزول للحصول على الدعم الكامل.

سمة القيمة المرجعة غير مطلوبة لمكتبة فئات. يستخدم البرنامج النصي C# بدلا من ذلك ملف تكوين function.json كما هو موضح في دليل البرمجة النصية C#. لمعرفة المزيد، راجع الاستخدام.

تعليقات توضيحية

في مكتبة وقت تشغيل وظائف Java، استخدم التعليق التوضيحي HttpOutput لتعريف متغير إخراج آخر غير المتغير الافتراضي الذي تم إرجاعه بواسطة الدالة. يدعم هذا التعليق التوضيحي الإعدادات التالية:

• نوع البيانات
• الاسم

هام

تستخدم هذه المقالة علامات التبويب لدعم إصدارات متعددة من نموذج البرمجة Node.js. يتوفر نموذج v4 بشكل عام وتم تصميمه للحصول على تجربة أكثر مرونة وبديهية لمطوري JavaScript وTypeScript. لمزيد من التفاصيل حول كيفية عمل نموذج v4، راجع دليل مطور Azure Functions Node.js. لمعرفة المزيد حول الاختلافات بين v3 وv4، راجع دليل الترحيل.

التكوين

الطراز v4

options لا يدعم الكائن الذي تم تمريره output.http() إلى الأسلوب حاليا أي خصائص للنموذج v4.

الطراز v3

يشرح الجدول الآتي خصائص تكوين ربط البيانات التي عليك تعيينها في ملف function.json.

الخاصية	الوصف
النوع	يجب تعيينه إلى http.
الاتجاه	يجب تعيينه إلى out.
الاسم	اسم المتغيّر المستخدم في تعليمة برمجية للدالة للاستجابة أو $return لاستخدام القيمة المرجعة.

التكوين

يشرح الجدول الآتي خصائص تكوين ربط البيانات التي عليك تعيينها في ملف function.json.

الخاصية	الوصف
النوع	يجب تعيينه إلى http.
الاتجاه	يجب تعيينه إلى out.
الاسم	اسم المتغيّر المستخدم في تعليمة برمجية للدالة للاستجابة أو $return لاستخدام القيمة المرجعة.

الاستخدام

لإرسال استجابة HTTP، استخدم أنماط الاستجابة القياسية للغة.

في .NET، يعتمد نوع الاستجابة على وضع C#‎:

نموذج عامل معزول

ترجع الدالة HTTP المشغلة كائنا من أحد الأنواع التالية:

• IActionResult¹ (أو Task<IActionResult>)
• HttpResponse¹ (أو Task<HttpResponse>)
• HttpResponseData (أو Task<HttpResponseData>)
• أنواع JSON القابلة للتسلسل التي تمثل نص الاستجابة للاستجابة 200 OK .

¹ يتوفر هذا النوع فقط عند استخدام تكامل ASP.NET Core.

عند استخدام أحد هذه الأنواع كجزء من كائنات الإخراج متعددة الربط، يجب تطبيق السمة [HttpResult] على خاصية الكائن. لا تأخذ السمة أي معلمات.

نموذج قيد المعالجة

ترجع الدالة HTTP المشغلة نوعا من IActionResult أو Task<IActionResult>.

بالنسبة إلى Java، استخدم HttpResponseMessage.Builder لإنشاء استجابة لمشغل HTTP. لمعرفة المزيد، راجع HttpRequestMessage وHttpResponseMessage.

على سبيل المثال الاستجابات، راجع مثال مشغّل.

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

• تشغيل دالة من طلب HTTP