Udostępnij przez

Zarządzanie profilami wersji interfejsu API w usłudze Azure Stack Hub

Profile interfejsu API określają dostawcę zasobów platformy Azure i wersję interfejsu API dla punktów końcowych REST platformy Azure. Klientów niestandardowych można tworzyć w różnych językach przy użyciu profilów interfejsu API. Każdy klient używa profilu interfejsu API do kontaktu z właściwym dostawcą zasobów i wersją interfejsu API dla usługi Azure Stack Hub.

Aplikację można utworzyć do pracy z dostawcami zasobów platformy Azure bez konieczności znajomości dokładnie, która wersja interfejsu API dostawcy zasobów jest zgodna z usługą Azure Stack Hub. Wystarczy dopasować aplikację do profilu, a SDK dopasuje się do poprawnej wersji API.

Temat ten pomoże Ci:

  • Omówienie profilów interfejsów API dla usługi Azure Stack Hub.
  • Dowiedz się, jak tworzyć rozwiązania przy użyciu profilów interfejsu API.
  • Zobacz, gdzie znaleźć wskazówki specyficzne dla kodu.

Podsumowanie profilów interfejsu API

  • Profile interfejsu API służą do reprezentowania zestawu dostawców zasobów platformy Azure i ich wersji interfejsu API.
  • Profile interfejsów API zostały utworzone, aby tworzyć szablony w wielu chmurach platformy Azure. Profile zapewniają zgodny i stabilny interfejs.
  • Profile są wydawane cztery razy w roku.
  • Używane są trzy konwencje nazewnictwa profilów:
    • najnowszy
      Zawiera najnowsze wersje interfejsu API wydane na globalnej platformie Azure.
    • rrrr-mm-dd-hybrydowy
      Wydana co roku wersja ta koncentruje się na spójności i stabilności w wielu chmurach. Ten profil ma na celu zapewnienie optymalnej zgodności z Azure Stack Hub.
    • yy-mm-dd-profile
      Równoważy optymalną stabilność i najnowsze funkcje.

Profile interfejsu API platformy Azure i zgodność z usługą Azure Stack Hub

Najnowsze profile interfejsu API platformy Azure nie są zgodne z usługą Azure Stack Hub. Użyj następujących konwencji nazewnictwa, aby zidentyfikować, które profile mają być używane dla rozwiązań usługi Azure Stack Hub:

najnowszy
Ten profil ma najbardziej aktualne wersje interfejsu API znajdujące się na globalnej platformie Azure, które nie działają w usłudze Azure Stack Hub. Najnowsza wersja ma największą liczbę zmian, które powodują niezgodność. Profil odkłada na bok stabilność i zgodność z innymi chmurami. Jeśli próbujesz użyć najbardziej up-towersji interfejsu API daty, najnowszą wersją jest profil, którego należy użyć.

Yyyy-mm-dd-hybrydowy
Ten profil jest udostępniany w marcu i wrześniu każdego roku. Zapewnia optymalną stabilność i zgodność z różnymi chmurami i jest przeznaczony dla globalnej platformy Azure i usługi Azure Stack Hub. Wersje interfejsu API platformy Azure wymienione w tym profilu będą takie same jak te wymienione w usłudze Azure Stack Hub. Ten profil służy do tworzenia kodu dla rozwiązań w chmurze hybrydowej.

yy-mm-dd-profile
Ten profil jest udostępniany dla globalnej platformy Azure w czerwcu i grudniu. Nie działa z usługą Azure Stack Hub i zwykle występuje wiele zmian powodujących awarie. Mimo że równoważy optymalną stabilność i najnowsze funkcje, różnica między najnowszym i tym profilem polega na tym, że najnowsza wersja zawsze składa się z najnowszych wersji interfejsu API, niezależnie od tego, kiedy interfejs API zostanie wydany. Na przykład, jeśli jutro zostanie utworzona nowa wersja interfejsu API dla API obliczeniowego, ta wersja zostanie umieszczona w najnowszych, ale nie w profilu yyyy-mm-dd-profile, ponieważ ten profil już istnieje. yyyy-mm-dd-profile obejmuje najnowsze up-to-date wersje wydane przed czerwcem lub przed grudniem.

Profile interfejsu API usługi Azure Resource Manager

Usługa Azure Stack Hub nie używa najnowszej wersji interfejsu API znalezionych na globalnej platformie Azure. Podczas tworzenia rozwiązania należy znaleźć wersję interfejsu API dla każdego dostawcy zasobów platformy Azure zgodnego z usługą Azure Stack Hub.

Zamiast badać każdego dostawcę zasobów i określoną wersję obsługiwaną przez usługę Azure Stack Hub, możesz użyć profilu interfejsu API. Profil określa zestaw dostawców zasobów i wersji interfejsu API. Zestaw SDK lub narzędzie utworzone za pomocą zestawu SDK powróci do elementu docelowego api-version określonego w profilu. Za pomocą profilów interfejsu API można określić wersję profilu, która ma zastosowanie do całego szablonu. W czasie wykonywania usługa Azure Resource Manager wybiera odpowiednią wersję zasobu.

Profile interfejsu API działają z narzędziami korzystającymi z usługi Azure Resource Manager, takich jak program PowerShell, interfejs wiersza polecenia platformy Azure, kod podany w zestawie SDK i program Microsoft Visual Studio. Narzędzia i zestawy SDK mogą używać profilów do odczytywania wersji modułów i bibliotek do uwzględnienia podczas kompilowania aplikacji.

Jeśli na przykład używasz programu PowerShell do tworzenia konta magazynu przy użyciu dostawcy zasobów Microsoft.Storage, który obsługuje interfejs API w wersji 2016-03-30, oraz maszyny wirtualnej przy użyciu dostawcy zasobów Microsoft.Compute z interfejsem API w wersji 2015-12-01, musisz wyszukać moduł programu PowerShell, który obsługuje wersję 2016-03-30 dla magazynu oraz moduł obsługujący wersję 2015-12-01 dla obliczeń, a następnie je zainstalować. Zamiast tego można użyć profilu. Użyj polecenia cmdlet Install-Profile <profilename>, a program PowerShell ładuje poprawną wersję modułów.

Podobnie podczas tworzenia aplikacji opartej na języku Python przy użyciu zestawu SDK języka Python można określić profil. Zestaw SDK ładuje odpowiednie moduły dla określonych w skrypcie dostawców zasobów.

Jako deweloper oznacza to, że możesz skupić się na pisaniu rozwiązania. Zamiast badać, które wersje interfejsu API, dostawca zasobów i chmura współpracują ze sobą, możesz użyć profilu i wiedzieć, że kod działa we wszystkich chmurach, które obsługują ten profil.

Przykłady kodu profilu interfejsu API

Przykłady kodu ułatwiające integrację rozwiązania z preferowanym językiem z usługą Azure Stack Hub można znaleźć przy użyciu profilów. Obecnie można znaleźć wskazówki i przykłady dla następujących języków:

Następne kroki

  • Last updated on