通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

目标订阅的 ID。
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
流向: 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

节点 ID。
计算节点的 ID。
nodeState

nodeState

计算节点的状态。 值为空闲、正在运行、准备中、不可用、离开和抢占。
port

number (int32)

港口。
节点的 SSH 端口号。
privateIpAddress

string

专用 IP 地址。
计算节点的专用 IP 地址。
publicIpAddress

string

公共 IP 地址。
计算节点的公共 IP 地址。
runId

string

运行 ID。
节点上运行的试验的 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