Aplicativo

  • Artigo

Criar

Cria um novo nó no cluster (chamado de nó de borda) e instala um aplicativo nesse nó.

Solicitação

Confira Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método URI da solicitação
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

O exemplo a seguir mostra o corpo da solicitação para instalar aplicativos em um cluster HDInsight baseado em 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 do elemento Obrigatório Type Descrição
name Sim String Especifica o nome do aplicativo. O nome deve ser especificado como clusterName/applicationName. O nome do aplicativo deve ser exclusivo por cluster.
type Sim String Especifica o tipo do recurso.
Propriedades Yes Tipo complexo Especifica as propriedades do cluster.

Propriedades

Nome do elemento Obrigatório Type Descrição
computeProfile Yes Tipo complexo Descreve a VM na qual o aplicativo será executado
InstallScriptActions Sim Tipo complexo Descreve as ações de instalação de script para o aplicativo. Pelo menos um script deve ser especificado e os scripts devem ser idempotentes, o que significa que os scripts podem ser chamados repetidamente enquanto produzem o mesmo resultado.
DesinstalarScriptActions No Tipo complexo Descreve as ações de script de desinstalação para o aplicativo. Esse parâmetro é opcional, mas todas as ações de script de desinstalação especificadas devem ser idempotentes (o que significa que os scripts podem ser chamados repetidamente durante a produção do mesmo resultado).
HttpEndpoint Não Tipo complexo Descreve quais pontos de extremidade no aplicativo devem ser endereçáveis à Internet.
applicationType Sim String Esse elemento é sempre o valor "CustomApplication"

computeProfile

Esse elemento deve conter exatamente uma função

Nome do elemento Obrigatório Type Descrição
role Sim Tipo complexo Especifica informações sobre funções no cluster
função
Nome do elemento Obrigatório Type Descrição
name Sim String O nome deve ser especificado como "edgenode"
targetInstanceCount Sim Integer Esse elemento deve ser definido como 1
hardwareProfile Yes Tipo complexo Especifica informações sobre o perfil de hardware para o nó de borda
hardwareProfile
Nome do elemento Obrigatório Type Descrição
vmSize Sim String Especifica o tamanho da VM. Consulte as opções de configuração do HDInsight (uma vez neste link, role para baixo até os tipos de preço do Nó) para obter tamanhos válidos

InstallScriptActions

Nome do elemento Obrigatório Type Descrição
Nome Sim String Especifica o nome da ação de script. Deve ser exclusivo em todas as ações de script persistentes no cluster
Uri Sim String Local acessível publicamente do script. Todos os scripts especificados devem ser idempotentes, o que significa que os scripts podem ser chamados repetidamente enquanto produzem o mesmo resultado.
Parâmetros Não String Conjunto opcional de parâmetros a serem passados para o script
Funções Yes Matriz de cadeia de caracteres Descreve a função para o script a ser executado. Os valores válidos são: headnode, workernode, zookeepernode e edgenode. edgenode é a função que hospeda o aplicativo e onde seu aplicativo será executado.

UninstallScriptActions

Nome do elemento Obrigatório Type Descrição
Nome Sim String Especifica o nome da ação de script.
Uri Sim String Local acessível publicamente do script. Todos os scripts especificados devem ser idempotentes, o que significa que os scripts podem ser chamados repetidamente enquanto produzem o mesmo resultado.
Parâmetros Não String Conjunto opcional de parâmetros a serem passados para o script
Funções Sim Matriz de cadeia de caracteres Descreve a função para o script a ser executado. Os valores válidos são: headnode, workernode, zookeepernode e edgenode. edgenode é a função que hospeda o aplicativo e onde seu aplicativo será executado.

HttpEndpoint

Nome do elemento Obrigatório Type Descrição
subDomainSuffix Sim String Uma cadeia de caracteres alfanumérica de três caracteres usada para criar o nome DNS usado para acessar o aplicativo. O nome DNS será do formato: *.apps.azurehdinsight.net. Esse nome deve ser exclusivo por cluster.
destinationPort Sim Integer A porta para a qual encaminhar o tráfego HTTP no nó de borda que hospeda seu aplicativo.
accessModes Não Matriz de cadeia de caracteres Metadados sobre o ponto de extremidade. Se o ponto de extremidade hospedar uma página da Web, especifique a página da Web como um modo de acesso. Caso contrário, a matriz deverá estar vazia ou não estar presente no conteúdo. Esse elemento permite que o portal do Azure exiba links diretos para seu aplicativo.

Resposta

Se a validação for concluída e a solicitação for aceita, a operação retornará 200 (OK).

Código de status: 200 OK

Obter

Obtém detalhes sobre um aplicativo HDInsight.

Solicitação

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método URI da solicitação
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Resposta

O corpo da resposta é uma matriz de detalhes do aplicativo HDInsight ou um único detalhe do aplicativo HDInsight se applicationName for fornecido. Veja abaixo um exemplo de detalhes do aplicativo.

Código de resposta: HTTP 200 (OK) após a conclusão bem-sucedida da operação.

Resposta de exemplo:

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

Remover

Remove um aplicativo HDInsight do cluster.

Solicitação

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método URI da solicitação
Delete (excluir) https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Resposta

A operação retornará 202 (Aceito) se a solicitação for concluída com êxito

Código de status: 202 Aceito.