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

Virtual Machines - List Hosts

Lists HDInsight 群集主机

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusters/{clusterName}/listHosts?api-version=2021-06-01

URI 参数

名称 必需 类型 说明
clusterName
path True

string

群集的名称。

resourceGroupName
path True

string

资源组的名称。

subscriptionId
path True

string

唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。

api-version
query True

string

HDInsight 客户端 API 版本。

响应

名称 类型 说明
200 OK

HostInfo[]

正常响应定义。

Other Status Codes

ErrorResponse

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称 说明
user_impersonation 模拟用户帐户

示例

Get All hosts in the cluster

Sample Request

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.HDInsight/clusters/cluster1/listHosts?api-version=2021-06-01

Sample Response

[
  {
    "name": "gateway1"
  },
  {
    "name": "gateway3"
  },
  {
    "name": "headnode0"
  },
  {
    "name": "headnode3"
  },
  {
    "name": "workernode0"
  },
  {
    "name": "workernode1"
  },
  {
    "name": "zookeepernode0"
  },
  {
    "name": "zookeepernode2"
  },
  {
    "name": "zookeepernode3"
  }
]

定义

名称 说明
ErrorResponse

描述错误响应的格式。

HostInfo

群集主机信息。

ErrorResponse

描述错误响应的格式。

名称 类型 说明
code

string

错误代码

message

string

指示操作失败原因的错误消息。

HostInfo

群集主机信息。

名称 类型 说明
effectiveDiskEncryptionKeyUrl

string

主机使用的有效磁盘加密密钥 URL

fqdn

string

主机的完全限定域名

name

string

主机名