你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

应用程序

项目
08/05/2023

创建

在群集上创建新节点 (称为边缘节点) 并在该节点上安装应用程序。

请求

有关群集使用的标头和参数，请参阅通用参数和标头。

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

元素名称	必须	类型	说明
name	是	字符串	指定应用程序的名称。该名称必须指定为 clusterName/applicationName。每个群集的应用程序名称必须唯一。
type	是	字符串	指定资源的类型。
属性	是	复杂类型	指定群集的属性。

属性

元素名称	必须	类型	说明
computeProfile	是	复杂类型	描述应用程序将在其中运行的 VM
InstallScriptActions	是	复杂类型	描述应用程序的安装脚本操作。必须至少指定一个脚本，并且这些脚本必须是幂等的，这意味着可以在生成相同结果时重复调用这些脚本。
UninstallScriptActions	否	复杂类型	描述应用程序的卸载脚本操作。此参数是可选的，但指定的任何卸载脚本操作都必须是幂等 (这意味着可以在生成相同结果) 时重复调用脚本。
HttpEndpoint	否	复杂类型	描述应用程序上的哪些终结点应可 Internet 寻址。
applicationType	是	字符串	此元素始终为值“CustomApplication”

computeProfile

此元素应仅包含一个角色

元素名称	必须	类型	说明
role	是	复杂类型	指定有关群集中角色的信息

role

元素名称	必须	类型	说明
name	是	字符串	名称必须指定为“edgenode”
targetInstanceCount	是	Integer	此元素必须设置为 1
hardwareProfile	是	复杂类型	指定有关边缘节点的硬件配置文件的信息

hardwareProfile

元素名称	必须	类型	说明
vmSize	是	字符串	指定 VM 的大小。请参阅此链接上的 HDInsight 配置选项 (一次，向下滚动到节点定价层) 以获取有效大小

InstallScriptActions

元素名称	必须	类型	说明
名称	是	字符串	指定脚本操作的名称。在群集上的所有持久化脚本操作中必须是唯一的
Uri	是	字符串	脚本的可公开访问位置。指定的所有脚本都必须是幂等的，这意味着可以在生成相同结果时重复调用脚本。
parameters	否	字符串	要传递给脚本的可选参数集
角色	是	字符串数组	描述要运行脚本的角色。有效值为： headnode、 workernode、 zookeepernode 和 edgenode。 edgenode 是托管应用程序的角色，应用程序将在其中运行。

UninstallScriptActions

元素名称	必须	类型	说明
名称	是	字符串	指定脚本操作的名称。
Uri	是	字符串	脚本的可公开访问位置。指定的任何脚本都必须是幂等的，这意味着可以在生成相同结果时重复调用脚本。
parameters	否	字符串	要传递给脚本的可选参数集
角色	是	字符串数组	描述要运行脚本的角色。有效值为： headnode、 workernode、 zookeepernode 和 edgenode。 edgenode 是托管应用程序的角色，应用程序将在其中运行。

HttpEndpoint

元素名称	必须	类型	说明
subDomainSuffix	是	字符串	一个三字符字母数字字符串，用于生成用于访问应用程序的 DNS 名称。 DNS 名称的格式为： *.apps.azurehdinsight.net。此名称对于每个群集必须是唯一的。
destinationPort	是	Integer	用于在托管应用程序的边缘节点上将 HTTP 流量转发到的端口。
accessModes	否	字符串数组	有关终结点的元数据。如果终结点托管网页，请将网页指定为访问模式。否则，数组应为空或有效负载中不存在。此元素使Azure 门户能够显示指向应用程序的直接链接。

响应

如果验证完成并接受请求，则操作将返回 200 (正常) 。

状态代码： 200 正常

获取

获取有关 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 (正常) 。

示例响应:

{  
	"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 应用程序。

请求