Application

  • Article

Créer

Crée un nœud sur le cluster (appelé nœud de périphérie) et installe une application sur ce nœud.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode URI de requête
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

L’exemple suivant montre le corps de la demande pour l’installation d’applications sur un cluster HDInsight 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"  
	}  
}
Nom de l'élément Obligatoire Type Description
name Oui String Spécifie le nom de l'application. Le nom doit être spécifié en tant que clusterName/applicationName. Le nom de l’application doit être unique par cluster.
type Oui String Spécifie le type de la ressource.
Propriétés Oui Type complexe Spécifie les propriétés du cluster.

Propriétés

Nom de l'élément Obligatoire Type Description
computeProfile Oui Type complexe Décrit la machine virtuelle sur laquelle l’application s’exécutera
InstallScriptActions Oui Type complexe Décrit les actions de script d’installation pour l’application. Au moins un script doit être spécifié et les scripts doivent être idempotents, ce qui signifie que les scripts peuvent être appelés à plusieurs reprises lors de la production du même résultat.
UninstallScriptActions Non Type complexe Décrit les actions de script de désinstallation pour l’application. Ce paramètre est facultatif, mais toutes les actions de script de désinstallation spécifiées doivent être idempotentes (ce qui signifie que les scripts peuvent être appelés à plusieurs reprises lors de la production du même résultat).
HttpEndpoint Non Type complexe Décrit les points de terminaison de l’application qui doivent être adressables à Internet.
applicationType Oui String Cet élément a toujours la valeur « CustomApplication »

computeProfile

Cet élément doit contenir exactement un rôle

Nom de l'élément Obligatoire Type Description
role Oui Type complexe Spécifie des informations sur les rôles dans le cluster
rôle
Nom de l'élément Obligatoire Type Description
name Oui String Le nom doit être spécifié en tant que « edgenode »
targetInstanceCount Oui Integer Cet élément doit être défini sur 1
hardwareProfile Oui Type complexe Spécifie des informations sur le profil matériel du edgenode
hardwareProfile
Nom de l'élément Obligatoire Type Description
vmSize Oui String Spécifie la taille de la machine virtuelle. Pour connaître les tailles valides, reportez-vous aux options de configuration HDInsight (une fois sur ce lien, faites défiler jusqu’aux niveaux tarifaires de nœud)

InstallScriptActions

Nom de l'élément Obligatoire Type Description
Nom Oui String Spécifie le nom de l’action de script. Doit être unique pour toutes les actions de script persistantes sur le cluster
Uri Oui String Emplacement accessible publiquement du script. Tous les scripts spécifiés doivent être idempotents, ce qui signifie qu’ils peuvent être appelés à plusieurs reprises tout en produisant le même résultat.
Paramètres Non String Ensemble facultatif de paramètres à passer au script
Rôles Oui Tableau de chaînes Décrit le rôle sur lequel le script doit s’exécuter. Les valeurs valides sont : nœud principal, workernode, zookeepernode et edgenode. edgenode est le rôle qui héberge l’application et où votre application s’exécutera.

UninstallScriptActions

Nom de l'élément Obligatoire Type Description
Nom Oui String Spécifie le nom de l’action de script.
Uri Oui String Emplacement accessible publiquement du script. Tous les scripts spécifiés doivent être idempotents, ce qui signifie qu’ils peuvent être appelés à plusieurs reprises tout en produisant le même résultat.
Paramètres Non String Ensemble facultatif de paramètres à passer au script
Rôles Oui Tableau de chaînes Décrit le rôle sur lequel le script doit s’exécuter. Les valeurs valides sont : nœud principal, workernode, zookeepernode et edgenode. edgenode est le rôle qui héberge l’application et où votre application s’exécutera.

HttpEndpoint

Nom de l'élément Obligatoire Type Description
subDomainSuffix Oui String Chaîne alphanumérique de trois caractères utilisée pour générer le nom DNS utilisé pour accéder à l’application. Le nom DNS sera au format : *.apps.azurehdinsight.net. Ce nom doit être unique par cluster.
destinationPort Oui Integer Port vers lequel transférer le trafic HTTP sur le edgenode hébergeant votre application.
accessModes Non Tableau de chaînes Métadonnées relatives au point de terminaison. Si le point de terminaison héberge une page Web, spécifiez page web comme mode d’accès. Sinon, le tableau doit être vide ou ne pas être présent dans la charge utile. Cet élément permet au Portail Azure d’afficher des liens directs vers votre application.

response

Si la validation est terminée et que la demande est acceptée, l’opération retourne 200 (OK).

Code d’état : 200 OK

Obtenir

Obtient des détails sur une application HDInsight.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

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

response

Le corps de la réponse est un tableau de détails d’application HDInsight ou un seul détail d’application HDInsight si applicationName est fourni. Voici un exemple de détails d’application.

Code de réponse : HTTP 200 (OK) en cas de réussite de l’opération.

Exemple de réponse :

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

Supprimer

Supprime une application HDInsight du cluster.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode URI de demande
Suppression https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

response

L’opération retourne la valeur 202 (Acceptée) si la demande est effectuée avec succès

Code d’état : 202 Accepté.