AciWebservice Klasa

Przedstawia model uczenia maszynowego wdrożony jako punkt końcowy usługi sieci Web na Azure Container Instances.

Wdrożona usługa jest tworzona na podstawie modelu, skryptu i skojarzonych plików. Wynikiem usługi sieci Web jest zrównoważony obciążenie, punkt końcowy HTTP z interfejsem API REST. Można wysyłać dane do tego interfejsu API i odbierać przewidywania zwrócone przez model.

Aby uzyskać więcej informacji, zobacz Wdrażanie modelu do Azure Container Instances.

Dziedziczenie
AciWebservice

Konstruktor

AciWebservice(workspace, name)

Uwagi

Zalecany wzorzec wdrożenia to utworzenie obiektu konfiguracji wdrożenia przy użyciu deploy_configuration metody, a następnie użycie jej z deploy metodą Model klasy, jak pokazano poniżej.


   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)

Pełny przykład jest dostępny z https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-cloud/model-register-and-deploy.ipynb

Istnieje kilka sposobów wdrożenia modelu jako usługi sieci Web, w tym:

  • deploy Metoda dla modeli, które są Model już zarejestrowane w obszarze roboczym.

  • deploy_from_image Metoda Webservice .

  • deploy_from_model Metoda Webservice dla modeli już zarejestrowanych w obszarze roboczym. Ta metoda spowoduje utworzenie obrazu.

  • deploy Metoda Webservice , która będzie rejestrować model i utworzyć obraz.

Aby uzyskać informacje na temat pracy z usługami WebServices, zobacz

Sekcja zmienne zawiera listę atrybutów lokalnej reprezentacji obiektu AciWebservice w chmurze. Te zmienne powinny być traktowane jako tylko do odczytu. Zmiana ich wartości nie będzie odzwierciedlona w odpowiadającym jej obiekcie w chmurze.

Zmienne

enable_app_insights
bool

Czy rejestrowanie AppInsights jest włączone dla usługi sieci Web.

cname
str

Rekord CNAME dla usługi sieci Web.

container_resource_requirements
ContainerResourceRequirements

Wymagania dotyczące zasobów kontenera dla usługi sieci Web.

encryption_properties
EncryptionProperties

Właściwości szyfrowania dla usługi sieci Web.

vnet_configuration
VnetConfiguration

Właściwości sieci wirtualnej dla usługi WebService, konfiguracja powinna zostać utworzona i udostępniona przez użytkownika.

azureml.core.webservice.AciWebservice.location
str

Lokalizacja, w której jest wdrażana usługa sieci Web.

public_ip
str

Publiczny adres IP usługi WebService.

azureml.core.webservice.AciWebservice.scoring_uri
str

Punkt końcowy oceniania usługi sieci Web

ssl_enabled
bool

Czy w sieci Web jest włączony protokół SSL

public_fqdn
str

Publiczna nazwa FQDN dla sieci Web

environment
Środowisko

Obiekt środowiska, który został użyty do utworzenia usługi sieci Web

azureml.core.webservice.AciWebservice.models
list[Model]

Lista modeli wdrożonych w usłudze sieci Web

azureml.core.webservice.AciWebservice.swagger_uri
str

Punkt końcowy struktury Swagger dla sieci Web

Metody

add_properties

Dodaj pary klucz wartość do słownika właściwości tej usługi WebService.

add_tags

Dodaj pary klucz wartość do tego słownika tagów usługi WebService.

deploy_configuration

Utwórz obiekt konfiguracji na potrzeby wdrażania elementu AciWebservice.

get_token

Pobierz token uwierzytelniania dla tej usługi sieci Web w zakresie bieżącego użytkownika.

Uwaga

Nie zaimplementowano.

remove_tags

Usuń określone klucze z tego słownika usługi WebService tagów.

run

Wywołaj tę usługę sieci Web z dostarczonymi danymi wejściowymi.

serialize

Przekonwertuj tę usługę sieci Web do słownika serializowanego JSON.

update

Zaktualizuj usługę sieci Web przy użyciu podanych właściwości.

Wartości pozostawione jako brak pozostaną bez zmian w tej usłudze sieci Web.

add_properties

Dodaj pary klucz wartość do słownika właściwości tej usługi WebService.

add_properties(properties)

Parametry

properties
dict[str, str]

Słownik właściwości do dodania.

add_tags

Dodaj pary klucz wartość do tego słownika tagów usługi WebService.

add_tags(tags)

Parametry

tags
dict[str, str]

Słownik tagów do dodania.

Wyjątki

deploy_configuration

Utwórz obiekt konfiguracji na potrzeby wdrażania elementu AciWebservice.

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)

Parametry

cpu_cores
float
wartość domyślna: None

Liczba rdzeni procesora CPU do przydzielenia dla tej usługi sieci Web. Może być liczbą dziesiętną. Wartość domyślna to 0,1

memory_gb
float
wartość domyślna: None

Ilość pamięci (w GB) do przydzielenia dla tej usługi sieci Web. Może być liczbą dziesiętną. Wartość domyślna to 0,5

tags
dict[str, str]
wartość domyślna: None

Słownik najważniejszych tagów wartości, aby udostępnić tę usługę sieci Web.

properties
dict[str, str]
wartość domyślna: None

Słownik właściwości wartości klucza, aby udostępnić tę usługę sieci Web. Tych właściwości nie można zmienić po wdrożeniu. można jednak dodać nowe pary klucz wartość.

