Share via

REST API kluster di Azure HDInsight

  • Artikel

Buat

Membuat kluster dalam langganan yang ditentukan.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode Meminta URI
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Contoh berikut menunjukkan isi permintaan untuk membuat kluster hadoop berbasis Linux. Untuk contoh pembuatan kluster dengan cara lain, lihat bagian Contoh di bawah ini.

{  
    "id":"/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",  
  "name":"mycluster",   
  "type":"Microsoft.HDInsight/clusters",  
  
    "location": "location-name",  
    "tags": { "tag1": "value1", "tag2": "value2" },  
    "properties": {  
        "clusterVersion": "3.2",  
        "osType": "Linux",  
        "clusterDefinition": {  
            "kind": "hadoop",  
  
            "configurations": {  
                "gateway": {  
                    "restAuthCredential.isEnabled": true,  
                    "restAuthCredential.username": "http-user",  
                    "restAuthCredential.password": "password"  
                },  
  
                "core-site": {  
                    "fs.defaultFS": "wasb://container@storageaccount.blob.core.windows.net",  
                    "fs.azure.account.key.storageaccount.blob.core.windows.net": storage-account-key"  
                }  
            }  
        },
  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "headnode",  
  
                    "targetInstanceCount": 2,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    },  
  
                    "osProfile": {  
                        "linuxOperatingSystemProfile": {  
                            "username": "username",  
                            "sshProfile": {  
                                "publicKeys": [   
                                    { "certificateData": "ssh-rsa key" }  
                                ]  
                            }  
                        }  
                    }  
                },  
                {  
                    "name": "workernode",  
  
                    "targetInstanceCount": 1,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    },  
  
                    "osProfile": {  
                        "linuxOperatingSystemProfile": {  
                            "username": "username",  
                            "sshProfile": {  
                                "publicKeys": [  
                                    { "certificateData": " ssh-rsa key" }  
                                ]  
                            }  
                        }  
                    }  
                },  
                {  
                    "name": "zookeepernode",  
  
                    "targetInstanceCount": 3,  
  
                    "hardwareProfile": {  
                        "vmSize": "Small"  
                    },  
  
                    "osProfile": {  
                        "linuxOperatingSystemProfile": {  
                            "username": "username",  
                            "sshProfile": {  
                                "publicKeys": [   
                                    { "certificateData": "ssh-rsa key" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}
Nama elemen Diperlukan Jenis Deskripsi
id Ya String Menentukan pengidentifikasi sumber daya kluster.
nama Ya String Menentukan nama kluster.
jenis Ya String Menentukan jenis kluster.
lokasi Ya String Menentukan lokasi Azure yang didukung tempat kluster harus dibuat. Untuk informasi selengkapnya, lihat Mencantumkan semua lokasi geografis yang tersedia.
tag Tidak String Menentukan tag yang akan ditetapkan ke kluster. Untuk informasi selengkapnya tentang menggunakan tag, lihat Menggunakan tag untuk menata sumber daya Azure Anda.
Properti Ya Jenis Kompleks Menentukan properti kluster.

Properti

Nama elemen Diperlukan Jenis Deskripsi
clusterVersion Ya String Menentukan versi kluster
osType Ya String Menentukan Sistem operasi untuk kluster.

Nilai yang valid adalah Linux dan Windows
clusterDefinition Ya Jenis Kompleks Menentukan informasi tentang jenis dan konfigurasi kluster
computeProfile Ya Jenis Kompleks Menentukan informasi tentang topologi kluster dan properti peran terkait

clusterDefinition

Nama elemen Diperlukan Jenis Deskripsi
jenis Ya String Menentukan jenis kluster.

Nilai yang valid adalah hadoop, hbase, storm & spark
configurations Ya Kamus Elemen ini adalah kamus jenis konfigurasi dan kamus nilai terkait.

Jenis konfigurasi gateway digunakan untuk mengonfigurasi pengguna http yang digunakan untuk menyambungkan ke API web dan portal Ambari

jenis konfigurasi situs inti digunakan untuk mengonfigurasi akun penyimpanan default untuk kluster

computeProfile

Nama elemen Diperlukan Jenis Deskripsi
clusterVersion Ya String Menentukan versi kluster
role Ya Array Tipe Kompleks (peran) Menentukan informasi tentang peran dalam kluster

peran

Nama elemen Diperlukan Jenis Deskripsi
nama Ya String Menentukan nama peran
targetInstanceCount Ya Bilangan bulat Menentukan jumlah instans target untuk peran tersebut
hardwareProfile Ya Jenis Kompleks Menentukan informasi tentang profil perangkat keras untuk peran tersebut
osProfile Ya Jenis Kompleks Menentukan informasi tentang profil os untuk peran tersebut

hardwareProfile

Nama elemen Diperlukan Jenis Deskripsi
vmSize Ya String Menentukan ukuran VM. Lihat opsi konfigurasi HDInsight (sekali pada tautan ini, gulir ke bawah ke tingkat harga Node) untuk ukuran yang valid

osProfile

Nama elemen Diperlukan Jenis Deskripsi
linuxOperatingSystemProfile Tidak Jenis Kompleks Menentukan pengaturan terkait OS linux
windowsOperatingSystemProfile Tidak Jenis Kompleks Menentukan pengaturan terkait OS windows
virtualNetworkProfile Tidak Jenis Kompleks Menentukan pengaturan terkait jaringan virtual jika kluster sedang disebarkan di jaringan virtual dalam langganan pengguna
scriptActions Tidak Array Tipe Kompleks Daftar tindakan skrip yang akan dijalankan pada kluster

linuxOperatingSystemProfile

Nama elemen Diperlukan Jenis Deskripsi
Nama pengguna Ya String Nama pengguna SSH
sshProfile Tidak Jenis Kompleks Menentukan kunci SSH.

Salah satu sshProfile atau Kata Sandi diperlukan.
Kata sandi Tidak String Menentukan kata sandi SSH

Salah satu sshProfile atau Kata Sandi diperlukan.

sshProfile

Nama elemen Diperlukan Jenis Deskripsi
publicKeys Ya Array Berisi daftar objek certificateData. Nilainya adalah kunci umum ssh-rsa

windowsOperatingSystemProfile

Nama elemen Diperlukan Jenis Deskripsi
rdpSettings Tidak Jenis Kompleks Menentukan pengaturan RDP untuk kluster windows

rdpSettings

Nama elemen Diperlukan Jenis Deskripsi
nama pengguna Ya String Menentukan nama pengguna RDP
kata sandi Ya String Menentukan kata sandi untuk pengguna RDP
expiryDate Ya Tanggal Tanggal kedaluwarsa untuk kredensial RDP

virtualNetworkProfile

Nama elemen Diperlukan Jenis Deskripsi
id Ya String Id Sumber Daya Virtual Network
subnet Ya String Menentukan nama subnet

scriptActions

Nama elemen Diperlukan Jenis Deskripsi
nama Ya String Nama yang mudah diingat untuk tindakan skrip
uri Ya String URL ke file tindakan skrip
parameter Tidak String Argumen yang akan diteruskan saat menjalankan file tindakan skrip

Respons

Jika validasi selesai dan permintaan diterima, operasi akan mengembalikan 200 (OK).

Kode status: 200 OK

Isi respons untuk kluster linux dibuat menggunakan kunci ssh:

{  
    "id":"/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",  
  "name":"mycluster",   
  "type":"Microsoft.HDInsight/clusters",  
  
    "location": "location-name",  
    "tags": { "tag1": "value1", "tag2": "value2" },  
    "properties": {  
        "clusterVersion": "3.2",  
        "osType": "Linux",  
		"provisioningState": "InProgress",  
		"clusterState": "Accepted",  
		"createdDate": "2015-09-23",  
		"quotaInfo": {  
			"coresUsed": 20  
}  
        "clusterDefinition": {  
            "kind": "hadoop"  
        },  
  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "headnode",  
  
                    "targetInstanceCount": 2,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
  
                },  
                {  
                    "name": "workernode",  
  
                    "targetInstanceCount": 1,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
                },  
                {  
                    "name": "zookeepernode",  
  
                    "targetInstanceCount": 3,  
  
                    "hardwareProfile": {  
                        "vmSize": "Small"  
                    }  
                }  
            ]  
        }  
    }  
}
Nama elemen Jenis Deskripsi
provisioningState String Menunjukkan status penyediaan saat ini.
clusterState String Menunjukkan status kluster HDInsight yang lebih rinci saat provisi sedang berlangsung.
createdDate Tanggal Tanggalwaktu saat permintaan pembuatan kluster diterima
quotaInfo Jenis Kompleks Menentukan core yang Digunakan oleh kluster
errors Array pesan kesalahan Berisi pesan kesalahan jika provisioningState = 'failed"
connectivityEndpoints Jenis Kompleks Menentukan titik akhir publik untuk kluster

connectivityEndpoints

Nama elemen Jenis Deskripsi
nama String Nama yang mudah diingat untuk titik akhir konektivitas
protocol String Menentukan Protokol yang akan digunakan (misalnya: HTTPS, SSH)
lokasi String Menentukan URL yang akan disambungkan
port int Menentukan port yang akan disambungkan

Membuat kluster HDInsight premium yang bergabung dengan domain (hanya Linux, pratinjau)

Buat kluster premium yang bergabung dengan domain dengan Apache Ranger. Pengguna perlu menyediakan SecurityProfile di isi permintaan untuk membuat kluster yang aman.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode Meminta URI
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Contoh berikut menunjukkan isi permintaan untuk membuat kluster Hadoop berbasis Linux, premium, dan bergabung dengan domain.

{
	"id": "/subscriptions/{ subscription-id }/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/ clusters/mycluster ", "
	name "
	: "mycluster",
	"type": "Microsoft.HDInsight/clusters",
	"location": "location-name",
	"tags": {
		"tag1": "value1",
		"tag2": "value2"
	},
	"properties": {
		"clusterVersion": "3.5",
		"osType": "Linux",
		"tier": "premium",
		"clusterDefinition": {
			"kind": "hadoop",
			"configurations": {
				"gateway": {
					"restAuthCredential.isEnabled": true,
					"restAuthCredential.username": "http-user",
					"restAuthCredential.password": "password"
				},
				"core-site": {
					"fs.defaultFS": "wasb://container@storageaccount.blob.core.windows.net",
					"fs.azure.account.key.storageaccount.blob.core.windows.net": "storage-account-key"
				}
			}
		},
		"securityProfile": {
			"directoryType": "ActiveDirectory",
			"domain": "mydomain.com",
			"organizationalUnitDN": "OU=Hadoop,DC=mydomain,DC=COM",
			"ldapsUrls": ["ldaps://mydomain.com:636"],
			"domainUsername": "clusteradmin@mydomain.com",
			"domainUserPassword": "password",
			"clusterUsersGroupDNs": ["ADGroup1", "ADGroup2"]
		},
		"computeProfile": {
			"roles": [
				{
					"name": "headnode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						}
					},
					"virtualNetworkProfile": {
						"id": "/subscriptions/mysubscriptionid/resourceGroups/myrresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork",
						"subnet": "/subscriptions/mysubscriptionid /resourceGroups/myresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork/subnets/mysubnet"
					}
				},
				{
					"name": "workernode",
					"targetInstanceCount": 1,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": " ssh-rsa key"
									}
								]
							}
						}
					},
					"virtualNetworkProfile": {
						"id": "/subscriptions/mysubscriptionid/resourceGroups/myrresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork",
						"subnet": "/subscriptions/mysubscriptionid /resourceGroups/myresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork/subnets/mysubnet"
					}
				},
				{
					"name": "zookeepernode",
					"targetInstanceCount": 3,
					"hardwareProfile": {
						"vmSize": "Small"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						},
						"virtualNetworkProfile": {
							"id": "/subscriptions/mysubscriptionid/resourceGroups/myrresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork",
							"subnet": "/subscriptions/mysubscriptionid /resourceGroups/myresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork/subnets/mysubnet"
						}
					}
				}
			]
		}
	}
}
Nama elemen Diperlukan Jenis Deskripsi
id Ya String Menentukan pengidentifikasi sumber daya kluster.
nama Ya String Menentukan nama kluster.
jenis Ya String Menentukan jenis kluster.
lokasi Ya String Menentukan lokasi Azure yang didukung tempat kluster harus dibuat. Untuk informasi selengkapnya, lihat Mencantumkan semua lokasi geografis yang tersedia.
tag Tidak String Menentukan tag yang akan ditetapkan ke kluster. Untuk informasi selengkapnya tentang menggunakan tag, lihat Menggunakan tag untuk menata sumber daya Azure Anda.
Properti Ya Jenis Kompleks Menentukan properti kluster.

