Azure HDInsight: REST APIs
O Azure HDInsight é um serviço de análise open source gerido e de espectro completo na cloud para empresas. Pode utilizar arquiteturas open source como o Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R e muito mais. Pode utilizar estas arquiteturas open source para ativar uma vasta gama de cenários, como extração, transformação e carregamento (ETL), armazenamento de dados, machine learning e IoT.
Descrição geral da consulta da API
Utilize estas APIs para criar e gerir recursos HDInsight através do Azure Resource Manager. Para realizar operações nos recursos do Azure HDInsight, envie um pedido HTTPS com um método suportado: GET, POST, PUTou DELETE para um ponto final que visa um recurso específico. Todas as operações de tarefa estão em conformidade com a especificação do protocolo HTTP/1.1 e cada operação devolve um x-ms-request-id cabeçalho que pode ser utilizado para obter informações sobre o pedido. Certifique-se de que os pedidos feitos a estes recursos estão protegidos. Para obter mais informações, veja Authenticating Azure Resource Manager requests (Autenticar pedidos do Azure Resource Manager).
Parâmetros e cabeçalhos comuns
As seguintes informações são comuns a todas as tarefas relacionadas com clusters que pode fazer:
Substituir {api-version} por
2021-06-01Substitua {subscription-id} pelo identificador de subscrição no URI.
Substitua {resource-group-name} pelo grupo de recursos. Para obter mais informações, veja Utilizar Grupos de recursos para gerir os recursos do Azure.
Substitua {cluster-name} pelo nome do cluster do HDInsight no URI.
Defina o cabeçalho Content-Type como application/json.
Defina o cabeçalho Autorização para um Token Web JSON que obtém do Azure Active Directory. Para obter mais informações, veja Authenticating Azure Resource Manager requests (Autenticar pedidos do Azure Resource Manager).
Versões da API REST suportadas
A tabela seguinte lista as versões da API REST suportadas pelo serviço Azure HDInsight. A versão tem de ser especificada através do x-ms-version cabeçalho em cada pedido. Se não for especificado, o serviço é predefinido para a versão 2021-06-01mais recente .
| Versão | Alteração introduzida | Data de descontinuação |
|---|---|---|
2015-03-01-preview |
Reforma planeada para 2024-11-30 | |
2018-06-01-preview |
Reforma planeada para 2024-11-30 | |
2021-06-01 |
Nova versão que adiciona suporte para várias novas funcionalidades detalhadas abaixo |
Atualizações na nova versão da API 2021-06-01
Lançámos uma nova versão da API 2021-06-01REST do HDInsight. Esta nova versão substitui a versão que será descontinuida 2018-06-01-preview em 2024-11-30. Esta nova versão da API adiciona várias novas funcionalidades, incluindo zonas de disponibilidade, ligações privadas e ligações de ponto final privado. Com a API mais recente 2021-06-01 , tenha em atenção as seguintes novas funcionalidades e alterações.
- Adicionar suporte para criar clusters com zonas de disponibilidade.
- Adicionar suporte para criar clusters com ligação privada.
- Suporte para obter recursos de ligação privada de clusters do HDInsight.
- Suporte para obter/aprovar/rejeitar/eliminar ligações de ponto final privado.
- Veja Ligações de ponto final privado e, para obter um exemplo rest rest – Ponto Final Privado Connections – Criar ou Atualizar
- Será necessária uma propriedade {location}, anteriormente opcional.
- Duas propriedades existentes serão removidas da API de Localizações, {vmsizes} e {vmsize_filters}. Estas propriedades permanecem noutra parte da api, BillingSpecs. Estamos a mudar para uma única origem (BillingSpecs) para estas duas propriedades.
- Serão renomeadas duas propriedades existentes para corresponder ao estilo camelCase.
- {cores_used} será mudado para {coresUsed}
- {max_cores_allowed} será mudado para {maxCoresAllowed}
- O nome de {regionName} foi mudado para {regionName}