Image Kelas

Menentukan kelas induk abstrak untuk Gambar Azure Machine Learning.

Kelas ini TIDAK DIGUNAKAN LAGI. Gunakan kelas Environment sebagai gantinya.

Konstruktor gambar.

Kelas ini TIDAK DIGUNAKAN LAGI. Gunakan kelas Environment sebagai gantinya.

Konstruktor gambar digunakan untuk mengambil representasi cloud dari objek Gambar yang terkait dengan ruang kerja yang disediakan. Akan mengembalikan instans kelas anak yang sesuai dengan jenis tertentu dari objek Gambar yang diambil.

Warisan

ABC

Image

Konstruktor

Image(workspace, name=None, id=None, tags=None, properties=None, version=None)

Parameter

workspace

Workspace

Diperlukan

Objek Ruang Kerja yang berisi Gambar yang akan diambil.

name

str

nilai default: None

Nama Gambar yang akan diambil. Akan mengembalikan versi terbaru dari Gambar, jika ada.

id

str

nilai default: None

ID spesifik dari Gambar yang akan diambil. (ID adalah "<nama>:<versi>")

tags

list

nilai default: None

Akan memfilter hasil Gambar berdasarkan daftar yang disediakan, baik dengan 'kunci' atau '[key, value]'. Contoh ['key', ['key2', 'key2 value']]

properties

list

nilai default: None

Akan memfilter hasil Gambar berdasarkan daftar yang disediakan, baik dengan 'kunci' atau '[key, value]'. Contoh ['key', ['key2', 'key2 value']]

version

str

nilai default: None

Ketika versi dan nama keduanya ditentukan, akan mengembalikan versi tertentu dari Gambar.

workspace

Workspace

Diperlukan

Objek ruang kerja yang berisi Gambar untuk diambil

name

str

Diperlukan

Nama Gambar yang akan diambil. Akan mengembalikan versi terbaru, jika ada

id

str

Diperlukan

ID spesifik dari Gambar yang akan diambil. (ID adalah ":")

tags

list

Diperlukan

Akan memfilter hasil Gambar berdasarkan daftar yang disediakan, baik dengan 'kunci' atau '[key, value]'. Contoh ['key', ['key2', 'key2 value']]

properties

list

Diperlukan

Akan memfilter hasil Gambar berdasarkan daftar yang disediakan, baik dengan 'kunci' atau '[key, value]'. Contoh ['key', ['key2', 'key2 value']]

version

str

Diperlukan

Ketika versi dan nama keduanya ditentukan, akan mengembalikan versi tertentu dari Gambar.

Keterangan

Konstruktor Gambar mengambil representasi cloud dari objek Gambar yang terkait dengan ruang kerja yang disediakan. Konstruktor mengembalikan instans dari kelas turunan yang sesuai dengan jenis spesifik dari objek Gambar yang diambil.

Objek Gambar digunakan untuk menyebarkan Model pengguna sebagai Webservice. Objek Gambar biasanya berisi Model, skrip eksekusi, dan semua dependensi yang diperlukan untuk penyebaran Model. Kelas Gambar memiliki beberapa subkelas seperti ContainerImage untuk Gambar Docker, dan Gambar seperti FPGA.

Lihat kelas ContainerImage untuk contoh kelas yang mewarisi dari kelas Gambar.

Gambar biasanya digunakan dalam alur kerja yang memerlukan penggunaan gambar. Untuk sebagian besar alur kerja, Anda sebaiknya menggunakan kelas Environment untuk menentukan gambar. Kemudian Anda dapat menggunakan objek Lingkungan dengan metode Modeldeploy() untuk menyebarkan model sebagai layanan web. Anda juga dapat menggunakan metode Model package() untuk membuat gambar yang dapat diunduh ke instalasi Docker lokal Anda sebagai gambar atau sebagai Dockerfile.

Lihat tautan berikut untuk gambaran umum tentang menyebarkan model di Azure: https://aka.ms/azureml-how-deploy.

Metode

add_properties	Tambahkan properti ke gambar.
add_tags	Tambahkan tag ke gambar.
create	Buat gambar di ruang kerja yang disediakan.
delete	Hapus gambar dari ruang kerja yang sesuai.
deserialize	Ubah objek json menjadi objek Gambar.
image_configuration	Metode abstrak untuk membuat objek konfigurasi gambar.
list	Daftar Gambar yang terkait dengan ruang kerja yang sesuai. Dapat difilter dengan parameter tertentu.
remove_tags	Hapus tag dari gambar.
serialize	Ubah objek Gambar ini menjadi kamus yang diserialisasi JSON.
update	Perbarui gambar.
update_creation_state	Refresh status objek dalam memori saat ini. Lakukan pembaruan properti objek di tempat berdasarkan status objek cloud terkait saat ini. Terutama berguna untuk polling manual dari status pembuatan.
wait_for_creation	Tunggu hingga gambar selesai dibuat. Tunggu hingga pembuatan gambar mencapai status terminal. Akan menampilkan WebserviceException jika mencapai status terminal yang tidak berhasil.

