Application

  • 發行項

建立

在叢集上建立新的節點 (稱為邊緣節點) ，並在該節點上安裝應用程式。

要求

如需叢集所使用的標頭和參數，請參閱 一般參數和標頭 。

方法 要求 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}

下列範例示範在以 Linux 為基礎的 HDInsight 叢集上安裝應用程式的要求本文。

{  
  
	"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"  
	}  
}
元素名稱 必要 類型 Description
NAME 是 String 指定應用程式的名稱。 名稱必須指定為 clusterName/applicationName。 每個叢集的應用程式名稱必須是唯一的。
類型 是 String 指定資源的類型。
屬性 Yes 複雜類型 指定叢集的屬性。

屬性

元素名稱 必要 類型 Description
computeProfile Yes 複雜類型 描述應用程式將在其中執行的 VM
InstallScriptActions Yes 複雜類型 描述應用程式的安裝腳本動作。 至少必須指定一個腳本，而且腳本必須是等冪的，這表示可以在產生相同的結果時重複呼叫腳本。
UninstallScriptActions No 複雜類型 描述應用程式的卸載腳本動作。 此參數是選擇性的，但指定的任何卸載腳本動作都必須是等冪 (這表示可以在產生相同的結果時重複呼叫腳本) 。
HttpEndpoint No 複雜類型 描述應用程式上的哪些端點應可定址網際網路。
applicationType 是 String 此元素一律為值 「CustomApplication」

computeProfile

此元素應該只包含一個角色

元素名稱 必要 類型 Description
role Yes 複雜類型 指定叢集中角色的相關資訊
角色 (role)
元素名稱 必要 類型 Description
NAME 是 String 名稱必須指定為 「edgenode」
targetInstanceCount 是 整數 此元素必須設定為 1
hardwareProfile Yes 複雜類型 指定 edgenode 硬體設定檔的相關資訊
hardwareProfile
元素名稱 必要 類型 Description
vmSize 是 String 指定 VM 的大小。 請參閱此連結上的 HDInsight 設定選項 (一次，請向下捲動至 節點定價層) 以取得有效大小

InstallScriptActions

元素名稱 必要 類型 Description
Name Yes String 指定腳本動作的名稱。 叢集上所有持續性腳本動作必須是唯一的
Uri 是 String 腳本的可公開存取位置。 所有指定的腳本都必須等冪，這表示可以在產生相同的結果時重複呼叫腳本。
參數 否 String 要傳遞至腳本的選擇性參數集
角色 Yes 字串陣列 描述要執行之腳本的角色。 有效值為： headnode、 workernode、 zookeepernode和 edgenode。 edgenode 是裝載應用程式和應用程式執行位置的角色。

UninstallScriptActions

元素名稱 必要 類型 Description
Name Yes String 指定腳本動作的名稱。
Uri 是 String 腳本的可公開存取位置。 任何指定的腳本都必須等冪，這表示可以在產生相同的結果時重複呼叫腳本。
參數 否 String 要傳遞至腳本的選擇性參數集
角色 Yes 字串陣列 描述要執行之腳本的角色。 有效值為： headnode、 workernode、 zookeepernode和 edgenode。 edgenode 是裝載應用程式和應用程式執行位置的角色。

HttpEndpoint

元素名稱 必要 類型 Description
subDomainSuffix 是 String 用來建置用來存取應用程式的 DNS 名稱的三個字元英數位元字串。 DNS 名稱的格式為： *.apps.azurehdinsight.net。 此名稱每個叢集必須是唯一的。
destinationPort 是 整數 將 HTTP 流量轉送至裝載應用程式的 edgenode 上的埠。
accessModes No 字串陣列 關於端點的中繼資料。 如果端點裝載網頁，請將 網頁 指定為存取模式。 否則，陣列應該是空的或不存在於承載中。 這個專案可讓Azure 入口網站顯示應用程式的直接連結。

回應

如果驗證完成並接受要求，作業會傳回 200 (OK) 。

狀態碼： 200 確定

Get

取得 HDInsight 應用程式的詳細資料。

要求

如需叢集所使用的標頭和參數，請參閱 一般參數和標頭 。

方法 要求 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}

回應

回應本文是 HDInsight 應用程式詳細資料的陣列，如果提供 applicationName，則為單一 HDInsight 應用程式詳細資料。 以下是應用程式詳細資料的範例。

回應碼：HTTP 200 (OK) 成功完成作業。

範例回應：

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

移除

從叢集移除 HDInsight 應用程式。

要求

如需叢集所使用的標頭和參數，請參閱 一般參數和標頭 。

方法 要求 URI
刪除 https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

回應

如果要求順利完成，作業會傳回 202 (已接受)

狀態碼： 202 已接受。