Freigeben über


Virtual Machines - List Hosts

Listen hdInsight-Clusterhosts

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
clusterName
path True

string

Der Name des Clusters.

resourceGroupName
path True

string

Der Name der Ressourcengruppe.

subscriptionId
path True

string

Die Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Die HDInsight-Client-API-Version.

Antworten

Name Typ Beschreibung
200 OK

HostInfo[]

OK-Antwortdefinition.

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Get All hosts in the cluster

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
ErrorResponse

Beschreibt das Format der Fehlerantwort.

HostInfo

Die Clusterhostinformationen.

ErrorResponse

Beschreibt das Format der Fehlerantwort.

Name Typ Beschreibung
code

string

Fehlercode

message

string

Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

HostInfo

Die Clusterhostinformationen.

Name Typ Beschreibung
effectiveDiskEncryptionKeyUrl

string

Die vom Host verwendete URL des effektiven Datenträgerverschlüsselungsschlüssels

fqdn

string

Der vollqualifizierte Domänenname des Hosts

name

string

Hostname