Application

  • Artikel

Erstellen

Erstellt einen neuen Knoten im Cluster (als Edgeknoten bezeichnet) und installiert eine Anwendung auf diesem Knoten.

Anforderung

Informationen zu Headern und Parametern , die von Clustern verwendet werden, finden Sie unter Allgemeine Parameter und Header.

Methode Anforderungs-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}

Das folgende Beispiel zeigt den Anforderungstext für die Installation von Anwendungen in einem Linux-basierten HDInsight-Cluster.

{  
  
	"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"  
	}  
}
Elementname Erforderlich type BESCHREIBUNG
name Ja String Gibt den Namen der Anwendung an. Der Name muss als clusterName/applicationName angegeben werden. Der Anwendungsname muss pro Cluster eindeutig sein.
type Ja String Gibt den Typ der Ressource an.
Eigenschaften Ja Komplexer Typ Gibt die Eigenschaften des Clusters an.

Eigenschaften

Elementname Erforderlich type BESCHREIBUNG
computeProfile Ja Komplexer Typ Beschreibt den virtuellen Computer, auf dem die Anwendung ausgeführt wird.
InstallScriptActions Ja Komplexer Typ Beschreibt die Installationsskriptaktionen für die Anwendung. Es muss mindestens ein Skript angegeben werden, und die Skripts müssen idempotent sein. Dies bedeutet, dass die Skripts wiederholt aufgerufen werden können, während dasselbe Ergebnis erzeugt wird.
UninstallScriptActions Nein Komplexer Typ Beschreibt die Deinstallationsskriptaktionen für die Anwendung. Dieser Parameter ist optional, aber alle angegebenen Deinstallationsskriptaktionen müssen idempotent sein (was bedeutet, dass die Skripts wiederholt aufgerufen werden können, während dasselbe Ergebnis erzeugt wird).
HttpEndpoint Nein Komplexer Typ Beschreibt, welche Endpunkte in der Anwendung internetadressierbar sein sollen.
applicationType Ja String Dieses Element hat immer den Wert "CustomApplication".

computeProfile

Dieses Element sollte genau eine Rolle enthalten.

Elementname Erforderlich type BESCHREIBUNG
role Ja Komplexer Typ Gibt Informationen zu Rollen im Cluster an.
Rolle (role)
Elementname Erforderlich type BESCHREIBUNG
name Ja String Der Name muss als "Edgenode" angegeben werden.
targetInstanceCount Ja Integer Dieses Element muss auf 1 festgelegt werden.
hardwareProfile Ja Komplexer Typ Gibt Informationen zum Hardwareprofil für den Edgeknoten an.
hardwareProfile
Elementname Erforderlich type BESCHREIBUNG
vmSize Ja String Gibt die Größe des virtuellen Computers an. Gültige Größen finden Sie unter HDInsight-Konfigurationsoptionen (scrollen Sie einmal auf diesem Link nach unten zu Knotentarifen).

InstallScriptActions

Elementname Erforderlich type BESCHREIBUNG
Name Ja String Gibt den Namen der Skriptaktion an. Muss für alle persistenten Skriptaktionen im Cluster eindeutig sein.
Uri Ja String Öffentlich zugänglicher Speicherort des Skripts. Alle angegebenen Skripts müssen idempotent sein, was bedeutet, dass die Skripts wiederholt aufgerufen werden können, während dasselbe Ergebnis erzeugt wird.
Parameter Nein String Optionaler Satz von Parametern, die an das Skript übergeben werden sollen
Rollen Ja Array von Zeichenfolgen Beschreibt die Rolle für das Skript, auf dem ausgeführt werden soll. Gültige Werte sind: headnode, workernode, zookeepernode und edgenode. edgenode ist die Rolle, in der die Anwendung gehostet wird und in der Ihre Anwendung ausgeführt wird.

UninstallScriptActions

Elementname Erforderlich type BESCHREIBUNG
Name Ja String Gibt den Namen der Skriptaktion an.
Uri Ja String Öffentlich zugänglicher Speicherort des Skripts. Alle angegebenen Skripts müssen idempotent sein, was bedeutet, dass die Skripts wiederholt aufgerufen werden können, während dasselbe Ergebnis erzeugt wird.
Parameter Nein String Optionaler Satz von Parametern, die an das Skript übergeben werden sollen
Rollen Ja Array von Zeichenfolgen Beschreibt die Rolle für das Skript, auf dem ausgeführt werden soll. Gültige Werte sind: headnode, workernode, zookeepernode und edgenode. edgenode ist die Rolle, in der die Anwendung gehostet wird und in der Ihre Anwendung ausgeführt wird.

HttpEndpoint

Elementname Erforderlich type BESCHREIBUNG
subDomainSuffix Ja String Eine dreistellige alphanumerische Zeichenfolge, die zum Erstellen des DNS-Namens verwendet wird, der für den Zugriff auf die Anwendung verwendet wird. Der DNS-Name weist das Format *.apps.azurehdinsight.net auf. Dieser Name muss pro Cluster eindeutig sein.
destinationPort Ja Integer Der Port, an den HTTP-Datenverkehr auf dem Edgeknoten weitergeleitet werden soll, an den Ihre Anwendung gehostet wird.
accessModes Nein Array von Zeichenfolgen Metadaten zum Endpunkt. Wenn der Endpunkt eine Webseite hostet, geben Sie die Webseite als Zugriffsmodus an. Andernfalls sollte das Array leer oder nicht in der Nutzlast vorhanden sein. Dieses Element ermöglicht es dem Azure-Portal, direkte Links zu Ihrer Anwendung anzuzeigen.

Antwort

Wenn die Überprüfung abgeschlossen ist und die Anforderung akzeptiert wird, gibt der Vorgang 200 (OK) zurück.

Statuscode: 200 OK

Herunterladen

Ruft Details zu einer HDInsight-Anwendung ab.

Anforderung

Informationen zu Headern und Parametern , die von Clustern verwendet werden, finden Sie unter Allgemeine Parameter und Header.

Methode Anforderungs-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}

Antwort

Antworttext ist ein Array von HDInsight-Anwendungsdetails oder ein einzelnes HDInsight-Anwendungsdetail, wenn applicationName angegeben wird. Im Folgenden finden Sie ein Beispiel für Anwendungsdetails.

Antwortcode: HTTP 200 (OK) bei erfolgreichem Abschluss des Vorgangs.

Beispielantwort:

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

Remove (Entfernen)

Entfernt eine HDInsight-Anwendung aus dem Cluster.

Anforderung

Informationen zu Headern und Parametern , die von Clustern verwendet werden, finden Sie unter Allgemeine Parameter und Header.

Methode Anforderungs-URI
Delete https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Antwort

Der Vorgang gibt 202 (akzeptiert) zurück, wenn die Anforderung erfolgreich abgeschlossen wurde.

Statuscode: 202 Akzeptiert.