Image الفصل

التفاعل مع الصور

توريث
Image

الدالمنشئ

Image(freta)

الأساليب

analyze

تحليل (أو إعادة تحليل) صورة تم تحميلها.

مثال TODO

cancel_analysis

إلغاء تحليل صورة تم تحميلها.

مثال TODO

delete

احذف صورة مع أي من التقارير التي تم إنشاؤها والبيانات الاصطناعية الأخرى.

formats

احصل على قائمة بتنسيقات الصور المدعومة حاليا.

مثال على النتيجة:


   {
       "lime": "LiME image",
       "raw": "Raw Physical Memory Dump",
       "vmrs": "Hyper-V Memory Snapshot"
   }
list

احصل على قائمة الصور وحالاتها.

مثال على النتيجة:


   [
       {
           "Timestamp": "2019-05-13 18:50:01",
           "image_id": "7fe75a61-b346-4a64-81f1-6389d12901f2",
           "image_type": "lime",
           "machine_id": "ubuntu-16.04-4.15.0-1040-azure",
           "owner_id": "986c3ebe-18e9-4c89-afad-1178c21603e1",
           "region": "eastus",
           "state": "Report available"
       }
   ]
search_filters

يسرد عوامل تصفية البحث المدعومة حاليا.

مثال على النتيجة:


   [
       "my_images",
       "my_images_and_samples"
   ]
status

احصل على حالة صورة واحدة.

مثال على النتيجة:


   {
       "Timestamp": "2019-06-11 19:03:17",
       "analysis_version": "0.0.0",
       "image_id": "23ca6dbe-4c6f-41c0-898e-82cdd56fcf4e",
       "image_type": "vmrs",
       "machine_id": "testing_upload_sas",
       "owner_id": "309fc32f-a06b-4821-a97b-194c271f9cc5",
       "region": "australiaeast",
       "state": "Upload started"
   }
update

تحديث بيانات التعريف لصورة.

مثال TODO

upload

تحميل ملف صورة وإرساله للتحليل.

مثال على النتيجة:


   {
       'image_id': '[guid string]',
       'owner_id': '[guid string]'
   }
upload_sas

احصل على SAS URIs الذي يخول (فقط) تحميل صورة وملف تعريف.

لا يقوم هذا الأسلوب بقائمة انتظار الصورة للتحليل. استدعاء self.analyze() مع image_id التي تم إرجاعها بعد كتابة بيانات الصورة.

مثال على النتيجة:


    {
       "image": {
           "sas_url": "https://fretaNNNN.blob.core.windows.net/..."
       },
       "image_id": "23ca6dbe-4c6f-41c0-898e-82cdd56fcf4e",
       "profile": {
           "sas_url": "https://fretaNNNN.blob.core.windows.net/..."
       },
       "result": True
   }

analyze

تحليل (أو إعادة تحليل) صورة تم تحميلها.

مثال TODO

analyze(image_id: str, owner_id: typing.Union[str, NoneType] = None)

المعلمات

image_id
مطلوب

معرف الصورة.

owner_id
مطلوب

بالنسبة للصور المملوكة للمجموعة، استخدم مالك الصورة.

المرتجعات

صواب

cancel_analysis

إلغاء تحليل صورة تم تحميلها.

مثال TODO

cancel_analysis(image_id: str, owner_id: typing.Union[str, NoneType] = None)

المعلمات

image_id
مطلوب

معرف الصورة.

owner_id
مطلوب

بالنسبة للصور المملوكة للمجموعة، استخدم مالك الصورة.

المرتجعات

صواب

delete

احذف صورة مع أي من التقارير التي تم إنشاؤها والبيانات الاصطناعية الأخرى.

delete(image_id: str, owner_id: typing.Union[str, NoneType] = None)

المعلمات

image_id
مطلوب

معرف Freta للصورة.

owner_id
مطلوب

userid اختياري لمالك الصورة (للصور المملوكة للمجموعة)

المرتجعات

صواب

formats

احصل على قائمة بتنسيقات الصور المدعومة حاليا.

مثال على النتيجة:


   {
       "lime": "LiME image",
       "raw": "Raw Physical Memory Dump",
       "vmrs": "Hyper-V Memory Snapshot"
   }
formats()

المرتجعات

Dict

list

احصل على قائمة الصور وحالاتها.

