Virtual Machines - List Hosts

Service:

HDInsight

API Version:

2021-06-01

Mencantumkan host kluster HDInsight

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

Parameter URI

Name	In	Required	Type	Description
clusterName	path	True	string	Nama kluster.
resourceGroupName	path	True	string	Nama grup sumber daya.
subscriptionId	path	True	string	Info masuk langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.
api-version	query	True	string	Versi API klien HDInsight.

Respons

Name	Type	Description
200 OK	HostInfo[]	Definisi respons OK.
Other Status Codes	ErrorResponse	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name	Description
user_impersonation	meniru akun pengguna Anda

Contoh

Get All hosts in the cluster

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for VirtualMachines ListHosts. */
public final class Main {
    /*
     * x-ms-original-file: specification/hdinsight/resource-manager/Microsoft.HDInsight/stable/2021-06-01/examples/GetClusterVirtualMachines.json
     */
    /**
     * Sample code: Get All hosts in the cluster.
     *
     * @param manager Entry point to HDInsightManager.
     */
    public static void getAllHostsInTheCluster(com.azure.resourcemanager.hdinsight.HDInsightManager manager) {
        manager.virtualMachines().listHostsWithResponse("rg1", "cluster1", Context.NONE);
    }
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Go

package armhdinsight_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/hdinsight/armhdinsight"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/hdinsight/resource-manager/Microsoft.HDInsight/stable/2021-06-01/examples/GetClusterVirtualMachines.json
func ExampleVirtualMachinesClient_ListHosts() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armhdinsight.NewVirtualMachinesClient("subid", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := client.ListHosts(ctx,
		"rg1",
		"cluster1",
		nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// TODO: use response item
	_ = res
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:

200

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

Definisi

ErrorResponse	Menjelaskan format respons Kesalahan.
HostInfo	Informasi host kluster.

ErrorResponse

Menjelaskan format respons Kesalahan.

Name	Type	Description
code	string	Kode kesalahan
message	string	Pesan kesalahan yang menunjukkan mengapa operasi gagal.

HostInfo

Informasi host kluster.

Name	Type	Description
effectiveDiskEncryptionKeyUrl	string	URL kunci enkripsi disk efektif yang digunakan oleh host
fqdn	string	Nama Domain host yang Sepenuhnya Memenuhi Syarat
name	string	Nama host