Applicazione

Crea

Crea un nuovo nodo nel cluster (denominato nodo perimetrale) e installa un'applicazione in tale nodo.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Nell'esempio seguente viene illustrato il corpo della richiesta per l'installazione di applicazioni in un cluster HDInsight basato su 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"  
	}  
}  
  
Nome dell'elemento Obbligatoria Tipo Descrizione
name string Specifica il nome dell'applicazione. Il nome deve essere specificato come clusterName/applicationName. Il nome dell'applicazione deve essere univoco per ogni cluster.
tipo string Specifica il tipo della risorsa.
Proprietà Tipo complesso Specifica le proprietà del cluster.

Proprietà

Nome dell'elemento Obbligatoria Tipo Descrizione
computeProfile Tipo complesso Descrive la macchina virtuale in cui verrà eseguita l'applicazione
InstallScriptActions Tipo complesso Descrive le azioni di script di installazione per l'applicazione. Almeno uno script deve essere specificato e gli script devono essere idempotenti, il che significa che gli script possono essere chiamati ripetutamente durante la produzione dello stesso risultato.
DisinstallaScriptActions No Tipo complesso Descrive le azioni di script di disinstallazione per l'applicazione. Questo parametro è facoltativo, ma tutte le azioni di script di disinstallazione specificate devono essere idempotenti (ovvero gli script possono essere chiamati ripetutamente durante la produzione dello stesso risultato).
HttpEndpoint No Tipo complesso Descrive quali endpoint nell'applicazione devono essere indirizzi Internet.
applicationType string Questo elemento è sempre valore "CustomApplication"

computeProfile

Questo elemento deve contenere esattamente un ruolo

Nome dell'elemento Obbligatoria Tipo Descrizione
ruolo Tipo complesso Specifica informazioni sui ruoli nel cluster
ruolo
Nome dell'elemento Obbligatoria Tipo Descrizione
name string Il nome deve essere specificato come "edgenode"
targetInstanceCount Integer Questo elemento deve essere impostato su 1
hardwareProfile Tipo complesso Specifica informazioni sul profilo hardware per il nodo perimetrale
hardwareProfile
Nome dell'elemento Obbligatoria Tipo Descrizione
vmSize string Specifica le dimensioni della macchina virtuale. Fare riferimento alle opzioni di configurazione di HDInsight (una volta su questo collegamento, scorrere verso il basso fino ai piani tariffari di Node) per le dimensioni valide

InstallScriptActions

Nome dell'elemento Obbligatoria Tipo Descrizione
Nome string Specifica il nome dell'azione script. Deve essere univoco in tutte le azioni di script persistenti nel cluster
Uri string Posizione accessibile pubblicamente dello script. Tutti gli script specificati devono essere idempotenti, il che significa che gli script possono essere chiamati ripetutamente durante la produzione dello stesso risultato.
Parametri No string Set facoltativo di parametri da passare allo script
Ruoli Matrice di stringhe Descrive il ruolo per l'esecuzione dello script. I valori validi sono: headnode, workernode, zookeepernode e edgenode. edgenode è il ruolo che ospita l'applicazione e dove verrà eseguita l'applicazione.

DisinstallaScriptActions

Nome dell'elemento Obbligatoria Tipo Descrizione
Nome string Specifica il nome dell'azione script.
Uri string Posizione accessibile pubblicamente dello script. Tutti gli script specificati devono essere idempotenti, il che significa che gli script possono essere chiamati ripetutamente durante la produzione dello stesso risultato.
Parametri No string Set facoltativo di parametri da passare allo script
Ruoli Matrice di stringhe Descrive il ruolo per l'esecuzione dello script. I valori validi sono: headnode, workernode, zookeepernode e edgenode. edgenode è il ruolo che ospita l'applicazione e dove verrà eseguita l'applicazione.

HttpEndpoint

Nome dell'elemento Obbligatoria Tipo Descrizione
subDomainSuffix string Stringa alfanumerica a tre caratteri usata per compilare il nome DNS usato per accedere all'applicazione. Il nome DNS sarà del formato : *.apps.azurehdinsight.net. Questo nome deve essere univoco per cluster.
destinationPort Integer Porta per inoltrare il traffico HTTP a sul nodo perimetrale che ospita l'applicazione.
accessModes No Matrice di stringhe Metadati sull'endpoint. Se l'endpoint ospita una pagina Web, specificare la pagina Web come modalità di accesso. In caso contrario, la matrice deve essere vuota o non presente nel payload. Questo elemento consente all'portale di Azure di visualizzare collegamenti diretti all'applicazione.

Risposta

Se la convalida è completata e la richiesta viene accettata, l'operazione restituirà 200 (OK).

Codice di stato: 200 OK

Recupero

Ottiene informazioni dettagliate su un'applicazione HDInsight.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Risposta

Il corpo della risposta è una matrice di dettagli dell'applicazione HDInsight o un singolo dettaglio dell'applicazione HDInsight se viene fornito applicationName. Di seguito è riportato un esempio di dettaglio dell'applicazione.

Codice di risposta: HTTP 200 (OK) al completamento dell'operazione.

Esempio di risposta:

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

Rimuovi

Rimuove un'applicazione HDInsight dal cluster.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Risposta

L'operazione restituirà il 202 (accettato) se la richiesta viene completata correttamente

Codice di stato: 202 Accettato.