Aplicação

Artigo
07/19/2023

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.

Aplicação

Criar

Pedir

Propriedades

computeProfile

role

hardwareProfile

InstallScriptActions

DesinstalarScriptActions

HttpEndpoint

Resposta

Get

Pedir

Resposta

Remover

Pedir

Resposta

Recursos adicionais