Applicazione
Crea un nuovo nodo nel cluster (denominato nodo perimetrale) e installa un'applicazione in tale nodo.
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 | Sì | 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 | Sì | string | Specifica il tipo della risorsa. |
Proprietà | Sì | Tipo complesso | Specifica le proprietà del cluster. |
Nome dell'elemento | Obbligatoria | Tipo | Descrizione |
---|---|---|---|
computeProfile | Sì | Tipo complesso | Descrive la macchina virtuale in cui verrà eseguita l'applicazione |
InstallScriptActions | Sì | 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 | Sì | string | Questo elemento è sempre valore "CustomApplication" |
Questo elemento deve contenere esattamente un ruolo
Nome dell'elemento | Obbligatoria | Tipo | Descrizione |
---|---|---|---|
ruolo | Sì | Tipo complesso | Specifica informazioni sui ruoli nel cluster |
Nome dell'elemento | Obbligatoria | Tipo | Descrizione |
---|---|---|---|
name | Sì | string | Il nome deve essere specificato come "edgenode" |
targetInstanceCount | Sì | Integer | Questo elemento deve essere impostato su 1 |
hardwareProfile | Sì | Tipo complesso | Specifica informazioni sul profilo hardware per il nodo perimetrale |
Nome dell'elemento | Obbligatoria | Tipo | Descrizione |
---|---|---|---|
vmSize | Sì | 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 |
Nome dell'elemento | Obbligatoria | Tipo | Descrizione |
---|---|---|---|
Nome | Sì | string | Specifica il nome dell'azione script. Deve essere univoco in tutte le azioni di script persistenti nel cluster |
Uri | Sì | 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 | Sì | 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. |
Nome dell'elemento | Obbligatoria | Tipo | Descrizione |
---|---|---|---|
Nome | Sì | string | Specifica il nome dell'azione script. |
Uri | Sì | 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 | Sì | 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. |
Nome dell'elemento | Obbligatoria | Tipo | Descrizione |
---|---|---|---|
subDomainSuffix | Sì | 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 | Sì | 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. |
Se la convalida è completata e la richiesta viene accettata, l'operazione restituirà 200 (OK).
Codice di stato: 200 OK
Ottiene informazioni dettagliate su un'applicazione HDInsight.
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} |
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"
}
]
}
Rimuove un'applicazione HDInsight dal cluster.
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} |
L'operazione restituirà il 202 (accettato) se la richiesta viene completata correttamente
Codice di stato: 202 Accettato.