LocalWebservice Kelas

Mewakili model pembelajaran mesin yang disebarkan sebagai titik akhir layanan web lokal.

Menyebarkan layanan web secara lokal berguna untuk skenario penelusuran kesalahan dan pengujian.

Konstruktor layanan web lokal.

Konstruktor LocalWebservice digunakan untuk mengambil representasi lokal objek LocalWebservice yang terkait dengan ruang kerja yang disediakan.

Warisan
LocalWebservice

Konstruktor

LocalWebservice(*args, **kwargs)

Parameter

workspace
Workspace
Diperlukan

Objek ruang kerja berisi objek Model apa pun yang akan diambil.

name
str
Diperlukan

Nama objek Layanan web yang akan diambil.

must_exist
bool
Diperlukan

Apakah layanan web harus sudah ada saat membuat objek dalam memori.

workspace
Workspace
Diperlukan

Objek ruang kerja berisi objek Model apa pun yang akan diambil.

name
str
Diperlukan

Nama objek LocalWebservice yang akan diambil.

must_exist
bool
Diperlukan

Apakah layanan web harus sudah ada saat membuat objek dalam memori.

Keterangan

Sampel kode berikut menunjukkan cara membuat layanan web Docker lokal. Lihat link notebook untuk detail lebih lanjut.


   from azureml.core.webservice import LocalWebservice

   # This is optional, if not provided Docker will choose a random unused port.
   deployment_config = LocalWebservice.deploy_configuration(port=6789)

   local_service = Model.deploy(ws, "test", [model], inference_config, deployment_config)

   local_service.wait_for_deployment()

Sampel lengkap tersedia dari https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-local/register-model-deploy-local.ipynb

Metode

delete

Hapus LocalWebservice ini dari komputer lokal.

Panggilan fungsi ini tidak asinkron; proses tersebut berjalan hingga layanan dihapus.

deploy_configuration

Buat objek konfigurasi untuk menyebarkan Layanan web lokal.

deploy_to_cloud

Menyebarkan Webservice berdasarkan konfigurasi LocalWebservice.

deserialize

Mengonversi objek JSON respons Layanan Manajemen Model menjadi objek Layanan Web.

Catatan

Tidak didukung untuk LocalWebservice.

get_keys

Ambil kunci autentikasi untuk layanan Web ini.

Catatan

Tidak didukung untuk LocalWebservice.

get_logs

Ambil log untuk LocalWebservice ini.

get_token

Ambil token untuk Layanan Web ini, yang dicakup ke pengguna saat ini.

Catatan

Tidak didukung untuk LocalWebservice.

list

Cantumkan LocalWebservices yang terkait dengan Ruang kerja yang sesuai.

Hasil yang dikembalikan dapat difilter menggunakan parameter.

regen_key

Regenerasi salah satu kunci Layanan web.

Catatan

Tidak didukung untuk LocalWebservice.

reload

Muat ulang skrip eksekusi dan dependensi LocalWebservice.

Langkah ini memulai ulang kontainer layanan dengan salinan aset yang diperbarui, termasuk skrip eksekusi dan dependensi lokal, tetapi tidak membangun kembali gambar yang mendasarinya. Oleh karena itu, perubahan pada dependensi Conda/pip atau langkah Docker kustom tidak akan tercermin dalam LocalWebservice yang dimuat ulang. Untuk menangani perubahan tersebut, panggil metode update sebagai gantinya.

run

Hubungi LocalWebservice ini dengan input yang disediakan.

serialize

Ubah objek Layanan web ini menjadi kamus serial JSON.

update

Perbarui LocalWebservice dengan properti yang disediakan.

Nilai yang tersisa “Tidak Ada” akan tetap tidak berubah di LocalWebservice ini.

update_deployment_state

Refresh status objek dalam memori saat ini.

Lakukan pembaruan di tempat pada properti objek berdasarkan status kontainer Docker lokal saat ini.

wait_for_deployment

Polling penyebaran LocalWebservice yang sedang berjalan.

delete

Hapus LocalWebservice ini dari komputer lokal.

Panggilan fungsi ini tidak asinkron; proses tersebut berjalan hingga layanan dihapus.

