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

  • Cikk

Az API-profilok határozzák meg 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-profillal lép kapcsolatba az Azure Stack Hubhoz megfelelő erőforrás-szolgáltatóval és API-verzióval.

Létrehozhat egy alkalmazást, amely együttműködik az Azure-erőforrás-szolgáltatókkal 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 Hubbal. Egyszerűen igazítsa az alkalmazást egy profilhoz, és az SDK a megfelelő API-verzióra áll vissza.

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.
  • Tekintse meg, hol találhat kódspecifikus útmutatást.

AZ API-profilok összegzése

  • Az API-profilok az Azure-erőforrásszolgáltatók és azok API-verzióinak halmazát képviselik.
  • API-profilokat hoztunk létre több Azure-felhő sablonjainak létrehozásához. A profilok kompatibilis és stabil felületet biztosítanak.
  • A profilok évente négyszer jelennek meg.
  • Három profilelnevezési konvenciót használunk:
    • legújabb
      A globális Azure-ban kiadott legújabb API-verziókat tartalmazza.
    • yyyy-mm-dd-hybrid
      Ez a kétévente kiadott kiadás a több felhőre kiterjedő konzisztenciára és stabilitásra összpontosít. Ez a profil az Azure Stack Hub optimális kompatibilitását célozza.
    • 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 azonosíthatja az Azure Stack Hub-megoldásokhoz használandó profilokat:

legújabb
Ez a profil a legfrissebb API-verziókkal rendelkezik a globális Azure-ban, amelyek nem működnek az Azure Stack Hubban. legutóbbi a legnagyobb számú kompatibilitástörő változás. 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újabbat kell használnia.

Yyyy-mm-dd-hybrid
Ez a profil minden évben márciusban és szeptemberben jelenik meg. Optimális stabilitással és kompatibilitással rendelkezik a különböző felhőkkel, és a globális Azure-t és az Azure Stack Hubot célozza meg. Az ebben 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-hoz. 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 kerül kiadásra az API. Ha például holnap új API-verziót hoz létre a Compute API-hoz, akkor az API-verzió a legújabb, de nem szerepel az yyyy-mm-dd-profile profilban, mivel ez a profil már létezik. Az yyyy-mm-dd-profile a június vagy december előtt kiadott legújabb verziókra vonatkozik.

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 keres, használhat API-profilt. 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 visszaáll a profilban megadott célra 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 olyan eszközökkel működnek, amelyek az Azure Resource Manager használják, 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, hogy az alkalmazások készítésekor mely modulok és kódtárak melyik verzióját tartalmazzák.

Ha például a PowerShell használatával hoz létre egy 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 Compute számára, 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-t használja egy Python-alapú alkalmazás létrehozásához, megadhatja a profilt. Az SDK betölti a megfelelő modulokat a szkriptben megadott erőforrás-szolgáltatók számára.

Fejlesztőként ez azt jelenti, hogy a megoldás megí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

A kódminták segítségével profilok használatával integrálhatja a megoldást az előnyben részesített nyelvvel az Azure Stack Hubbal. Jelenleg az alábbi 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 profilok különböző erőforrástípusok és különböző szolgáltatások különböző verzióinak kombinációjai. A profilok az YYYY-MM-DD formátumban elérhető profilok/elérési utak alatt érhetők el. További információ: Api-verzióprofilok használata a Go-hoz.
  • Ruby
    Az Azure Stack Hubhoz készült Ruby SDK Resource Manager eszközöket biztosít az infrastruktúra létrehozásához és kezeléséhez. Az SDK erőforrás-szolgáltatói közé tartoznak a számítási, virtuális hálózatok és a Ruby nyelvvel rendelkező tárolás. További információ: API-verzióprofilok használata a Rubyval.
  • 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-profilok használatával hozhat létre megoldásokat egy hibrid felhőhöz. További információ: API-verzióprofilok használata a Pythonnal.
  • Node.js
    Az Azure Stack Hubhoz készült Node.js SDK Resource Manager eszközöket biztosít az infrastruktúra létrehozásához és kezeléséhez. További információ: API-verzióprofilok használata Node.js.

Következő lépések