Azure HDInsight: interfejsy API REST

  • Artykuł

Azure HDInsight to zarządzana, pełna spektrum, usługa analizy typu open source w chmurze dla przedsiębiorstw. Można jej używać z platformami typu „open source”, takimi jak Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R i nie tylko. Za pomocą tych platform typu open source można włączyć szeroką gamę scenariuszy, takich jak wyodrębnianie, przekształcanie i ładowanie (ETL), magazynowanie danych, uczenie maszynowe i IoT.

Omówienie zapytań interfejsu API

Użyj tych interfejsów API do tworzenia i zarządzania zasobami usługi HDInsight za pośrednictwem usługi Azure Resource Manager. Aby wykonać operacje na zasobach usługi Azure HDInsight, należy wysłać żądanie HTTPS z obsługiwaną metodą: GET, , POSTPUTlub DELETE do punktu końcowego przeznaczonego dla określonego zasobu. Wszystkie operacje zadań są zgodne ze specyfikacją x-ms-request-id protokołu HTTP/1.1, a każda operacja zwraca nagłówek, którego można użyć do uzyskania informacji o żądaniu. Upewnij, się że żądania wysyłane do tych zasobów są bezpieczne. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie żądań usługi Azure Resource Manager.

Typowe parametry i nagłówki

Następujące informacje są typowe dla wszystkich zadań związanych z klastrami, które można wykonać:

  • Zastąp ciąg {api-version} ciągiem 2021-06-01

  • Zastąp ciąg {subscription-id} identyfikatorem subskrypcji w identyfikatorze URI.

  • Zastąp ciąg {resource-group-name} grupą zasobów. Aby uzyskać więcej informacji, zobacz Używanie grup zasobów do zarządzania zasobami platformy Azure.

  • Zastąp ciąg {cluster-name} nazwą klastra usługi HDInsight w identyfikatorze URI.

  • Ustaw nagłówek Content-Type na wartość application/json.

  • Ustaw nagłówek Autoryzacja na token internetowy JSON uzyskany z usługi Azure Active Directory. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie żądań usługi Azure Resource Manager.

Obsługiwane wersje interfejsu API REST

W poniższej tabeli wymieniono obsługiwane wersje interfejsu API REST w usłudze Azure HDInsight. Wersja musi być określona za pośrednictwem nagłówka x-ms-version w każdym żądaniu. Jeśli nie zostanie określona, usługa jest domyślnie ustawiona na najnowszą wersję 2021-06-01.

Wersja Wprowadzona zmiana Data wycofania
2015-03-01-preview Planowana emerytura w 2024-11-30
2018-06-01-preview Planowana emerytura w 2024-11-30
2021-06-01 Nowa wersja, która dodaje obsługę kilku nowych funkcji opisanych poniżej

Aktualizacje w nowej wersji interfejsu API 2021-06-01

Opublikowaliśmy nową wersję interfejsu API 2021-06-01REST usługi HDInsight. Ta nowa wersja zastępuje 2018-06-01-preview wersję, która zostanie wycofana w wersji 2024-11-30. Ta nowa wersja interfejsu API dodaje kilka nowych funkcji, w tym strefy dostępności, łącza prywatne i połączenia prywatnego punktu końcowego. W przypadku najnowszego 2021-06-01 interfejsu API zwróć uwagę na następujące nowe funkcje i zmiany.

  1. Dodanie obsługi tworzenia klastrów ze strefami dostępności.
  2. Dodanie obsługi tworzenia klastrów za pomocą łącza prywatnego.
  3. Obsługa pobierania zasobów linków prywatnych klastrów usługi HDInsight.
  4. Obsługa połączeń uzyskiwania/zatwierdzania/odrzucania/usuwania prywatnych punktów końcowych.
  5. Jedna właściwość {location}, wcześniej opcjonalna, będzie wymagana.
  6. Dwie istniejące właściwości zostaną usunięte z interfejsu API lokalizacji, {vmsizes} i {vmsize_filters}. Te właściwości pozostają w innej części interfejsu API, BillingSpecs. Przenosimy się do jednego źródła (BillingSpecs) dla tych dwóch właściwości.
  7. Nazwa dwóch istniejących właściwości zostanie zmieniona w celu dopasowania do stylu camelCase.
    1. Nazwa elementu {cores_used} zostanie zmieniona na {coresUsed}
    2. Nazwa elementu {max_cores_allowed} zostanie zmieniona na {maxCoresAllowed}
    3. Nazwa {regionName} została zmieniona na {regionName}

Zobacz też