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:
|
| list |
Rufen Sie die Liste der Bilder und deren Status ab. Beispielergebnis:
|
| search_filters |
Listet die derzeit unterstützten Suchfilter auf. Beispielergebnis:
|
| status |
Ruft den Status eines einzelnen Bilds ab. Beispielergebnis:
|
| update |
Aktualisieren von Metadaten für ein Bild. TODO-Beispiel |
| upload |
Laden Sie eine Bilddatei hoch, und übermitteln Sie sie zur Analyse. Beispielergebnis:
|
| 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:
|
analyze
Analysieren (oder neu analysieren) eines hochgeladenen Bilds.
TODO-Beispiel
analyze(image_id: str, owner_id: typing.Union[str, NoneType] = None)
Parameter
- image_id
Bildbezeichner.
- owner_id
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
Bildbezeichner.
- owner_id
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
Freta-Id für das Bild.
- owner_id
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
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
Freta-Id für das Bild.
- owner_id
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
Freta-Bezeichner für das Bild
- owner_id
Bei gruppeneigenen Bildern die UserID des Imagebesitzers.
- name
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
Der vom Benutzer angegebene Name für das Image.
- image_type
Format des Bilds. Zulässige Werte finden Sie unter <xref:freta.Freta.formats>.
- region
Region, in der das Image gespeichert und verarbeitet werden soll. Zulässige Werte finden Sie unter <xref:freta.Freta.regions>.
- image
Dateisystempfad zur Bilddatei.
- profile
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
Name für das Image.
- image_type
Format des Bilds. Zulässige Werte finden Sie unter <xref:freta.Freta.formats>.
- region
Region, in der das Image gespeichert und verarbeitet werden soll. Zulässige Werte finden Sie unter Freta.regions. TODO-Link
Gibt zurück
dict