Поделиться через

Compute - List Nodes

Служба:
Machine Learning
Версия API:
2025-09-01

Получите сведения (например, IP-адрес, порт и т. д.) всех вычислительных узлов в вычислительных ресурсах.

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

Параметры URI

Имя В Обязательно Тип Описание
computeName
 path True

string

Имя вычислительной среды Машинного обучения Azure.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя не зависит от регистра.
subscriptionId
 path True

string

minLength: 1

Идентификатор целевой подписки.
workspaceName
 path True

string

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

Имя рабочей области Машинное обучение Azure.
api-version
 query True

string

minLength: 1

Версия API, используемая для данной операции.

Ответы

Имя Тип Описание
200 OK

AmlComputeNodesInformation

Операция прошла успешно. Ответ содержит список IP-адресов.
Other Status Codes

ErrorResponse

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

Get compute nodes information for a compute

Образец запроса

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

Пример ответа

Код состояния:
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"
}

Определения

Имя Описание
AmlComputeNodeInformation

Сведения о вычислительном узле, связанные с AmlCompute.
AmlComputeNodesInformation

Результат работы узлов AmlCompute
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail

Сведения об ошибке.
ErrorResponse

Ответ на ошибку
nodeState

Состояние вычислительного узла. Значения простаивают, выполняются, готовятся, непригодны для использования, уходят и вытесняются.

AmlComputeNodeInformation

Object

Сведения о вычислительном узле, связанные с AmlCompute.

Имя Тип Описание
nodeId

string

Идентификатор узла.
Идентификатор вычислительного узла.
nodeState

nodeState

Состояние вычислительного узла. Значения простаивают, выполняются, готовятся, непригодны для использования, уходят и вытесняются.
port

number (int32)

Порт.
Номер SSH-порта узла.
privateIpAddress

string

Частный IP-адрес.
Частный IP-адрес вычислительного узла.
publicIpAddress

string

Публичный IP-адрес.
Общедоступный IP-адрес вычислительного узла.
runId

string

Run ID.
Идентификатор эксперимента, запущенного на узле, если еще null.

AmlComputeNodesInformation

Object

Результат работы узлов AmlCompute

Имя Тип Описание
nextLink

string

Маркер продолжения.
nodes

AmlComputeNodeInformation[]

Коллекция возвращенных сведений об узлах AmlCompute.

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.
type

string

Дополнительный тип сведений.

ErrorDetail

Object

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.
code

string

Код ошибки.
details

ErrorDetail[]

Сведения об ошибке.
message

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

ErrorResponse

Object

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

nodeState

Перечисление

Состояние вычислительного узла. Значения простаивают, выполняются, готовятся, непригодны для использования, уходят и вытесняются.

Значение Описание
idle
running
preparing
unusable
leaving
preempted