Partilhar via


Aplicação

Criar

Cria um novo nó no cluster (referido como um nó edge) e instala uma aplicação nesse nó.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método URI do pedido
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 seguinte mostra o corpo do pedido para instalar aplicações num cluster do 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 Necessário Tipo Descrição
name Sim String Especifica o nome da aplicação. O nome tem de ser especificado como clusterName/applicationName. O nome da aplicação tem de ser exclusivo por cluster.
tipo Sim String Especifica o tipo de recurso.
Propriedades Yes Tipo Complexo Especifica as propriedades do cluster.

Propriedades

Nome do elemento Necessário Tipo Description
computeProfile Yes Tipo Complexo Descreve a VM em que a aplicação será executada
InstallScriptActions Yes Tipo Complexo Descreve as ações de script de instalação da aplicação. Tem de especificar pelo menos um script e os scripts têm de 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 desinstalação do script para a aplicação. Este parâmetro é opcional, mas quaisquer ações de script de desinstalação especificadas têm de ser idempotentes (o que significa que os scripts podem ser chamados repetidamente enquanto produzem o mesmo resultado).
HttpEndpoint No Tipo Complexo Descreve os pontos finais na aplicação que devem ser endereçáveis pela Internet.
applicationType Sim String Este elemento é sempre o valor "CustomApplication"

computeProfile

Este elemento deve conter exatamente uma função

Nome do elemento Necessário Tipo Description
função Yes Tipo Complexo Especifica informações sobre funções no cluster
role
Nome do elemento Necessário Tipo Descrição
name Sim String O nome tem de ser especificado como "edgenode"
targetInstanceCount Yes Número inteiro Este elemento tem de ser definido como 1
hardwareProfile Yes Tipo Complexo Especifica informações sobre o perfil de hardware do edgenode
hardwareProfile
Nome do elemento Necessário Tipo Description
vmSize Sim String Especifica o tamanho da VM. Veja opções de configuração do HDInsight (uma vez nesta ligação, desloque-se para baixo até escalões de preço do Nó) para obter tamanhos válidos

InstallScriptActions

Nome do elemento Necessário Tipo Descrição
Nome Sim String Especifica o nome da ação de script. Tem de ser exclusivo em todas as ações de script persistentes no cluster
URI Sim String Localização acessível publicamente do script. Todos os scripts especificados têm de 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 transmitir para o script
Funções Yes Matriz de Cadeias Descreve a função para o script ser executado. Os valores válidos são: nó principal, workernode, zookeepernode e edgenode. edgenode é a função que aloja a aplicação e onde a sua aplicação será executada.

DesinstalarScriptActions

Nome do elemento Necessário Tipo Descrição
Nome Sim String Especifica o nome da ação de script.
URI Sim String Localização acessível publicamente do script. Todos os scripts especificados têm de 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 transmitir para o script
Funções Yes Matriz de Cadeias Descreve a função para o script ser executado. Os valores válidos são: nó principal, workernode, zookeepernode e edgenode. edgenode é a função que aloja a aplicação e onde a sua aplicação será executada.

HttpEndpoint

Nome do elemento Necessário Tipo Description
subDomainSuffix Sim String Uma cadeia alfanumérica de três carateres utilizada para criar o nome DNS utilizado para aceder à aplicação. O nome DNS será do formato : *.apps.azurehdinsight.net. Este nome tem de ser exclusivo por cluster.
destinationPort Yes Número inteiro A porta para reencaminhar o tráfego HTTP para o no nó edge que aloja a sua aplicação.
accessModes No Matriz de Cadeias Metadados sobre o ponto final. Se o ponto final alojar uma página Web, especifique a página Web como um modo de acesso. Caso contrário, a matriz deve estar vazia ou não estar presente no payload. Este elemento permite que o portal do Azure apresente ligações diretas para a sua aplicação.

Resposta

Se a validação estiver concluída e o pedido for aceite, a operação devolverá 200 (OK).

Código de estado: 200 OK

Get

Obtém detalhes sobre uma aplicação do HDInsight.

Pedir

Veja Common parameters and headers for headers and parameters that are used by clusters ( Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros utilizados por clusters).

Método URI do pedido
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 da aplicação HDInsight ou um único detalhe da aplicação HDInsight se for fornecido applicationName. Segue-se um exemplo de detalhes da aplicação.

Código de resposta: HTTP 200 (OK) após a conclusão da operação com êxito.

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 uma aplicação do HDInsight do cluster.

Pedir

Veja Common parameters and headers for headers and parameters that are used by clusters ( Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros utilizados por clusters).

Método URI do pedido
DELETE 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 devolverá 202 (Aceite) se o pedido for concluído com êxito

Código de estado: 202 Aceite.