Application
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é.