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

workspace
Workspace
Diperlukan

Objek ruang kerja yang berisi objek Layanan Web yang akan diambil.

name
str
Diperlukan

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

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

properties
dict[str, str]
Diperlukan

Kamus properti yang ditambahkan.

add_tags

Tambahkan pasangan nilai kunci ke kamus properti Layanan Web ini.

add_tags(tags)

Parameter

tags
dict[str, str]
Diperlukan

Kamus tag yang ditambahkan.

Pengecualian

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

cpu_cores
float
nilai default: None

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

memory_gb
float
nilai default: None

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

tags
dict[str, str]
nilai default: None

Kamus tag nilai kunci untuk memberikan Layanan Web ini.

properties
dict[str, str]
nilai default: None

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

description
str
nilai default: None

Deskripsi untuk memberikan Layanan Web ini.

location
str
nilai default: None

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.

auth_enabled
bool
nilai default: None

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

ssl_enabled
bool
nilai default: None

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

enable_app_insights
bool
nilai default: None

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

ssl_cert_pem_file
str
nilai default: None

File sertifikat diperlukan jika SSL diaktifkan.

ssl_key_pem_file
str
nilai default: None

File kunci diperlukan jika SSL diaktifkan.

ssl_cname
str
nilai default: None

Cname jika SSL diaktifkan.

dns_name_label
str
nilai default: None

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

primary_key
str
nilai default: None

Kunci autentikasi utama yang digunakan untuk Layanan Web ini.

secondary_key
str
nilai default: None

Kunci autentikasi sekunder yang digunakan untuk Layanan Web ini.

collect_model_data
bool
nilai default: None

Apakah kumpulan data model untuk Layanan Web diaktifkan atau tidak.

cmk_vault_base_url
str
nilai default: None

url dasar brankas kunci yang dikelola pelanggan

cmk_key_name
str
nilai default: None

nama kunci yang dikelola pelanggan.

cmk_key_version
str
nilai default: None

versi kunci yang dikelola pelanggan.

vnet_name
str
nilai default: None

nama jaringan virtual.

subnet_name
str
nilai default: None

nama subnet dalam jaringan virtual.

Mengembalikan

Objek konfigurasi yang akan digunakan saat menyebarkan objek Layanan Web.

Tipe hasil

AciServiceDeploymentConfiguration

Pengecualian

WebserviceException

get_token

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

Catatan

Tidak diterapkan.

get_token()

Mengembalikan

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

Tipe hasil

str, datetime

Pengecualian

azureml.exceptions.NotImplementedError

remove_tags

Hapus kunci yang ditentukan dari kamus tag Layanan Web ini.

remove_tags(tags)

Parameter

tags
list[str]
Diperlukan

Daftar kunci yang akan dihapus.

run

Hubungi Layanan Web ini dengan input yang disediakan.

run(input_data)

Parameter

input_data
<xref:varies>
Diperlukan

Input untuk memanggil Layanan Web.

Mengembalikan

Hasil dari memanggil Layanan Web.

Tipe hasil

dict

Pengecualian

WebserviceException

serialize

Konversi Layanan Web ini menjadi kamus serial JSON.

serialize()

Mengembalikan

Representasi JSON dari objek Layanan Web ini.

Tipe hasil

dict

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

image
Image
nilai default: None

Gambar baru untuk disebarkan ke Layanan Web.

tags
dict[str, str]
nilai default: None

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

properties
dict[str, str]
nilai default: None

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

description
str
nilai default: None

Deskripsi untuk memberikan Layanan Web ini.

auth_enabled
bool
nilai default: None

Aktifkan atau nonaktifkan autentikasi untuk Layanan Web ini.

ssl_enabled
bool
nilai default: None

Apakah akan mengaktifkan SSL untuk Layanan Web ini atau tidak.

ssl_cert_pem_file
str
nilai default: None

File sertifikat diperlukan jika SSL diaktifkan.

ssl_key_pem_file
str
nilai default: None

File kunci diperlukan jika SSL diaktifkan.

ssl_cname
str
nilai default: None

Cname jika SSL diaktifkan.

enable_app_insights
bool
nilai default: None

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

models
list[Model]
nilai default: None

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

inference_config
InferenceConfig
nilai default: None

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

Tipe hasil

None