LocalWebservice Sınıf

Yerel web hizmeti uç noktası olarak dağıtılan bir makine öğrenmesi modelini temsil eder.

Web hizmetlerini yerel olarak dağıtmak, hata ayıklama ve test senaryoları için yararlıdır.

Yerel web hizmeti oluşturucu.

LocalWebservice oluşturucu, sağlanan çalışma alanıyla ilişkili bir LocalWebservice nesnesinin yerel gösterimini almak için kullanılır.

Devralma

Webservice

LocalWebservice

Oluşturucu

LocalWebservice(*args, **kwargs)

Parametreler

Name	Description
workspace Gerekli	Workspace Alınacak tüm Model nesnelerini içeren çalışma alanı nesnesi.
name Gerekli	str Alınacak Web hizmeti nesnesinin adı.
must_exist Gerekli	bool Bellek içi nesnesi oluşturulurken web hizmeti zaten mevcut olmalıdır.
workspace Gerekli	Workspace Alınacak tüm Model nesnelerini içeren çalışma alanı nesnesi.
name Gerekli	str Alınacak LocalWebservice nesnesinin adı.
must_exist Gerekli	bool Bellek içi nesnesi oluşturulurken web hizmeti zaten mevcut olmalıdır.

Açıklamalar

Aşağıdaki kod örnekleri, yerel bir Docker web hizmetinin nasıl oluşturulacağını gösterir. Diğer ayrıntılar için not defteri bağlantısına bakın.

   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()

Tam örnek şu kaynaktan edinilebilir: https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-local/register-model-deploy-local.ipynb

Yöntemler

delete	Bu LocalWebservice'i yerel makineden silin. Bu işlev çağrısı zaman uyumsuz değil; hizmet silinene kadar çalışır.
deploy_configuration	Yerel Web hizmetini dağıtmak için bir yapılandırma nesnesi oluşturun.
deploy_to_cloud	LocalWebservice yapılandırmasına göre bir Web hizmeti dağıtın.
deserialize	Model Yönetim Hizmeti yanıt JSON nesnesini Web hizmeti nesnesine dönüştürün. Not LocalWebservice için desteklenmez.
get_keys	Bu Web hizmeti için kimlik doğrulama anahtarlarını alın. Not LocalWebservice için desteklenmez.
get_logs	Bu LocalWebservice 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. Not LocalWebservice için desteklenmez.
list	İlgili Çalışma Alanı ile ilişkili LocalWebservices'i listeleyin. Döndürülen sonuçlar parametreler kullanılarak filtrelenebilir.
regen_key	Web hizmeti anahtarlarından birini yeniden üretin. Not LocalWebservice için desteklenmez.
reload	LocalWebservice'in yürütme betiğini ve bağımlılıklarını yeniden yükleyin. Bu işlem, hizmetin kapsayıcısını yürütme betiği ve yerel bağımlılıklar da dahil olmak üzere güncelleştirilmiş varlıkların kopyalarıyla yeniden başlatır, ancak temel alınan görüntüyü yeniden oluşturmaz. Buna göre, Conda/pip bağımlılıklarında veya özel Docker adımlarında yapılan değişiklikler yeniden yüklenen LocalWebservice'e yansıtılmaz. Bu değişiklikleri işlemek için bunun yerine yöntemini çağırın update .
run	Sağlanan girişle bu LocalWebservice'i çağırın.
serialize	Bu Web hizmeti nesnesini JSON serileştirilmiş sözlüğe dönüştürün.
update	Sağlanan özelliklerle LocalWebservice'i güncelleştirin. Hiçbiri olarak bırakılan değerler bu LocalWebservice'te değişmeden kalır.
update_deployment_state	Bellek içi nesnenin geçerli durumunu yenileyin. İlgili yerel Docker kapsayıcısının geçerli durumuna bağlı olarak nesnenin özelliklerinin yerinde güncelleştirmesini gerçekleştirin.
wait_for_deployment	Çalışan LocalWebservice dağıtımını yoklama.

delete

Bu LocalWebservice'i yerel makineden silin.

Bu işlev çağrısı zaman uyumsuz değil; hizmet silinene kadar çalışır.

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

Parametreler