Properti

Nama elemen Diperlukan Jenis Deskripsi
clusterVersion Ya String Menentukan versi kluster
osType Ya String Menentukan Sistem operasi untuk kluster.

Nilai yang valid adalah Linux karena hanya jenis kluster Linux yang dapat bergabung dengan domain Azure AD.
Tier Tidak String Nilai default adalah standar. Nilai yang valid adalah standar dan premium. Jika tidak ada nilai yang ditentukan, nilai diasumsikan sebagai standar. Menentukan Tingkat untuk kluster. Kluster yang bergabung dengan domain hanya didukung di tingkat premium
clusterDefinition Ya Jenis Kompleks Menentukan informasi tentang jenis dan konfigurasi kluster
computeProfile Ya Jenis Kompleks Menentukan informasi tentang topologi kluster dan properti peran terkait
securityProfile Tidak Jenis Kompleks Jika kluster yang aman dan bergabung dengan domain sedang dibuat, elemen ini menentukan pengaturan terkait Direktori Aktif

clusterDefinition

Nama elemen Diperlukan Jenis Deskripsi
jenis Ya String Menentukan jenis kluster.

Nilai yang valid adalah hadoop, hbase, storm & spark
configurations Ya Kamus Elemen ini adalah kamus jenis konfigurasi dan kamus nilai terkait.

