Olvasás angol nyelven

Megosztás a következőn keresztül:


Image Osztály

Képek kezelése

Öröklődés
Image

Konstruktor

Image(freta)

Metódusok

analyze

Feltöltött kép elemzése (vagy újraelemzése).

PÉLDA TODO-ra

cancel_analysis

A feltöltött kép elemzésének megszakítása.

PÉLDA TODO-ra

delete

A létrehozott jelentésekkel és egyéb összetevőkkel együtt töröljön egy képet.

formats

A jelenleg támogatott képformátumok listájának lekérése.

Példa eredmény:


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

Kérje le a képek listáját és állapotát.

Példa eredmény:


   [
       {
           "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

Felsorolja a jelenleg támogatott keresési szűrőket.

Példa eredmény:


   [
       "my_images",
       "my_images_and_samples"
   ]
status

Egyetlen kép állapotának lekérése.

Példa eredmény:


   {
       "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

Kép metaadatainak frissítése.

PÉLDA TODO-ra

upload

Töltsön fel egy képfájlt, és küldje el elemzésre.

Példa eredmény:


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

Szerezze be az SAS URI-kat, hogy engedélyezzék (csak) egy kép és egy profil feltöltését.

Ez a metódus nem várólistára állítja a rendszerképet elemzés céljából. Hívja meg a self.analyze() függvényt a visszaadott image_id a képadatok írása után.

Példa eredmény:


    {
       "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

Feltöltött kép elemzése (vagy újraelemzése).

PÉLDA TODO-ra

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

Paraméterek

image_id
Kötelező

Képazonosító.

owner_id
Kötelező

Csoport tulajdonában lévő képek esetén a rendszerkép tulajdonosának felhasználóazonosítója.

Válaszok

Igaz

cancel_analysis

A feltöltött kép elemzésének megszakítása.

PÉLDA TODO-ra

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

Paraméterek

image_id
Kötelező

Képazonosító.

owner_id
Kötelező

Csoport tulajdonában lévő képek esetén a rendszerkép tulajdonosának felhasználóazonosítója.

Válaszok

Igaz

delete

A létrehozott jelentésekkel és egyéb összetevőkkel együtt töröljön egy képet.

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

Paraméterek

image_id
Kötelező

Freta-azonosító a képhez.

owner_id
Kötelező

A rendszerkép tulajdonosának nem kötelező felhasználói azonosítója (csoport tulajdonában lévő képek esetén)

Válaszok

Igaz

formats

A jelenleg támogatott képformátumok listájának lekérése.

Példa eredmény:


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

Válaszok

dict

list

Kérje le a képek listáját és állapotát.

Példa eredmény:


   [
       {
           "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)

Paraméterek

search_filter
Kötelező

Keresési eredmények szűrése, engedélyezett értékek meghívása <xref:freta.Freta.search_filters> .

Válaszok

A kulcsokkal rendelkező diktálások listája az alább látható módon.

search_filters

Felsorolja a jelenleg támogatott keresési szűrőket.

Példa eredmény:


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

Válaszok

[str]

status

Egyetlen kép állapotának lekérése.

Példa eredmény:


   {
       "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)

Paraméterek

image_id
Kötelező

Freta-azonosító a képhez.

owner_id
Kötelező

a kép tulajdonosának userid azonosítója (csoport tulajdonában lévő képek esetén)

Válaszok

dict

update

Kép metaadatainak frissítése.

PÉLDA TODO-ra

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

Paraméterek

image_id
Kötelező

Freta-azonosító a képhez

owner_id
Kötelező

Csoport tulajdonában lévő képek esetén a rendszerkép tulajdonosának felhasználóazonosítója.

name
Kötelező

Igény szerint állítsa be a felhasználó által megadott gépazonosítót a rendszerképhez

upload

Töltsön fel egy képfájlt, és küldje el elemzésre.

Példa eredmény:


   {
       '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)

Paraméterek

name
Kötelező

A rendszerkép felhasználó által megadott neve.

image_type
Kötelező

A kép formátuma. Tekintse meg <xref:freta.Freta.formats> az engedélyezett értékeket.

region
Kötelező

A rendszerkép tárolására és feldolgozására szolgáló régió. Tekintse meg <xref:freta.Freta.regions> az engedélyezett értékeket.

image
Kötelező

Fájlrendszer elérési útja a képfájlhoz.

profile
Kötelező

Fájlrendszer elérési útja a kernelprofilhoz. (Nem kötelező)

Válaszok

dict

upload_sas

Szerezze be az SAS URI-kat, hogy engedélyezzék (csak) egy kép és egy profil feltöltését.

Ez a metódus nem várólistára állítja a rendszerképet elemzés céljából. Hívja meg a self.analyze() függvényt a visszaadott image_id a képadatok írása után.

Példa eredmény:


    {
       "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)

Paraméterek

name
Kötelező

A kép neve.

image_type
Kötelező

A kép formátuma. Tekintse meg <xref:freta.Freta.formats> az engedélyezett értékeket.

region
Kötelező

A rendszerkép tárolására és feldolgozására szolgáló régió. Az engedélyezett értékekért lásd: Freta.regions. TODO-hivatkozás

Válaszok

dict