Bagikan melalui

AciWebservice Kelas

  • Referensi

Tunjukkan model pembelajaran mesin yang disebarkan sebagai titik akhir layanan web pada Azure Container Instances.

Layanan yang disebarkan dibuat dari model, skrip, serta file yang diasosiasikan. Layanan web yang dihasilkan adalah titik akhir HTTP yang bebannya diseimbangkan dengan REST API. Anda dapat mengirim data ke API ini serta menerima prediksi yang dikembalikan oleh model.

Untuk informasi selengkapnya, lihat Menerapkan model ke Azure Container Instances.

Menginisialisasi instans Webservice.

Konstruktor Webservice mengambil representasi cloud dari objek Webservice yang terkait dengan ruang kerja yang disediakan. Ini akan mengembalikan instans kelas anak yang sesuai dengan jenis tertentu dari objek Webservice yang diambil.

Warisan
Webservice
AciWebservice

Konstruktor

AciWebservice(workspace, name)

Parameter

Nama Deskripsi
workspace
Diperlukan
Workspace

Objek ruang kerja yang berisi objek Layanan Web yang akan diambil.
name
Diperlukan
str

Nama objek Layanan Web yang akan diambil.

Keterangan

Pola penyebaran yang disarankan adalah membuat objek konfigurasi penyebaran dengan deploy_configuration metode lalu kemudian menggunakannya dengan deploy metode Model kelas seperti yang ditunjukkan di bawah ini.


   from azureml.core.model import InferenceConfig
   from azureml.core.webservice import AciWebservice


   service_name = 'my-custom-env-service'

   inference_config = InferenceConfig(entry_script='score.py', environment=environment)
   aci_config = AciWebservice.deploy_configuration(cpu_cores=1, memory_gb=1)

   service = Model.deploy(workspace=ws,
                          name=service_name,
                          models=[model],
                          inference_config=inference_config,
                          deployment_config=aci_config,
                          overwrite=True)
   service.wait_for_deployment(show_output=True)

Ada sejumlah cara untuk menyebarkan model sebagai layanan web, termasuk dengan:

  • deploy metode untuk Model model yang sudah terdaftar di ruang kerja.

  • deploy_from_image metode dari Webservice.

  • deploy_from_model metode dari Webservice untuk model yang sudah terdaftar di ruang kerja. Metode ini akan membuat sebuah gambar.

  • deploymetode dari Webservice, yang akan mendaftarkan model dan membuat gambar.

Untuk informasi tentang bekerja dengan layanan web, lihat

Bagian Variabel mencantumkan atribut representasi lokal dari objek AciWebservice cloud. Variabel-variabel ini harus dianggap baca-saja. Mengubah nilainya tidak akan tercermin dalam objek cloud yang sesuai.

Variabel

Nama Deskripsi
enable_app_insights
bool

Apakah pengelogan Application Insights diaktifkan untuk Layanan Web atau tidak.
cname
str

Cname untuk Layanan Web.
container_resource_requirements
ContainerResourceRequirements

Persyaratan sumber daya kontainer untuk Layanan Web.
encryption_properties
EncryptionProperties

Properti enkripsi untuk Layanan Web.
vnet_configuration
VnetConfiguration

Properti jaringan virtual untuk Layanan Web, konfigurasi harus dibuat dan disediakan oleh pengguna.
azureml.core.webservice.AciWebservice.location
str

Lokasi tempat Layanan Web disebarkan.
public_ip
str

Alamat ip publik dari Layanan Web.
azureml.core.webservice.AciWebservice.scoring_uri
str

Titik akhir penilaian untuk Layanan Web
ssl_enabled
bool

Apakah SSL diaktifkan untuk Layanan Web atau tidak
public_fqdn
str

FQDN umum untuk Layanan Web
environment
Environment

Objek Lingkungan yang digunakan untuk membuat Layanan Web
azureml.core.webservice.AciWebservice.models
list[Model]

