Image Kelas

Berinteraksi dengan Gambar

Warisan
Image

Konstruktor

Image(freta)

Metode

analyze

Menganalisis (atau menganalisis ulang) gambar yang diunggah.

Contoh TODO

cancel_analysis

Batal menganalisis gambar yang diunggah.

Contoh TODO

delete

Hapus gambar bersama dengan salah satu laporan yang dihasilkan dan artefak lainnya.

formats

Dapatkan daftar format gambar yang saat ini didukung.

Contoh hasil:


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

Dapatkan daftar gambar dan statusnya.

Contoh hasil:


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

Mencantumkan filter pencarian yang saat ini didukung.

Contoh hasil:


   [
       "my_images",
       "my_images_and_samples"
   ]
status

Mendapatkan status satu gambar.

Contoh hasil:


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

Memperbarui metadata untuk gambar.

Contoh TODO

upload

Unggah file gambar dan kirimkan untuk analisis.

Contoh hasil:


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

Dapatkan URI SAS yang mengotorisasi (hanya) unggahan gambar dan profil.

Metode ini tidak mengantrekan gambar untuk analisis. Panggil self.analyze() dengan image_id yang dikembalikan setelah menulis data gambar.

Contoh hasil:


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

Menganalisis (atau menganalisis ulang) gambar yang diunggah.

Contoh TODO

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

Parameter

image_id
Diperlukan

Pengidentifikasi gambar.

owner_id
Diperlukan

Untuk gambar milik grup, userid pemilik gambar.

Mengembalikan

True

cancel_analysis

Batal menganalisis gambar yang diunggah.

Contoh TODO

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

Parameter

image_id
Diperlukan

Pengidentifikasi gambar.

owner_id
Diperlukan

Untuk gambar milik grup, userid pemilik gambar.

Mengembalikan

True

delete

Hapus gambar bersama dengan salah satu laporan yang dihasilkan dan artefak lainnya.

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

Parameter

image_id
Diperlukan

Pengidentifikasi Freta untuk gambar.

owner_id
Diperlukan

Userid opsional pemilik gambar (Untuk gambar yang dimiliki grup)

Mengembalikan

True

formats

Dapatkan daftar format gambar yang saat ini didukung.

Contoh hasil:


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

Mengembalikan

dict

list

Dapatkan daftar gambar dan statusnya.

Contoh hasil:


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

Memfilter hasil pencarian, memanggil <xref:freta.Freta.search_filters> nilai yang diizinkan.

Mengembalikan

Daftar dict yang memiliki kunci seperti yang ditunjukkan di bawah ini.

search_filters

Mencantumkan filter pencarian yang saat ini didukung.

Contoh hasil:


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

Mengembalikan

[str]

status

Mendapatkan status satu gambar.

Contoh hasil:


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

Pengidentifikasi Freta untuk gambar.

owner_id
Diperlukan

userid pemilik gambar (Untuk gambar milik grup)

Mengembalikan

dict

update

Memperbarui metadata untuk gambar.

Contoh TODO

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

Parameter

image_id
Diperlukan

Pengidentifikasi Freta untuk gambar

owner_id
Diperlukan

Untuk gambar yang dimiliki grup, userid pemilik gambar.

name
Diperlukan

Secara opsional atur pengidentifikasi komputer yang ditentukan pengguna untuk gambar

upload

Unggah file gambar dan kirimkan untuk analisis.

Contoh hasil:


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

Nama yang ditentukan pengguna untuk gambar.

image_type
Diperlukan

Format gambar. Lihat <xref:freta.Freta.formats> untuk nilai yang diizinkan.

region
Diperlukan

Wilayah tempat menyimpan dan memproses gambar. Lihat <xref:freta.Freta.regions> untuk nilai yang diizinkan.

image
Diperlukan

Jalur sistem file ke file gambar.

profile
Diperlukan

Jalur sistem file ke profil kernel. (Opsional)

Mengembalikan

dict

upload_sas

Dapatkan URI SAS yang mengotorisasi (hanya) unggahan gambar dan profil.

Metode ini tidak mengantrekan gambar untuk analisis. Panggil self.analyze() dengan image_id yang dikembalikan setelah menulis data gambar.

Contoh hasil:


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

Nama untuk gambar.

image_type
Diperlukan

Format gambar. Lihat <xref:freta.Freta.formats> untuk nilai yang diizinkan.

region
Diperlukan

Wilayah tempat menyimpan dan memproses gambar. Lihat Freta.regions untuk nilai yang diizinkan. Tautan TODO

Mengembalikan

dict