API-verzióprofilok kezelése az Azure Stack Hubban
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.
-
legújabb
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
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: