Aplikasi
Buat
Membuat simpul baru pada kluster (disebut sebagai simpul tepi) dan menginstal aplikasi pada simpul tersebut.
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}/applications/{application Name}?api-version={api-version} |
Contoh berikut menunjukkan isi permintaan untuk menginstal aplikasi pada kluster HDInsight berbasis Linux.
{
"name": "clusterName / applicationName"
"type": "Microsoft.HDInsight/clusters/applications",
"properties": {
"computeProfile": {
"roles": [
{
"name": "edgenode",
"targetInstanceCount": 1,
"hardwareProfile": {
"vmSize": "Standard_D3"
}
}
]
},
"installScriptActions": [
{
"name": "hue-install",
"uri": "https://publicEndpoint-bash-file.sh",
"parameters": "",
"roles": ["edgenode"]
}
],
"uninstallScriptActions": [
{
"name": "hue-uninstall",
"uri": "https://publicEndpoint-bash-file.sh",
"parameters": "",
"roles": ["edgenode"]
}
],
"httpsEndpoints": [
{
"subDomainSuffix": "abc",
"destinationPort": 8888,
"accessModes": ["WebPage"]
},
{
"subDomainSuffix": "was",
"destinationPort": 50073,
"accessModes": ["WebPage"]
}
],
"applicationType": "CustomApplication"
}
}
Nama elemen | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
nama | Ya | String | Menentukan nama aplikasi. Nama harus ditentukan sebagai clusterName/applicationName. Nama aplikasi harus unik per kluster. |
jenis | Ya | String | Menentukan jenis sumber daya. |
Properti | Ya | Jenis Kompleks | Menentukan properti kluster. |
Properti
Nama elemen | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
computeProfile | Ya | Jenis Kompleks | Menjelaskan VM yang akan dijalankan aplikasi |
InstallScriptActions | Ya | Jenis Kompleks | Menjelaskan tindakan instal skrip untuk aplikasi. Setidaknya satu skrip harus ditentukan dan skrip harus idempotensi, yang berarti skrip dapat dipanggil berulang kali saat menghasilkan hasil yang sama. |
UninstallScriptActions | Tidak | Jenis Kompleks | Menjelaskan tindakan hapus instalan skrip untuk aplikasi. Parameter ini bersifat opsional, tetapi setiap tindakan skrip penghapusan instalan yang ditentukan harus idempotensi (yang berarti skrip dapat dipanggil berulang kali saat menghasilkan hasil yang sama). |
HttpEndpoint | Tidak | Jenis Kompleks | Menjelaskan titik akhir mana pada aplikasi yang harus dapat diatasi internet. |
applicationType | Ya | String | Elemen ini selalu bernilai "CustomApplication" |
computeProfile
Elemen ini harus berisi tepat satu peran
Nama elemen | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
role | Ya | Jenis Kompleks | Menentukan informasi tentang peran dalam kluster |
peran
Nama elemen | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
nama | Ya | String | Nama harus ditentukan sebagai "edgenode" |
targetInstanceCount | Ya | Bilangan bulat | Elemen ini harus diatur ke 1 |
hardwareProfile | Ya | Jenis Kompleks | Menentukan informasi tentang profil perangkat keras untuk edgenode |
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 |
InstallScriptActions
Nama elemen | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
Nama | Ya | String | Menentukan nama tindakan skrip. Harus unik di semua tindakan skrip yang dipertahankan pada kluster |
Uri | Ya | String | Lokasi skrip yang dapat diakses publik. Semua skrip yang ditentukan harus idempotensi, yang berarti skrip dapat dipanggil berulang kali sambil menghasilkan hasil yang sama. |
Parameter | Tidak | String | Set parameter opsional untuk diteruskan ke skrip |
Peran | Ya | Array String | Menjelaskan peran untuk menjalankan skrip. Nilai yang valid adalah: headnode, workernode, zookeepernode, dan edgenode. edgenode adalah peran yang menghosting aplikasi dan di mana aplikasi Anda akan berjalan. |
UninstallScriptActions
Nama elemen | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
Nama | Ya | String | Menentukan nama tindakan skrip. |
Uri | Ya | String | Lokasi skrip yang dapat diakses publik. Setiap skrip yang ditentukan harus idempotensi, yang berarti skrip dapat dipanggil berulang kali sambil menghasilkan hasil yang sama. |
Parameter | Tidak | String | Set parameter opsional untuk diteruskan ke skrip |
Peran | Ya | Array String | Menjelaskan peran untuk menjalankan skrip. Nilai yang valid adalah: headnode, workernode, zookeepernode, dan edgenode. edgenode adalah peran yang menghosting aplikasi dan di mana aplikasi Anda akan berjalan. |
HttpEndpoint
Nama elemen | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
subDomainSuffix | Ya | String | String alfanumerik tiga karakter yang digunakan untuk membangun nama DNS yang digunakan untuk mengakses aplikasi. Nama DNS akan memiliki format: *.apps.azurehdinsight.net. Nama ini harus unik per kluster. |
destinationPort | Ya | Bilangan bulat | Port untuk meneruskan lalu lintas HTTP ke pada edgenode yang menghosting aplikasi Anda. |
accessModes | Tidak | Array String | Metadata tentang titik akhir. Jika titik akhir menghosting halaman Web, tentukan halaman web sebagai mode akses. Jika tidak, array harus kosong atau tidak ada dalam payload. Elemen ini memungkinkan portal Azure menampilkan tautan langsung ke aplikasi Anda. |
Respons
Jika validasi selesai dan permintaan diterima, operasi akan mengembalikan 200 (OK).
Kode status: 200 OK
Dapatkan
Mendapatkan detail tentang aplikasi HDInsight.
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}/applications/{application Name}?api-version={api-version} |
Respons
Isi respons adalah array detail aplikasi HDInsight atau satu detail aplikasi HDInsight jika applicationName disediakan. Di bawah ini adalah contoh detail aplikasi.
Kode respons: HTTP 200 (OK) tentang keberhasilan penyelesaian operasi.
Contoh respons
{
"value": [
{
"id": "resourceId",
"name": "clusterName / applicationName",
"type": "Microsoft.HDInsight/clusters/applications",
"etag": "etagValue",
"tags": null,
"properties": {
"computeProfile": {
"roles": [
{
"name": "edgenode",
"targetInstanceCount": 1,
"hardwareProfile": {
"vmSize": "Standard_D3"
}
}
]
},
"installScriptActions": [
{
"name": "hue-install",
"uri": "https://publicEndpoint-bash-file.sh",
"parameters": "",
"roles": ["edgenode"]
}
],
"uninstallScriptActions": [
{
"name": "hue-uninstall",
"uri": "https://publicEndpoint-bash-file.sh",
"parameters": "",
"roles": ["edgenode"]
}
],
"httpsEndpoints": [
{
"subDomainSuffix": "abc",
"destinationPort": 8888,
"accessModes": ["WebPage"]
},
{
"subDomainSuffix": "was",
"destinationPort": 50073,
"accessModes": ["WebPage"]
}
],
"provisioningState": "Succeeded",
"applicationState": "Running",
"createdDate": "CreatedDate",
"applicationType": "CustomApplication",
"marketplaceIdentifier": "HueV1"
}
]
}
Hapus
Menghapus aplikasi HDInsight dari 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}/applications/{application Name}?api-version={api-version} |
Respons
Operasi akan mengembalikan 202 (Diterima) jika permintaan berhasil diselesaikan
Kode status: 202 Diterima.