Azure HDInsight: REST APIs

O Azure HDInsight é um serviço de análise gerenciado, de espectro completo e de software livre na nuvem para empresas. Você pode usar estruturas de software livre, como Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R e muito mais. Você pode usar essas estruturas de software livre para habilitar uma ampla variedade de cenários, como ETL (extração, transformação e carregamento), data warehouse, aprendizado de máquina 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. Certifique-se de que as solicitações feitas a esses recursos sejam seguras. Para obter mais informações, consulte Autenticando solicitações do Azure Resource Manager.

Parâmetros e cabeçalhos comuns

As informações a seguir são comuns a todas as tarefas relacionadas a clusters que você pode fazer:

• Substitua {api-version} por 2021-06-01

• Substitua {subscription-id} pelo identificador de assinatura no URI.

• Substitua {resource-group-name} pelo grupo de recursos. Para obter mais informações, consulte Usando 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 Authorization como um JSON Web Token obtido do Azure Active Directory. Para obter mais informações, consulte Autenticando solicitações do Azure Resource Manager.

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 será padronizado para a versão 2021-06-01mais recente.

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 2018-06-01-preview versão que será descontinuada em 30/11/2024. Esta 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.

1. Adição de suporte para a criação de clusters com zonas de disponibilidade.
   • Consulte Criação de clusters com zonas de disponibilidade e, para obter um exemplo de Rest , Rest – Criar cluster com zonas de disponibilidade
2. Adição de suporte para a criação de clusters com link privado.
   • Consulte Criação de clusters com link privado
3. Suporte à obtenção de recursos de link privado de clusters HDInsight.
   • Consulte Recursos de link privado
4. Suporte a conexões de ponto de extremidade privado get/approve/reject/delete.
   • Consulte Conexões de ponto de extremidade privado e, para obter um exemplo de Rest , Rest - Conexões de ponto de extremidade privado - Criar ou atualizar
5. Uma propriedade {location}, anteriormente opcional, será obrigatória.
6. Duas propriedades existentes serão removidas da API Locations, {vmsizes} e {vmsize_filters}. Essas propriedades permanecem em outra parte da API, BillingSpecs. Estamos mudando para uma única fonte (BillingSpecs) para essas duas propriedades.
7. Duas propriedades existentes serão renomeadas para corresponder ao estilo camelCase.
   1. {cores_used} será renomeado para {coresUsed}
   2. {max_cores_allowed} será renomeado para {maxCoresAllowed}
   3. {regionName} foi renomeado para {regionName}

Consulte também

• Azure HDInsight

• Criar clusters usando a API REST

• Gerenciar clusters do HDInsight usando a API REST do Apache Ambari

• Azure HDInsight Spark – API REST de envio de trabalho remoto

• Interagir com clusters do HDInsight Kafka no Azure HDInsight usando um proxy REST