AciWebservice Osztály

  • Referencia

Webszolgáltatás-végpontként üzembe helyezett gépi tanulási modellt jelöl a Azure Container Instances.

Az üzembe helyezett szolgáltatás modellből, szkriptből és társított fájlokból jön létre. Az eredményként kapott webszolgáltatás egy elosztott terhelésű HTTP-végpont REST API-val. Adatokat küldhet erre az API-ra, és megkaphatja a modell által visszaadott előrejelzést.

További információ: Modell üzembe helyezése Azure Container Instances.

Inicializálja a webszolgáltatás-példányt.

A Webservice-konstruktor lekéri a megadott munkaterülethez társított webszolgáltatás-objektum felhőbeli ábrázolását. Egy gyermekosztály egy példányát adja vissza, amely megfelel a lekért webszolgáltatás-objektum adott típusának.

Öröklődés
Webservice
AciWebservice

Konstruktor

AciWebservice(workspace, name)

Paraméterek

workspace
Workspace
Kötelező

A lekérni kívánt Webservice objektumot tartalmazó munkaterület-objektum.

name
str
Kötelező

A lekérni kívánt Webservice objektum neve.

Megjegyzések

Az ajánlott üzembehelyezési minta egy üzembehelyezési konfigurációs objektum létrehozása a deploy_configuration metódussal, majd az osztály metódusával deploy való használata az Model alább látható módon.


   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)

A modellek webszolgáltatásként többféleképpen is üzembe helyezhetők, többek között az alábbiakkal:

  • deploy metódusát a Model munkaterületen már regisztrált modellek esetében.

  • deploy_from_image metódusa Webservice.

  • deploy_from_model metódust Webservice a munkaterületen már regisztrált modellekhez. Ez a metódus létrehoz egy képet.

  • deploy metódusa Webservice, amely regisztrál egy modellt, és létrehoz egy képet.

A webszolgáltatások használatával kapcsolatos információkért lásd:

A Változók szakasz a felhőbeli AciWebservice objektum helyi reprezentációjának attribútumait sorolja fel. Ezeket a változókat írásvédettnek kell tekinteni. Az értékek módosítása nem jelenik meg a megfelelő felhőobjektumban.

Változók

enable_app_insights
bool

Azt jelzi, hogy az AppInsights naplózása engedélyezve van-e a webszolgáltatáshoz.

cname
str

A webszolgáltatás cname neve.

container_resource_requirements
ContainerResourceRequirements

A webszolgáltatás tárolóerőforrás-követelményei.

encryption_properties
EncryptionProperties

A webszolgáltatás titkosítási tulajdonságai.

vnet_configuration
VnetConfiguration

A webszolgáltatás virtuális hálózati tulajdonságait, a konfigurációt a felhasználónak kell létrehoznia és megadnia.

azureml.core.webservice.AciWebservice.location
str

A webszolgáltatás üzembe helyezésének helye.

public_ip
str

A webszolgáltatás nyilvános IP-címe.

azureml.core.webservice.AciWebservice.scoring_uri
str

A webszolgáltatás pontozási végpontja

ssl_enabled
bool

Azt jelzi, hogy az SSL engedélyezve van-e a webszolgáltatáshoz

public_fqdn
str

A webszolgáltatás nyilvános teljes tartományneve

environment
Environment

A webszolgáltatás létrehozásához használt Környezeti objektum

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

A webszolgáltatásban üzembe helyezett modellek listája

azureml.core.webservice.AciWebservice.swagger_uri
str

A webszolgáltatás swagger végpontja

Metódusok

add_properties

Adjon hozzá kulcsértékpárokat a webszolgáltatás tulajdonságszótárához.
add_tags

Adjon hozzá kulcsértékpárokat a webszolgáltatás címkeszótárához.
deploy_configuration

Hozzon létre egy konfigurációs objektumot az AciWebservice üzembe helyezéséhez.
get_token

