Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Criar
Cria um novo nó no cluster (conhecido como nó de borda) e instala um aplicativo nesse nó.
Solicitação
Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.
| Método | URI de solicitação |
|---|---|
| COLOCAR | 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"
}
}
Propriedades
| Nome do elemento | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Perfil de computação | Yes | Tipo complexo | Descreve a VM em que o aplicativo será executado |
| InstallScriptActions | Yes | Tipo complexo | Descreve as ações de script de instalação 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. |
| UninstallScriptActions | Não | Tipo complexo | Descreve as ações de script de desinstalação do 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 enquanto produzem o mesmo resultado). |
| HttpEndpoint | Não | Tipo complexo | Descreve quais pontos de extremidade no aplicativo devem ser endereçáveis pela Internet. |
| applicationType | Yes | fio | Esse elemento é sempre o valor "CustomApplication" |
Perfil de computação
Esse elemento deve conter exatamente uma função
| Nome do elemento | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| função | Yes | Tipo complexo | Especifica informações sobre funções no cluster |
função
| Nome do elemento | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| nome | Yes | fio | O nome deve ser especificado como "edgenode" |
| targetInstanceCount | Yes | Número Inteiro | Este elemento deve ser definido como 1 |
| hardwareProfile | Yes | Tipo complexo | Especifica informações sobre o perfil de hardware para o edgenode |
hardwareProfile
| Nome do elemento | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| vmSize | Yes | fio | Especifica o tamanho da VM. Consulte as opções de configuração do HDInsight (uma vez neste link, role para baixo até Tipos de preço do nó) para obter tamanhos válidos |
InstallScriptActions
| Nome do elemento | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Nome | Yes | fio | Especifica o nome da ação de script. Deve ser exclusivo em todas as ações de script persistentes no cluster |
| Uri | Yes | fio | 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 | fio | Conjunto opcional de parâmetros a serem passados para o script |
| Funções | Yes | Matriz de cadeias de caracteres | Descreve a função para o script 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 | Tipo | Descrição |
|---|---|---|---|
| Nome | Yes | fio | Especifica o nome da ação de script. |
| Uri | Yes | fio | 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 | fio | Conjunto opcional de parâmetros a serem passados para o script |
| Funções | Yes | Matriz de cadeias de caracteres | Descreve a função para o script 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 | Tipo | Descrição |
|---|---|---|---|
| subDomainSuffix | Yes | fio | Uma cadeia de caracteres alfanumérica de três caracteres usada para criar o nome DNS usado para acessar o aplicativo. O nome DNS terá o formato: *.apps.azurehdinsight.net. Esse nome deve ser exclusivo por cluster. |
| destinationPort | Yes | Número Inteiro | A porta para encaminhar o tráfego HTTP no edgenode que hospeda seu aplicativo. |
| accessModes | Não | Matriz de cadeias 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 deve estar vazia ou não estar presente na carga. 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 de 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. Abaixo está um exemplo de detalhes da aplicação.
Código de resposta: HTTP 200 (OK) na 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"
}
]
}
Retirar
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 de solicitação |
|---|---|
| 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 retornará 202 (Aceito) se a solicitação for concluída com êxito
Código de status: 202 Aceito.