Jenis konfigurasi gateway digunakan untuk mengonfigurasi pengguna http yang digunakan untuk menyambungkan ke API web dan portal Ambari

jenis konfigurasi situs inti digunakan untuk mengonfigurasi akun penyimpanan default untuk kluster

computeProfile

Nama elemen Diperlukan Jenis Deskripsi
clusterVersion Ya String Menentukan versi kluster
role Ya Array Jenis Kompleks (peran) Menentukan informasi tentang peran dalam kluster

securityProfile

Nama elemen Diperlukan Jenis Deskripsi
directoryType Ya String Jenis direktori LDAP yang digunakan. Saat ini "ActiveDirectory" adalah satu-satunya nilai yang didukung.
domain Ya String Domain Direktori Aktif untuk kluster
organizationalUnitDN Ya String Nama khusus unit organisasi di direktori Aktif tempat akun pengguna dan komputer akan dibuat
ldapsUrls Ya Array String URL dari satu atau beberapa server LDAPS untuk Direktori Aktif
domainUserName Ya String Akun pengguna domain dengan izin yang memadai untuk membuat kluster. Seharusnya dalam format user@domain
domainUserPassword Ya String Kata sandi untuk akun pengguna domain
clusterUsersGroupDNS Tidak Array String Nama yang dibedakan dari grup Direktori Aktif yang akan tersedia di Ambari dan Apache Ranger

peran

Nama elemen Diperlukan Jenis Deskripsi
nama Ya String Menentukan nama peran
targetInstanceCount Ya Bilangan bulat Menentukan jumlah instans target untuk peran tersebut
hardwareProfile Ya Jenis Kompleks Menentukan informasi tentang profil perangkat keras untuk peran tersebut
osProfile Ya Jenis Kompleks Menentukan informasi tentang profil os untuk peran tersebut

hardwareProfile

Nama elemen Diperlukan Jenis Deskripsi
vmSize Ya String Menentukan ukuran VM. Lihat opsi konfigurasi HDInsight (sekali pada tautan ini, gulir ke bawah ke tingkat harga Node) untuk ukuran yang valid

osProfile

Nama elemen Diperlukan Jenis Deskripsi
linuxOperatingSystemProfile Tidak Jenis Kompleks Menentukan pengaturan terkait OS linux
virtualNetworkProfile Tidak Jenis Kompleks Menentukan pengaturan terkait jaringan virtual jika kluster sedang disebarkan di jaringan virtual dalam langganan pengguna
scriptActions Tidak Array Tipe Kompleks Daftar tindakan skrip yang akan dijalankan pada kluster

linuxOperatingSystemProfile

Nama elemen Diperlukan Jenis Deskripsi
Nama pengguna Ya String Nama pengguna SSH
sshProfile Tidak Jenis Kompleks Menentukan kunci SSH.

Salah satu sshProfile atau Kata Sandi diperlukan.
Kata sandi Tidak String Menentukan kata sandi SSH

Salah satu sshProfile atau Kata Sandi diperlukan.