delete(delete_cache=True, delete_image=False, delete_volume=True)

Parameter

delete_cache
bool
Diperlukan

Apakah akan menghapus file sementara yang di-cache untuk layanan tersebut. (Default: True)

delete_image
bool
Diperlukan

Apakah akan menghapus gambar Docker layanan. (Default: False)

delete_volume
bool
Diperlukan

Apakah akan menghapus volume Docker layanan. (Default: True)

Pengecualian

deploy_configuration

Buat objek konfigurasi untuk menyebarkan Layanan web lokal.

static deploy_configuration(port=None)

Parameter

port
int
nilai default: None

Port lokal tempat mengekspos titik akhir HTTP layanan.

Mengembalikan

Objek konfigurasi yang akan digunakan saat menyebarkan objek Layanan Web.

Tipe hasil

Pengecualian

deploy_to_cloud

Menyebarkan Webservice berdasarkan konfigurasi LocalWebservice.

deploy_to_cloud(name=None, deployment_config=None, deployment_target=None)

Parameter

name
str
nilai default: None

Nama untuk memberikan layanan yang disebarkan. Harus unik untuk ruang kerja.

deployment_config
WebserviceDeploymentConfiguration
nilai default: None

WebserviceDeploymentConfiguration yang digunakan untuk mengonfigurasi layanan web. Jika tidak tersedia, objek konfigurasi kosong akan digunakan berdasarkan target yang diinginkan.

deployment_target
ComputeTarget
nilai default: None

ComputeTarget tempat menyebarkan Layanan web. Karena ACI tidak memiliki ComputeTargetterkait, tinggalkan parameter ini sebagai Tidak Ada untuk disebarkan ke ACI.

Mengembalikan

Objek Layanan web yang sesuai dengan layanan web yang disebarkan.

Tipe hasil

Pengecualian

deserialize

Mengonversi objek JSON respons Layanan Manajemen Model menjadi objek Layanan Web.

Catatan

Tidak didukung untuk LocalWebservice.

deserialize(workspace, webservice_payload)

Parameter

cls
Diperlukan
workspace
Workspace
Diperlukan

Objek ruang kerja yang didaftarkan oleh Layanan Web.

webservice_payload
dict
Diperlukan

Objek JSON yang akan dikonversi menjadi objek Layanan Web.

Pengecualian

azureml.exceptions.NotImplementedError

get_keys

Ambil kunci autentikasi untuk layanan Web ini.

Catatan

Tidak didukung untuk LocalWebservice.

get_keys()

Mengembalikan

Kunci autentikasi untuk Layanan Web ini.

Pengecualian

azureml.exceptions.NotImplementedError

get_logs

Ambil log untuk LocalWebservice ini.

get_logs(num_lines=5000, raw=False)

Parameter

num_lines
int
Diperlukan

Jumlah maksimum garis log yang akan diambil. (Default: 5000)

raw
bool
Diperlukan

Kembalikan output kontainer Docker mentah tanpa mencoba memformatnya. (Default: False)

Mengembalikan

Log untuk LocalWebservice ini.

Tipe hasil

str

Pengecualian

get_token

Ambil token untuk Layanan Web ini, yang dicakup ke pengguna saat ini.

Catatan

Tidak didukung untuk LocalWebservice.

get_token()

Mengembalikan

Token untuk Layanan Web ini dan ketika harus di-refresh setelahnya.

Tipe hasil

Pengecualian

azureml.exceptions.NotImplementedError

list

Cantumkan LocalWebservices yang terkait dengan Ruang kerja yang sesuai.

Hasil yang dikembalikan dapat difilter menggunakan parameter.

static list(workspace, model_name=None, model_id=None, all=None)

Parameter

workspace
Workspace
Diperlukan

Objek Ruang kerja yang terkait dengan LocalWebservices.

model_name
str
nilai default: None

Filter daftar untuk hanya menyertakan LocalWebservices yang disebarkan dengan nama model tertentu.

model_id
str
nilai default: None

Filter daftar untuk hanya menyertakan LocalWebservices yang disebarkan dengan ID model tertentu.

all
bool
nilai default: None

