Azure HDInsight'ta Uygulama REST API'si

Oluştur

Kümede yeni bir düğüm oluşturur (kenar düğümü olarak adlandırılır) ve bu düğüme bir uygulama yükler.

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
YERLEŞTİRMEK https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Aşağıdaki örnekte, Linux tabanlı bir HDInsight kümesine uygulama yüklemek için istek gövdesi gösterilmektedir.

{  
  
	"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"  
	}  
}
Öğe adı Gerekli Türü Açıklama
isim Evet Dize Uygulamanın adını belirtir. Adın clusterName/applicationName olarak belirtilmesi gerekir. Uygulama adı her küme için benzersiz olmalıdır.
tür Evet Dize Kaynağın türünü belirtir.
Özellikleri Evet Karmaşık Tür Kümenin özelliklerini belirtir.

Özellikler

Öğe adı Gerekli Türü Açıklama
computeProfile Evet Karmaşık Tür Uygulamanın üzerinde çalışacağı VM'yi açıklar
InstallScriptActions Evet Karmaşık Tür Uygulama için yükleme komut dosyası eylemlerini açıklar. En az bir komut dosyası belirtilmelidir ve komut dosyaları bir kez etkili olmalıdır, bu da komut dosyalarının aynı sonucu üretirken tekrar tekrar çağrılabileceği anlamına gelir.
UninstallScriptActions Hayı Karmaşık Tür Uygulama için kaldırma komut dosyası eylemlerini açıklar. Bu parametre isteğe bağlıdır, ancak belirtilen tüm kaldırma betik eylemlerinin bir kez etkili olması gerekir (bu, aynı sonucu üretirken betiklerin tekrar tekrar çağrılabileceği anlamına gelir).
HttpEndpoint (HttpEndpoint) Hayı Karmaşık Tür Uygulamadaki hangi uç noktaların İnternet adreslenebilir olması gerektiğini açıklar.
applicationType (Uygulama Türü) Evet Dize Bu öğe her zaman "CustomApplication" değeridir

computeProfile

Bu öğe tam olarak bir rol içermelidir

Öğe adı Gerekli Türü Açıklama
rol Evet Karmaşık Tür Kümedeki rollerle ilgili bilgileri belirtir
rol
Öğe adı Gerekli Türü Açıklama
isim Evet Dize Ad "edgenode" olarak belirtilmelidir
targetInstanceCount (hedefÖrnekSayısı) Evet Integer Bu eleman 1 olarak ayarlanmalıdır
donanım Profili Evet Karmaşık Tür Edgenode için donanım profili hakkındaki bilgileri belirtir
donanım Profili
Öğe adı Gerekli Türü Açıklama
vmSize Evet Dize VM'nin boyutunu belirtir. Geçerli boyutlar için HDInsight yapılandırma seçeneklerine bakın (bu bağlantıda bir kez aşağı kaydırın ve Düğüm fiyatlandırma katmanları'na gidin)

InstallScriptActions

Öğe adı Gerekli Türü Açıklama
İsim Evet Dize Betik eyleminin adını belirtir. Kümedeki tüm kalıcı betik eylemlerinde benzersiz olmalıdır
Uri Evet Dize Komut dosyasının genel olarak erişilebilir konumu. Belirtilen tüm komut dosyaları bir kez etkili olmalıdır, bu da komut dosyalarının aynı sonucu üretirken tekrar tekrar çağrılabileceği anlamına gelir.
Parametreler Hayı Dize Komut dosyasına geçirilecek isteğe bağlı parametre kümesi
Görevler Evet Dize Dizisi Komut dosyasının çalıştırılacağı rolü açıklar. Geçerli değerler şunlardır: headnode, workernode, zookeepernode ve edgenode. Edgenode, uygulamayı barındıran ve uygulamanızın çalışacağı roldür.

UninstallScriptActions

Öğe adı Gerekli Türü Açıklama
İsim Evet Dize Betik eyleminin adını belirtir.
Uri Evet Dize Komut dosyasının genel olarak erişilebilir konumu. Belirtilen tüm komut dosyaları bir kez etkili olmalıdır, bu da komut dosyalarının aynı sonucu üretirken tekrar tekrar çağrılabileceği anlamına gelir.
Parametreler Hayı Dize Komut dosyasına geçirilecek isteğe bağlı parametre kümesi
Görevler Evet Dize Dizisi Komut dosyasının çalıştırılacağı rolü açıklar. Geçerli değerler şunlardır: headnode, workernode, zookeepernode ve edgenode. Edgenode, uygulamayı barındıran ve uygulamanızın çalışacağı roldür.

HttpEndpoint (HttpEndpoint)

Öğe adı Gerekli Türü Açıklama
subDomainSuffix Evet Dize Uygulamaya erişmek için kullanılan DNS adını oluşturmak için kullanılan üç karakterli alfasayısal bir dize. DNS adı şu biçimde olacaktır: *.apps.azurehdinsight.net. Bu adın her küme için benzersiz olması gerekir.
varış noktası Evet Integer Uygulamanızı barındıran kenar düğümünde HTTP trafiğinin iletileceği bağlantı noktası.
accessModes Hayı Dize Dizisi Uç noktayla ilgili meta veriler. Uç nokta bir Web sayfası barındırıyorsa, erişim modu olarak web sayfasını belirtin. Aksi takdirde, dizi boş olmalı veya yükte bulunmamalıdır. Bu öğe, Azure portal uygulamanıza doğrudan bağlantılar görüntülemesini sağlar.

Yanıt

Doğrulama tamamlandıysa ve istek kabul edildiyse, işlem 200 (Tamam) döndürür.

Durum kodu: 200 Tamam

Edin

HDInsight uygulaması hakkında ayrıntılı bilgi alır.

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Yanıt

Yanıt gövdesi, HDInsight uygulama ayrıntılarından oluşan bir dizi veya applicationName sağlanmışsa tek bir HDInsight uygulama ayrıntısıdır. Aşağıda uygulama detayına bir örnek verilmiştir.

Yanıt kodu: HTTP 200 (Tamam) işlem başarıyla tamamlandığında.

Örnek yanıt:

{  
	"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"  
			}  
		]  
	}

Kaldır

Bir HDInsight uygulamasını kümeden kaldırır.

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
SİLMEK https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Yanıt

İstek başarıyla tamamlanırsa işlem 202 (Kabul Edildi) döndürür

Durum kodu: 202 Kabul edildi.

  • Last updated on