LocalWebservice Sınıf

  • Başvuru

Yerel web hizmeti uç noktası olarak dağıtılan 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şkilendirilmiş 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 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 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ğildir; 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 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

LocalWebservice'i sağlanan özelliklerle 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 göre 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ğildir; 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

Bir 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 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ürebilirsiniz. (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 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

LocalWebservice'i sağlanan özelliklerle 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 göre 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'si.

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'