Udostępnij za pośrednictwem

AciWebservice Klasa

Reprezentuje model uczenia maszynowego wdrożony jako punkt końcowy usługi internetowej w usłudze Azure Container Instances.

Wdrożona usługa jest tworzona na podstawie modelu, skryptu i skojarzonych plików. Wynikowa usługa internetowa to punkt końcowy HTTP o zrównoważonym obciążeniu z interfejsem API REST. Możesz wysłać dane do tego interfejsu API i otrzymać przewidywanie zwrócone przez model.

Aby uzyskać więcej informacji, zobacz Wdrażanie modelu w usłudze Azure Container Instances.

Zainicjuj wystąpienie usługi internetowej.

Konstruktor usługi sieci Web pobiera reprezentację w chmurze obiektu usługi sieci Web skojarzonego z podanym obszarem roboczym. Zwróci wystąpienie klasy podrzędnej odpowiadające określonemu typowi pobranego obiektu usługi sieci Web.

Konstruktor

AciWebservice(workspace, name)

Parametry

Nazwa Opis
workspace
Wymagane
Workspace

Obiekt obszaru roboczego zawierający obiekt usługi sieci Web do pobrania.
name
Wymagane
str

Nazwa obiektu usługi sieci Web do pobrania.

Uwagi

Zalecanym wzorcem wdrażania jest utworzenie obiektu konfiguracji wdrożenia za deploy_configuration pomocą metody , a następnie użycie go 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)

Istnieje wiele sposobów wdrażania modelu jako usługi internetowej, w tym następujących elementów:

  • deploy Model metoda dla modeli już zarejestrowanych w obszarze roboczym.

  • deploy_from_image Webservicemetoda .

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

  • deploy Webservicemetoda , która zarejestruje model i utworzy obraz.

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

Sekcja Zmienne zawiera listę atrybutów lokalnej reprezentacji obiektu cloud AciWebservice. Te zmienne powinny być traktowane jako tylko do odczytu. Zmiana ich wartości nie zostanie odzwierciedlona w odpowiednim obiekcie chmury.

Zmienne

Nazwa Opis
enable_app_insights
bool

Określa, czy rejestrowanie w usłudze AppInsights jest włączone dla usługi internetowej.
cname
str

Nazwa cname 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 sieci Web należy utworzyć i udostępnić użytkownikowi.
azureml.core.webservice.AciWebservice.location
str

Lokalizacja, w ramach których jest wdrażana usługa sieci Web.
public_ip
str

Publiczny adres IP usługi sieci Web.
azureml.core.webservice.AciWebservice.scoring_uri
str

Punkt końcowy oceniania dla usługi sieci Web
ssl_enabled
bool

Określa, czy protokół SSL jest włączony dla usługi sieci Web
public_fqdn
str

Publiczna nazwa FQDN usługi sieci Web
environment
Environment

Obiekt Environment, 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 usługi sieci Web

Metody

add_properties

Dodaj pary wartości klucza do słownika właściwości tej usługi sieci Web.
add_tags

Dodaj pary wartości klucza do słownika tagów tej usługi sieci Web.
deploy_configuration

Utwórz obiekt konfiguracji na potrzeby wdrażania usługi AciWebservice.
get_token

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

Uwaga

Nie zaimplementowano.
remove_tags

Usuń określone klucze ze słownika tagów tej usługi sieci Web.
run

Wywołaj tę usługę sieci Web przy użyciu podanych danych wejściowych.
serialize

Przekonwertuj tę usługę internetową na słownik serializowany w formacie JSON.
update

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

Wartości pozostawione jako Brak pozostaną niezmienione w tej usłudze sieci Web.

add_properties

Dodaj pary wartości klucza do słownika właściwości tej usługi sieci Web.

add_properties(properties)

Parametry

Nazwa Opis
properties
Wymagane
dict[str, str]

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

add_tags

Dodaj pary wartości klucza do słownika tagów tej usługi sieci Web.

add_tags(tags)

Parametry

Nazwa Opis
tags
Wymagane
dict[str, str]

Słownik tagów do dodania.

Wyjątki

Typ Opis
WebserviceException

deploy_configuration

Utwórz obiekt konfiguracji na potrzeby wdrażania usługi AciWebservice.

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)

Parametry

Nazwa Opis
cpu_cores
float

Liczba rdzeni procesora CPU do przydzielenia dla tej usługi sieci Web. Może to być liczba dziesiętna. Wartość domyślna to 0.1

Domyślna wartość: None
memory_gb
float

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

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

