Share via


LocalWebservice Sınıf

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
LocalWebservice

Oluşturucu

LocalWebservice(*args, **kwargs)

Parametreler

workspace
Workspace
Gerekli

Alınacak model nesnelerini içeren çalışma alanı nesnesi.

name
str
Gerekli

Alınacak Web hizmeti nesnesinin adı.

must_exist
bool
Gerekli

Bellek içi nesnesi oluşturulurken web hizmeti zaten mevcut olmalıdır.

workspace
Workspace
Gerekli

Alınacak model nesnelerini içeren çalışma alanı nesnesi.

name
str
Gerekli

Alınacak LocalWebservice nesnesinin adı.

must_exist
bool
Gerekli

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

delete_cache
bool
Gerekli

Hizmet için önbelleğe alınan geçici dosyaların silinip silinmeyeceği. (Varsayılan: True)

delete_image
bool
Gerekli

Hizmetin Docker görüntüsünün silinip silinmeyeceği. (Varsayılan: Yanlış)

delete_volume
bool
Gerekli

Hizmetin Docker biriminin silinip silinmeyeceği. (Varsayılan: True)

Özel durumlar

deploy_configuration

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

static deploy_configuration(port=None)

Parametreler

port
int
varsayılan değer: None

Hizmetin HTTP uç noktasının kullanıma açık olduğu yerel bağlantı noktası.

Döndürülenler

Bir Web hizmeti nesnesi dağıtılırken kullanılacak yapılandırma nesnesi.

Dönüş türü

Özel durumlar

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
str
varsayılan değer: None

Dağıtılan hizmeti vermek için gereken ad. Çalışma alanı için benzersiz olmalıdır.

deployment_config
WebserviceDeploymentConfiguration
varsayılan değer: None

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
varsayılan değer: None

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.

Döndürülenler

Dağıtılan web hizmetiyle ilgili bir Web hizmeti nesnesi.

Dönüş türü

Özel durumlar

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

cls
Gerekli
workspace
Workspace
Gerekli

Web hizmeti'nin kayıtlı olduğu çalışma alanı nesnesi.

webservice_payload
dict
Gerekli

Web hizmeti nesnesine dönüştürülecek JSON nesnesi.

Özel durumlar

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

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

Özel durumlar

azureml.exceptions.NotImplementedError

get_logs

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

get_logs(num_lines=5000, raw=False)

Parametreler

num_lines
int
Gerekli

Alınacak günlük satırı sayısı üst sınırı. (Varsayılan: 5000)

raw
bool
Gerekli

Ham Docker kapsayıcı çıkışını biçimlendirmeye çalışmadan döndürebilirsiniz. (Varsayılan: Yanlış)

Döndürülenler

Bu LocalWebservice için günlükler.

Dönüş türü

str

Özel durumlar

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

Bu Web hizmeti için kimlik doğrulama belirteci ve sonrasında ne zaman yenilenmesi gerektiği.

Dönüş türü

Özel durumlar

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

workspace
Workspace
Gerekli

LocalWebservices ile ilişkili Workspace nesnesi.

model_name
str
varsayılan değer: None

Listeyi yalnızca belirli model adıyla dağıtılan LocalWebservices'i içerecek şekilde filtreleyin.

model_id
str
varsayılan değer: None

Listeyi yalnızca belirli model kimliğiyle dağıtılan LocalWebservices'i içerecek şekilde filtreleyin.

all
bool
varsayılan değer: None

Tüm hizmetleri göster. Varsayılan olarak yalnızca çalışan hizmetler gösterilir.

Döndürülenler

Sağlanan Çalışma Alanı ile ilişkili LocalWebservices'in filtrelenmiş listesi.

Dönüş türü

Özel durumlar

regen_key

Web hizmeti anahtarlarından birini yeniden üretin.

Not

LocalWebservice için desteklenmez.

regen_key(key)

Parametreler

key
str
Gerekli

Yeniden oluşturulacak anahtar. Seçenekler 'Birincil' veya 'İkincil'

Özel durumlar

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

wait
bool
Gerekli

Hizmetin kapsayıcısının iyi durumda olmasını bekleyin. (Varsayılan: Yanlış)

Özel durumlar

run

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

run(input_data)

Parametreler

input_data
<xref:varies>
Gerekli

LocalWebservice'in çağrıldığı giriş.

Döndürülenler

LocalWebservice çağrısının sonucu.

Dönüş türü

<xref:varies>

Özel durumlar

serialize

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

serialize()

Döndürülenler

Web hizmeti nesnesinin serileştirilmiş gösterimi.

Dönüş türü

Özel durumlar

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

models
list[Model]
Gerekli

LocalWebservice içinde bulunan modellerin yeni bir listesi.

image_config
ContainerImageConfig
Gerekli

LocalWebservice'e uygulanacak görüntü yapılandırma seçenekleri.

deployment_config
LocalWebserviceDeploymentConfiguration
Gerekli

LocalWebservice'e uygulanacak dağıtım yapılandırma seçenekleri.

inference_config
InferenceConfig
Gerekli

Gerekli model dağıtım özelliklerini sağlamak için kullanılan bir InferenceConfig nesnesi.

wait
bool
Gerekli

Hizmetin kapsayıcısının iyi durumda olmasını bekleyin. (Varsayılan: Yanlış)

Dönüş türü

Özel durumlar

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

must_exist
bool
varsayılan değer: False

Bellek içi nesnesi oluşturulurken web hizmeti zaten mevcut olmalıdır.

Özel durumlar

wait_for_deployment

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

wait_for_deployment(show_output=False)

Parametreler

show_output
bool
Gerekli

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

Özel durumlar

Öznitelikler

port

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

Döndürülenler

Bağlantı noktası numarası.

Dönüş türü

int

scoring_uri

Yerel web hizmeti puanlama URI'sini alın.

Döndürülenler

Puanlama URI'si.

Dönüş türü

str

swagger_uri

Yerel web hizmeti Swagger URI'sini alın.

Döndürülenler

Swagger URI'sı.

Dönüş türü

str

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'