sshProfile

Nama elemen Diperlukan Jenis Deskripsi
publicKeys Ya Array Berisi daftar objek certificateData. Nilainya adalah kunci umum ssh-rsa

virtualNetworkProfile

Nama elemen Diperlukan Jenis Deskripsi
id Ya String Id Sumber Daya Virtual Network
subnet Ya String Menentukan nama subnet

scriptActions

Nama elemen Diperlukan Jenis Deskripsi
nama Ya String Nama yang mudah diingat untuk tindakan skrip
uri Ya String URL ke file tindakan skrip
parameter Tidak String Argumen yang akan diteruskan saat menjalankan file tindakan skrip

Respons

Jika validasi selesai dan permintaan diterima, operasi akan mengembalikan 200 (OK).

Kode status: 200 OK

Isi respons untuk kluster linux dibuat menggunakan kunci ssh:

{  
    "id":"/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",  
  "name":"mycluster",   
  "type":"Microsoft.HDInsight/clusters",  
  
    "location": "location-name",  
    "tags": { "tag1": "value1", "tag2": "value2" },  
    "properties": {  
        "clusterVersion": "3.2",  
        "osType": "Linux",  
		"provisioningState": "InProgress",  
		"clusterState": "Accepted",  
		"createdDate": "2015-09-23",  
		"quotaInfo": {  
			"coresUsed": 20  
}  
        "clusterDefinition": {  
            "kind": "hadoop"  
        },  
  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "headnode",  
  
                    "targetInstanceCount": 2,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
  
                },  
                {  
                    "name": "workernode",  
  
                    "targetInstanceCount": 1,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
                },  
                {  
                    "name": "zookeepernode",  
  
                    "targetInstanceCount": 3,  
  
                    "hardwareProfile": {  
                        "vmSize": "Small"  
                    }  
                }  
            ]  
        }  
    }  
}
Nama elemen Jenis Deskripsi
provisioningState String Menunjukkan status penyediaan saat ini.
clusterState String Menunjukkan status kluster HDInsight yang lebih rinci saat provisi sedang berlangsung.
createdDate Tanggal Tanggalwaktu saat permintaan pembuatan kluster diterima
quotaInfo Jenis Kompleks Menentukan core yang Digunakan oleh kluster
errors Array pesan kesalahan Berisi pesan kesalahan jika provisioningState = 'failed"
connectivityEndpoints Jenis Kompleks Menentukan titik akhir publik untuk kluster

connectivityEndpoints

Nama elemen Jenis Deskripsi
nama String Nama yang mudah diingat untuk titik akhir konektivitas
protocol String Menentukan Protokol yang akan digunakan (misalnya: HTTPS, SSH)
lokasi String Menentukan URL yang akan disambungkan
port int Menentukan port yang akan disambungkan

Membuat kluster dengan Azure Data Lake Store sebagai sistem file default

Membuat kluster dalam langganan yang ditentukan dengan Azure Data Lake Store sebagai sistem file default. Berikan objek ClusterIdentity dalam isi permintaan dan konfigurasikan properti default-filesystem dengan URL Data Lake Store yang sesuai.

Azure Data Lake dapat dikonfigurasi sebagai sistem file default untuk versi kluster mulai dari 3.5 inklusif.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode Meminta URI
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}}

Contoh berikut menunjukkan isi permintaan untuk membuat kluster Hadoop berbasis Linux menggunakan Azure Data Lake Store sebagai sistem file default untuk kluster.

