Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


Image Klasa

Interakcja z obrazami

Dziedziczenie
Image

Konstruktor

Image(freta)

Metody

analyze

Analizowanie (lub ponowne analizowanie) przekazanego obrazu.

Przykład TODO

cancel_analysis

Anuluj analizowanie przekazanego obrazu.

Przykład TODO

delete

Usuń obraz wraz z dowolnym z wygenerowanych raportów i innych artefaktów.

formats

Pobierz listę aktualnie obsługiwanych formatów obrazów.

Przykładowy wynik:


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

Pobierz listę obrazów i ich stanów.

Przykładowy wynik:


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

Wyświetla listę aktualnie obsługiwanych filtrów wyszukiwania.

Przykładowy wynik:


   [
       "my_images",
       "my_images_and_samples"
   ]
status

Uzyskaj stan pojedynczego obrazu.

Przykładowy wynik:


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

Aktualizowanie metadanych obrazu.

Przykład TODO

upload

Przekaż plik obrazu i prześlij go do analizy.

Przykładowy wynik:


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

Uzyskaj identyfikatory URI sygnatur dostępu współdzielonego autoryzujące (tylko) przekazywanie obrazu i profilu.

Ta metoda nie powoduje kolejkowania obrazu do analizy. Wywołaj metodę self.analyze() z zwróconym image_id po zapisaniu danych obrazu.

Przykładowy wynik:


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

Analizowanie (lub ponowne analizowanie) przekazanego obrazu.

Przykład TODO

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

Parametry

image_id
Wymagane

Identyfikator obrazu.

owner_id
Wymagane

W przypadku obrazów należących do grupy identyfikator userid właściciela obrazu.

Zwraca

Prawda

cancel_analysis

Anuluj analizowanie przekazanego obrazu.

Przykład TODO

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

Parametry

image_id
Wymagane

Identyfikator obrazu.

owner_id
Wymagane

W przypadku obrazów należących do grupy identyfikator userid właściciela obrazu.

Zwraca

Prawda

delete

Usuń obraz wraz z dowolnym z wygenerowanych raportów i innych artefaktów.

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

Parametry

image_id
Wymagane

Identyfikator freta obrazu.

owner_id
Wymagane

Opcjonalny identyfikator userid właściciela obrazu (w przypadku obrazów należących do grupy)

Zwraca

Prawda

formats

Pobierz listę aktualnie obsługiwanych formatów obrazów.

Przykładowy wynik:


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

Zwraca

dict

list

Pobierz listę obrazów i ich stanów.

Przykładowy wynik:


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

Parametry

search_filter
Wymagane

Filtruj wyniki wyszukiwania, wywołaj <xref:freta.Freta.search_filters> dozwolone wartości.

Zwraca

Lista dykt z kluczami, jak pokazano poniżej.

search_filters

Wyświetla listę aktualnie obsługiwanych filtrów wyszukiwania.

Przykładowy wynik:


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

Zwraca

[str]

status

Uzyskaj stan pojedynczego obrazu.

Przykładowy wynik:


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

Parametry

image_id
Wymagane

Identyfikator freta obrazu.

owner_id
Wymagane

userid właściciela obrazu (w przypadku obrazów należących do grupy)

Zwraca

dict

update

Aktualizowanie metadanych obrazu.

Przykład TODO

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

Parametry

image_id
Wymagane

Identyfikator freta obrazu

owner_id
Wymagane

W przypadku obrazów należących do grupy identyfikator userid właściciela obrazu.

name
Wymagane

Opcjonalnie ustaw identyfikator komputera określonego przez użytkownika dla obrazu

upload

Przekaż plik obrazu i prześlij go do analizy.

Przykładowy wynik:


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

Parametry

name
Wymagane

Określona przez użytkownika nazwa obrazu.

image_type
Wymagane

Format obrazu. Zobacz <xref:freta.Freta.formats> , aby uzyskać dozwolone wartości.

region
Wymagane

Region, w którym można przechowywać i przetwarzać obraz. Zobacz <xref:freta.Freta.regions> , aby uzyskać dozwolone wartości.

image
Wymagane

Ścieżka systemu plików do pliku obrazu.

profile
Wymagane

Ścieżka systemu plików do profilu jądra. (opcjonalnie)

Zwraca

dict

upload_sas

Uzyskaj identyfikatory URI sygnatur dostępu współdzielonego autoryzujące (tylko) przekazywanie obrazu i profilu.

Ta metoda nie powoduje kolejkowania obrazu do analizy. Wywołaj metodę self.analyze() z zwróconym image_id po zapisaniu danych obrazu.

Przykładowy wynik:


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

Parametry

name
Wymagane

Nazwa obrazu.

image_type
Wymagane

Format obrazu. Zobacz <xref:freta.Freta.formats> , aby uzyskać dozwolone wartości.

region
Wymagane

Region, w którym można przechowywać i przetwarzać obraz. Zobacz Freta.regions, aby uzyskać dozwolone wartości. Link DO WYKONANIA

Zwraca

dict