Udostępnij przez

Azure HDInsight: interfejsy API REST

Azure HDInsight to zarządzana, kompleksowa usługa analityczna typu open source w chmurze dla przedsiębiorstw. Możesz używać platform typu open source, takich jak Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R i inne. Za pomocą tych struktur typu open source można włączyć szeroki zakres scenariuszy, takich jak wyodrębnianie, przekształcanie i ładowanie (ETL), magazynowanie danych, uczenie maszynowe i IoT.

Omówienie zapytań dotyczących interfejsu API

Te interfejsy API służą do tworzenia zasobów usługi HDInsight i zarządzania nimi za pośrednictwem usługi Azure Resource Manager. Aby wykonać operacje na zasobach usługi Azure HDInsight, należy wysłać żądanie HTTPS przy użyciu obsługiwanej metody: GET, POST, PUT, lub DELETE do punktu końcowego przeznaczonego dla określonego zasobu. Wszystkie operacje zadania są zgodne ze specyfikacją protokołu HTTP/1.1, a x-ms-request-id 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

Poniższe informacje są wspólne dla wszystkich zadań związanych z klastrami, które można wykonać:

  • Zamień {api-version} na 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 Zarządzanie zasobami platformy Azure przy użyciu grup zasobów.

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

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

  • Ustaw nagłówek autoryzacji 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 przez usługę Azure HDInsight. Wersja musi być określona za pomocą nagłówka x-ms-version w każdym żądaniu. Jeśli nie zostanie określony, usługa domyślnie przyjmie najnowszą wersję 2021-06-01.

wersja Wprowadzona zmiana Data wycofania
2015-03-01-preview 2024-11-30 planowane zakończenie kariery
2018-06-01-preview 2024-11-30 planowane zakończenie kariery
2021-06-01 Nowa wersja, która dodaje obsługę kilku nowych funkcji opisanych poniżej

Aktualizacje w nowej wersji API 2021-06-01

Wydaliś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 dniu 2024-11-30. Ta nowa wersja interfejsu API dodaje kilka nowych funkcji, w tym strefy dostępności, łącze prywatne i prywatne połączenia punktu końcowego. W najnowszym 2021-06-01 interfejsie API należy pamiętać o następujących nowych funkcjach i zmianach.

  1. Dodanie obsługi tworzenia klastrów ze strefami dostępności.
  2. Dodanie obsługi tworzenia klastrów za pomocą linku prywatnego.
  3. Obsługa uzyskiwania zasobów łącza prywatnego klastrów usługi HDInsight.
  4. Obsługa pobierania/zatwierdzania/odrzucania/usuwania połączeń prywatnego punktu końcowego.
  5. Jedna właściwość {location}, wcześniej opcjonalna, będzie wymagana.
  6. Dwie istniejące usługi 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. Nazwy dwóch istniejących właściwości zostaną zmienione tak, aby pasowały do stylu camelCase.
    1. Nazwa {cores_used} zostanie zmieniona na {coresUsed}
    2. Nazwa {max_cores_allowed} zostanie zmieniona na {maxCoresAllowed}
    3. Nazwa {regionName} została zmieniona na {regionName}

Zobacz także

  • Last updated on