Daftar Model yang disebarkan ke Layanan Web
azureml.core.webservice.AciWebservice.swagger_uri
str

Titik akhir swagger untuk Layanan Web

Metode

add_properties

Tambahkan pasangan nilai kunci ke kamus properti Layanan Web ini.
add_tags

Tambahkan pasangan nilai kunci ke kamus properti Layanan Web ini.
deploy_configuration

Buat objek konfigurasi untuk menyebarkan AciWebservice.
get_token

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

Catatan

Tidak diterapkan.
remove_tags

Hapus kunci yang ditentukan dari kamus tag Layanan Web ini.
run

Hubungi Layanan Web ini dengan input yang disediakan.
serialize

Konversi Layanan Web ini menjadi kamus serial JSON.
update

Perbarui Layanan Web dengan properti yang disediakan.

Nilai yang dibiarkan None akan tetap tidak berubah di Layanan Web ini.

add_properties

Tambahkan pasangan nilai kunci ke kamus properti Layanan Web ini.

add_properties(properties)

Parameter

Nama Deskripsi
properties
Diperlukan
dict[str, str]

Kamus properti yang ditambahkan.

add_tags

Tambahkan pasangan nilai kunci ke kamus properti Layanan Web ini.

add_tags(tags)

Parameter

Nama Deskripsi
tags
Diperlukan
dict[str, str]

Kamus tag yang ditambahkan.

Pengecualian

Jenis Deskripsi
WebserviceException

deploy_configuration

Buat objek konfigurasi untuk menyebarkan AciWebservice.

static deploy_configuration(cpu_cores=None, memory_gb=None, tags=None, properties=None, description=None, location=None, auth_enabled=None, ssl_enabled=None, enable_app_insights=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, ssl_cname=None, dns_name_label=None, primary_key=None, secondary_key=None, collect_model_data=None, cmk_vault_base_url=None, cmk_key_name=None, cmk_key_version=None, vnet_name=None, subnet_name=None)

Parameter

Nama Deskripsi
cpu_cores
float

Jumlah inti CPU yang akan dialokasikan untuk Layanan Web ini. Bisa berupa desimal. Default ke 0,1

Nilai default: None
memory_gb
float

Jumlah memori (dalam GB) yang dialokasikan untuk Layanan web ini. Bisa berupa desimal. Default ke 0,5

Nilai default: None
tags
dict[str, str]

Kamus tag nilai kunci untuk memberikan Layanan Web ini.

Nilai default: None
properties
dict[str, str]

Kamus properti nilai kunci untuk memberikan Layanan Web ini. Properti ini tidak dapat diubah setelah penyebaran, namun pasangan nilai kunci baru bisa ditambahkan.

Nilai default: None
description
str

Deskripsi untuk memberikan Layanan Web ini.

Nilai default: None
location
str

Wilayah Azure untuk menggunakan Layanan Web ini. Jika tidak ditentukan, lokasi Ruang Kerja akan digunakan. Untuk detail selengkapnya tentang wilayah yang tersedia, lihat Produk berdasarkan wilayah.

Nilai default: None
auth_enabled
bool

Apakah akan mengaktifkan autentikasi untuk Layanan Web ini atau tidak. Default ke False.

Nilai default: None
ssl_enabled
bool

Apakah akan mengaktifkan SSL untuk Layanan Web ini atau tidak. Default ke False.

Nilai default: None
enable_app_insights
bool

Apakah akan mengaktifkan Application Insights untuk Layanan Web ini atau tidak. Default ke False.

Nilai default: None
ssl_cert_pem_file
str

File sertifikat diperlukan jika SSL diaktifkan.

Nilai default: None
ssl_key_pem_file
str

File kunci diperlukan jika SSL diaktifkan.

Nilai default: None
ssl_cname
str

Cname jika SSL diaktifkan.

Nilai default: None
dns_name_label
str

Label nama DNS untuk titik akhir penilaian. Jika tidak ditentukan, label nama DNS unik akan dibuat untuk titik akhir penilaian.

