AciWebservice Klasa

Reprezentuje model uczenia maszynowego wdrożony jako punkt końcowy usługi internetowej w 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. Dane można wysyłać do tego interfejsu API i otrzymywać przewidywania zwrócone przez model.

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

Zainicjuj wystąpienie usługi internetowej.

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

Dziedziczenie
AciWebservice

Konstruktor

AciWebservice(workspace, name)

Parametry

workspace
Workspace
Wymagane

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

name
str
Wymagane

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:

  • deployModel metoda dla modeli już zarejestrowanych w obszarze roboczym.

  • deploy_from_imageWebservicemetoda .

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

  • deployWebservicemetoda , 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

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 internetowej.

encryption_properties
EncryptionProperties

Właściwości szyfrowania dla usługi internetowej.

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 internetowej.

azureml.core.webservice.AciWebservice.scoring_uri
str

Punkt końcowy oceniania dla usługi internetowej

ssl_enabled
bool

Określa, czy protokół SSL jest włączony dla usługi internetowej

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 internetowej

azureml.core.webservice.AciWebservice.swagger_uri
str

Punkt końcowy struktury Swagger dla usługi internetowej

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 do wdrażania usługi AciWebservice.

get_token

Pobierz token uwierzytelniania dla tej usługi sieci Web o określonym zakresie dla 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 serializacji JSON.

update

Zaktualizuj usługę sieci Web 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

properties
dict[str, str]
Wymagane

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

tags
dict[str, str]
Wymagane

Słownik tagów do dodania.

Wyjątki

deploy_configuration

Utwórz obiekt konfiguracji do 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

cpu_cores
float
wartość domyślna: None

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

memory_gb
float
wartość domyślna: None

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

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

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

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

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

description
str
wartość domyślna: None

Opis, który ma nadać tej usłudze sieci Web.

location
str
wartość domyślna: None

Region platformy Azure do wdrożenia tej usługi sieci Web. 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.

auth_enabled
bool
wartość domyślna: None

Niezależnie od tego, czy włączyć uwierzytelnianie dla tej usługi sieci Web. Wartość domyślna to False.

ssl_enabled
bool
wartość domyślna: None

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

enable_app_insights
bool
wartość domyślna: None

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

ssl_cert_pem_file
str
wartość domyślna: None

Plik certyfikatu wymagany w przypadku włączenia protokołu 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

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

dns_name_label
str
wartość domyślna: None

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

primary_key
str
wartość domyślna: None

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

secondary_key
str
wartość domyślna: None

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

collect_model_data
bool
wartość domyślna: None

Niezależnie od tego, czy włączono zbieranie danych modelu dla usługi sieci Web.

cmk_vault_base_url
str
wartość domyślna: None

Adres URL podstawowy 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 do użycia podczas wdrażania obiektu usługi sieci Web.

Typ zwracany

Wyjątki

get_token

Pobierz token uwierzytelniania dla tej usługi sieci Web o określonym zakresie dla bieżącego użytkownika.

Uwaga

Nie zaimplementowano.

get_token()

Zwraca

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

Typ zwracany

Wyjątki

azureml.exceptions.NotImplementedError

remove_tags

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

remove_tags(tags)

Parametry

tags
list[str]
Wymagane

Lista kluczy do usunięcia.

run

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

run(input_data)

Parametry

input_data
<xref:varies>
Wymagane

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

Zwraca

Wynik wywołania usługi sieci Web.

Typ zwracany

Wyjątki

serialize

Przekonwertuj tę usługę internetową na słownik serializacji JSON.

serialize()

Zwraca

Reprezentacja JSON tego obiektu usługi sieci Web.

Typ zwracany

update

Zaktualizuj usługę sieci Web 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

image
Image
wartość domyślna: None

Nowy obraz do wdrożenia w usłudze internetowej.

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

Słownik tagów wartości klucza, aby nadać tej usłudze 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, który ma nadać tej usłudze 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

Czy włączyć protokół SSL dla tej usługi sieci Web.

ssl_cert_pem_file
str
wartość domyślna: None

Plik certyfikatu wymagany w przypadku włączenia protokołu 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

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

enable_app_insights
bool
wartość domyślna: None

Czy włączyć usługę 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 udostępniania wymaganych właściwości wdrożenia modelu.

Typ zwracany