مثال على النتيجة:


   [
       {
           "Timestamp": "2019-05-13 18:50:01",
           "image_id": "7fe75a61-b346-4a64-81f1-6389d12901f2",
           "image_type": "lime",
           "machine_id": "ubuntu-16.04-4.15.0-1040-azure",
           "owner_id": "986c3ebe-18e9-4c89-afad-1178c21603e1",
           "region": "eastus",
           "state": "Report available"
       }
   ]
list(search_filter: typing.Union[str, NoneType] = None)

المعلمات

search_filter
مطلوب

تصفية نتائج البحث، استدعاء <xref:freta.Freta.search_filters> القيم المسموح بها.

المرتجعات

قائمة الإملاءات التي تحتوي على مفاتيح كما هو موضح أدناه.

search_filters

يسرد عوامل تصفية البحث المدعومة حاليا.

مثال على النتيجة:


   [
       "my_images",
       "my_images_and_samples"
   ]
search_filters()

المرتجعات

[str]

status

احصل على حالة صورة واحدة.

مثال على النتيجة:


   {
       "Timestamp": "2019-06-11 19:03:17",
       "analysis_version": "0.0.0",
       "image_id": "23ca6dbe-4c6f-41c0-898e-82cdd56fcf4e",
       "image_type": "vmrs",
       "machine_id": "testing_upload_sas",
       "owner_id": "309fc32f-a06b-4821-a97b-194c271f9cc5",
       "region": "australiaeast",
       "state": "Upload started"
   }
status(image_id: str, owner_id: typing.Union[str, NoneType] = None)

المعلمات

image_id
مطلوب

معرف Freta للصورة.

owner_id
مطلوب

userid لمالك الصورة (للصور المملوكة للمجموعة)

المرتجعات

Dict

update

تحديث بيانات التعريف لصورة.

مثال TODO

update(image_id: str, owner_id: typing.Union[str, NoneType] = None, name: typing.Union[str, NoneType] = None)

المعلمات

image_id
مطلوب

معرف Freta للصورة

owner_id
مطلوب

بالنسبة للصور المملوكة للمجموعة، استخدم مالك الصورة.

name
مطلوب

تعيين معرف الجهاز المحدد للمستخدم للصورة اختياريا

upload

تحميل ملف صورة وإرساله للتحليل.

مثال على النتيجة:


   {
       'image_id': '[guid string]',
       'owner_id': '[guid string]'
   }
upload(name: str, image_type: str, region: str, image: <function NewType.<locals>.new_type at 0x000001E3C872E840>, profile: typing.Union[File, NoneType] = None)

المعلمات

name
مطلوب

الاسم المحدد من قبل المستخدم للصورة.

image_type
مطلوب

تنسيق الصورة. راجع <xref:freta.Freta.formats> القيم المسموح بها.

region
مطلوب

المنطقة التي سيتم تخزين الصورة ومعالجتها فيها. راجع <xref:freta.Freta.regions> القيم المسموح بها.

image
مطلوب

مسار نظام الملفات إلى ملف الصورة.

profile
مطلوب

مسار نظام الملفات إلى ملف تعريف النواة. (اختياري)

المرتجعات

Dict

upload_sas

احصل على SAS URIs الذي يخول (فقط) تحميل صورة وملف تعريف.

لا يقوم هذا الأسلوب بقائمة انتظار الصورة للتحليل. استدعاء self.analyze() مع image_id التي تم إرجاعها بعد كتابة بيانات الصورة.

مثال على النتيجة:


    {
       "image": {
           "sas_url": "https://fretaNNNN.blob.core.windows.net/..."
       },
       "image_id": "23ca6dbe-4c6f-41c0-898e-82cdd56fcf4e",
       "profile": {
           "sas_url": "https://fretaNNNN.blob.core.windows.net/..."
       },
       "result": True
   }
upload_sas(name: str, image_type: str, region: str)

المعلمات

name
مطلوب

اسم الصورة.

image_type
مطلوب

تنسيق الصورة. راجع <xref:freta.Freta.formats> القيم المسموح بها.

region
مطلوب

المنطقة التي سيتم تخزين الصورة ومعالجتها فيها. راجع Freta.regions للحصول على القيم المسموح بها. ارتباط TODO

المرتجعات

Dict