Azure HDInsight 는 엔터프라이즈용 클라우드의 관리형 전체 스펙트럼 오픈 소스 분석 서비스입니다. Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R 등과 같은 오픈 소스 프레임워크를 사용할 수 있습니다. 이러한 오픈 소스 프레임워크를 사용하여 ETL(추출, 변환 및 로드), 데이터 웨어하우징, 기계 학습 및 IoT와 같은 광범위한 시나리오를 사용하도록 설정할 수 있습니다.
API 쿼리 개요
이러한 API를 사용하여 Azure Resource Manager를 통해 HDInsight 리소스를 만들고 관리합니다. Azure HDInsight 리소스에 대한 작업을 수행하려면 지원되는 메서드( GET, POST, PUT또는 특정 DELETE 리소스를 대상으로 하는 엔드포인트)를 사용하여 HTTPS 요청을 보냅니다. 모든 작업 작업은 HTTP/1.1 프로토콜 사양을 준수하며 각 작업은 요청에 대한 정보를 가져오는 데 사용할 수 있는 헤더를 반환 x-ms-request-id 합니다. 이러한 리소스에 대한 요청이 안전한지 확인합니다. 자세한 내용은 Azure Resource Manager 요청 인증을 참조하세요.
일반적인 매개 변수 및 헤더
다음 정보는 수행할 수 있는 클러스터와 관련된 모든 작업에 공통적입니다.
{api-version}을
2021-06-01{subscription-id}를 URI의 구독 식별자로 바꿉니다.
{resource-group-name}을 리소스 그룹으로 바꿉니다. 자세한 내용은 리소스 그룹을 사용하여 Azure 리소스 관리를 참조하세요.
URI에서 {cluster-name}을 HDInsight 클러스터 이름으로 바꿉니다.
Content-Type 헤더를 application/json으로 설정합니다.
권한 부여 헤더를 Azure Active Directory에서 가져오는 JSON 웹 토큰으로 설정합니다. 자세한 내용은 Azure Resource Manager 요청 인증을 참조하세요.
지원되는 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에서는 다음과 같은 새로운 기능 및 변경 사항에 유의하십시오.
- 가용성 영역이 있는 클러스터 생성에 대한 지원을 추가합니다.
- private link를 사용하여 클러스터를 만들기 위한 지원을 추가합니다.
- HDInsight 클러스터의 프라이빗 링크 리소스 가져오기를 지원합니다.
- 프라이빗 엔드포인트 연결 가져오기/승인/거부/삭제를 지원합니다.
- 프라이빗 엔드포인트 연결 및 나머지 예제 Rest - 프라이빗 엔드포인트 연결 - 만들기 또는 업데이트를 참조하세요.
- 이전에는 선택 사항이었던 속성 {location} 하나가 필요합니다.
- 두 개의 기존 속성인 {vmsizes} 및 {vmsize_filters}이 위치 API에서 제거됩니다. 이러한 속성은 API의 다른 부분인 BillingSpecs에 남아 있습니다. 이 두 속성에 대해 단일 소스(BillingSpecs)로 이동하고 있습니다.
- 두 개의 기존 속성이 camelCase 스타일과 일치하도록 이름이 바뀝니다.
- {cores_used}의 이름이 {coresUsed}로 바뀝니다.
- {max_cores_allowed}의 이름이 {maxCoresAllowed}로 바뀝니다.
- {regionName}의 이름이 {regionName}으로 변경되었습니다.