Aplikace

  • Článek

Vytvořit

Vytvoří v clusteru nový uzel (označovaný jako hraniční uzel) a nainstaluje na tento uzel aplikaci.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry používané clustery.

Metoda Identifikátor URI žádosti
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Následující příklad ukazuje text požadavku pro instalaci aplikací v clusteru HDInsight se systémem 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"  
	}  
}
Název elementu Požaduje se Typ Description
name Ano Řetězec Určuje název aplikace. Název musí být zadaný jako clusterName/applicationName. Název aplikace musí být jedinečný pro každý cluster.
typ Ano Řetězec Určuje typ prostředku.
Vlastnosti Ano Komplexní typ Určuje vlastnosti clusteru.

Vlastnosti

Název elementu Požaduje se Typ Description
computeProfile Yes Komplexní typ Popisuje virtuální počítač, na který bude aplikace běžet.
InstallScriptActions Ano Komplexní typ Popisuje akce instalačního skriptu pro aplikaci. Musí být zadán aspoň jeden skript a skripty musí být idempotentní, což znamená, že skripty lze volat opakovaně a současně vytvářet stejný výsledek.
UninstallScriptActions No Komplexní typ Popisuje akce skriptu odinstalace pro aplikaci. Tento parametr je nepovinný, ale všechny zadané akce skriptu odinstalace musí být idempotentní (to znamená, že skripty lze volat opakovaně a současně vytvořit stejný výsledek).
HttpEndpoint Ne Komplexní typ Popisuje, které koncové body v aplikaci by měly být adresovatelné z internetu.
typ aplikace Ano Řetězec Tento prvek má vždy hodnotu CustomApplication.

computeProfile

Tento prvek by měl obsahovat přesně jednu roli.

Název elementu Požaduje se Typ Description
Roli Yes Komplexní typ Určuje informace o rolích v clusteru.
role
Název elementu Požaduje se Typ Description
name Ano Řetězec Název musí být zadaný jako edgenode.
targetInstanceCount Ano Integer Tento prvek musí být nastaven na hodnotu 1.
hardwareProfile Ano Komplexní typ Určuje informace o hardwarovém profilu edgenode.
hardwareProfile
Název elementu Požaduje se Typ Description
vmSize Ano Řetězec Určuje velikost virtuálního počítače. Platné velikosti najdete v tématu Možnosti konfigurace SLUŽBY HDInsight (jednou na tomto odkazu se posuňte dolů na Cenové úrovně Node).

InstallScriptActions

Název elementu Požaduje se Typ Popis
Název Ano Řetězec Určuje název akce skriptu. Musí být jedinečný napříč všemi trvalými akcemi skriptů v clusteru.
Uri Ano Řetězec Veřejně přístupné umístění skriptu. Všechny zadané skripty musí být idempotentní, což znamená, že skripty lze volat opakovaně a současně generovat stejný výsledek.
Parametry No Řetězec Volitelná sada parametrů, které se mají předat do skriptu
Role Ano Pole řetězců Popisuje roli pro skript, pro který se má spustit. Platné hodnoty jsou : headnode, workernode, zookeepernode a edgenode. edgeNode je role, která je hostitelem aplikace a kde se bude vaše aplikace spouštět.

UninstallScriptActions

Název elementu Požaduje se Typ Popis
Název Ano Řetězec Určuje název akce skriptu.
Uri Ano Řetězec Veřejně přístupné umístění skriptu. Všechny zadané skripty musí být idempotentní, což znamená, že skripty lze volat opakovaně a současně získáte stejný výsledek.
Parametry No Řetězec Volitelná sada parametrů, které se mají předat do skriptu
Role Yes Pole řetězců Popisuje roli pro skript, pro který se má spustit. Platné hodnoty jsou : headnode, workernode, zookeepernode a edgenode. edgeNode je role, která je hostitelem aplikace a kde se bude vaše aplikace spouštět.

Koncový bod http

Název elementu Požaduje se Typ Description
subDomainSuffix Ano Řetězec Alfanumerický řetězec se třemi znaky, který slouží k vytvoření názvu DNS používaného pro přístup k aplikaci. Název DNS bude ve formátu *.apps.azurehdinsight.net. Tento název musí být jedinečný pro každý cluster.
cílový port Yes Integer Port pro přesměrování provozu HTTP na hraničním uzlu, který je hostitelem vaší aplikace.
accessModes Ne Pole řetězců Metadata o koncovém bodu Pokud koncový bod hostuje webovou stránku, zadejte webovou stránku jako režim přístupu. Jinak by pole mělo být prázdné nebo nemělo být v datové části. Tento prvek umožňuje Azure Portal zobrazit přímé odkazy na vaši aplikaci.

Odpověď

Pokud je ověření dokončeno a požadavek je přijat, operace vrátí hodnotu 200 (OK).

Stavový kód: 200 OK

Získat

Získá podrobnosti o aplikaci HDInsight.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Odpověď

Text odpovědi je pole podrobností o aplikaci HDInsight nebo jeden detail aplikace HDInsight, pokud je zadaný název_aplikace. Níže je příklad podrobností o aplikaci.

Kód odpovědi: HTTP 200 (OK) při úspěšném dokončení operace.

Příklad odpovědi:

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

Odebrat

Odebere aplikaci HDInsight z clusteru.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Odpověď

Operace vrátí hodnotu 202 (přijato), pokud se požadavek úspěšně dokončí.

Stavový kód: 202 Přijato.