تحميل ملف لتحليله
يتطلب بدء مهمة التحليل مسارًا إلى Azure blob يمكن الوصول اليه بواسطة عنوان URL. يتم توفير القدرة علي تحميل ملف إلى مساحة تخزين Azure blob في المنطقة الجغرافية المحددة باستخدام خدمة التحميل. وليس من الضروري ان يتم استخدام واجهة برمجة التطبيقات للتحميل لتشغيل التحليل. يمكنك التحميل باستخدام طلب POST لما يلي: [Geographical URI]/api/upload?api-version=1.0. يمكن تحميل ملف يصل حجمه حتى 30 ميغابايت. إذا أردت تحميل ملفات أكبر حجمًا، فستحتاج إلى توفير مساحة تخزين Azure يمكن الوصول إليها خارجيًا بالإضافة إلى SAS URI.
ملاحظة
تتطلب واجهة برمجة التطبيقات هذه رمزا مميزا OAuth .
الرؤوس
| الاسم | نوع | القيمة المتوقعة | مطلوب؟ |
|---|---|---|---|
| التصريح | string | المطالبة بالرمز OAuth المميز للحامل 1 مع Microsoft Entra معرف معرف التطبيق. | نعم |
| x-ms-tenant-id | معرف Guid | معرف المستأجر الخاص بالتطبيق. | نعم |
| x-ms-correlation-id | GUID | معرف تشغيل التحليل. يجب عليك توفير المعرف نفسه للتنفيذ بالكامل (التحميل والتحليل والحالة). | نعم |
| نوع المحتوى | كائن | البيانات متعددة الأشكال/النماذج | نعم |
| تنظيم المحتوى | كائن | قم بتضمين معلمات الاسم واسم الملف، على سبيل المثال:form-data; name="solution1.zip"; filename="solution1.zip" |
نعم |
الاستجابات المتوقعة
| رمز حالة HTTP | السيناريو | نتيجة |
|---|---|---|
| 200 | نجحت عملية التحميل | لا يوجد نص نتيجة |
| 400 | تم إرسال ملف ليس من نوع zip، أو تم تضمين معلمات غير صحيحة، أو تم تضمين ملف مع فيروس | لا يوجد نص نتيجة |
| 413 | الملف كبير جدًا | لا يوجد نص نتيجة |
مثال: تحميل ملف
يوضح هذا المثال كيفية تحميل ملف يمكن تحليله.
طلب
POST [Geographical URI]/api/upload
Accept: application/json
x-ms-correlation-id: aaaa0000-bb11-2222-33cc-444444dddddd
x-ms-tenant-id: aaaabbbb-0000-cccc-1111-dddd2222eeee
Content-Type: multipart/form-data
Content-Disposition: form-data; name=mySolution.zip; filename=mySolution.zip
رد
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
["https://mystorage.blob.core.windows.net/solution-files/0a4cd700-d1d0-4ef8-8318-e4844cc1636c/mySolution.zip?sv=2017-11-09&sr=b&sig=xyz&se=2019-06-11T19%3A05%3A20Z&sp=rd"]
راجع أيضًا
استخدام واجهة برمجة تطبيقات الويب المدقق Power Apps
استرداد قائمة مجموعات القواعد
استرداد قائمة القواعد
استدعاء التحليل
تحقق من حالة التحليل