Megosztás a következőn keresztül:

API-verzióprofilok kezelése az Azure Stack Hubban

  • Cikk

Az API-profilok meghatározzák az Azure-erőforrás-szolgáltatót és az Azure REST-végpontok API-verzióját. Az API-profilok használatával különböző nyelveken hozhat létre egyéni ügyfeleket. Minden ügyfél EGY API-profilt használ az Azure Stack Hub megfelelő erőforrás-szolgáltatójának és API-verziójának megkereséséhez.

Létrehozhat egy alkalmazást az Azure-erőforrás-szolgáltatókkal való együttműködéshez anélkül, hogy pontosan tudnia kellene, hogy az egyes erőforrás-szolgáltatói API-k melyik verziója kompatibilis az Azure Stack Hubdal. Egyszerűen igazítsa az alkalmazást egy profilhoz, és az SDK visszaáll a megfelelő API-verzióra.

Ez a témakör a következőkben nyújt segítséget:

  • Az Azure Stack Hub API-profiljainak ismertetése.
  • Megtudhatja, hogyan fejleszthet megoldásokat API-profilokkal.
  • Megtudhatja, hogy hol talál kódspecifikus útmutatást.

Az API-profilok összegzése

  • Az API-profilok az Azure-erőforrás-szolgáltatók egy csoportját és azok API-verzióit jelölik.
  • Api-profilokat hoztunk létre, hogy több Azure-felhőben is létrehozhasson sablonokat. A profilok kompatibilis és stabil felületet biztosítanak.
  • A profilok évente négyszer jelennek meg.
  • Három profilelnevezési konvenciót használunk:
    • legkésőbbi
      A globális Azure-ban kiadott legújabb API-verziókat tartalmazza.
    • yyyy-mm-dd-hybrid
      Ez a kétévente kiadott kiadás több felhő konzisztenciájára és stabilitására összpontosít. Ez a profil az Azure Stack Hub optimális kompatibilitását célozza meg.
    • yyyy-mm-dd-profile
      Kiegyensúlyozza az optimális stabilitást és a legújabb funkciókat.

Az Azure API-profilok és az Azure Stack Hub kompatibilitása

A legújabb Azure API-profilok nem kompatibilisek az Azure Stack Hubbal. Az alábbi elnevezési konvenciók segítségével állapítsa meg, hogy mely profilokat használja az Azure Stack Hub-megoldásokhoz:

legkésőbbi
Ez a profil a globális Azure-ban található legfrissebb API-verziókkal rendelkezik, amelyek nem működnek az Azure Stack Hubban. legújabb verzióban a legnagyobb a kompatibilitástörő változások száma. A profil félreteszi a stabilitást és a más felhőkkel való kompatibilitást. Ha a legfrissebb API-verziókat próbálja használni, a legújabb a használni kívánt profil.

Yyyy-mm-dd-hybrid
Ez a profil minden év márciusában és szeptemberében jelenik meg. Optimális stabilitással és kompatibilitással rendelkezik a különböző felhőkkel, és a globális Azure-ra és az Azure Stack Hubra irányul. A profilban felsorolt Azure API-verziók megegyeznek az Azure Stack Hubban felsoroltakkal. Ezzel a profillal kódokat fejleszthet hibrid felhőmegoldásokhoz.

yyyy-mm-dd-profile
Ez a profil júniusban és decemberben jelenik meg a globális Azure-ban. Nem működik az Azure Stack Hubbal, és általában sok kompatibilitástörő változás történik. Bár kiegyensúlyozza az optimális stabilitást és a legújabb funkciókat, a legújabb és a profil közötti különbség az, hogy a legújabb mindig a legújabb API-verziókból áll, függetlenül attól, hogy mikor jelenik meg az API. Ha például holnap létrehoz egy új API-verziót a Compute API-hoz, az API-verzió a legújabb, de nem a yyyy-mm-dd-profile profilban szerepel, mert ez a profil már létezik. A yyyy-mm-dd-profile a június vagy december előtt kiadott legújabb verziókat tartalmazza.

Azure Resource Manager API-profilok

Az Azure Stack Hub nem a globális Azure-ban található API-verziók legújabb verzióját használja. Megoldás létrehozásakor meg kell találnia az API-verziót minden Olyan Azure-erőforrás-szolgáltatóhoz, amely kompatibilis az Azure Stack Hubbal.