Słownik tagów wartości klucza, aby nadać tej usłudze sieci Web.

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

Słownik właściwości wartości klucza, aby nadać tej usłudze sieci Web. Tych właściwości nie można zmienić po wdrożeniu, jednak można dodać nowe pary wartości klucza.

Domyślna wartość: None
description
str

Opis do nadania tej usługi sieci Web.

Domyślna wartość: None
location
str

Region świadczenia usługi Azure do wdrożenia tej usługi internetowej. Jeśli nie określono lokalizacji obszaru roboczego, zostanie użyta. Aby uzyskać więcej informacji na temat dostępnych regionów, zobacz Produkty według regionów.

Domyślna wartość: None
auth_enabled
bool

Czy włączyć uwierzytelnianie dla tej usługi sieci Web. Wartość domyślna to False.

Domyślna wartość: None
ssl_enabled
bool

Określa, czy włączyć protokół SSL dla tej usługi sieci Web. Wartość domyślna to False.

Domyślna wartość: None
enable_app_insights
bool

Określa, czy włączyć usługę AppInsights dla tej usługi sieci Web. Wartość domyślna to False.

Domyślna wartość: None
ssl_cert_pem_file
str

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

Domyślna wartość: None
ssl_key_pem_file
str

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

Domyślna wartość: None
ssl_cname
str

Nazwa cname dla , jeśli protokół SSL jest włączony.

Domyślna wartość: None
dns_name_label
str

Etykieta nazwy DNS dla punktu końcowego oceniania. Jeśli nie określono unikatowej etykiety nazwy DNS, zostanie wygenerowana dla punktu końcowego oceniania.

Domyślna wartość: None
primary_key
str

Podstawowy klucz uwierzytelniania używany dla tej usługi sieci Web.

Domyślna wartość: None
secondary_key
str

Pomocniczy klucz uwierzytelniania do użycia dla tej usługi sieci Web.

Domyślna wartość: None
collect_model_data
bool

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

Domyślna wartość: None
cmk_vault_base_url
str

adres URL podstawowy magazynu kluczy zarządzanych przez klienta

Domyślna wartość: None
cmk_key_name
str

nazwa klucza zarządzanego przez klienta.

Domyślna wartość: None
cmk_key_version
str

wersja klucza zarządzanego przez klienta.

Domyślna wartość: None
vnet_name
str

nazwa sieci wirtualnej.

Domyślna wartość: None
subnet_name
str

nazwa podsieci w sieci wirtualnej.

Domyślna wartość: None

Zwraca

Typ Opis
AciServiceDeploymentConfiguration

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

Wyjątki

Typ Opis
WebserviceException

get_token

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

Uwaga

Nie zaimplementowano.

get_token()

Zwraca

Typ Opis
str, datetime

Token uwierzytelniania dla tej usługi internetowej i kiedy powinien zostać odświeżony po.

Wyjątki

Typ Opis
azureml.exceptions.NotImplementedError

remove_tags

Usuń określone klucze ze słownika tagów tej usługi sieci Web.

remove_tags(tags)

Parametry

Nazwa Opis
tags
Wymagane
list[str]

Lista kluczy do usunięcia.

run

Wywołaj tę usługę sieci Web przy użyciu podanych danych wejściowych.

run(input_data)

Parametry

Nazwa Opis
input_data
Wymagane
<xref:varies>

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

Zwraca

Typ Opis
dict

Wynik wywołania usługi sieci Web.

Wyjątki

Typ Opis
WebserviceException

serialize

Przekonwertuj tę usługę internetową na słownik serializowany w formacie JSON.

serialize()

Zwraca

Typ Opis
dict

Reprezentacja JSON tego obiektu usługi sieci Web.

update

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

Wartości pozostawione jako Brak pozostaną niezmienione 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

Nazwa Opis
image
Image

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

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

Słownik tagów wartości klucza, aby nadać tej usłudze sieci Web. Zastąpi istniejące tagi.

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

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

Domyślna wartość: None
description
str

Opis do nadania tej usługi sieci Web.

Domyślna wartość: None
auth_enabled
bool

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

Domyślna wartość: None
ssl_enabled
bool

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

Domyślna wartość: None
ssl_cert_pem_file
str

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

Domyślna wartość: None
ssl_key_pem_file
str

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

Domyślna wartość: None
ssl_cname
str

Nazwa cname dla , jeśli protokół SSL jest włączony.

Domyślna wartość: None
enable_app_insights
bool

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

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

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

Domyślna wartość: None
inference_config
InferenceConfig

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

Domyślna wartość: None

Zwraca

Typ Opis
None