Nilai default: None
primary_key
str

Kunci autentikasi utama yang digunakan untuk Layanan Web ini.

Nilai default: None
secondary_key
str

Kunci autentikasi sekunder yang digunakan untuk Layanan Web ini.

Nilai default: None
collect_model_data
bool

Apakah kumpulan data model untuk Layanan Web diaktifkan atau tidak.

Nilai default: None
cmk_vault_base_url
str

url dasar brankas kunci yang dikelola pelanggan

Nilai default: None
cmk_key_name
str

nama kunci yang dikelola pelanggan.

Nilai default: None
cmk_key_version
str

versi kunci yang dikelola pelanggan.

Nilai default: None
vnet_name
str

nama jaringan virtual.

Nilai default: None
subnet_name
str

nama subnet dalam jaringan virtual.

Nilai default: None

Mengembalikan

Jenis Deskripsi
AciServiceDeploymentConfiguration

Objek konfigurasi yang akan digunakan saat menyebarkan objek Layanan Web.

Pengecualian

Jenis Deskripsi
WebserviceException

get_token

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

Catatan

Tidak diterapkan.

get_token()

Mengembalikan

Jenis Deskripsi
str, datetime

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

Pengecualian

Jenis Deskripsi
azureml.exceptions.NotImplementedError

remove_tags

Hapus kunci yang ditentukan dari kamus tag Layanan Web ini.

remove_tags(tags)

Parameter

Nama Deskripsi
tags
Diperlukan
list[str]

Daftar kunci yang akan dihapus.

run

Hubungi Layanan Web ini dengan input yang disediakan.

run(input_data)

Parameter

Nama Deskripsi
input_data
Diperlukan
<xref:varies>

Input untuk memanggil Layanan Web.

Mengembalikan

Jenis Deskripsi
dict

Hasil dari memanggil Layanan Web.

Pengecualian

Jenis Deskripsi
WebserviceException

serialize

Konversi Layanan Web ini menjadi kamus serial JSON.

serialize()

Mengembalikan

Jenis Deskripsi
dict

Representasi JSON dari objek Layanan Web ini.

update

Perbarui Layanan Web dengan properti yang disediakan.

Nilai yang dibiarkan None akan tetap tidak berubah di Layanan Web ini.

update(image=None, tags=None, properties=None, description=None, auth_enabled=None, ssl_enabled=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, ssl_cname=None, enable_app_insights=None, models=None, inference_config=None)

Parameter

Nama Deskripsi
image
Image

Gambar baru untuk disebarkan ke Layanan Web.

Nilai default: None
tags
dict[str, str]

Kamus tag nilai kunci untuk memberikan Layanan Web ini. Akan menggantikan tag yang ada.

Nilai default: None
properties
dict[str, str]

Kamus properti nilai kunci yang akan ditambahkan ke kamus properti yang ada.

Nilai default: None
description
str

Deskripsi untuk memberikan Layanan Web ini.

Nilai default: None
auth_enabled
bool

Aktifkan atau nonaktifkan autentikasi untuk Layanan Web ini.

Nilai default: None
ssl_enabled
bool

Apakah akan mengaktifkan SSL untuk Layanan Web ini atau tidak.

Nilai default: None
ssl_cert_pem_file
str

File sertifikat diperlukan jika SSL diaktifkan.

Nilai default: None
ssl_key_pem_file
str

File kunci diperlukan jika SSL diaktifkan.

Nilai default: None
ssl_cname
str

Cname jika SSL diaktifkan.

Nilai default: None
enable_app_insights
bool

Apakah akan mengaktifkan Application Insights untuk Layanan Web ini atau tidak.

Nilai default: None
models
list[Model]

Daftar objek Model yang akan dikemas ke dalam layanan yang diperbarui.

Nilai default: None
inference_config
InferenceConfig

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

Nilai default: None

Mengembalikan

Jenis Deskripsi
None