Ahelyett, hogy minden erőforrás-szolgáltatót és az Azure Stack Hub által támogatott konkrét verziót vizsgálnál, api-profilt is használhatsz. A profil erőforrás-szolgáltatók és API-verziók készletét adja meg. Az SDK vagy az SDK-val létrehozott eszköz visszatér a profilban megadott célhoz api-version . AZ API-profilokkal megadhat egy profilverziót, amely egy teljes sablonra vonatkozik. Futásidőben az Azure Resource Manager kiválasztja az erőforrás megfelelő verzióját.

Az API-profilok az Azure Resource Managert használó eszközökkel működnek együtt, például a PowerShellt, az Azure CLI-t, az SDK-ban megadott kódot és a Microsoft Visual Studiót. Az eszközök és az SDK-k profilokkal olvashatják el a modulok és kódtárak melyik verzióját az alkalmazások létrehozásakor.

Ha például a PowerShell használatával hoz létre tárfiókot a Microsoft.Storage erőforrás-szolgáltató használatával, amely támogatja a 2016-03-30-as api-verziót és a Microsoft.Compute erőforrás-szolgáltatót használó virtuális gépet a 2015-12-01 api-verzióval, meg kell keresnie, hogy melyik PowerShell-modul támogatja a 2016-03-30-as verziót a Storage-hoz, és melyik modul támogatja a 2015-02-01-es verziót a Computehez, majd telepítenie kell őket. Ehelyett használhat profilt. Használja a parancsmagot Install-Profile <profilename>, és a PowerShell betölti a modulok megfelelő verzióját.

Hasonlóképpen, ha a Python SDK használatával hoz létre Egy Python-alapú alkalmazást, megadhatja a profilt. Az SDK betölti a szkriptben megadott erőforrás-szolgáltatók megfelelő moduljait.

Fejlesztőként ez azt jelenti, hogy a megoldás írására összpontosíthat. Ahelyett, hogy azt kutatja, hogy mely API-verziók, erőforrás-szolgáltató és felhő működik együtt, használhat egy profilt, és tudja, hogy a kód minden olyan felhőben működik, amely támogatja ezt a profilt.

API-profilkódminták

Olyan kódmintákat találhat, amelyek segítenek a megoldásnak az Előnyben részesített nyelvvel való integrálásában az Azure Stack Hubban profilok használatával. Jelenleg a következő nyelvekhez találhat útmutatást és mintákat:

  • .NET
    A .NET API-profillal lekérheti az egyes erőforrástípusok legújabb, legstabilabb verzióját egy erőforrás-szolgáltatói csomagban. További információ: API-verzióprofilok használata .NET-tel az Azure Stack Hubban.
  • PowerShell
    A PowerShell-galéria keresztül elérhető Az.Bootstrapper modullal lekérheti az API-verzióprofilok használatához szükséges PowerShell-parancsmagokat. További információ: Api-verzióprofilok használata a PowerShellhez. A PowerShell-galéria keresztül elérhető AzureRM.Bootstrapper modullal lekérheti az API-verzióprofilok használatához szükséges PowerShell-parancsmagokat. További információ: Api-verzióprofilok használata a PowerShellhez.
  • Azure CLI
    Frissítse a környezeti konfigurációt az Azure Stack Hub-specifikus API-verzióprofil használatára. További információ: Api-verzióprofilok használata az Azure CLI-hez.
  • Ugrás
    A Go SDK-ban a profil különböző erőforrástípusok és különböző szolgáltatások különböző verzióinak kombinációja. A profilok az YYYY-MM-DD formátumban elérhető profilok/elérési utak alatt érhetők el. További információ: Go API-verzióprofilok használata.
  • Python
    A Python SDK támogatja az API-verzióprofilokat a különböző felhőplatformok, például az Azure Stack Hub és a globális Azure megcélzásához. Api-profilokkal hozhat létre megoldásokat hibrid felhőkhöz. További információ: API-verzióprofilok használata a Pythonnal.
  • Node.js
    Az Azure Stack Hub Resource Managerhez készült Node.js SDK eszközökkel segíti az infrastruktúra kiépítését és kezelését. További információ: API-verzióprofilok használata Node.js.

Következő lépések