Tampilkan semua layanan. Hanya layanan yang berjalan yang ditampilkan secara default.

Mengembalikan

Daftar LocalWebservices yang difilter berkaitan dengan Ruang kerja yang disediakan.

Tipe hasil

Pengecualian

regen_key

Regenerasi salah satu kunci Layanan web.

Catatan

Tidak didukung untuk LocalWebservice.

regen_key(key)

Parameter

key
str
Diperlukan

Kunci yang harus diregenerasi. Pilihannya adalah 'Primer' atau 'Sekunder'

Pengecualian

reload

Muat ulang skrip eksekusi dan dependensi LocalWebservice.

Langkah ini memulai ulang kontainer layanan dengan salinan aset yang diperbarui, termasuk skrip eksekusi dan dependensi lokal, tetapi tidak membangun kembali gambar yang mendasarinya. Oleh karena itu, perubahan pada dependensi Conda/pip atau langkah Docker kustom tidak akan tercermin dalam LocalWebservice yang dimuat ulang. Untuk menangani perubahan tersebut, panggil metode update sebagai gantinya.

reload(wait=False)

Parameter

wait
bool
Diperlukan

Tunggu kontainer layanan untuk mencapai kondisi normal. (Default: False)

Pengecualian

run

Hubungi LocalWebservice ini dengan input yang disediakan.

run(input_data)

Parameter

input_data
<xref:varies>
Diperlukan

Input yang digunakan untuk memanggil LocalWebservice.

Mengembalikan

Hasil dari memanggil LocalWebservice.

Tipe hasil

<xref:varies>

Pengecualian

serialize

Ubah objek Layanan web ini menjadi kamus serial JSON.

serialize()

Mengembalikan

Representasi serial dari objek Layanan web.

Tipe hasil

Pengecualian

update

Perbarui LocalWebservice dengan properti yang disediakan.

Nilai yang tersisa “Tidak Ada” akan tetap tidak berubah di LocalWebservice ini.

update(models=None, image_config=None, deployment_config=None, wait=False, inference_config=None)

Parameter

models
list[Model]
Diperlukan

Daftar model baru yang terdapat di LocalWebservice.

image_config
ContainerImageConfig
Diperlukan

Opsi konfigurasi gambar untuk diterapkan ke LocalWebservice.

deployment_config
LocalWebserviceDeploymentConfiguration
Diperlukan

Opsi konfigurasi penyebaran untuk diterapkan ke LocalWebservice.

inference_config
InferenceConfig
Diperlukan

Objek InferenceConfig yang digunakan untuk menyediakan properti penyebaran model yang diperlukan.

wait
bool
Diperlukan

Tunggu kontainer layanan untuk mencapai kondisi normal. (Default: False)

Tipe hasil

Pengecualian

update_deployment_state

Refresh status objek dalam memori saat ini.

Lakukan pembaruan di tempat pada properti objek berdasarkan status kontainer Docker lokal saat ini.

update_deployment_state(must_exist=False)

Parameter

must_exist
bool
nilai default: False

Apakah layanan web harus sudah ada saat membuat objek dalam memori.

Pengecualian

wait_for_deployment

Polling penyebaran LocalWebservice yang sedang berjalan.

wait_for_deployment(show_output=False)

Parameter

show_output
bool
Diperlukan

Opsi untuk mencetak lebih banyak output verbose. (Default: False)

Pengecualian

Atribut

port

Dapatkan port layanan web lokal.

Mengembalikan

Nomor port.

Tipe hasil

int

scoring_uri

Dapatkan URI penilaian layanan web lokal.

Mengembalikan

URI Penilaian.

Tipe hasil

str

swagger_uri

Dapatkan layanan web lokal URI Swagger.

Mengembalikan

URI Swagger.

Tipe hasil

str

NETWORK_NAME

NETWORK_NAME = 'azureml-local'

STATE_DELETED

STATE_DELETED = 'deleted'

STATE_DEPLOYING

STATE_DEPLOYING = 'deploying'

STATE_FAILED

STATE_FAILED = 'failed'

STATE_RUNNING

STATE_RUNNING = 'running'

STATE_UNKNOWN

STATE_UNKNOWN = 'unknown'