Kérje le a webszolgáltatás hitelesítési jogkivonatát, amely az aktuális felhasználóra terjed ki.

Megjegyzés

Nincs implementálva.
remove_tags

Távolítsa el a megadott kulcsokat a webszolgáltatás címkékből álló szótárából.
run

Hívja meg ezt a webszolgáltatást a megadott bemenettel.
serialize

Konvertálja ezt a webszolgáltatást JSON szerializált szótárlá.
update

Frissítse a webszolgáltatást a megadott tulajdonságokkal.

A Nincs érték változatlan marad ebben a webszolgáltatásban.

add_properties

Adjon hozzá kulcsértékpárokat a webszolgáltatás tulajdonságszótárához.

add_properties(properties)

Paraméterek

properties
dict[str, str]
Kötelező

A hozzáadni kívánt tulajdonságok szótára.

add_tags

Adjon hozzá kulcsértékpárokat a webszolgáltatás címkeszótárához.

add_tags(tags)

Paraméterek

tags
dict[str, str]
Kötelező

A hozzáadni kívánt címkék szótára.

Kivételek

WebserviceException

deploy_configuration

Hozzon létre egy konfigurációs objektumot az AciWebservice üzembe helyezéséhez.

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)

Paraméterek

cpu_cores
float
alapértelmezett érték: None

A webszolgáltatáshoz lefoglalandó processzormagok száma. Tizedes tört is lehet. Alapértelmezett érték: 0,1

memory_gb
float
alapértelmezett érték: None

A webszolgáltatás számára lefoglalandó memória mennyisége (GB-ban). Tizedes tört is lehet. Alapértelmezett érték: 0,5

tags
dict[str, str]
alapértelmezett érték: None

A webszolgáltatáshoz tartozó kulcsértékcímkék szótára.

properties
dict[str, str]
alapértelmezett érték: None

A webszolgáltatáshoz tartozó kulcsérték-tulajdonságok szótára. Ezek a tulajdonságok az üzembe helyezés után nem módosíthatók, de új kulcsértékpárok is hozzáadhatók.

description
str
alapértelmezett érték: None

A webszolgáltatás leírásának megadása.

location
str
alapértelmezett érték: None

A webszolgáltatás üzembe helyezéséhez szükséges Azure-régió. Ha nincs megadva, a munkaterület helye lesz használva. Az elérhető régiókkal kapcsolatos további információkért lásd: Termékek régiónként.

auth_enabled
bool
alapértelmezett érték: None

Azt jelzi, hogy engedélyezi-e a hitelesítést ehhez a webszolgáltatáshoz. Alapértelmezés szerint Hamis.

ssl_enabled
bool
alapértelmezett érték: None

Azt határozza meg, hogy engedélyezi-e az SSL-t ehhez a webszolgáltatáshoz. Alapértelmezés szerint Hamis.

enable_app_insights
bool
alapértelmezett érték: None

Azt határozza meg, hogy engedélyezi-e az AppInsights szolgáltatást ehhez a webszolgáltatáshoz. Alapértelmezés szerint Hamis.

ssl_cert_pem_file
str
alapértelmezett érték: None

Az SSL engedélyezéséhez szükséges tanúsítványfájl.

ssl_key_pem_file
str
alapértelmezett érték: None

Az SSL engedélyezéséhez szükséges kulcsfájl.

ssl_cname
str
alapértelmezett érték: None

A cname értéke, ha az SSL engedélyezve van.

dns_name_label
str
alapértelmezett érték: None

A pontozási végpont DNS-névcímkéje. Ha nincs megadva egyedi DNS-névcímke a pontozási végponthoz.

primary_key
str
alapértelmezett érték: None

A webszolgáltatáshoz használandó elsődleges hitelesítési kulcs.

secondary_key
str
alapértelmezett érték: None

A webszolgáltatáshoz használandó másodlagos hitelesítési kulcs.

collect_model_data
bool
alapértelmezett érték: None

