Share via

Toepassing

  • Artikel

Maken

Hiermee maakt u een nieuw knooppunt in het cluster (ook wel een edge-knooppunt genoemd) en installeert u een toepassing op dat knooppunt.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

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

In het volgende voorbeeld ziet u de aanvraagbody voor het installeren van toepassingen op een HDInsight-cluster op basis van Linux.

{  
  
	"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"  
	}  
}
Elementnaam Vereist Type Beschrijving
naam Ja Tekenreeks Hiermee geeft u de naam van de toepassing. De naam moet worden opgegeven als clusterName/applicationName. De toepassingsnaam moet uniek zijn per cluster.
type Ja Tekenreeks Hiermee geeft u het type van de resource op.
Eigenschappen Ja Complex Type Hiermee geeft u de eigenschappen van het cluster op.

Eigenschappen

Elementnaam Vereist Type Beschrijving
computeProfile Ja Complex Type Beschrijft de VM waarop de toepassing wordt uitgevoerd
InstallScriptActions Ja Complex Type Hierin worden de scriptacties voor de toepassing geïnstalleerd. Er moet ten minste één script worden opgegeven en de scripts moeten idempotent zijn, wat betekent dat de scripts herhaaldelijk kunnen worden aangeroepen terwijl hetzelfde resultaat wordt geproduceerd.
UninstallScriptActions Nee Complex Type Beschrijft de scriptacties voor het verwijderen van de toepassing. Deze parameter is optioneel, maar alle opgegeven acties voor het verwijderen van scripts moeten idempotent zijn (wat betekent dat de scripts herhaaldelijk kunnen worden aangeroepen terwijl hetzelfde resultaat wordt geproduceerd).
HttpEndpoint Nee Complex Type Hierin wordt beschreven welke eindpunten in de toepassing internetadressen moeten hebben.
applicationType Ja Tekenreeks Dit element is altijd de waarde CustomApplication

computeProfile

Dit element moet precies één rol bevatten

Elementnaam Vereist Type Beschrijving
Role Ja Complex Type Hiermee geeft u informatie op over rollen in het cluster
role
Elementnaam Vereist Type Beschrijving
naam Ja Tekenreeks De naam moet worden opgegeven als 'edgenode'
targetInstanceCount Ja Geheel getal Dit element moet worden ingesteld op 1
hardwareProfile Ja Complex Type Hiermee geeft u informatie op over het hardwareprofiel voor het edgenode
hardwareProfile
Elementnaam Vereist Type Beschrijving
vmSize Ja Tekenreeks Hiermee geeft u de grootte van de VM op. Raadpleeg HDInsight-configuratieopties (schuif eenmaal op deze koppeling omlaag naar Knooppunt-prijscategorieën) voor geldige grootten

InstallScriptActions

Elementnaam Vereist Type Beschrijving
Naam Ja Tekenreeks Hiermee geeft u de naam van de scriptactie. Moet uniek zijn voor alle persistente scriptacties in het cluster
Uri Ja Tekenreeks Openbaar toegankelijke locatie van het script. Alle opgegeven scripts moeten idempotent zijn, wat betekent dat de scripts herhaaldelijk kunnen worden aangeroepen terwijl hetzelfde resultaat wordt geproduceerd.
Parameters Nee Tekenreeks Optionele set parameters die moeten worden doorgegeven aan het script
Rollen Ja Matrix van tekenreeksen Beschrijft de rol voor het script waarop moet worden uitgevoerd. Geldige waarden zijn: headnode, workernode, zookeepernode en edgenode. edgenode is de rol die als host fungeert voor de toepassing en waar uw toepassing wordt uitgevoerd.

UninstallScriptActions

Elementnaam Vereist Type Beschrijving
Naam Ja Tekenreeks Hiermee geeft u de naam van de scriptactie.
Uri Ja Tekenreeks Openbaar toegankelijke locatie van het script. Opgegeven scripts moeten idempotent zijn, wat betekent dat de scripts herhaaldelijk kunnen worden aangeroepen terwijl hetzelfde resultaat wordt geproduceerd.
Parameters Nee Tekenreeks Optionele set parameters die moeten worden doorgegeven aan het script
Rollen Ja Matrix van tekenreeksen Beschrijft de rol voor het script waarop moet worden uitgevoerd. Geldige waarden zijn: headnode, workernode, zookeepernode en edgenode. edgenode is de rol die als host fungeert voor de toepassing en waar uw toepassing wordt uitgevoerd.

HttpEndpoint

Elementnaam Vereist Type Beschrijving
subDomainSuffix Ja Tekenreeks Een alfanumerieke tekenreeks van drie tekens die wordt gebruikt om de DNS-naam te bouwen die wordt gebruikt voor toegang tot de toepassing. De DNS-naam heeft de volgende indeling: *.apps.azurehdinsight.net. Deze naam moet uniek zijn per cluster.
destinationPort Ja Geheel getal De poort voor het doorsturen van HTTP-verkeer naar het edgenode dat als host fungeert voor uw toepassing.
accessModes Nee Matrix van tekenreeksen Metagegevens over het eindpunt. Als het eindpunt als host fungeert voor een webpagina, geeft u webpagina op als toegangsmodus. Anders moet de matrix leeg zijn of niet aanwezig zijn in de nettolading. Met dit element kan de Azure Portal directe koppelingen naar uw toepassing weergeven.

Antwoord

Als de validatie is voltooid en de aanvraag wordt geaccepteerd, retourneert de bewerking 200 (OK).

Statuscode: 200 OK

Ophalen

Hiermee haalt u details op over een HDInsight-toepassing.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

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

Antwoord

Antwoordtekst is een matrix met HDInsight-toepassingsdetails of één HDInsight-toepassingsdetail als applicationName wordt opgegeven. Hieronder ziet u een voorbeeld van toepassingsdetails.

Antwoordcode: HTTP 200 (OK) na voltooiing van de bewerking.

Voorbeeld van een reactie:

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

Verwijderen

Hiermee verwijdert u een HDInsight-toepassing uit het cluster.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

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

Antwoord

De bewerking retourneert 202 (geaccepteerd) als de aanvraag is voltooid

Statuscode: 202 Geaccepteerd.