Azure HDInsight: REST APIs
O Azure HDInsight é um serviço de análise totalmente gerenciado, completo e open-source na nuvem para empresas. Você pode usar estruturas de software livre como Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R e outros. Você pode usar essas estruturas de software livre para habilitar uma ampla gama de cenários, como ETL (extração, transformação e carregamento), data warehousing, machine learning e IoT.
Visão geral da consulta de API
Use essas APIs para criar e gerenciar recursos do HDInsight por meio do Azure Resource Manager. Para executar operações em recursos do Azure HDInsight, envie uma solicitação HTTPS com um método com suporte: GET, POST, PUTou DELETE para um ponto de extremidade direcionado a 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 retorna um x-ms-request-id cabeçalho que pode ser usado para obter informações sobre a solicitação. Verifique se as solicitações feitas a esses recursos são seguras. Para mais informações, consulte Autenticação de solicitações do Gerenciador de Recursos do Azure.
Parâmetros e cabeçalhos comuns
As seguintes informações são comuns a todas as tarefas relacionadas a clusters que você pode fazer:
Substituir {api-version} por
2021-06-01Substitua {subscription-id} pelo identificador de sua assinatura no URI.
Substitua {resource-group-name} pelo grupo de recursos. Para obter mais informações, consulte Usando os grupos de recursos para gerenciar seus recursos do Azure.
Substitua {cluster-name} pelo nome do cluster HDInsight no URI.
Defina o cabeçalho Content-Type como application/json.
Defina o cabeçalho de Autorização para um JSON Web Token que você obtém do Active Directory do Azure. Para mais informações, consulte Autenticação de solicitações do Gerenciador de Recursos do Azure.
Versões da API REST com suporte
A tabela a seguir lista as versões da API REST com suporte pelo serviço Azure HDInsight. A versão deve ser especificada por meio do x-ms-version cabeçalho em cada solicitação. Se não for especificado, o serviço usará como padrão a versão 2021-06-01mais recente.
| Versão | Alteração introduzida | Data de baixa |
|---|---|---|
2015-03-01-preview |
Aposentadoria planejada de 2024-11-30 | |
2018-06-01-preview |
Aposentadoria planejada de 2024-11-30 | |
2021-06-01 |
Nova versão que adiciona suporte para vários novos recursos detalhados abaixo |
Atualizações na nova versão da API 2021-06-01
Lançamos uma nova versão da API 2021-06-01REST do HDInsight. Esta nova versão substitui a versão que será desativada 2018-06-01-preview em 2024-11-30. Essa nova versão da API adiciona vários novos recursos, incluindo zonas de disponibilidade, link privado e conexões de ponto de extremidade privado. Com a API mais recente 2021-06-01 , observe os novos recursos e alterações a seguir.
- Adicionando suporte para criar clusters com zonas de disponibilidade.
- Consulte Criando clusters com zonas de disponibilidade e para um exemplo rest rest – Criar cluster com zonas de disponibilidade
- Adicionando suporte para a criação de clusters com link privado.
- Consulte Criando clusters com link privado
- Suporte para obter recursos de link privado de clusters HDInsight.
- Confira Recursos de link privado
- Suporte a conexões de ponto de extremidade privado get/approve/reject/delete.
- Confira Conexões de ponto de extremidade privado e, para obter um exemplo de Rest, Rest – Connections de ponto de extremidade privado – Criar ou atualizar
- Uma propriedade {location}, anteriormente opcional, será necessária.
- Duas propriedades existentes serão removidas da API locations, {vmsizes} e {vmsize_filters}. Essas propriedades permanecem em outra parte da API, BillingSpecs. Estamos migrando para uma única origem (BillingSpecs) para essas duas propriedades.
- Duas propriedades existentes serão renomeada para corresponder ao estilo camelCase.
- {cores_used} será renomeado para {coresUsed}
- {max_cores_allowed} será renomeado para {maxCoresAllowed}
- {regionName} foi renomeado para {regionName}