Engedélyezve van-e a modelladatok gyűjtése a webszolgáltatásban.

cmk_vault_base_url
str
alapértelmezett érték: None

ügyfél által felügyelt kulcstartó alap URL-címe

cmk_key_name
str
alapértelmezett érték: None

ügyfél által felügyelt kulcs neve.

cmk_key_version
str
alapértelmezett érték: None

ügyfél által felügyelt kulcs verziója.

vnet_name
str
alapértelmezett érték: None

virtuális hálózat neve.

subnet_name
str
alapértelmezett érték: None

alhálózat neve a virtuális hálózaton belül.

Válaszok

Egy webszolgáltatási objektum üzembe helyezésekor használandó konfigurációs objektum.

Visszatérési típus

AciServiceDeploymentConfiguration

Kivételek

WebserviceException

get_token

Kérje le a webszolgáltatás hitelesítési jogkivonatát, amely az aktuális felhasználóra terjed ki.

Megjegyzés

Nincs implementálva.

get_token()

Válaszok

A webszolgáltatás hitelesítési jogkivonata, és azt követően, hogy mikor kell frissíteni.

Visszatérési típus

str, datetime

Kivételek

azureml.exceptions.NotImplementedError

remove_tags

Távolítsa el a megadott kulcsokat a webszolgáltatás címkékből álló szótárából.

remove_tags(tags)

Paraméterek

tags
list[str]
Kötelező

Az eltávolítandó kulcsok listája.

run

Hívja meg ezt a webszolgáltatást a megadott bemenettel.

run(input_data)

Paraméterek

input_data
<xref:varies>
Kötelező

A webszolgáltatás meghívásához szükséges bemenet.

Válaszok

A webszolgáltatás meghívásának eredménye.

Visszatérési típus

dict

Kivételek

WebserviceException

serialize

Konvertálja ezt a webszolgáltatást JSON szerializált szótárlá.

serialize()

Válaszok

A webszolgáltatási objektum JSON-ábrázolása.

Visszatérési típus

dict

update

Frissítse a webszolgáltatást a megadott tulajdonságokkal.

A Nincs érték változatlan marad ebben a webszolgáltatásban.

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)

Paraméterek

image
Image
alapértelmezett érték: None

A webszolgáltatásban üzembe helyezendő új rendszerkép.

tags
dict[str, str]
alapértelmezett érték: None

A webszolgáltatáshoz tartozó kulcsértékcímkék szótára. Lecseréli a meglévő címkéket.

properties
dict[str, str]
alapértelmezett érték: None

A meglévő tulajdonságok szótárához hozzáadandó kulcsérték-tulajdonságok szótára.

description
str
alapértelmezett érték: None

A webszolgáltatás leírásának megadása.

auth_enabled
bool
alapértelmezett érték: None

Engedélyezze vagy tiltsa le a hitelesítést ehhez a webszolgáltatáshoz.

ssl_enabled
bool
alapértelmezett érték: None

Azt határozza meg, hogy engedélyezi-e az SSL-t ehhez a webszolgáltatáshoz.

ssl_cert_pem_file
str
alapértelmezett érték: None

Az SSL engedélyezéséhez szükséges tanúsítványfájl.

ssl_key_pem_file
str
alapértelmezett érték: None

Az SSL engedélyezéséhez szükséges kulcsfájl.

ssl_cname
str
alapértelmezett érték: None

A cname értéke, ha az SSL engedélyezve van.

enable_app_insights
bool
alapértelmezett érték: None

Azt határozza meg, hogy engedélyezi-e az AppInsights szolgáltatást ehhez a webszolgáltatáshoz.

models
list[Model]
alapértelmezett érték: None

A frissített szolgáltatásba csomagolandó modellobjektumok listája.

inference_config
InferenceConfig
alapértelmezett érték: None

Egy InferenceConfig objektum, amely a modell szükséges üzembehelyezési tulajdonságainak megadására szolgál.

Visszatérési típus

None