Aracılığıyla paylaş

AciWebservice Sınıf

  • Başvuru

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

Dağıtılan hizmet model, betik ve ilişkili dosyalardan oluşturulur. Sonuçta elde edilen web hizmeti, REST API'ye sahip yük dengeli bir HTTP uç noktasıdır. Bu API'ye veri gönderebilir ve model tarafından döndürülen tahmini alabilirsiniz.

Daha fazla bilgi için bkz. modeli Azure Container Instances 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
AciWebservice

Oluşturucu

AciWebservice(workspace, name)

Parametreler

Name Description
workspace
Gerekli
Workspace

Alınacak Web hizmeti nesnesini içeren çalışma alanı nesnesi.
name
Gerekli
str

Alınacak Web hizmeti nesnesinin adı.

Açıklamalar

Önerilen dağıtım düzeni, yöntemiyle deploy_configuration bir dağıtım yapılandırma nesnesi oluşturmak ve ardından aşağıda gösterildiği gibi sınıfın Model yöntemiyle deploy kullanmaktır.


   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_imageyöntemi.Webservice

  • 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 AciWebservice 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

Name Description
enable_app_insights
bool

Web hizmeti için AppInsights günlüğünün etkinleştirilip etkinleştirilmediği.
cname
str

Web hizmeti için cname.
container_resource_requirements
ContainerResourceRequirements

Web hizmeti için kapsayıcı kaynak gereksinimleri.
encryption_properties
EncryptionProperties

Web hizmeti için şifreleme özellikleri.
vnet_configuration
VnetConfiguration

Web hizmeti, yapılandırma için sanal ağ özellikleri oluşturulup kullanıcı tarafından sağlanmalıdır.
azureml.core.webservice.AciWebservice.location
str

Web hizmeti'nin dağıtılacağı konum.
public_ip
str

Web hizmeti genel IP adresi.
azureml.core.webservice.AciWebservice.scoring_uri
str

Web hizmeti için puanlama uç noktası
ssl_enabled
bool

Web hizmeti için SSL'nin etkinleştirilip etkinleştirilmediği
public_fqdn
str

Web hizmeti için genel FQDN
environment
Environment

Web hizmetini oluşturmak için kullanılan Ortam nesnesi
azureml.core.webservice.AciWebservice.models
list[Model]

Webservice'e dağıtılan Modellerin listesi
azureml.core.webservice.AciWebservice.swagger_uri
str

Web hizmeti için swagger uç noktası

Yöntemler

add_properties

Bu Web hizmeti özellikleri sözlüğüne anahtar değer çiftleri ekleyin.
add_tags

Bu Web hizmeti etiketleri sözlüğüne anahtar değer çiftleri ekleyin.
deploy_configuration

AciWebservice dağıtmak için bir yapılandırma nesnesi oluşturun.
get_token

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

Not

Uygulanmaz.
remove_tags

Belirtilen anahtarları bu Web hizmetindeki etiket sözlüğünden kaldırın.
run

Sağlanan girişle bu Web hizmetini çağırın.
serialize

Bu Web hizmetini JSON serileştirilmiş sözlüğüne dönüştürün.
update

Web hizmetini sağlanan özelliklerle güncelleştirin.

Hiçbiri olarak bırakılan değerler bu Web hizmetindeki değişmeden kalır.

add_properties

Bu Web hizmeti özellikleri sözlüğüne anahtar değer çiftleri ekleyin.

add_properties(properties)

Parametreler

Name Description
properties
Gerekli
dict[str, str]

Eklenecek özelliklerin sözlüğü.

add_tags

Bu Web hizmeti etiketleri sözlüğüne anahtar değer çiftleri ekleyin.

add_tags(tags)

Parametreler

Name Description
tags
Gerekli
dict[str, str]

Eklenecek etiketlerin sözlüğü.

Özel durumlar

Tür Description
WebserviceException

deploy_configuration

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

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)

Parametreler

Name Description
cpu_cores
float

Bu Web hizmeti için ayrılacak CPU çekirdeği sayısı. Ondalık olabilir. Varsayılan değer: 0.1

Default value: None
memory_gb
float

Bu Web hizmeti için ayrılacak bellek miktarı (GB cinsinden). Ondalık olabilir. Varsayılan değer 0,5'tir

Default value: None
tags
dict[str, str]

Bu Web hizmetini vermek için anahtar değer etiketlerini içeren bir sözlük.

Default value: None
properties
dict[str, str]

Bu Web hizmetini vermek için anahtar değer özellikleri sözlüğü. Bu özellikler dağıtımdan sonra değiştirilemez, ancak yeni anahtar değer çiftleri eklenebilir.

Default value: None
description
str

Bu Web hizmetini vermek için bir açıklama.

