Azure HDInsight: REST API

  • 아티클

Azure HDInsight는 엔터프라이즈용 클라우드의 전체 범위 관리형 오픈 소스 분석 서비스입니다. Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R 등과 같은 오픈 소스 프레임워크를 사용할 수 있습니다. 이러한 오픈 소스 프레임워크를 사용하여 ETL(추출, 변환 및 로드), 데이터 웨어하우징, 기계 학습 및 IoT와 같은 광범위한 시나리오를 사용할 수 있습니다.

API 쿼리 개요

이러한 API를 사용하여 Azure Resource Manager를 통해 HDInsight 리소스를 만들고 관리합니다. Azure HDInsight 리소스에 대한 작업을 수행하려면 지원되는 메서드GET인 , , POSTPUT또는 DELETE 특정 리소스를 대상으로 하는 엔드포인트로 HTTPS 요청을 보냅니다. 모든 작업 작업은 HTTP/1.1 프로토콜 사양을 준수하며 각 작업은 요청에 대한 정보를 가져오는 데 사용할 수 있는 헤더를 반환 x-ms-request-id 합니다. 해당 리소스에 대해 생성된 요청이 안전하도록 합니다. 자세한 내용은 Azure 리소스 관리자 요청 인증을 참조하세요.

공통 매개 변수 및 헤더

다음 정보는 수행할 수 있는 클러스터와 관련된 모든 작업에 공통적으로 적용됩니다.

  • {api-version}을(를) 로 바꾸기 2021-06-01

  • URI에서 {subscription-id}를 구독 식별자로 바꿉니다.

  • {resource-group-name}을 리소스 그룹으로 바꿉니다. 자세한 내용은 리소스 그룹을 사용하여 Azure 리소스 관리(영문)를 참조하세요.

  • {cluster-name}을(를) URI의 HDInsight 클러스터 이름으로 바꿉 있습니다.

  • Content-Type 헤더를 application/json으로 설정합니다.

  • Authorization 헤더를 Azure Active Directory에서 가져온 JSON 웹 토큰으로 설정합니다. 자세한 내용은 Azure 리소스 관리자 요청 인증을 참조하세요.

지원되는 REST API 버전

다음 표에서는 Azure HDInsight 서비스에서 지원되는 REST API 버전을 나열합니다. 버전은 모든 요청의 헤더를 x-ms-version 통해 지정해야 합니다. 지정하지 않으면 서비스는 기본적으로 최신 버전 2021-06-01으로 설정됩니다.

버전 변경 내용 도입 사용 중지 날짜
2015-03-01-preview 2024-11-30 계획된 은퇴
2018-06-01-preview 2024-11-30 계획된 은퇴
2021-06-01 아래에 자세히 설명된 몇 가지 새로운 기능에 대한 지원을 추가하는 새 버전

새 2021-06-01 API 버전에서 업데이트

HDInsight REST API 2021-06-01의 새 버전을 릴리스했습니다. 이 새 버전은 2024-11-30에서 사용 중지되는 버전을 대체 2018-06-01-preview 합니다. 이 새로운 API 버전은 가용성 영역, 프라이빗 링크 및 프라이빗 엔드포인트 연결을 비롯한 몇 가지 새로운 기능을 추가합니다. 최신 2021-06-01 API를 사용하여 다음과 같은 새로운 기능 및 변경 내용을 확인하세요.

  1. 가용성 영역을 사용하여 클러스터를 만들기 위한 지원 추가.
  2. 프라이빗 링크를 사용하여 클러스터를 만들기 위한 지원 추가
  3. HDInsight 클러스터의 프라이빗 링크 리소스 가져오기를 지원합니다.
  4. 프라이빗 엔드포인트 연결 가져오기/승인/거부/삭제를 지원합니다.
  5. 이전에 선택 사항이었던 하나의 속성 {location}이(가) 필요합니다.
  6. 위치 API인 {vmsizes} 및 {vmsize_filters}에서 두 개의 기존 속성이 제거됩니다. 이러한 속성은 API의 다른 부분인 BillingSpecs에 남아 있습니다. 이 두 속성에 대해 단일 원본(BillingSpecs)으로 이동하고 있습니다.
  7. camelCase 스타일과 일치하도록 두 개의 기존 속성 이름이 변경됩니다.
    1. {cores_used}의 이름이 {coresUsed}로 변경됩니다.
    2. {max_cores_allowed}의 이름이 {maxCoresAllowed}로 변경됩니다.
    3. {regionName}의 이름이 {regionName}으로 변경되었습니다.

추가 정보