Compute - List Nodes

Servizio:

Machine Learning

Versione API:

2025-09-01

Ottenere i dettagli ,ad esempio indirizzo IP, porta e così via, di tutti i nodi di calcolo nel calcolo.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
computeName	path	True	string	Nome dell'ambiente di calcolo di Azure Machine Learning.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Nome dell'area di lavoro di Azure Machine Learning.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	AmlComputeNodesInformation	Operazione riuscita. La risposta contiene l'elenco degli indirizzi IP.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get compute nodes information for a compute

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

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"
}

Definizioni

Nome	Descrizione
AmlComputeNodeInformation	Informazioni sul nodo di calcolo correlate a un AmlCompute.
AmlComputeNodesInformation	Risultato dei nodi AmlCompute
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
nodeState	Stato del nodo di calcolo. I valori sono inattivo, in esecuzione, in preparazione, inutilizzabile, in uscita e anticipato.

AmlComputeNodeInformation

Object

Informazioni sul nodo di calcolo correlate a un AmlCompute.

Nome	Tipo	Descrizione
nodeId	string	ID nodo. ID del nodo di calcolo.
nodeState	nodeState	Stato del nodo di calcolo. I valori sono inattivo, in esecuzione, in preparazione, inutilizzabile, in uscita e anticipato.
port	number (int32)	Porto. Numero di porta SSH del nodo.
privateIpAddress	string	Indirizzo IP privato. Indirizzo IP privato del nodo di calcolo.
publicIpAddress	string	Indirizzo IP pubblico. Indirizzo IP pubblico del nodo di calcolo.
runId	string	ID di esecuzione. ID dell'esperimento in esecuzione sul nodo, se null.

AmlComputeNodesInformation

Object

Risultato dei nodi AmlCompute

Nome	Tipo	Descrizione
nextLink	string	Token di continuazione.
nodes	AmlComputeNodeInformation[]	La raccolta dei dettagli dei nodi AmlCompute restituiti.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

nodeState

Enumerazione

Stato del nodo di calcolo. I valori sono inattivo, in esecuzione, in preparazione, inutilizzabile, in uscita e anticipato.

Valore	Descrizione
idle
running
preparing
unusable
leaving
preempted