Webservice Sınıf
Azure Machine Learning'de modelleri web hizmeti uç noktaları olarak dağıtmak için temel işlevselliği tanımlar.
Web hizmeti oluşturucu, sağlanan Çalışma Alanı ile ilişkilendirilmiş bir Web hizmeti nesnesinin bulut gösterimini almak için kullanılır. Alınan Web hizmeti nesnesinin belirli türüne karşılık gelen bir alt sınıfın örneğini döndürür. Web hizmeti sınıfı, makine öğrenmesi modellerinin bir Model veya Image nesnesinden dağıtılmasına olanak tanır.
Web hizmetiyle çalışma hakkında daha fazla bilgi için bkz. Azure Machine Learning ile model dağıtma.
Web hizmeti örneğini başlatın.
Web hizmeti oluşturucu, sağlanan çalışma alanıyla ilişkili bir Web hizmeti nesnesinin bulut gösterimini alır. Alınan Web hizmeti nesnesinin belirli türüne karşılık gelen bir alt sınıfın örneğini döndürür.
- Devralma
-
Webservice
Oluşturucu
Webservice(workspace, name)
Parametreler
Açıklamalar
Aşağıdaki örnek, önce Webservice'in alt sınıfı (bu örnekteAksWebservice) yöntemiyle deploy_configuration
bir yapılandırma nesnesi oluşturduğunuz ve ardından sınıfın yöntemiyle deploy
yapılandırmayı kullandığınız önerilen dağıtım desenini Model gösterir.
# Set the web service configuration (using default here)
aks_config = AksWebservice.deploy_configuration()
# # Enable token auth and disable (key) auth on the webservice
# aks_config = AksWebservice.deploy_configuration(token_auth_enabled=True, auth_enabled=False)
Tam örnek şu kaynaktan edinilebilir: https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/production-deploy-to-aks/production-deploy-to-aks.ipynb
Aşağıdaki örnekte, çalışma alanında var olan AciWebservice bir öğeyi bulma ve mevcutsa silme işlemi gösterilmektedir; böylece ad yeniden kullanılabilir.
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)
Modeli web hizmeti olarak dağıtmanın çeşitli yolları vardır; örneğin:
deploy
Model çalışma alanında kayıtlı olan modeller için yöntemi.deploy_from_image
Webservice modelinden oluşturulmuş görüntüler için yöntemi.deploy_from_model
Webservice çalışma alanında zaten kayıtlı olan modeller için yöntemi. Bu yöntem bir görüntü oluşturur.deploy
Webservicemodeli kaydedecek ve bir görüntü oluşturacak olan yöntemini kullanır.
Web hizmetleriyle çalışma hakkında bilgi için bkz.
Değişkenler bölümünde, bulut Web hizmeti nesnesinin yerel gösteriminin öznitelikleri listelenir. Bu değişkenler salt okunur olarak kabul edilmelidir. Değerlerinin değiştirilmesi ilgili bulut nesnesine yansıtılmaz.
Değişkenler
- auth_enabled
- bool
Web hizmeti kimlik doğrulamasının etkinleştirilip etkinleştirilmediği.
- compute_type
- str
Web hizmetini dağıtılan işlem türü.
- created_time
- datetime
Web hizmeti oluşturulduğunda.
- azureml.core.Webservice.description
Web hizmeti nesnesinin açıklaması.
- azureml.core.Webservice.tags
Web hizmeti nesnesi için etiket sözlüğü.
- azureml.core.Webservice.name
Web hizmeti adı.
- azureml.core.Webservice.properties
Web hizmeti için anahtar değeri özelliklerinin sözlüğü. Bu özellikler dağıtımdan sonra değiştirilemez, ancak yeni anahtar değer çiftleri eklenebilir.
- created_by
- str
Web hizmetini oluşturan kullanıcı.
- error
- str
Web hizmeti dağıtılamadıysa, bunun neden başarısız olduğuyla ilgili hata iletisini içerir.
- azureml.core.Webservice.state
Web hizmeti geçerli durumu.
- updated_time
- datetime
Web hizmeti en son güncelleştirildiğinde.
- azureml.core.Webservice.workspace
Bu Web hizmetini içeren Azure Machine Learning Çalışma Alanı.
- token_auth_enabled
- bool
Web hizmeti için belirteç kimlik doğrulamasının etkinleştirilip etkinleştirilmediği.
Yöntemler
check_for_existing_webservice |
Web hizmeti olup olmadığını denetleyin. |
delete |
Bu Web hizmetini ilişkili çalışma alanından silin. Bu işlev çağrısı zaman uyumsuz değil. Kaynak silinene kadar çağrı çalışır. Modeli WebserviceException Model Yönetim Hizmeti'nden silerken bir sorun oluşur. |
deploy |
Sıfır veya daha fazla Model nesneden Web hizmeti dağıtın. Bu işlev, sağlanan tüm model dosyalarını kaydeder ve işlemde, tümü belirtilen Workspaceile ilişkili bir görüntü oluşturur. Dağıtılacak ve daha önce kaydedilmemiş bir model dizininiz varsa bu işlevi kullanın. Sonuçta elde edilen Web hizmeti, çıkarım istekleri için kullanılabilecek gerçek zamanlı bir uç noktadır. Daha fazla bilgi için bkz . Web hizmeti olarak dağıtılan bir modeli kullanma. |
deploy_from_image |
Bir nesneden Image Web hizmeti dağıtma. Model için oluşturulmuş bir Image nesneniz varsa bu işlevi kullanın. Sonuçta elde edilen Web hizmeti, çıkarım istekleri için kullanılabilecek gerçek zamanlı bir uç noktadır. Daha fazla bilgi için bkz . Web hizmeti olarak dağıtılan bir modeli kullanma. |
deploy_from_model |
Sıfır veya daha fazla Model nesneden Web hizmeti dağıtın. Bu işlev ile benzerdir deployancak modelleri kaydetmez. Zaten kayıtlı model nesneleriniz varsa bu işlevi kullanın. Bu işlem, belirtilen Çalışma Alanı ile ilişkili bir görüntü oluşturur. Sonuçta elde edilen Web hizmeti, çıkarım istekleri için kullanılabilecek gerçek zamanlı bir uç noktadır. Daha fazla bilgi için bkz . Web hizmeti olarak dağıtılan bir modeli kullanma. |
deploy_local_from_model |
Test için bir LocalWebservice derleyin ve dağıtın. Docker'ın yüklenmesini ve yapılandırılmasını gerektirir. |
deserialize |
Model Yönetim Hizmeti yanıt JSON nesnesini Web hizmeti nesnesine dönüştürün. Sağlanan çalışma alanı Web hizmeti altında kayıtlı çalışma alanı değilse başarısız olur. |
get_keys |
Bu Web hizmeti için kimlik doğrulama anahtarlarını alın. |
get_logs |
Bu Web hizmeti için günlükleri alın. |
get_token |
Bu Web hizmeti için geçerli kullanıcı kapsamına alınmış kimlik doğrulama belirtecini alın. |
list |
İlgili ile ilişkili Web hizmetlerini listeleyin Workspace. Döndürülen sonuçlar parametreler kullanılarak filtrelenebilir. |
regen_key |
Web hizmeti anahtarlarından birini ('Birincil' veya 'İkincil' anahtar) yeniden üretin. WebserviceException belirtilmezse |
run |
Sağlanan girişle bu Web hizmetini çağırın. alt sınıfları Webservicetarafından uygulanan soyut yöntem. |
serialize |
Bu Web hizmeti nesnesini JSON serileştirilmiş sözlüğe dönüştürün. Bir Web hizmeti nesnesine geri dönüştürmek için kullanın deserialize . |
update |
Web hizmeti parametrelerini güncelleştirin. Bu, alt sınıfları tarafından uygulanan soyut bir yöntemdir Webservice. Güncelleştirilecek olası parametreler Web hizmeti alt türüne göre değişir. Örneğin, Azure Container Instances web hizmetleri için belirli parametrelere bakınupdate. |
update_deployment_state |
Bellek içi nesnenin geçerli durumunu yenileyin. İlgili bulut nesnesinin geçerli durumuna göre nesnenin özelliklerinin yerinde güncelleştirmesini gerçekleştirin. Oluşturma durumunun el ile yoklanması için öncelikli olarak yararlıdır. |
wait_for_deployment |
Çalışan Web hizmeti dağıtımında otomatik olarak yoklama. Web hizmeti'nin terminal durumuna ulaşmasını bekleyin. Başarılı olmayan bir terminal durumuna ulaşırsa veya sağlanan zaman aşımını aşarsa bir WebserviceException oluşturur. |
check_for_existing_webservice
Web hizmeti olup olmadığını denetleyin.
static check_for_existing_webservice(workspace, name, overwrite=False, request_func=None, check_func=None)
Parametreler
- workspace
- Workspace
- name
- str
- overwrite
- bool
- request_func
- <xref:function>
hizmet adının mevcut olup olmadığını denetlemek için hizmet isteğinde bulunma işlevi
- check_func
- <xref:function>
request_func yanıt içeriğini denetleme işlevi
Özel durumlar
delete
Bu Web hizmetini ilişkili çalışma alanından silin.
Bu işlev çağrısı zaman uyumsuz değil. Kaynak silinene kadar çağrı çalışır. Modeli WebserviceException Model Yönetim Hizmeti'nden silerken bir sorun oluşur.
delete()
Özel durumlar
deploy
Sıfır veya daha fazla Model nesneden Web hizmeti dağıtın.
Bu işlev, sağlanan tüm model dosyalarını kaydeder ve işlemde, tümü belirtilen Workspaceile ilişkili bir görüntü oluşturur. Dağıtılacak ve daha önce kaydedilmemiş bir model dizininiz varsa bu işlevi kullanın.
Sonuçta elde edilen Web hizmeti, çıkarım istekleri için kullanılabilecek gerçek zamanlı bir uç noktadır. Daha fazla bilgi için bkz . Web hizmeti olarak dağıtılan bir modeli kullanma.
static deploy(workspace, name, model_paths, image_config, deployment_config=None, deployment_target=None, overwrite=False)
Parametreler
- name
- str
Dağıtılan hizmeti vermek için gereken ad. Çalışma alanına özgü olmalıdır, yalnızca küçük harflerden, sayılardan veya kısa çizgilerden oluşmalıdır, bir harfle başlamalıdır ve 3 ile 32 karakter uzunluğunda olmalıdır.
Dosyaları veya klasörü modellemek için disk üzerindeki yolların listesi. Boş bir liste olabilir.
- image_config
- ImageConfig
Gerekli Görüntü özelliklerini belirlemek için kullanılan ImageConfig nesnesi.
- deployment_config
- WebserviceDeploymentConfiguration
Web hizmetini yapılandırmak için kullanılan bir WebserviceDeploymentConfiguration. Sağlanmazsa, istenen hedefe göre boş bir yapılandırma nesnesi kullanılır.
- deployment_target
- ComputeTarget
Web hizmetini dağıtmak için A ComputeTarget . Azure Container Instances ilişkili ComputeTargetolmadığından, Azure Container Instances dağıtmak için bu parametreyi Yok olarak bırakın.
Döndürülenler
Dağıtılan web hizmetiyle ilgili bir Web hizmeti nesnesi.
Dönüş türü
Özel durumlar
deploy_from_image
Bir nesneden Image Web hizmeti dağıtma.
Model için oluşturulmuş bir Image nesneniz varsa bu işlevi kullanın.
Sonuçta elde edilen Web hizmeti, çıkarım istekleri için kullanılabilecek gerçek zamanlı bir uç noktadır. Daha fazla bilgi için bkz . Web hizmeti olarak dağıtılan bir modeli kullanma.
static deploy_from_image(workspace, name, image, deployment_config=None, deployment_target=None, overwrite=False)
Parametreler
- name
- str
Dağıtılan hizmeti vermek için gereken ad. Çalışma alanına özgü olmalıdır, yalnızca küçük harflerden, sayılardan veya kısa çizgilerden oluşmalıdır, bir harfle başlamalıdır ve 3 ile 32 karakter uzunluğunda olmalıdır.
- deployment_config
- WebserviceDeploymentConfiguration
Web hizmetini yapılandırmak için kullanılan bir WebserviceDeploymentConfiguration. Sağlanmazsa, istenen hedefe göre boş bir yapılandırma nesnesi kullanılır.
- deployment_target
- ComputeTarget
Web hizmetini dağıtmak için A ComputeTarget . Azure Container Instances ilişkili ComputeTargetolmadığından, Azure Container Instances dağıtmak için bu parametreyi Yok olarak bırakın.
Döndürülenler
Dağıtılan web hizmetiyle ilgili bir Web hizmeti nesnesi.
Dönüş türü
Özel durumlar
deploy_from_model
Sıfır veya daha fazla Model nesneden Web hizmeti dağıtın.
Bu işlev ile benzerdir deployancak modelleri kaydetmez. Zaten kayıtlı model nesneleriniz varsa bu işlevi kullanın. Bu işlem, belirtilen Çalışma Alanı ile ilişkili bir görüntü oluşturur.
Sonuçta elde edilen Web hizmeti, çıkarım istekleri için kullanılabilecek gerçek zamanlı bir uç noktadır. Daha fazla bilgi için bkz . Web hizmeti olarak dağıtılan bir modeli kullanma.
static deploy_from_model(workspace, name, models, image_config, deployment_config=None, deployment_target=None, overwrite=False)
Parametreler
- name
- str
Dağıtılan hizmeti vermek için gereken ad. Çalışma alanına özgü olmalıdır, yalnızca küçük harflerden, sayılardan veya kısa çizgilerden oluşmalıdır, bir harfle başlamalıdır ve 3 ile 32 karakter uzunluğunda olmalıdır.
- image_config
- ImageConfig
Gerekli Görüntü özelliklerini belirlemek için kullanılan ImageConfig nesnesi.
- deployment_config
- WebserviceDeploymentConfiguration
Web hizmetini yapılandırmak için kullanılan bir WebserviceDeploymentConfiguration. Sağlanmazsa, istenen hedefe göre boş bir yapılandırma nesnesi kullanılır.
- deployment_target
- ComputeTarget
Web hizmetini dağıtmak için A ComputeTarget . ACI'nin ilişkili ComputeTargetbir parametresi olmadığından, ACI'ye dağıtmak için bu parametreyi Yok olarak bırakın.
Döndürülenler
Dağıtılan web hizmetiyle ilgili bir Web hizmeti nesnesi.
Dönüş türü
Özel durumlar
deploy_local_from_model
Test için bir LocalWebservice derleyin ve dağıtın.
Docker'ın yüklenmesini ve yapılandırılmasını gerektirir.
static deploy_local_from_model(workspace, name, models, image_config, deployment_config=None, wait=False)
Parametreler
- image_config
- ImageConfig
Gerekli hizmet görüntüsü özelliklerini belirlemek için kullanılan bir ImageConfig nesnesi.
- deployment_config
- LocalWebserviceDeploymentConfiguration
Web hizmetini yapılandırmak için kullanılan bir LocalWebserviceDeploymentConfiguration. Sağlanmadıysa, boş bir yapılandırma nesnesi kullanılır.
- wait
- bool
LocalWebservice'in Docker kapsayıcısının iyi durumda olarak raporlanmasının beklenip beklenmeyeceği. Kapsayıcı kilitlenirse bir özel durum oluşturur. Varsayılan değer False'tur.
Dönüş türü
Özel durumlar
deserialize
Model Yönetim Hizmeti yanıt JSON nesnesini Web hizmeti nesnesine dönüştürün.
Sağlanan çalışma alanı Web hizmeti altında kayıtlı çalışma alanı değilse başarısız olur.
deserialize(workspace, webservice_payload)
Parametreler
- cls
Bunun bir sınıf yöntemi olduğunu gösterir.
Döndürülenler
Sağlanan JSON nesnesinin Web hizmeti gösterimi.
Dönüş türü
Özel durumlar
get_keys
Bu Web hizmeti için kimlik doğrulama anahtarlarını alın.
get_keys()
Döndürülenler
Bu Web hizmeti için kimlik doğrulama anahtarları.
Dönüş türü
Özel durumlar
get_logs
Bu Web hizmeti için günlükleri alın.
get_logs(num_lines=5000, init=False)
Parametreler
Döndürülenler
Bu Web hizmeti için günlükler.
Dönüş türü
Özel durumlar
get_token
Bu Web hizmeti için geçerli kullanıcı kapsamına alınmış kimlik doğrulama belirtecini alın.
get_token()
Döndürülenler
Bu Web hizmeti için kimlik doğrulama belirteci ve sonrasında ne zaman yenilenmesi gerektiği.
Dönüş türü
Özel durumlar
list
İlgili ile ilişkili Web hizmetlerini listeleyin Workspace.
Döndürülen sonuçlar parametreler kullanılarak filtrelenebilir.
static list(workspace, compute_type=None, image_name=None, image_id=None, model_name=None, model_id=None, tags=None, properties=None, image_digest=None)
Parametreler
- compute_type
- str
Yalnızca belirli Web hizmeti türlerini listelemek için filtreleyin. Seçenekler şunlardır: 'ACI', 'AKS'.
- image_name
- str
Listeyi yalnızca belirli bir görüntü adıyla dağıtılan Web hizmetlerini içerecek şekilde filtreleyin.
- image_id
- str
Listeyi yalnızca belirli bir görüntü kimliğiyle dağıtılan Web hizmetlerini içerecek şekilde filtreleyin.
- model_name
- str
Listeyi yalnızca belirli model adıyla dağıtılan Web hizmetlerini içerecek şekilde filtreleyin.
- model_id
- str
Listeyi yalnızca belirli model kimliğiyle dağıtılan Web hizmetlerini içerecek şekilde filtreleyin.
- tags
- list
Sağlanan listeye göre filtreleyin; 'key' veya '[key, value]'. Örn. ['key', ['key2', 'key2 value']]
- properties
- list
Sağlanan listeye göre filtreleyin; 'key' veya '[key, value]'. Örn. ['key', ['key2', 'key2 value']]
- image_digest
- str
Listeyi yalnızca belirli bir görüntü özetiyle dağıtılan Web hizmetlerini içerecek şekilde filtreleyin.
Döndürülenler
Sağlanan Çalışma Alanında Web hizmetlerinin filtrelenmiş listesi.
Dönüş türü
Özel durumlar
regen_key
Web hizmeti anahtarlarından birini ('Birincil' veya 'İkincil' anahtar) yeniden üretin.
WebserviceException belirtilmezse key
veya 'Birincil' veya 'İkincil' değilse bir oluşturulur.
regen_key(key, set_key=None)
Parametreler
- set_key
- str
Anahtar değerinin el ile belirtimini sağlayan kullanıcı tarafından belirtilen değer
Özel durumlar
run
Sağlanan girişle bu Web hizmetini çağırın.
alt sınıfları Webservicetarafından uygulanan soyut yöntem.
abstract run(input)
Parametreler
- input
- <xref:varies>
Web hizmetini çağırmak için giriş verileri. Bu, makine öğrenmesi modelinizin tahminleri çalıştırmak için giriş olarak beklediği verilerdir.
Döndürülenler
Web hizmetini çağırmanın sonucu. Bu, makine öğrenmesi modelinizden çalıştırılacak tahminleri döndürür.
Dönüş türü
Özel durumlar
serialize
Bu Web hizmeti nesnesini JSON serileştirilmiş sözlüğe dönüştürün.
Bir Web hizmeti nesnesine geri dönüştürmek için kullanın deserialize .
serialize()
Döndürülenler
Bu Web hizmetini JSON gösterimi.
Dönüş türü
Özel durumlar
update
Web hizmeti parametrelerini güncelleştirin.
Bu, alt sınıfları tarafından uygulanan soyut bir yöntemdir Webservice. Güncelleştirilecek olası parametreler Web hizmeti alt türüne göre değişir. Örneğin, Azure Container Instances web hizmetleri için belirli parametrelere bakınupdate.
abstract update(*args)
Parametreler
- args
- <xref:varies>
Güncelleştirilecek değerler.
Özel durumlar
update_deployment_state
Bellek içi nesnenin geçerli durumunu yenileyin.
İlgili bulut nesnesinin geçerli durumuna göre nesnenin özelliklerinin yerinde güncelleştirmesini gerçekleştirin. Oluşturma durumunun el ile yoklanması için öncelikli olarak yararlıdır.
update_deployment_state()
Özel durumlar
wait_for_deployment
Çalışan Web hizmeti dağıtımında otomatik olarak yoklama.
Web hizmeti'nin terminal durumuna ulaşmasını bekleyin. Başarılı olmayan bir terminal durumuna ulaşırsa veya sağlanan zaman aşımını aşarsa bir WebserviceException oluşturur.
wait_for_deployment(show_output=False, timeout_sec=None)
Parametreler
- show_output
- bool
Daha ayrıntılı çıktı yazdırılıp yazdırılmayacağını gösterir.
- timeout_sec
- float
Dağıtım belirtilen zaman aşımını aşarsa bir özel durum tetikleyin.
Özel durumlar
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin