Azure HDInsight: API REST
Azure HDInsight es un servicio de análisis, de código abierto, espectro completo y administrado en la nube para empresas. Puede usar plataformas de código abierto como Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R, etc. Puede usar estos marcos de código abierto para habilitar una amplia gama de escenarios, como extracción, transformación y carga (ETL), almacenamiento de datos, aprendizaje automático e IoT.
Introducción a las consultas de API
Use las API para crear y administrar los recursos de HDInsight mediante Azure Resource Manager. Para realizar operaciones en recursos de Azure HDInsight, envíe una solicitud HTTPS con un método compatible: GET, POST, PUTo DELETE a un punto de conexión destinado a un recurso específico. Todas las operaciones de tareas se ajustan a la especificación del protocolo HTTP/1.1 y cada operación devuelve un x-ms-request-id encabezado que se puede usar para obtener información sobre la solicitud. Asegúrese de que las solicitudes hechas a estos recursos sean seguras. Par obtener más información, consulte Solicitudes de autenticación del Administrador de recursos de Azure.
Parámetros y encabezados comunes
La siguiente información es común a todas las tareas relacionadas con los clústeres que puede hacer:
Reemplace {api-version} por
2021-06-01Reemplace {subscription-id} por su identificador de suscripción en el URI.
Reemplazar {nombre-grupo-recursos} con el grupo de recursos. Para más información, consulte el artículo sobre el uso de grupos de recursos para administrar los recursos de Azure.
Reemplace {cluster-name} por el nombre del clúster de HDInsight en el URI.
Establezca el encabezado Content-Type en application/json.
Define el encabezado Authorization en un token de web JSON que obtenga de Azure Active Directory. Par obtener más información, consulte Solicitudes de autenticación del Administrador de recursos de Azure.
Versiones admitidas de la API REST
En la tabla siguiente se enumeran las versiones admitidas de la API REST por el servicio Azure HDInsight. La versión debe especificarse a través del x-ms-version encabezado en cada solicitud. Si no se especifica, el servicio tiene como valor predeterminado la versión 2021-06-01más reciente.
| Versión | Cambio introducido | Fecha de retirada |
|---|---|---|
2015-03-01-preview |
2024-11-30 retirada planeada | |
2018-06-01-preview |
2024-11-30 retirada planeada | |
2021-06-01 |
Nueva versión que agrega compatibilidad con varias características nuevas que se detallan a continuación |
Novedades en la nueva versión de la API 2021-06-01
Hemos publicado una nueva versión de la API 2021-06-01DE REST de HDInsight. Esta nueva versión reemplaza 2018-06-01-preview la versión que se retirará en 2024-11-30. Esta nueva versión de API agrega varias características nuevas, incluidas las zonas de disponibilidad, el vínculo privado y las conexiones de punto de conexión privados. Con la API más reciente 2021-06-01 , tenga en cuenta las siguientes características y cambios nuevos.
- Adición de compatibilidad para crear clústeres con zonas de disponibilidad.
- Consulte Creación de clústeres con zonas de disponibilidad y para obtener un ejemplo de Rest: Creación de clústeres con zonas de disponibilidad
- Adición de compatibilidad para crear clústeres con private link.
- Compatibilidad con la obtención de recursos de vínculo privado de clústeres de HDInsight.
- Consulte Recursos de Private Link.
- Compatibilidad con conexiones de punto de conexión privado get/approve/reject/delete.
- Consulte Conexiones de punto de conexión privado y para obtener un ejemplo de Rest rest: punto de conexión privado Connections: crear o actualizar.
- Se necesitará una propiedad {location}, anteriormente opcional.
- Se quitarán dos propiedades existentes de la API locations, {vmsizes} y {vmsize_filters}. Estas propiedades permanecen en otra parte de la API, BillingSpecs. Estamos pasando a un único origen (BillingSpecs) para estas dos propiedades.
- Se cambiará el nombre de dos propiedades existentes para que coincidan con el estilo camelCase.
- Se cambiará el nombre de {cores_used} a {coresUsed}
- {max_cores_allowed} se cambiará de nombre a {maxCoresAllowed}
- Se ha cambiado el nombre de {regionName} a {regionName}