description
str
wartość domyślna: None

Opis, aby udostępnić tę usługę sieci Web.

location
str
wartość domyślna: None

Region świadczenia usługi Azure, w którym ma zostać wdrożona ta usługa sieci Web. Jeśli nie zostanie określona, zostanie użyta Lokalizacja obszaru roboczego. Aby uzyskać więcej informacji na temat dostępnych regionów, zobacz produkty według regionów.

auth_enabled
bool
wartość domyślna: None

Określa, czy włączyć uwierzytelnianie dla tej usługi sieci Web. Wartością domyślną jest false.

ssl_enabled
bool
wartość domyślna: None

Określa, czy włączyć protokół SSL dla tej usługi sieci Web. Wartością domyślną jest false.

enable_app_insights
bool
wartość domyślna: None

Określa, czy włączyć AppInsights dla tej usługi sieci Web. Wartością domyślną jest false.

ssl_cert_pem_file
str
wartość domyślna: None

Plik certyfikatu, który jest wymagany, jeśli jest włączony protokół SSL.

ssl_key_pem_file
str
wartość domyślna: None

Plik klucza wymagany w przypadku włączenia protokołu SSL.

ssl_cname
str
wartość domyślna: None

Rekord CNAME dla jeśli jest włączony protokół SSL.

dns_name_label
str
wartość domyślna: None

Etykieta nazwy DNS dla punktu końcowego oceniania. Jeśli nie zostanie określona, zostanie wygenerowana unikatowa etykieta nazwy DNS dla punktu końcowego oceniania.

primary_key
str
wartość domyślna: None

Podstawowy klucz uwierzytelniania, który ma być używany przez tę usługę sieci Web.

secondary_key
str
wartość domyślna: None

Pomocniczy klucz uwierzytelniania, który będzie używany przez tę usługę sieci Web.

collect_model_data
bool
wartość domyślna: None

Określa, czy włączyć zbieranie danych modelu dla usługi sieci Web.

cmk_vault_base_url
str
wartość domyślna: None

podstawowy adres URL magazynu kluczy zarządzanych przez klienta

cmk_key_name
str
wartość domyślna: None

Nazwa klucza zarządzanego przez klienta.

cmk_key_version
str
wartość domyślna: None

wersja klucza zarządzanego przez klienta.

vnet_name
str
wartość domyślna: None

Nazwa sieci wirtualnej.

subnet_name
str
wartość domyślna: None

Nazwa podsieci w sieci wirtualnej.

Zwraca

Obiekt konfiguracji, który ma być używany podczas wdrażania obiektu usługi WebService.

Typ zwracany

Wyjątki

get_token

Pobierz token uwierzytelniania dla tej usługi sieci Web w zakresie bieżącego użytkownika.

Uwaga

Nie zaimplementowano.

get_token()

Zwraca

Token uwierzytelniania dla tej usługi sieci Web i kiedy powinien być odświeżany po.

Typ zwracany

remove_tags

Usuń określone klucze z tego słownika usługi WebService tagów.

remove_tags(tags)

Parametry

tags
list[str]

Lista kluczy do usunięcia.

run

Wywołaj tę usługę sieci Web z dostarczonymi danymi wejściowymi.

run(input_data)

Parametry

input_data
<xref:varies>

Dane wejściowe do wywołania usługi sieci Web za pomocą.

Zwraca

Wynik wywołania usługi sieci Web.

Typ zwracany

Wyjątki

serialize

Przekonwertuj tę usługę sieci Web do słownika serializowanego JSON.

serialize()

Zwraca

Reprezentacja JSON tego obiektu usługi WebService.

Typ zwracany

update

Zaktualizuj usługę sieci Web przy użyciu podanych właściwości.

Wartości pozostawione jako brak pozostaną bez zmian w tej usłudze sieci Web.

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)

Parametry

image
Image
wartość domyślna: None

Nowy obraz do wdrożenia w usłudze sieci Web.

tags
dict[str, str]
wartość domyślna: None

Słownik najważniejszych tagów wartości, aby udostępnić tę usługę sieci Web. Zastąpi istniejące Tagi.

properties
dict[str, str]
wartość domyślna: None

Słownik właściwości wartości klucza do dodania do istniejącego słownika właściwości.

description
str
wartość domyślna: None

Opis, aby udostępnić tę usługę sieci Web.

auth_enabled
bool
wartość domyślna: None

Włącz lub Wyłącz uwierzytelnianie dla tej usługi sieci Web.

ssl_enabled
bool
wartość domyślna: None

Określa, czy włączyć protokół SSL dla tej usługi sieci Web.

ssl_cert_pem_file
str
wartość domyślna: None

Plik certyfikatu, który jest wymagany, jeśli jest włączony protokół SSL.

ssl_key_pem_file
str
wartość domyślna: None

Plik klucza wymagany w przypadku włączenia protokołu SSL.

ssl_cname
str
wartość domyślna: None

Rekord CNAME dla jeśli jest włączony protokół SSL.

enable_app_insights
bool
wartość domyślna: None

Określa, czy włączyć AppInsights dla tej usługi sieci Web.

models
list[Model]
wartość domyślna: None

Lista obiektów modelu do spakowania w zaktualizowanej usłudze.

inference_config
InferenceConfig
wartość domyślna: None

Obiekt InferenceConfig używany do zapewnienia wymaganych właściwości wdrożenia modelu.

Typ zwracany