Azure HDInsight: API REST

  • Articolo

Azure HDInsight è un servizio di analisi open source, ad ampio spettro e gestito nel cloud, rivolto alle aziende. È possibile usare framework open source, ad esempio Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R e altri. È possibile usare questi framework open source per abilitare un'ampia gamma di scenari, ad esempio estrarre, trasformare e caricare (ETL), data warehousing, Machine Learning e IoT.

Panoramica delle query sulle API

È possibile usare queste API per creare e gestire risorse di HDInsight tramite Azure Resource Manager. Per eseguire operazioni sulle risorse di Azure HDInsight, inviare una richiesta HTTPS con un metodo supportato: GET, POST, PUTo DELETE a un endpoint destinato a una risorsa specifica. Tutte le operazioni attività sono conformi alla specifica del protocollo HTTP/1.1 e ogni operazione restituisce un'intestazione x-ms-request-id che può essere usata per ottenere informazioni sulla richiesta. Assicurarsi che le richieste effettuate per tali risorse siano sicure. Per altre informazioni, vedere Autenticazione delle richieste di Gestione risorse di Azure.

Parametri e intestazioni comuni

Le informazioni seguenti sono comuni a tutte le attività correlate ai cluster che è possibile eseguire:

  • Sostituire {api-version} con 2021-06-01

  • Sostituire {subscription-id} con l'identificatore della sottoscrizione nell'URI.

  • Sostituire {resource-group-name} con il gruppo di risorse. Per altre informazioni, vedere Uso dei gruppi di risorse per gestire le risorse di Azure.

  • Sostituire {cluster-name} con il nome del cluster HDInsight nell'URI.

  • Impostare l'intestazione Content-Type su application/json.

  • Impostare l'intestazione Authorization su un token Web JSON che è possibile ottenere da Azure Active Directory. Per altre informazioni, vedere Autenticazione delle richieste di Gestione risorse di Azure.

Versioni dell'API REST supportate

Nella tabella seguente sono elencate le versioni dell'API REST supportate dal servizio Azure HDInsight. La versione deve essere specificata tramite l'intestazione x-ms-version in ogni richiesta. Se non specificato, il servizio viene predefinito alla versione 2021-06-01più recente.

Versione Modifica introdotta Data di ritiro
2015-03-01-preview Ritiro pianificato 2024-11-30
2018-06-01-preview Ritiro pianificato 2024-11-30
2021-06-01 Nuova versione che aggiunge il supporto per diverse nuove funzionalità dettagliate di seguito

Aggiornamenti nella nuova versione api 2021-06-01

È stata rilasciata una nuova versione dell'API 2021-06-01REST HDInsight. Questa nuova versione sostituisce 2018-06-01-preview la versione che verrà ritirato nel 2024-11-30. Questa nuova versione dell'API aggiunge diverse nuove funzionalità, tra cui zone di disponibilità, collegamento privato e connessioni end-point private. Con l'API più recente 2021-06-01 , tenere presente le nuove funzionalità e le modifiche seguenti.

  1. Aggiunta del supporto per la creazione di cluster con zone di disponibilità.
  2. Aggiunta del supporto per la creazione di cluster con collegamento privato.
  3. Supporto per ottenere risorse di collegamento privato dei cluster HDInsight.
  4. Supporto di ottenere/approvare/rifiutare/eliminare le connessioni endpoint private.
  5. Sarà necessaria una proprietà {location}, in precedenza facoltativa.
  6. Due proprietà esistenti verranno rimosse dall'API Locations, {vmsizes} e {vmsize_filters}. Queste proprietà rimangono in un'altra parte dell'API, BillingSpecs. Si passa a un'unica origine (BillingSpecs) per queste due proprietà.
  7. Due proprietà esistenti verranno rinominate in modo da corrispondere allo stile camelCase.
    1. {cores_used} verrà rinominato in {coresUsed}
    2. {max_cores_allowed} verrà rinominato in {maxCoresAllowed}
    3. {regionName} è stato rinominato in {regionName}

Vedi anche