Freigeben über

Compute - List Nodes

Dienst:
Machine Learning
API-Version:
2025-09-01

Rufen Sie die Details (z. B. IP-Adresse, Port usw.) aller Computeknoten in der Berechnung ab.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/computes/{computeName}/listNodes?api-version=2025-09-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
computeName
 path True

string

Name des Azure Machine Learning-Computes.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId
 path True

string

minLength: 1

Hierbei handelt es sich um die ID des Zielabonnements.
workspaceName
 path True

string

pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$

Name des Azure Machine Learning-Arbeitsbereichs.
api-version
 query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name Typ Beschreibung
200 OK

AmlComputeNodesInformation

Der Vorgang war erfolgreich. Die Antwort enthält die Liste der IP-Adressen.
Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Get compute nodes information for a compute

Beispielanforderung

POST https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123/listNodes?api-version=2025-09-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "nodes": [
    {
      "nodeId": "tvm-3601533753_1-20170719t162906z",
      "privateIpAddress": "13.84.190.124",
      "publicIpAddress": "13.84.190.134",
      "port": 50000,
      "nodeState": "running",
      "runId": "2f378a44-38f2-443a-9f0d-9909d0b47890"
    },
    {
      "nodeId": "tvm-3601533753_2-20170719t162906z",
      "privateIpAddress": "13.84.190.124",
      "publicIpAddress": "13.84.190.134",
      "port": 50001,
      "nodeState": "idle"
    }
  ],
  "nextLink": "nextLink"
}

Definitionen

Name Beschreibung
AmlComputeNodeInformation

Informationen zu Computeknoten im Zusammenhang mit einem AmlCompute.
AmlComputeNodesInformation

Ergebnis von AmlCompute-Knoten
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail

Das Fehlerdetails.
ErrorResponse

Fehlerantwort
nodeState

Status des Compute-Knotens. Die Werte sind Leerlauf, Wird ausgeführt, Vorbereiten, Unbrauchbar, Wird verlassen und Vorzeitig entfernt.

AmlComputeNodeInformation

Objekt

Informationen zu Computeknoten im Zusammenhang mit einem AmlCompute.

Name Typ Beschreibung
nodeId

string

Knoten-ID.
ID des Computeknotens.
nodeState

nodeState

Status des Compute-Knotens. Die Werte sind Leerlauf, Wird ausgeführt, Vorbereiten, Unbrauchbar, Wird verlassen und Vorzeitig entfernt.
port

number (int32)

Hafen.
SSH-Portnummer des Knotens.
privateIpAddress

string

Private IP-Adresse.
Private IP-Adresse des Computeknotens.
publicIpAddress

string

Öffentliche IP-Adresse.
Öffentliche IP-Adresse des Computeknotens.
runId

string

Führen Sie die ID aus.
ID des Experiments, das auf dem Knoten ausgeführt wird, falls vorhanden NULL.

AmlComputeNodesInformation

Objekt

Ergebnis von AmlCompute-Knoten

Name Typ Beschreibung
nextLink

string

Das Fortsetzungstoken.
nodes

AmlComputeNodeInformation[]

Die Auflistung der zurückgegebenen AmlCompute-Knotendetails.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.
type

string

Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.
code

string

Der Fehlercode.
details

ErrorDetail[]

Die Fehlerdetails.
message

string

Die Fehlermeldung.
target

string

Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

nodeState

Enumeration

Status des Compute-Knotens. Die Werte sind Leerlauf, Wird ausgeführt, Vorbereiten, Unbrauchbar, Wird verlassen und Vorzeitig entfernt.

Wert Beschreibung
idle
running
preparing
unusable
leaving
preempted