add_properties

Tambahkan properti ke gambar.

add_properties(properties)

Parameter

properties

dict[str, str]

Diperlukan

Kamus properti yang akan ditambahkan.

Pengecualian

WebserviceException

add_tags

Tambahkan tag ke gambar.

add_tags(tags)

Parameter

tags

dict[str, str]

Diperlukan

Kamus tag yang akan ditambahkan.

Pengecualian

WebserviceException

create

Buat gambar di ruang kerja yang disediakan.

static create(workspace, name, models, image_config)

Parameter

workspace

<xref:<xref:workspace: azureml.core.workspace.Workspace>>

Diperlukan

Ruang kerja untuk dikaitkan dengan gambar ini.

name

str

Diperlukan

Nama untuk dikaitkan dengan gambar ini.

models

list[Model]

Diperlukan

Daftar objek Model untuk dikemas dengan gambar ini. Bisa berupa daftar kosong.

image_config

ImageConfig

Diperlukan

Objek konfigurasi gambar yang akan digunakan untuk mengonfigurasi gambar ini.

Mengembalikan

Objek Gambar yang dibuat.

Tipe hasil

Image

Pengecualian

WebserviceException

delete

Hapus gambar dari ruang kerja yang sesuai.

delete()

Pengecualian

WebserviceException

Keterangan

Metode ini gagal jika gambar telah disebarkan ke layanan web yang aktif.

deserialize

Ubah objek json menjadi objek Gambar.

deserialize(workspace, image_payload)

Parameter

cls

Diperlukan

Menunjukkan metode kelas.

workspace

Workspace

Diperlukan

Objek ruang kerja tempat Gambar didaftarkan.

image_payload

dict

Diperlukan

Objek JSON untuk dikonversi menjadi objek Gambar.

Mengembalikan

Representasi Gambar dari objek JSON yang disediakan.

Tipe hasil

Image

Pengecualian

WebserviceException

Keterangan

Metode ini gagal jika ruang kerja yang disediakan bukan ruang kerja tempat gambar didaftarkan.

image_configuration

Metode abstrak untuk membuat objek konfigurasi gambar.

abstract static image_configuration()

Pengecualian

WebserviceException

list

Daftar Gambar yang terkait dengan ruang kerja yang sesuai. Dapat difilter dengan parameter tertentu.

static list(workspace, image_name=None, model_name=None, model_id=None, tags=None, properties=None)

Parameter

workspace

Workspace

Diperlukan

Objek Ruang Kerja untuk mencantumkan Gambar.

image_name

str

nilai default: None

Daftar filter untuk hanya menyertakan Gambar yang disebarkan dengan nama gambar tertentu.

model_name

str

nilai default: None

Daftar filter untuk hanya menyertakan Gambar yang disebarkan dengan nama model tertentu.

model_id

str

nilai default: None

Daftar filter untuk hanya menyertakan Gambar yang disebarkan dengan ID model tertentu.

tags

list

nilai default: None

Akan memfilter berdasarkan daftar yang disediakan, baik dengan 'kunci' atau '[key, value]'. Contoh ['key', ['key2', 'key2 value']]

properties

list

nilai default: None

Akan memfilter berdasarkan daftar yang disediakan, baik dengan 'kunci' atau '[key, value]'. Contoh ['key', ['key2', 'key2 value']]

Mengembalikan

Daftar Gambar yang difilter di ruang kerja yang disediakan.

Tipe hasil

list[<xref:Images>]

Pengecualian

WebserviceException

remove_tags

Hapus tag dari gambar.

remove_tags(tags)

Parameter

tags

list[str]

Diperlukan

Daftar kunci yang sesuai dengan tag yang akan dihapus.

Pengecualian

WebserviceException

serialize

Ubah objek Gambar ini menjadi kamus yang diserialisasi JSON.

serialize()

Mengembalikan

Representasi JSON dari objek Gambar ini.

Tipe hasil

dict

Pengecualian

WebserviceException

update

Perbarui gambar.

update(tags)

Parameter

tags

dict[str, str]

Diperlukan

Kamus tag untuk memperbarui gambar. Akan menimpa tag yang ada.

Pengecualian

WebserviceException

update_creation_state

Refresh status objek dalam memori saat ini.

Lakukan pembaruan properti objek di tempat berdasarkan status objek cloud terkait saat ini. Terutama berguna untuk polling manual dari status pembuatan.

update_creation_state()

Pengecualian

WebserviceException

wait_for_creation

Tunggu hingga gambar selesai dibuat.

Tunggu hingga pembuatan gambar mencapai status terminal. Akan menampilkan WebserviceException jika mencapai status terminal yang tidak berhasil.

wait_for_creation(show_output=False)

Parameter

show_output

bool

nilai default: False

Opsi Boolean untuk mencetak lebih banyak output verbose. Default ke False.

Pengecualian

WebserviceException