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

workspace
Workspace
Gerekli

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

name
str
Gerekli

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:

  • deployModel çalışma alanında kayıtlı olan modeller için yöntemi.

  • deploy_from_imageyöntemi.Webservice

  • deploy_from_modelWebservice çalışma alanında zaten kayıtlı olan modeller için yöntemi. Bu yöntem bir görüntü oluşturur.

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

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

properties
dict[str, str]
Gerekli

Eklenecek özelliklerin sözlüğü.

add_tags

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

add_tags(tags)

Parametreler

tags
dict[str, str]
Gerekli

Eklenecek etiketlerin sözlüğü.

Özel durumlar

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

cpu_cores
float
varsayılan değer: None

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

memory_gb
float
varsayılan değer: None

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

tags
dict[str, str]
varsayılan değer: None

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

properties
dict[str, str]
varsayılan değer: None

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.

description
str
varsayılan değer: None

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

location
str
varsayılan değer: None

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.

auth_enabled
bool
varsayılan değer: None

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

ssl_enabled
bool
varsayılan değer: None

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

enable_app_insights
bool
varsayılan değer: None

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

ssl_cert_pem_file
str
varsayılan değer: None

SSL etkinse gereken sertifika dosyası.

ssl_key_pem_file
str
varsayılan değer: None

SSL etkinse gereken anahtar dosyası.

ssl_cname
str
varsayılan değer: None

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

dns_name_label
str
varsayılan değer: None

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

primary_key
str
varsayılan değer: None

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

secondary_key
str
varsayılan değer: None

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

collect_model_data
bool
varsayılan değer: None

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

cmk_vault_base_url
str
varsayılan değer: None

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

cmk_key_name
str
varsayılan değer: None

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

cmk_key_version
str
varsayılan değer: None

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

vnet_name
str
varsayılan değer: None

sanal ağ adı.

subnet_name
str
varsayılan değer: None

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

Döndürülenler

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

Dönüş türü

AciServiceDeploymentConfiguration

Özel durumlar

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

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

Dönüş türü

str, datetime

Özel durumlar

azureml.exceptions.NotImplementedError

remove_tags

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

remove_tags(tags)

Parametreler

tags
list[str]
Gerekli

Kaldırılacak anahtarların listesi.

run

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

run(input_data)

Parametreler

input_data
<xref:varies>
Gerekli

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

Döndürülenler

Web hizmetini çağırmanın sonucu.

Dönüş türü

dict

Özel durumlar

WebserviceException

serialize

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

serialize()

Döndürülenler

Bu Web hizmeti nesnesinin JSON gösterimi.

Dönüş türü

dict

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

image
Image
varsayılan değer: None

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

tags
dict[str, str]
varsayılan değer: None

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

properties
dict[str, str]
varsayılan değer: None

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

description
str
varsayılan değer: None

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

auth_enabled
bool
varsayılan değer: None

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

ssl_enabled
bool
varsayılan değer: None

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

ssl_cert_pem_file
str
varsayılan değer: None

SSL etkinse gereken sertifika dosyası.

ssl_key_pem_file
str
varsayılan değer: None

SSL etkinse gereken anahtar dosyası.

ssl_cname
str
varsayılan değer: None

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

enable_app_insights
bool
varsayılan değer: None

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

models
list[Model]
varsayılan değer: None

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

inference_config
InferenceConfig
varsayılan değer: None

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

Dönüş türü

None