Name	Description
delete_cache Gerekli	bool Hizmet için önbelleğe alınan geçici dosyaların silinip silinmeyeceği. (Varsayılan: True)
delete_image Gerekli	bool Hizmetin Docker görüntüsünün silinip silinmeyeceği. (Varsayılan: Yanlış)
delete_volume Gerekli	bool Hizmetin Docker biriminin silinip silinmeyeceği. (Varsayılan: True)

Özel durumlar

Tür	Description
WebserviceException

deploy_configuration

Yerel Web hizmetini dağıtmak için bir yapılandırma nesnesi oluşturun.

static deploy_configuration(port=None)

Parametreler

Name	Description
port	int Hizmetin HTTP uç noktasının kullanıma açık olduğu yerel bağlantı noktası. Default value: None

Döndürülenler

Tür	Description
LocalWebserviceDeploymentConfiguration	Web hizmeti nesnesi dağıtılırken kullanılacak yapılandırma nesnesi.

Özel durumlar

Tür	Description
WebserviceException

deploy_to_cloud

LocalWebservice yapılandırmasına göre bir Web hizmeti dağıtın.

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

Parametreler

Name	Description
name	str Dağıtılan hizmeti vermek için gereken ad. Çalışma alanı için benzersiz olmalıdır. Default value: None
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. Default value: None
deployment_target	ComputeTarget ComputeTarget Web hizmeti dağıtılacak A. ACI'nin ilişkili ComputeTargetbir parametresi olmadığından, ACI'ye dağıtmak için bu parametreyi Yok olarak bırakın. Default value: None

Döndürülenler

Tür	Description
Webservice	Dağıtılan web hizmetiyle ilgili bir Web hizmeti nesnesi.

Özel durumlar

Tür	Description
WebserviceException

deserialize

Model Yönetim Hizmeti yanıt JSON nesnesini Web hizmeti nesnesine dönüştürün.

Not

LocalWebservice için desteklenmez.

deserialize(workspace, webservice_payload)

Parametreler

Name	Description
cls Gerekli
workspace Gerekli	Workspace Web hizmeti'nin kayıtlı olduğu çalışma alanı nesnesi.
webservice_payload Gerekli	dict Web hizmeti nesnesine dönüştürülecek bir JSON nesnesi.

Özel durumlar

Tür	Description
azureml.exceptions.NotImplementedError

get_keys

Bu Web hizmeti için kimlik doğrulama anahtarlarını alın.

Not

LocalWebservice için desteklenmez.

get_keys()

Döndürülenler

Tür	Description
	Bu Web hizmeti için kimlik doğrulama anahtarları.

Özel durumlar

Tür	Description
azureml.exceptions.NotImplementedError

get_logs

Bu LocalWebservice için günlükleri alın.

get_logs(num_lines=5000, raw=False)

Parametreler

Name	Description
num_lines Gerekli	int Alınacak günlük satırı sayısı üst sınırı. (Varsayılan: 5000)
raw Gerekli	bool Ham Docker kapsayıcı çıkışını biçimlendirmeye çalışmadan döndür. (Varsayılan: Yanlış)

Döndürülenler

Tür	Description
str	Bu LocalWebservice için günlükler.

Özel durumlar

Tür	Description
WebserviceException

get_token

Bu Web hizmeti için geçerli kullanıcı kapsamına alınmış kimlik doğrulama belirtecini alın.

Not

LocalWebservice için desteklenmez.

get_token()

Döndürülenler

Tür	Description
str, datetime	Bu Web hizmeti için kimlik doğrulama belirteci ve sonrasında ne zaman yenilenmesi gerektiği.

Özel durumlar

Tür	Description
azureml.exceptions.NotImplementedError

list

İlgili Çalışma Alanı ile ilişkili LocalWebservices'i listeleyin.

Döndürülen sonuçlar parametreler kullanılarak filtrelenebilir.

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

Parametreler

Name	Description
workspace Gerekli	Workspace LocalWebservices ile ilişkili Workspace nesnesi.
model_name	str Listeyi yalnızca belirli model adıyla dağıtılan LocalWebservices'i içerecek şekilde filtreleyin. Default value: None
model_id	str Listeyi yalnızca belirli model kimliğiyle dağıtılan LocalWebservices'i içerecek şekilde filtreleyin. Default value: None
all	bool Tüm hizmetleri göster. Varsayılan olarak yalnızca çalışan hizmetler gösterilir. Default value: None

Döndürülenler