{
	"id": "/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",
	"name": "mycluster",
	"type": "Microsoft.HDInsight/clusters",
	"location": "location-name",
	"tags": {
		"tag1": "value1",
		"tag2": "value2"
	},
	"properties": {
		"clusterVersion": "3.5",
		"osType": "Linux",
		"tier": "Standard",
		"clusterDefinition": {
			"kind": "hadoop",
			"configurations": {
				"gateway": {
					"restAuthCredential.isEnabled": true,
					"restAuthCredential.username": "http-user",
					"restAuthCredential.password": "password"
				},
				"clusterIdentity": {
					"clusterIdentity.applicationId": "applicationId",
					"clusterIdentity.certificate": "certificate-contents-in-base64-encoding",
					"clusterIdentity.aadTenantId": "aad-tenant-id",
					"clusterIdentity.resourceUri": "https://KonaCompute.net/",
					"clusterIdentity.certificatePassword": "certificate-password"
				},
				"core-site": {
					"fs.defaultFS": "adl://home",
					"dfs.adls.home.hostname": "yourstorageaccount.azuredatalakestore.net",
					"dfs.adls.home.mountpoint": "/path/to/cluster/root"
				}
			}
		},
		"computeProfile": {
			"roles": [
				{
					"name": "headnode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						}
					}
				},
				{
					"name": "workernode",
					"targetInstanceCount": 1,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": " ssh-rsa key"
									}
								]
							}
						}
					}
				},
				{
					"name": "zookeepernode",
					"targetInstanceCount": 3,
					"hardwareProfile": {
						"vmSize": "Small"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}
Nama elemen Diperlukan Jenis Deskripsi
id Ya String Menentukan pengidentifikasi sumber daya kluster.
nama Ya String Menentukan nama kluster.
jenis Ya String Menentukan jenis kluster.
lokasi Ya String Menentukan lokasi Azure yang didukung tempat kluster harus dibuat. Untuk informasi selengkapnya, lihat Mencantumkan semua lokasi geografis yang tersedia.
tag Tidak String Menentukan tag yang akan ditetapkan ke kluster. Untuk informasi selengkapnya tentang menggunakan tag, lihat Menggunakan tag untuk menata sumber daya Azure Anda.
Properti Ya Jenis Kompleks Menentukan properti kluster.

Properti

Nama elemen Diperlukan Jenis Deskripsi
clusterVersion Ya String Menentukan versi kluster
osType Ya String Menentukan Sistem operasi untuk kluster.

Nilai yang valid adalah Linux
Tier Tidak String Menentukan tingkat untuk kluster. Nilai yang valid adalah standar dan premium. Jika tingkat tidak ditentukan, kluster akan memiliki tingkat standar.
clusterDefinition Ya Jenis Kompleks Menentukan informasi tentang jenis dan konfigurasi kluster
computeProfile Ya Jenis Kompleks Menentukan informasi tentang topologi kluster dan properti peran terkait

clusterDefinition

Nama elemen Diperlukan Jenis Deskripsi
jenis Ya String Menentukan jenis kluster.

Nilai yang valid adalah hadoop, hbase, storm & spark
configurations Ya Kamus Elemen ini adalah kamus jenis konfigurasi dan kamus nilai terkait.

Jenis konfigurasi gateway digunakan untuk mengonfigurasi pengguna http yang digunakan untuk menyambungkan ke API web dan portal Ambari

jenis konfigurasi situs inti digunakan untuk mengonfigurasi akun penyimpanan default untuk kluster

computeProfile

Nama elemen Diperlukan Jenis Deskripsi
clusterVersion Ya String Menentukan versi kluster
role Ya Array Tipe Kompleks (peran) Menentukan informasi tentang peran dalam kluster

peran

Nama elemen Diperlukan Jenis Deskripsi
nama Ya String Menentukan nama peran
targetInstanceCount Ya Bilangan bulat Menentukan jumlah instans target untuk peran tersebut
hardwareProfile Ya Jenis Kompleks Menentukan informasi tentang profil perangkat keras untuk peran tersebut
osProfile Ya Jenis Kompleks Menentukan informasi tentang profil os untuk peran tersebut

hardwareProfile

Nama elemen Diperlukan Jenis Deskripsi
vmSize Ya String Menentukan ukuran VM. Lihat opsi konfigurasi HDInsight (sekali pada tautan ini, gulir ke bawah ke tingkat harga Node) untuk ukuran yang valid

osProfile

Nama elemen Diperlukan Jenis Deskripsi
linuxOperatingSystemProfile Tidak Jenis Kompleks Menentukan pengaturan terkait OS linux
virtualNetworkProfile Tidak Jenis Kompleks Menentukan pengaturan terkait jaringan virtual jika kluster sedang disebarkan di jaringan virtual dalam langganan pengguna
scriptActions Tidak Array Tipe Kompleks Daftar tindakan skrip yang akan dijalankan pada kluster

linuxOperatingSystemProfile

Nama elemen Diperlukan Jenis Deskripsi
Nama pengguna Ya String Nama pengguna SSH
sshProfile Tidak Jenis Kompleks Menentukan kunci SSH.

Salah satu sshProfile atau Kata Sandi diperlukan.
Kata sandi Tidak String Menentukan kata sandi SSH

Salah satu sshProfile atau Kata Sandi diperlukan.

sshProfile

Nama elemen Diperlukan Jenis Deskripsi
publicKeys Ya Array Berisi daftar objek certificateData. Nilainya adalah kunci umum ssh-rsa

virtualNetworkProfile

Nama elemen Diperlukan Jenis Deskripsi
id Ya String Id Sumber Daya Virtual Network
subnet Ya String Menentukan nama subnet

scriptActions

Nama elemen Diperlukan Jenis Deskripsi
nama Ya String Nama yang mudah diingat untuk tindakan skrip
uri Ya String URL ke file tindakan skrip
parameter Tidak String Argumen yang akan diteruskan saat menjalankan file tindakan skrip

Respons

Jika validasi selesai dan permintaan diterima, operasi akan mengembalikan 200 (OK).

Kode status: 200 OK

Isi respons untuk kluster linux dibuat menggunakan kunci ssh:

{
	"id": "/subscriptions/{subscription ID}/resourceGroups/rg1/providers/Microsoft.HDInsightCurrent/clusters/mycluster",
	"name": "mycluster",
	"type": "Microsoft.HDInsightCurrent/clusters",
	"location": "East Asia",
	"etag": "{value}",
	"tags": null,
	"properties": {
		"clusterVersion": "3.5.1000.0",
		"osType": "Linux",
		"clusterDefinition": {
			"kind": "hadoop"
		},
		"computeProfile": {
			"roles": [
				{
					"name": "headnode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Standard_D3"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "myuser"
						}
					}
				},
				{
					"name": "workernode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Standard_D3"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "myuser"
						}
					}
				}
			]
		},
		"provisioningState": "InProgress",
		"clusterState": "Accepted",
		"createdDate": "2016-11-15T09:21:47.61",
		"quotaInfo": {
			"coresUsed": 16
		},
		"tier": "standard"
	}
}
Nama elemen Jenis Deskripsi
provisioningState String Menunjukkan status penyediaan saat ini.
clusterState String Menunjukkan status kluster HDInsight yang lebih rinci saat provisi sedang berlangsung.
createdDate Tanggal Tanggalwaktu saat permintaan pembuatan kluster diterima
quotaInfo Jenis Kompleks Menentukan core yang Digunakan oleh kluster
errors Array pesan kesalahan Berisi pesan kesalahan jika provisioningState = 'failed"
connectivityEndpoints Jenis Kompleks Menentukan titik akhir publik untuk kluster

connectivityEndpoints

Nama elemen Jenis Deskripsi
nama String Nama yang mudah diingat untuk titik akhir konektivitas
protocol String Menentukan Protokol yang akan digunakan (misalnya: HTTPS, SSH)
lokasi String Menentukan URL yang akan disambungkan
port int Menentukan port yang akan disambungkan

