ComputeInstance Klas
Hiermee beheert u een cloudgebaseerde, geoptimaliseerde ML-ontwikkelomgeving in Azure Machine Learning.
Een Azure Machine Learning-rekenproces is een volledig geconfigureerde en beheerde ontwikkelomgeving in de cloud die is geoptimaliseerd voor machine learning-ontwikkelwerkstromen. ComputeInstance wordt doorgaans gebruikt om een ontwikkelomgeving te maken of als rekendoel voor training en deductie voor ontwikkeling en testen. Met een ComputeInstance kunt u modellen ontwerpen, trainen en implementeren in een volledig geïntegreerde notebookervaring in uw werkruimte. Zie Wat is een Azure Machine Learning-rekenproces? voor meer informatie.
Klasse ComputeTarget-constructor.
Haal een cloudweergave op van een Compute-object dat is gekoppeld aan de opgegeven werkruimte. Retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde compute-object.
Constructor
ComputeInstance(workspace, name)
Parameters
| Name | Description |
|---|---|
|
workspace
Vereist
|
Het werkruimteobject met het rekenobject dat moet worden opgehaald. |
|
name
Vereist
|
De naam van het rekenobject dat moet worden opgehaald. |
Methoden
| delete |
Verwijder het ComputeInstance-object uit de bijbehorende werkruimte. |
| deserialize |
Converteer een JSON-object naar een ComputeInstance-object. Dit mislukt als de opgegeven werkruimte niet de werkruimte is waarmee de ComputeInstance is gekoppeld. |
| detach |
Loskoppelen wordt niet ondersteund voor het ComputeInstance-object. Gebruik in plaats daarvan delete. |
| get |
ComputeInstance-object retourneren. |
| get_active_runs |
Retourneert een generator van de uitvoeringen voor deze berekening. |
| get_docs_url |
Url naar de documentatie voor deze klasse. |
| get_status |
Haal de huidige gedetailleerde status voor de ComputeInstance op. |
| provisioning_configuration |
Maak een configuratieobject voor het inrichten van een ComputeInstance-doel. |
| refresh_state |
Voer een in-place update uit van de eigenschappen van het object. Met deze methode worden de eigenschappen bijgewerkt op basis van de huidige status van het bijbehorende cloudobject. Dit is voornamelijk handig voor handmatige polling van de rekenstatus. |
| restart |
Start de ComputeInstance opnieuw. |
| serialize |
Converteer dit ComputeInstance-object naar een geserialiseerde JSON-woordenlijst. |
| start |
Start de ComputeInstance. |
| stop |
Stop de ComputeInstance. |
| supported_vmsizes |
Geef de ondersteunde VM-grootten in een regio weer. |
| update_sso_settings |
Werk de instellingen voor eenmalige aanmelding van het rekenproces bij. |
| wait_for_completion |
Wacht totdat de inrichting van ComputeInstance is voltooid. |
delete
Verwijder het ComputeInstance-object uit de bijbehorende werkruimte.
delete(wait_for_completion=False, show_output=False)
Parameters
| Name | Description |
|---|---|
|
wait_for_completion
|
Default value: False
|
|
show_output
|
Default value: False
|
Uitzonderingen
| Type | Description |
|---|---|
Opmerkingen
Als dit object is gemaakt via Azure ML, worden de bijbehorende cloudobjecten ook verwijderd. Als dit object extern is gemaakt en alleen is gekoppeld aan de werkruimte, wordt er een uitzondering gegenereerd en wordt er niets gewijzigd.
deserialize
Converteer een JSON-object naar een ComputeInstance-object.
Dit mislukt als de opgegeven werkruimte niet de werkruimte is waarmee de ComputeInstance is gekoppeld.
static deserialize(workspace, object_dict)
Parameters
| Name | Description |
|---|---|
|
workspace
Vereist
|
Het werkruimteobject waarmee het ComputeInstance-object is gekoppeld. |
|
object_dict
Vereist
|
Een JSON-object dat moet worden geconverteerd naar een ComputeInstance-object. |
Retouren
| Type | Description |
|---|---|
|
De ComputeInstance-weergave van het opgegeven JSON-object. |
Uitzonderingen
| Type | Description |
|---|---|
detach
Loskoppelen wordt niet ondersteund voor het ComputeInstance-object. Gebruik in plaats daarvan delete.
detach()
Uitzonderingen
| Type | Description |
|---|---|
|
De bewerking wordt niet ondersteund. |
get
ComputeInstance-object retourneren.
get()
Retouren
| Type | Description |
|---|---|
|
De ComputeInstance-weergave van het opgegeven JSON-object. |
Uitzonderingen
| Type | Description |
|---|---|
get_active_runs
Retourneert een generator van de uitvoeringen voor deze berekening.
get_active_runs(type=None, tags=None, properties=None, status=None)
Parameters
| Name | Description |
|---|---|
|
type
|
Filter de geretourneerde generator van uitvoeringen op het opgegeven type. Zie add_type_provider voor het maken van uitvoeringstypen. Default value: None
|
|
tags
|
Filter wordt uitgevoerd op tag of {"tag": "value"} Default value: None
|
|
properties
|
Filter wordt uitgevoerd op 'property' of {'property': 'value'} Default value: None
|
|
status
|
De uitvoeringsstatus kan 'Actief' of 'In wachtrij' zijn. Default value: None
|
Retouren
| Type | Description |
|---|---|
|
<xref:builtin.generator>
|
Een generator van azureml._restclient.models.RunDto |
get_docs_url
get_status
Haal de huidige gedetailleerde status voor de ComputeInstance op.
get_status()
Retouren
| Type | Description |
|---|---|
|
Een gedetailleerd statusobject voor de berekening |
provisioning_configuration
Maak een configuratieobject voor het inrichten van een ComputeInstance-doel.
static provisioning_configuration(vm_size='', ssh_public_access=False, admin_user_ssh_public_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, assigned_user_object_id=None, assigned_user_tenant_id=None)
Parameters
| Name | Description |
|---|---|
|
vm_size
Vereist
|
De grootte van agent-VM's. Meer informatie vindt u hier: https://aka.ms/azureml-vm-details. Houd er rekening mee dat niet alle grootten beschikbaar zijn in alle regio's, zoals beschreven in de vorige koppeling. De standaardinstelling is Standard_NC6. |
|
ssh_public_access
|
Geeft de status van de openbare SSH-poort aan. Mogelijke waarden zijn:
Default value: False
|
|
admin_user_ssh_public_key
|
De openbare SSH-sleutel van het gebruikersaccount van de beheerder. Default value: None
|
|
vnet_resourcegroup_name
|
De naam van de resourcegroep waar het virtuele netwerk zich bevindt. Default value: None
|
|
vnet_name
|
De naam van het virtuele netwerk. Default value: None
|
|
subnet_name
|
De naam van het subnet in het vnet. Default value: None
|
|
tags
|
Een optionele woordenlijst met sleutelwaardetags die u aan het rekenobject wilt koppelen. Default value: None
|
|
description
|
Een optionele beschrijving voor het rekenobject. Default value: None
|
|
assigned_user_object_id
|
De AAD-object-id van de toegewezen gebruiker (preview). Default value: None
|
|
assigned_user_tenant_id
|
De AAD-tenant-id van de toegewezen gebruiker (preview). Default value: None
|
Retouren
| Type | Description |
|---|---|
|
Een configuratieobject dat moet worden gebruikt bij het maken van een rekenobject. |
Uitzonderingen
| Type | Description |
|---|---|
refresh_state
Voer een in-place update uit van de eigenschappen van het object.
Met deze methode worden de eigenschappen bijgewerkt op basis van de huidige status van het bijbehorende cloudobject. Dit is voornamelijk handig voor handmatige polling van de rekenstatus.
refresh_state()
restart
Start de ComputeInstance opnieuw.
restart(wait_for_completion=False, show_output=False)
Parameters
| Name | Description |
|---|---|
|
wait_for_completion
|
Booleaanse waarde die moet wachten op de statusupdate. De standaardwaarde is False. Default value: False
|
|
show_output
|
Booleaanse waarde voor uitgebreidere uitvoer. De standaardwaarde is False. Default value: False
|
Retouren
| Type | Description |
|---|---|
|
Geen |
Uitzonderingen
| Type | Description |
|---|---|
|
azureml.exceptions.ComputeTargetException:
|
serialize
Converteer dit ComputeInstance-object naar een geserialiseerde JSON-woordenlijst.
serialize()
Retouren
| Type | Description |
|---|---|
|
De JSON-weergave van dit ComputeInstance-object. |
start
Start de ComputeInstance.
start(wait_for_completion=False, show_output=False)
Parameters
| Name | Description |
|---|---|
|
wait_for_completion
|
Of moet worden gewacht op de statusupdate. De standaardwaarde is False. Default value: False
|
|
show_output
|
Of u uitgebreidere uitvoer wilt leveren. De standaardwaarde is False. Default value: False
|
Retouren
| Type | Description |
|---|---|
|
Geen |
Uitzonderingen
| Type | Description |
|---|---|
stop
Stop de ComputeInstance.
stop(wait_for_completion=False, show_output=False)
Parameters
| Name | Description |
|---|---|
|
wait_for_completion
|
Of moet worden gewacht op de statusupdate. De standaardwaarde is False. Default value: False
|
|
show_output
|
Of u uitgebreidere uitvoer wilt leveren. De standaardwaarde is False. Default value: False
|
Retouren
| Type | Description |
|---|---|
|
Geen |
Uitzonderingen
| Type | Description |
|---|---|
supported_vmsizes
Geef de ondersteunde VM-grootten in een regio weer.
static supported_vmsizes(workspace, location=None)
Parameters
| Name | Description |
|---|---|
|
workspace
Vereist
|
De werkruimte. |
|
location
|
De locatie van het exemplaar. Als dit niet is opgegeven, is de standaardlocatie van de werkruimte. Default value: None
|
Retouren
| Type | Description |
|---|---|
|
Een lijst met ondersteunde VM-grootten in een regio met de naam van de VM, VCPU's en RAM. |
update_sso_settings
wait_for_completion
Wacht totdat de inrichting van ComputeInstance is voltooid.
wait_for_completion(show_output=False, is_delete_operation=False)
Parameters
| Name | Description |
|---|---|
|
show_output
|
Of u uitgebreidere uitvoer wilt leveren. De standaardwaarde is False. Default value: False
|
|
is_delete_operation
|
Hiermee wordt aangegeven of de bewerking is bedoeld voor het verwijderen. Default value: False
|
Uitzonderingen
| Type | Description |
|---|---|