Compartir a través de

Azure HDInsight: API de REST

Azure HDInsight es un servicio de análisis administrado, de espectro completo y de código abierto en la nube para empresas. Puede usar marcos de código abierto como Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R y más. 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.

Información general sobre las consultas de API

Use estas API para crear y administrar recursos de HDInsight a través de Azure Resource Manager. Para realizar operaciones en recursos de Azure HDInsight, envíe una solicitud HTTPS con un método admitido: GET, POST, PUT, o DELETE a un punto de conexión que tenga como destino un recurso específico. Todas las operaciones de tarea 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 realizadas a estos recursos sean seguras. Para obtener más información, consulte Autenticación de solicitudes de Azure Resource Manager.

Parámetros y encabezados comunes

La siguiente información es común a todas las tareas relacionadas con los clústeres que pueda realizar:

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

  • Reemplace {subscription-id} por el identificador de suscripción en el URI.

  • Reemplace {resource-group-name} por el grupo de recursos. Para obtener más información, consulte 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.

  • Establezca el encabezado Authorization en un token web JSON que obtenga de Azure Active Directory. Para obtener más información, consulte Autenticación de solicitudes de Azure Resource Manager.

Versiones de API de REST admitidas

En la tabla siguiente se enumeran las versiones de API de REST admitidas 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 jubilación planificada
2018-06-01-preview 2024-11-30 jubilación planificada
2021-06-01 Nueva versión que agrega soporte para varias características nuevas que se detallan a continuación

Actualizaciones 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 a 2018-06-01-preview la versión que se retirará el 30/11/2024. Esta nueva versión de la API agrega varias características nuevas, incluidas zonas de disponibilidad, vínculos privados y conexiones de punto final privadas. Con la API más reciente 2021-06-01 , tenga en cuenta las siguientes características y cambios nuevos.

  1. Agregar compatibilidad para crear clústeres con zonas de disponibilidad.
  2. Se ha agregado compatibilidad para crear clústeres con Private Link.
  3. Compatibilidad con la obtención de recursos de vínculos privados de clústeres de HDInsight.
  4. Admite conexiones de punto de conexión privado de obtención/aprobación/rechazo/eliminación.
  5. Se requerirá una propiedad {location}, que antes era opcional.
  6. Se quitarán dos propiedades existentes de la API de ubicaciones, {vmsizes} y {vmsize_filters}. Estas propiedades permanecen en otra parte de la API, BillingSpecs. Nos estamos moviendo a una sola fuente (BillingSpecs) para estas dos propiedades.
  7. Se cambiará el nombre de dos propiedades existentes para que coincidan con el estilo camelCase.
    1. {cores_used} se renombrará a {coresUsed}
    2. {max_cores_allowed} pasará a llamarse {maxCoresAllowed}
    3. {regionName} ha sido renombrado a {regionName}

Consulte también

  • Last updated on