Hapus

Menghapus kluster HDInsight.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
HAPUS https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Respons

HTTP 202 (Diterima) untuk menunjukkan bahwa operasi akan selesai secara asinkron. Polling asinkron akan mengembalikan 204 (NoContent) setelah operasi berhasil diselesaikan.

Keterangan

Untuk melacak kemajuan permintaan kluster penghapusan, lihat Operasi Asinkron (header Diterima dan Lokasi 202)

Get

Mendapatkan detail/properti kluster yang ditentukan.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
DAPATKAN https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Respons

Operasi akan mengembalikan 200 (OK) jika permintaan berhasil diselesaikan

Kode status: 200 OK

Isi respons sama dengan membuat kluster.

Isi respons untuk detail kluster linux

{  
    "id":"/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",  
  "name":"mycluster",   
  "type":"Microsoft.HDInsight/clusters",  
  
    "location": "location-name",  
    "tags": { "tag1": "value1", "tag2": "value2" },  
    "properties": {  
        "clusterVersion": "3.2",  
        "osType": "Linux",  
		"provisioningState": "InProgress",  
		"clusterState": "Accepted",  
		"createdDate": "2015-09-23",  
		"quotaInfo": {  
			"coresUsed": 20  
}  
        "clusterDefinition": {  
            "kind": "hadoop"  
        },  
  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "headnode",  
  
                    "targetInstanceCount": 2,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    },  
                    "osProfile": {  
                       "linuxOperatingSystemProfile": {  
                          "username": "sshuser"  
                       }  
                     }  
  
                },  
                {  
                    "name": "workernode",  
  
                    "targetInstanceCount": 1,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    },  
  
                    "osProfile": {  
                       "linuxOperatingSystemProfile": {  
                          "username": "sshuser"  
                       }  
                     }  
  
                },  
                {  
                    "name": "zookeepernode",  
  
                    "targetInstanceCount": 3,  
  
                    "hardwareProfile": {  
                        "vmSize": "Small"  
                    },  
  
                    "osProfile": {  
                       "linuxOperatingSystemProfile": {  
                          "username": "sshuser"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}
Nama elemen Jenis Deskripsi
provisioningState String Menunjukkan status penyediaan saat ini.
clusterState String Menunjukkan status kluster HDInsight yang lebih rinci saat provisi sedang berlangsung.
createdDate Tanggal Tanggalwaktu saat permintaan pembuatan kluster diterima
quotaInfo Jenis Kompleks Menentukan core yang Digunakan oleh kluster
errors Array pesan kesalahan Berisi pesan kesalahan jika provisioningState = 'failed"
connectivityEndpoints Jenis Kompleks Menentukan titik akhir publik untuk kluster

connectivityEndpoints

Nama elemen Jenis Deskripsi
nama String Nama yang mudah diingat untuk titik akhir konektivitas
protocol String Menentukan Protokol yang akan digunakan (misalnya: HTTPS, SSH)
lokasi String Menentukan URL yang akan disambungkan
port int Menentukan port yang akan disambungkan

Mencantumkan konfigurasi

Mengambil semua detail konfigurasi kluster (termasuk informasi sensitif).

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations?api-version={api-version}

Respons

HTTP 200 (OK) tentang keberhasilan penyelesaian operasi.

Contoh respons

"configurations":   
{  
     "gateway": {  
          "restAuthCredential.isEnabled": true,  
          "restAuthCredential.username": "username",  
          "restAuthCredential.password": "Password123!"     
      },  
  
      "core-site": {  
           "fs.defaultFS": "wasbs://mycontainter@mystorageaccount.blob.core.windows.net",
	   "fs.azure.account.key.mystorageaccount.blob.core.windows.net": "storagekey1value"  
      }  
}
Nama elemen Jenis Deskripsi
configurations Kamus Elemen ini adalah kamus jenis konfigurasi dan kamus nilai terkait.
Jenis konfigurasi gateway digunakan untuk mengonfigurasi pengguna http yang digunakan untuk menyambungkan ke API web dan portal Ambari
jenis konfigurasi situs inti digunakan untuk mengonfigurasi akun penyimpanan default untuk kluster

Mendapatkan konfigurasi

Mendapatkan detail tentang satu jenis konfigurasi (menghilangkan nilai sensitif).

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
DAPATKAN https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Respons

HTTP 200 (OK) tentang keberhasilan penyelesaian operasi.

Contoh respons

{
     "core-site": {  
          "fs.defaultFS": "wasbs://mycontainter@mystorageaccount.blob.core.windows.net",
	  "fs.azure.account.key.mystorageaccount.blob.core.windows.net": ""
     }
}

Mendapatkan pengaturan gateway

Operasi ini mengambil kredensial HTTP gateway kluster.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/getGatewaySettings?api-version={api-version}

Respons

HTTP 200 (OK) tentang keberhasilan penyelesaian operasi.

Contoh respons

{  
     "restAuthCredential.isEnabled": true,  
     "restAuthCredential.username": "username",  
     "restAuthCredential.password": "Password123!"  
}

Memperbarui pengaturan gateway

Operasi ini memungkinkan pengguna untuk mengubah kredensial HTTP gateway kluster.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/updateGatewaySettings?api-version={api-version} 
{  
     "restAuthCredential.isEnabled": true,  
     "restAuthCredential.username": "username",  
     "restAuthCredential.password": "Password123!"  
}

Respons

HTTP 202 (Diterima) pada keberhasilan penyelesaian operasi.

Mengubah pengaturan konektivitas (TIDAK DIGUNAKAN LAGI)

Operasi ini memungkinkan pengguna untuk mengaktifkan/menonaktifkan konektivitas HTTPS ke kluster.

Gunakan updateGatewaySettings sebagai gantinya.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Untuk mengaktifkan konektivitas

{  	
   "restAuthCredential.isEnabled": true,  	
   "restAuthCredential.username": "user",  	
   "restAuthCredential.password": "password here"  
}

Daftar menurut grup sumber daya

Lists semua kluster dalam langganan pengguna di grup sumber daya yang ditentukan.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
DAPATKAN https://management.azure.com/subscriptions/{subscription Id}/resourcegroups/{resourceGroup Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Respons

Operasi akan mengembalikan 200 (OK) jika permintaan berhasil diselesaikan.

Kode status: 200 OK

Isi respons adalah array detail kluster. Untuk informasi selengkapnya, lihat Mendapatkan properti kluster.

{  
  "value": [  
		{ Cluster details }  
    ]  
}

Daftar menurut langganan

Lists semua kluster dalam langganan pengguna.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
DAPATKAN https://management.azure.com/subscriptions/{subscription Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Respons

Operasi akan mengembalikan 200 (OK) jika permintaan berhasil diselesaikan.

Kode status: 200 OK

Isi respons adalah array detail kluster.

{  
  "value": [  
		{ Cluster details }  
    ]  
}

Untuk menonaktifkan konektivitas

{  
   "restAuthCredential.isEnabled": false  
}
Nama elemen Diperlukan Jenis Deskripsi
restAuthCredential.isEnabled Ya Boolean Menentukan apakah konektivitas harus diaktifkan atau dinonaktifkan
restAuthCredential.username Tidak String Diperlukan jika isEnabled=true
Menentukan nama pengguna untuk pengaturan konektivitas
restAuthCredential.password Tidak String Diperlukan jika isEnabled=true
Menentukan kata sandi untuk pengaturan konektivitas

Respons

HTTP 202 (Diterima) untuk menunjukkan bahwa operasi akan selesai secara asinkron. Polling asinkron akan mengembalikan 204 (NoContent) setelah operasi berhasil diselesaikan.

Keterangan

Untuk melacak kemajuan permintaan kluster penghapusan, lihat Operasi Asinkron (header Diterima dan Lokasi 202)

Mengubah pengaturan RDP (hanya kluster Windows)

Operasi ini memungkinkan pengguna untuk mengaktifkan/menonaktifkan RDP. Ini berlaku untuk kluster berbasis Windows.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/changerdpsetting?api-version={api-version}

Isi Permintaan

Untuk mengaktifkan RDP

{  
	"osProfile": {  
        "windowsOperatingSystemProfile": {  
        	"rdpSettings": {  
        	      "username": "username",  
            	      "password": "password here",  
            	      "expiryDate": "YYYY-MM-DD"  
        	}  
        }  
    }  
}

Untuk menonaktifkan RDP

{  
	"osProfile": {  
        "windowsOperatingSystemProfile": {  
        	"rdpSettings": null  
        }  
    }  
}

osProfile

Nama elemen Diperlukan Jenis Deskripsi
windowsOperatingSystemProfile Tidak Jenis Kompleks Menentukan pengaturan terkait OS windows

windowsOperatingSystemProfile

Nama elemen Diperlukan Jenis Deskripsi
rdpSettings Tidak Jenis Kompleks Menentukan pengaturan RDP untuk kluster windows

rdpSettings

Nama elemen Diperlukan Jenis Deskripsi
nama pengguna Ya String Menentukan nama pengguna RDP
kata sandi Ya String Menentukan kata sandi untuk pengguna RDP
expiryDate Ya Tanggal Tanggal kedaluwarsa untuk kredensial RDP

Respons

Operasi akan mengembalikan 200 (OK) jika permintaan berhasil diselesaikan

Kode status: 200 OK

Isi respons sama dengan Buat kluster.

Jalankan Tindakan Skrip pada kluster yang sedang berjalan (hanya kluster Linux)

Jalankan tindakan Skrip pada kluster yang sedang berjalan.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/executeScriptActions?api-version={api-version}

Isi Permintaan

{  
  "scriptActions": [  
    {  
      "name": "script-name",  
      "uri": "script-uri",  
      "parameters": "script-parameters",  
      "roles": [  
        "headnode",  
        "workernode"  
      ]  
    },  
    ...  
  ],  
  "persistOnSuccess": true  
}

scriptActions

Nama elemen Diperlukan Jenis Deskripsi
nama Ya String Menentukan nama tindakan skrip
uri Ya String Menentukan URI tindakan skrip
parameter Ya String Menentukan parameter yang diperlukan oleh tindakan skrip
peran Ya Array String Menentukan peran target tempat tindakan skrip dijalankan
persistOnSuccess Ya Boolean Menentukan apakah tindakan skrip akan dipertahankan setelah eksekusi berhasil

Respons

Jika validasi selesai dan permintaan diterima, operasi akan mengembalikan 202 (Diterima).

Kode status: 202 (Diterima)

Mencantumkan semua Tindakan Skrip yang dipertahankan untuk kluster (hanya kluster Linux)

Operasi ini mengembalikan semua tindakan skrip yang bertahan dari kluster yang ditentukan.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
DAPATKAN https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions?api-version={api-version}

Respons

HTTP 200 (OK) tentang keberhasilan penyelesaian operasi.

Kode status: 200 OK

Contoh respons

{  
"value":  
[  
  {  
    "name":"script-name",  
    "uri":"script-uri",  
    "parameters":"script-parameters",  
    "roles":["headnode","workernode"],  
    "applicationName":null  
  },  
  ...  
]  
}
Nama elemen Jenis Deskripsi
nama String Menentukan nama tindakan skrip.
uri String Menentukan URI tindakan skrip.
parameter String Menentukan parameter yang diperlukan oleh tindakan skrip
peran Array String Menentukan peran yang ditargetkan tempat tindakan skrip dijalankan.
applicationName String Menentukan aplikasi terkait yang terkait dengan skrip. applicationName null jika skrip disediakan oleh pengguna

Menghapus Tindakan Skrip yang bertahan untuk kluster (hanya kluster Linux)

Operasi ini menghapus tindakan skrip tetap HDInsight untuk kluster.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
HAPUS https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions/{script Name}?api-version={api-version}

Respons

  • HTTP 200 (OK) untuk menunjukkan bahwa tindakan skrip telah dihapus dari daftar tindakan skrip yang bertahan.

  • HTTP 404 (NotFound) untuk menunjukkan bahwa tidak ada tindakan skrip yang bertahan dengan scriptName yang sesuai.

Dapatkan eksekusi Tindakan Skrip dari riwayat (hanya kluster Linux)

Operasi ini mengembalikan eksekusi tindakan skrip terbaru dari kluster atau detail eksekusi yang ditentukan untuk eksekusi skrip individual.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
DAPATKAN https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptExecutionHistory/{script Execution Id}?api-version={api-version}

Respons

Operasi akan mengembalikan 200 (OK) jika permintaan berhasil diselesaikan. Isi respons adalah array detail eksekusi skrip atau detail eksekusi skrip tunggal jika scriptExecutionId disediakan. Di bawah ini adalah contoh detail eksekusi skrip.

Kode status: 200 (OK)

Contoh respons

{  
  "scriptExecutionId":script-execution-id,  
  "name":"script-name",  
  "applicationName":null,  
  "uri":"script-uri",  
  "parameters":"script-parameters",  
  "roles":["headnode","workernode"],  
  "startTime":"2016-02-26T23:49:13.0773637Z",  
  "endTime":"2016-02-26T23:49:33.4964725Z",  
  "status":"Succeeded",  
  "operation":"PostClusterCreateScriptActionRequest",  
  "executionSummary":  
	[{"status":"COMPLETED",  
	 "instanceCount":4}],  
  "debugInformation": "debug-information"  
}
Nama elemen Jenis Deskripsi
scriptExecutionId Long Menentukan id eksekusi tindakan skrip.
nama String Menentukan nama tindakan skrip.
applicationName String Menentukan aplikasi terkait yang terkait dengan skrip. applicationName null jika skrip disediakan oleh pengguna
uri String Menentukan URI tindakan skrip.
parameter String Menentukan parameter yang diperlukan oleh tindakan skrip
peran Array String Menentukan peran yang ditargetkan tempat tindakan skrip dijalankan.
startTime DateTime Menentukan waktu mulai eksekusi tindakan skrip
endTime DateTime Menentukan waktu akhir eksekusi tindakan skrip
status Untai (karakter) Menentukan status eksekusi tindakan skrip
operasi String Menentukan alasan tindakan skrip dijalankan. Misalnya, ScaleUp berarti bahwa tindakan skrip dijalankan selama peningkatan skala kluster.
executionSummary Array jenis kompleks Menentukan ringkasan eksekusi dalam hal berapa banyak host yang berhasil dan berapa banyak host yang gagal menjalankan skrip.
debugInformation String Menentukan informasi debug terperinci untuk skrip. debugInformation dikembalikan hanya ketika scriptExecutionId disediakan dalam permintaan.

executionSummary

Nama elemen Jenis Deskripsi
status Untai (karakter) Menentukan status eksekusi pada masing-masing host.
instanceCount Int Menentukan jumlah eksekusi dengan status yang sesuai.

Mempromosikan skrip dari riwayat eksekusi Tindakan Skrip untuk dipertahankan (hanya kluster Linux)

Operasi ini mempromosikan skrip HDInsight dari riwayat eksekusi skrip untuk dipertahankan.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptExecutionHistory/{script Execution Id}/promote?api-version={api-version}

Respons

  • HTTP 200 (OK) untuk menunjukkan bahwa tindakan skrip telah dipromosikan.

  • HTTP 404 (NotFound) untuk menunjukkan bahwa tidak ada eksekusi tindakan skrip yang ada dengan scriptExecutionId yang sesuai.

Pengubahan ukuran

Mengubah ukuran kluster HDInsight yang ada.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode URI Permintaan
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/roles/{role name}/resize?api-version={api-version}

Berikut ini memperlihatkan contoh permintaan untuk memperbarui tag untuk kluster

{  
    "targetInstanceCount": 10  
}
Nama elemen Diperlukan Jenis Deskripsi
targetInstanceCount Ya Int Menentukan jumlah instans baru untuk peran tersebut

Respons

HTTP 202 (Diterima) untuk menunjukkan bahwa operasi akan selesai secara asinkron. Polling asinkron akan mengembalikan 204 (NoContent) setelah operasi berhasil diselesaikan.

Keterangan

Untuk melacak kemajuan permintaan kluster penghapusan, lihat Operasi Asinkron (header Diterima dan Lokasi 202)

Pembaruan

Updates tag untuk kluster.

Semua pembaruan lainnya adalah tindakan terpisah yang dijelaskan secara terpisah.

Minta

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh kluster.

Metode Permintaan URI
PATCH https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Berikut ini memperlihatkan contoh permintaan untuk memperbarui tag untuk kluster

{   
    "tags": {"department": "finance"}  
}
Nama elemen Diperlukan Jenis Deskripsi
tag Ya String Menentukan tag yang akan ditetapkan ke kluster. Untuk informasi selengkapnya tentang menggunakan tag, lihat Menggunakan tag untuk menata sumber daya Azure Anda.

Respons

Operasi akan mengembalikan 200 (OK) jika permintaan berhasil diselesaikan.

Kode status: 200 OK

Isi respons sama dengan Buat kluster.