Default value: None
location
str

Bu Web hizmetini dağıtılacak Azure bölgesi. Belirtilmezse Çalışma Alanı konumu kullanılır. Kullanılabilir bölgeler hakkında daha fazla bilgi için bkz . Bölgeye göre ürünler.

Default value: None
auth_enabled
bool

Bu Web hizmeti için kimlik doğrulamasının etkinleştirilip etkinleştirilmeyileceği. Varsayılan değer False'tur.

Default value: None
ssl_enabled
bool

Bu Web hizmeti için SSL'nin etkinleştirilip etkinleştirilmeyileceği. Varsayılan değer False'tur.

Default value: None
enable_app_insights
bool

Bu Web hizmeti için AppInsights'ın etkinleştirilip etkinleştirilmeyileceği. Varsayılan değer False'tur.

Default value: None
ssl_cert_pem_file
str

SSL etkinse gereken sertifika dosyası.

Default value: None
ssl_key_pem_file
str

SSL etkinse gereken anahtar dosyası.

Default value: None
ssl_cname
str

SSL'nin etkin olup olmadığının cname değeri.

Default value: None
dns_name_label
str

Puanlama uç noktasının DNS adı etiketi. Belirtilmezse puanlama uç noktası için benzersiz bir DNS adı etiketi oluşturulur.

Default value: None
primary_key
str

Bu Web hizmeti için kullanılacak birincil kimlik doğrulama anahtarı.

Default value: None
secondary_key
str

Bu Web hizmeti için kullanılacak ikincil kimlik doğrulama anahtarı.

Default value: None
collect_model_data
bool

Web hizmeti için model veri koleksiyonunun etkinleştirilip etkinleştirilmeydiği.

Default value: None
cmk_vault_base_url
str

müşteri tarafından yönetilen anahtar kasası temel URL'si

Default value: None
cmk_key_name
str

müşteri tarafından yönetilen anahtar adı.

Default value: None
cmk_key_version
str

müşteri tarafından yönetilen anahtar sürümü.

Default value: None
vnet_name
str

sanal ağ adı.

Default value: None
subnet_name
str

sanal ağ içinde alt ağ adı.

Default value: None

Döndürülenler

Tür Description
AciServiceDeploymentConfiguration

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

Ö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

Uygulanmaz.

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

remove_tags

Belirtilen anahtarları bu Web hizmetindeki etiket sözlüğünden kaldırın.

remove_tags(tags)

Parametreler

Name Description
tags
Gerekli
list[str]

Kaldırılacak anahtarların listesi.

run

Sağlanan girişle bu Web hizmetini çağırın.

run(input_data)

Parametreler

Name Description
input_data
Gerekli
<xref:varies>

Web hizmetini çağırmak için giriş.

Döndürülenler

Tür Description
dict

Web hizmetini çağırmanın sonucu.

Özel durumlar

Tür Description
WebserviceException

serialize

Bu Web hizmetini JSON serileştirilmiş sözlüğüne dönüştürün.

serialize()

Döndürülenler

Tür Description
dict

Bu Web hizmeti nesnesinin JSON gösterimi.

update

Web hizmetini sağlanan özelliklerle güncelleştirin.

Hiçbiri olarak bırakılan değerler bu Web hizmetindeki değişmeden kalır.

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)

Parametreler

Name Description
image
Image

Webservice'e dağıtılacak yeni bir Görüntü.

Default value: None
tags
dict[str, str]

Bu Web hizmetini vermek için anahtar değer etiketlerini içeren bir sözlük. Mevcut etiketlerin yerini alır.

Default value: None
properties
dict[str, str]

Mevcut özellikler sözlüğüne eklenecek anahtar değeri özellikleri sözlüğü.

Default value: None
description
str

Bu Web hizmetini vermek için bir açıklama.

Default value: None
auth_enabled
bool

Bu Web hizmeti için kimlik doğrulamasını etkinleştirin veya devre dışı bırakın.

Default value: None
ssl_enabled
bool

Bu Web hizmeti için SSL'nin etkinleştirilip etkinleştirilmeyileceği.

Default value: None
ssl_cert_pem_file
str

SSL etkinse gereken sertifika dosyası.

Default value: None
ssl_key_pem_file
str

SSL etkinse gereken anahtar dosyası.

Default value: None
ssl_cname
str

SSL'nin etkin olup olmadığının cname değeri.

Default value: None
enable_app_insights
bool

Bu Web hizmeti için AppInsights'ın etkinleştirilip etkinleştirilmeyileceği.

Default value: None
models
list[Model]

Güncelleştirilmiş hizmete paketlenecek Model nesnelerinin listesi.

Default value: None
inference_config
InferenceConfig

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

Default value: None

Döndürülenler

Tür Description
None