Tür	Description
list[LocalWebservice]	Sağlanan Çalışma Alanı ile ilişkili LocalWebservices'in filtrelenmiş listesi.

Özel durumlar

Tür	Description
WebserviceException

regen_key

Web hizmeti anahtarlarından birini yeniden üretin.

Not

LocalWebservice için desteklenmez.

regen_key(key)

Parametreler

Name	Description
key Gerekli	str Yeniden oluşturulacak anahtar. Seçenekler :'Birincil' veya 'İkincil'

Özel durumlar

Tür	Description
NotImplementedError

reload

LocalWebservice'in yürütme betiğini ve bağımlılıklarını yeniden yükleyin.

Bu işlem, hizmetin kapsayıcısını yürütme betiği ve yerel bağımlılıklar da dahil olmak üzere güncelleştirilmiş varlıkların kopyalarıyla yeniden başlatır, ancak temel alınan görüntüyü yeniden oluşturmaz. Buna göre, Conda/pip bağımlılıklarında veya özel Docker adımlarında yapılan değişiklikler yeniden yüklenen LocalWebservice'e yansıtılmaz. Bu değişiklikleri işlemek için bunun yerine yöntemini çağırın update .

reload(wait=False)

Parametreler

Name	Description
wait Gerekli	bool Hizmetin kapsayıcısının iyi durumda olmasını bekleyin. (Varsayılan: Yanlış)

Özel durumlar

Tür	Description
WebserviceException

run

Sağlanan girişle bu LocalWebservice'i çağırın.

run(input_data)

Parametreler

Name	Description
input_data Gerekli	<xref:varies> LocalWebservice'in çağrıldığı giriş.

Döndürülenler

Tür	Description
<xref:varies>	LocalWebservice çağrısının sonucu.

Özel durumlar

Tür	Description
WebserviceException

serialize

Bu Web hizmeti nesnesini JSON serileştirilmiş sözlüğe dönüştürün.

serialize()

Döndürülenler

Tür	Description
dict	Web hizmeti nesnesinin serileştirilmiş gösterimi.

Özel durumlar

Tür	Description
WebserviceException

update

Sağlanan özelliklerle LocalWebservice'i güncelleştirin.

Hiçbiri olarak bırakılan değerler bu LocalWebservice'te değişmeden kalır.

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

Parametreler

Name	Description
models Gerekli	list[Model] LocalWebservice içinde bulunan modellerin yeni bir listesi.
image_config Gerekli	ContainerImageConfig LocalWebservice'e uygulanacak görüntü yapılandırma seçenekleri.
deployment_config Gerekli	LocalWebserviceDeploymentConfiguration LocalWebservice'e uygulanacak dağıtım yapılandırma seçenekleri.
inference_config Gerekli	InferenceConfig Gerekli model dağıtım özelliklerini sağlamak için kullanılan bir InferenceConfig nesnesi.
wait Gerekli	bool Hizmetin kapsayıcısının iyi durumda olmasını bekleyin. (Varsayılan: Yanlış)

Döndürülenler

Tür	Description
None

Özel durumlar

Tür	Description
WebserviceException

update_deployment_state

Bellek içi nesnenin geçerli durumunu yenileyin.

İlgili yerel Docker kapsayıcısının geçerli durumuna bağlı olarak nesnenin özelliklerinin yerinde güncelleştirmesini gerçekleştirin.

update_deployment_state(must_exist=False)

Parametreler

Name	Description
must_exist	bool Bellek içi nesnesi oluşturulurken web hizmeti zaten mevcut olmalıdır. Default value: False

Özel durumlar

Tür	Description
WebserviceException

wait_for_deployment

Çalışan LocalWebservice dağıtımını yoklama.

wait_for_deployment(show_output=False)

Parametreler

Name	Description
show_output Gerekli	bool Daha ayrıntılı çıktı yazdırma seçeneği. (Varsayılan: Yanlış)

Özel durumlar

Tür	Description
WebserviceException

Öznitelikler

port

Yerel web hizmeti bağlantı noktasını alın.

Döndürülenler

Tür	Description
int	Bağlantı noktası numarası.

scoring_uri

Yerel web hizmeti puanlama URI'sini alın.

Döndürülenler

Tür	Description
str	Puanlama URI'sini seçin.

swagger_uri

Yerel web hizmeti Swagger URI'sini alın.

Döndürülenler

Tür	Description
str	Swagger URI'sı.

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'