Image Klasse

Interagieren mit Bildern

Vererbung
Image

Konstruktor

Image(freta)

Methoden

analyze

Analysieren (oder neu analysieren) eines hochgeladenen Bilds.

TODO-Beispiel

cancel_analysis

Abbrechen der Analyse eines hochgeladenen Bilds.

TODO-Beispiel

delete

Löschen Sie ein Bild zusammen mit allen generierten Berichten und anderen Artefakten.

formats

Rufen Sie die Liste der derzeit unterstützten Bildformate ab.

Beispielergebnis:


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

Rufen Sie die Liste der Bilder und deren Status ab.

Beispielergebnis:


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

Listet die derzeit unterstützten Suchfilter auf.

Beispielergebnis:


   [
       "my_images",
       "my_images_and_samples"
   ]
status

Ruft den Status eines einzelnen Bilds ab.

Beispielergebnis:


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

Aktualisieren von Metadaten für ein Bild.

TODO-Beispiel

upload

Laden Sie eine Bilddatei hoch, und übermitteln Sie sie zur Analyse.

Beispielergebnis:


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

Abrufen von SAS-URIs, die (nur) den Upload eines Bilds und eines Profils autorisieren.

Mit dieser Methode wird das Bild nicht für die Analyse in die Warteschlange gestellt. Rufen Sie self.analyze() mit dem zurückgegebenen image_id nach dem Schreiben der Bilddaten auf.

Beispielergebnis:


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

Analysieren (oder neu analysieren) eines hochgeladenen Bilds.

TODO-Beispiel

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

Parameter

image_id
Erforderlich

Bildbezeichner.

owner_id
Erforderlich

Für gruppeneigene Bilder: userid des Imagebesitzers.

Gibt zurück

True

cancel_analysis

Abbrechen der Analyse eines hochgeladenen Bilds.

TODO-Beispiel

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

Parameter

image_id
Erforderlich

Bildbezeichner.

owner_id
Erforderlich

Für gruppeneigene Bilder: userid des Imagebesitzers.

Gibt zurück

True

delete

Löschen Sie ein Bild zusammen mit allen generierten Berichten und anderen Artefakten.

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

Parameter

image_id
Erforderlich

Freta-Id für das Bild.

owner_id
Erforderlich

Optionale UserID des Imagebesitzers (für gruppeneigene Images)

Gibt zurück

True

formats

Rufen Sie die Liste der derzeit unterstützten Bildformate ab.

Beispielergebnis:


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

Gibt zurück

dict

list

Rufen Sie die Liste der Bilder und deren Status ab.

Beispielergebnis:


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

Parameter

search_filter
Erforderlich

Filtern sie Suchergebnisse, rufen Sie <xref:freta.Freta.search_filters> nach zulässigen Werten auf.

Gibt zurück

Liste der Diktaten mit Schlüsseln, wie unten gezeigt.

search_filters

Listet die derzeit unterstützten Suchfilter auf.

Beispielergebnis:


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

Gibt zurück

[str]

status

Ruft den Status eines einzelnen Bilds ab.

Beispielergebnis:


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

Parameter

image_id
Erforderlich

Freta-Id für das Bild.

owner_id
Erforderlich

userid des Imagebesitzers (für gruppeneigene Images)

Gibt zurück

dict

update

Aktualisieren von Metadaten für ein Bild.

TODO-Beispiel

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

Parameter

image_id
Erforderlich

Freta-Bezeichner für das Bild

owner_id
Erforderlich

Bei gruppeneigenen Bildern die UserID des Imagebesitzers.

name
Erforderlich

Optional die vom Benutzer angegebene Computeridentifer für das Image festlegen

upload

Laden Sie eine Bilddatei hoch, und übermitteln Sie sie zur Analyse.

Beispielergebnis:


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

Parameter

name
Erforderlich

Der vom Benutzer angegebene Name für das Image.

image_type
Erforderlich

Format des Bilds. Zulässige Werte finden Sie unter <xref:freta.Freta.formats>.

region
Erforderlich

Region, in der das Image gespeichert und verarbeitet werden soll. Zulässige Werte finden Sie unter <xref:freta.Freta.regions>.

image
Erforderlich

Dateisystempfad zur Bilddatei.

profile
Erforderlich

Dateisystempfad zum Kernelprofil. (Optional)

Gibt zurück

dict

upload_sas

Abrufen von SAS-URIs, die (nur) den Upload eines Bilds und eines Profils autorisieren.

Mit dieser Methode wird das Bild nicht für die Analyse in die Warteschlange gestellt. Rufen Sie self.analyze() mit dem zurückgegebenen image_id nach dem Schreiben der Bilddaten auf.

Beispielergebnis:


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

Parameter

name
Erforderlich

Name für das Image.

image_type
Erforderlich

Format des Bilds. Zulässige Werte finden Sie unter <xref:freta.Freta.formats>.

region
Erforderlich

Region, in der das Image gespeichert und verarbeitet werden soll. Zulässige Werte finden Sie unter Freta.regions. TODO-Link

Gibt zurück

dict