Program

  • Artikel

Skapa

Skapar en ny nod i klustret (kallas för en gränsnod) och installerar ett program på noden.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod URI för förfrågan
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

I följande exempel visas begärandetexten för att installera program i ett Linux-baserat HDInsight-kluster.

{  
  
	"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"  
	}  
}
Elementnamn Krävs Typ Description
name Ja Sträng Anger namnet på programmet. Namnet måste anges som clusterName/applicationName. Programnamnet måste vara unikt per kluster.
typ Ja Sträng Anger resurstypen.
Egenskaper Yes Komplex typ Anger egenskaperna för klustret.

Egenskaper

Elementnamn Krävs Typ Description
computeProfile Yes Komplex typ Beskriver den virtuella dator som programmet ska köras på
InstallScriptActions Yes Komplex typ Beskriver installation av skriptåtgärder för programmet. Minst ett skript måste anges och skripten måste vara idempotent, vilket innebär att skripten kan anropas upprepade gånger samtidigt som samma resultat skapas.
UninstallScriptActions No Komplex typ Beskriver avinstallationsskriptåtgärderna för programmet. Den här parametern är valfri, men alla angivna avinstallationsskriptåtgärder måste vara idempotent (vilket innebär att skripten kan anropas upprepade gånger samtidigt som samma resultat skapas).
HttpEndpoint No Komplex typ Beskriver vilka slutpunkter i programmet som ska vara Adresserbara på Internet.
applicationType Ja Sträng Det här elementet är alltid värdet "CustomApplication"

computeProfile

Det här elementet ska innehålla exakt en roll

Elementnamn Krävs Typ Description
Roll Yes Komplex typ Anger information om roller i klustret
roll
Elementnamn Krävs Typ Description
name Ja Sträng Namnet måste anges som "edgenode"
targetInstanceCount Yes Integer Det här elementet måste anges till 1
hardwareProfile Yes Komplex typ Anger information om maskinvaruprofilen för edgenode
hardwareProfile
Elementnamn Krävs Typ Description
vmSize Ja Sträng Anger storleken på den virtuella datorn. Se konfigurationsalternativ för HDInsight (en gång på den här länken bläddrar du ned till nodprisnivåer) för giltiga storlekar

InstallScriptActions

Elementnamn Krävs Typ Beskrivning
Name Ja Sträng Anger namnet på skriptåtgärden. Måste vara unikt för alla bestående skriptåtgärder i klustret
Uri Ja Sträng Offentligt tillgänglig plats för skriptet. Alla angivna skript måste vara idempotent, vilket innebär att skripten kan anropas upprepade gånger samtidigt som samma resultat skapas.
Parametrar Inga Sträng Valfri uppsättning parametrar som ska skickas till skriptet
Roller Yes Strängmatris Beskriver vilken roll skriptet ska köras på. Giltiga värden är: headnode, workernode, zookeepernode och edgenode. edgenode är den roll som är värd för programmet och där programmet kommer att köras.

UninstallScriptActions

Elementnamn Krävs Typ Beskrivning
Name Ja Sträng Anger namnet på skriptåtgärden.
Uri Ja Sträng Offentligt tillgänglig plats för skriptet. Alla angivna skript måste vara idempotent, vilket innebär att skripten kan anropas upprepade gånger samtidigt som samma resultat skapas.
Parametrar Inga Sträng Valfri uppsättning parametrar som ska skickas till skriptet
Roller Yes Strängmatris Beskriver vilken roll skriptet ska köras på. Giltiga värden är: headnode, workernode, zookeepernode och edgenode. edgenode är den roll som är värd för programmet och där programmet kommer att köras.

HttpEndpoint

Elementnamn Krävs Typ Description
subDomainSuffix Ja Sträng En alfanumerisk sträng med tre tecken som används för att skapa DNS-namnet som används för att komma åt programmet. DNS-namnet kommer att ha formatet : *.apps.azurehdinsight.net. Det här namnet måste vara unikt per kluster.
destinationPort Yes Integer Porten för att vidarebefordra HTTP-trafik till på den gränsnod som är värd för ditt program.
accessModes No Strängmatris Metadata om slutpunkten. Om slutpunkten är värd för en webbsida anger du webbsidan som ett åtkomstläge. Annars bör matrisen vara tom eller inte finnas i nyttolasten. Med det här elementet kan Azure Portal visa direktlänkar till ditt program.

Svarsåtgärder

Om verifieringen är klar och begäran godkänns returnerar åtgärden 200 (OK).

Statuskod: 200 OK

Hämta

Hämtar information om ett HDInsight-program.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod URI för förfrågan
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Svarsåtgärder

Svarstexten är en matris med HDInsight-programinformation eller en enskild HDInsight-programinformation om applicationName tillhandahålls. Nedan visas ett exempel på programinformation.

Svarskod: HTTP 200 (OK) när åtgärden har slutförts.

Exempelsvar:

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

Ta bort

Tar bort ett HDInsight-program från klustret.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod URI för förfrågan
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Svarsåtgärder

Åtgärden returnerar 202 (accepterad) om begäran har slutförts

Statuskod: 202 Accepterad.