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
Obiekt obszaru roboczego zawierający obiekt 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
metoda dla modeli już zarejestrowanych Model w obszarze roboczym.deploy_from_image
metoda .Webservicedeploy_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
Korzystanie z modelu usługi Azure Machine Learning wdrożonego jako usługa internetowa
Monitorowanie i zbieranie danych z punktów końcowych usługi internetowej ML
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
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
add_tags
Dodaj pary wartości klucza do słownika tagów tej usługi sieci Web.
add_tags(tags)
Parametry
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
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
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
Słownik tagów wartości klucza, aby nadać tej usłudze sieci Web.
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.
- location
- str
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
Niezależnie od tego, czy włączyć uwierzytelnianie dla tej usługi sieci Web. Wartość domyślna to False.
- ssl_enabled
- bool
Czy włączyć protokół SSL dla tej usługi sieci Web. Wartość domyślna to False.
- enable_app_insights
- bool
Czy włączyć usługę AppInsights dla tej usługi sieci Web. Wartość domyślna to False.
- ssl_cert_pem_file
- str
Plik certyfikatu wymagany w przypadku włączenia protokołu SSL.
- ssl_key_pem_file
- str
Plik klucza wymagany w przypadku włączenia protokołu SSL.
- dns_name_label
- str
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
Podstawowy klucz uwierzytelniania do użycia dla tej usługi sieci Web.
- secondary_key
- str
Pomocniczy klucz uwierzytelniania do użycia dla tej usługi sieci Web.
- collect_model_data
- bool
Niezależnie od tego, czy włączono zbieranie danych modelu dla usługi sieci Web.
- cmk_vault_base_url
- str
Adres URL podstawowy magazynu kluczy zarządzanych przez klienta
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
remove_tags
Usuń określone klucze ze słownika tagów tej usługi sieci Web.
remove_tags(tags)
Parametry
run
Wywołaj tę usługę sieci Web przy użyciu podanych danych wejściowych.
run(input_data)
Parametry
- input_data
- <xref:varies>
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
Słownik tagów wartości klucza, aby nadać tej usłudze sieci Web. Zastąpi istniejące tagi.
Słownik właściwości wartości klucza do dodania do istniejącego słownika właściwości.
- auth_enabled
- bool
Włącz lub wyłącz uwierzytelnianie dla tej usługi sieci Web.
- ssl_cert_pem_file
- str
Plik certyfikatu wymagany w przypadku włączenia protokołu SSL.
- ssl_key_pem_file
- str
Plik klucza wymagany w przypadku włączenia protokołu SSL.
- enable_app_insights
- bool
Czy włączyć usługę AppInsights dla tej usługi sieci Web.
Lista obiektów modelu do spakowania w zaktualizowanej usłudze.
- inference_config
- InferenceConfig
Obiekt InferenceConfig używany do udostępniania wymaganych właściwości wdrożenia modelu.
Typ zwracany
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla