Megosztás:

API-verzióprofilok használata .NET-tel az Azure Stack Hubban

Fontos

A .NET SDK frissítve lett a track 1-ről a track 2-re. Javasoljuk, hogy mihamarabb migráljon a 2. SDK-ra. Útmutatásért tekintse meg ezt a migrálási útmutatót .

Az Azure Stack Hub Resource Managerhez készült .NET SDK eszközökkel segíti az infrastruktúra kiépítését és kezelését. Az SDK erőforrás-szolgáltatói közé tartozik a számítás, a hálózatkezelés, a tárolás, az App Services és a Key Vault. A .NET SDK 14 NuGet-csomagot tartalmaz. Ha az elavult 1.NET SDK-t használja (nem ajánlott), ezek a csomagok API-profilokkal vannak verzióban, például 2020-09-01 hibrid és 2019-03-01 hibrid. A .NET SDK API-profiljai lehetővé teszik a hibrid felhőfejlesztést azáltal, hogy segít a globális Azure-erőforrások és az Azure Stack Hub-erőforrások közötti váltásban. További információt a .NET- és API-verzióprofilok szakaszában talál.

Az Azure .NET SDK telepítése

.NET- és API-verzióprofilok

Az API-profil az erőforrás-szolgáltatók és az API-verziók kombinációja. AZ API-profil használatával lekérheti az egyes erőforrástípusok legújabb, legstabilabb verzióját egy erőforrás-szolgáltatói csomagban.

Megjegyzés:

A NuGet-csomag specifikációjának ResourceProvider részét módosítani kell. Emellett az 1-es nyomvonal .NET SDK csomagjai elavultak, ami miatt hibák léphetnek fel. Javasoljuk, hogy a lehető leghamarabb frissítsen a 2.NET SDK-ra.

Profiles

Dátumokat tartalmazó profilok esetén, ha másik SDK-profilt vagy -verziót szeretne használni, cserélje le a dátumot a következőben Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManager: . A 2008-es verzió esetében például a profil az 2019_03_01, és a karakterlánc válik Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager. Vegye figyelembe, hogy előfordulhat, hogy az SDK-csapat megváltoztatja a csomagok nevét, ezért előfordulhat, hogy egy sztring dátumának lecserélése egy másik dátumra nem fog működni. A profilok és az Azure Stack-verziók társítását az alábbi táblázat ismerteti.

Azure Stack-verzió Profile
2311 2020.09.01
2301 2020-09-01
2206 2020_09_01
2108 2020.09.01
2102 2020_09_01
2008 2019.03.01

További információ az Azure Stack Hubról és az API-profilokról: az API-profilok összegzése.

Subscription

Ha még nem rendelkezik előfizetéssel, hozzon létre egy előfizetést, és mentse a később használni kívánt előfizetés-azonosítót. Az előfizetés létrehozásával kapcsolatos további információkért tekintse meg ezt a dokumentumot.

Szolgáltatási főelem

Létre kell hozni és menteni kell egy szolgáltatásnevet és annak kapcsolódó környezeti adatait. A owner szerepkörrel rendelkező szolgáltatásfiók használata ajánlott, de a mintától függően elegendő lehet egy contributor szerepkör. A szükséges értékekért tekintse meg a mintaadattár README elemét. Ezeket az értékeket az SDK nyelv által támogatott bármilyen formátumban elolvashatja, például egy JSON-fájlból (amelyet a minták használnak). A futtatott mintától függően nem mindegyik érték használható. A frissített mintakódért vagy további információkért tekintse meg a mintaadattárat .

Bérlő azonosító

Az Azure Stack Hub címtárának vagy bérlőazonosítójának megkereséséhez kövesse az ebben a cikkben található utasításokat.

Erőforrás-szolgáltatók regisztrálása

A dokumentum követésével regisztrálja a szükséges erőforrás-szolgáltatókat. Ezekre az erőforrás-szolgáltatókra a futtatni kívánt mintáktól függően lesz szükség. Ha például virtuálisgép-mintát szeretne futtatni, az Microsoft.Compute erőforrás-szolgáltató regisztrációja szükséges.

Azure Stack Resource Manager-végpont

Az Azure Resource Manager (ARM) egy felügyeleti keretrendszer, amely lehetővé teszi a rendszergazdák számára az Azure-erőforrások üzembe helyezését, kezelését és monitorozását. Az Azure Resource Manager ezeket a feladatokat nem önállóan, hanem csoportként tudja kezelni egyetlen műveletben. A metaadatok a Resource Manager-végpontról is lekérhetők. A végpont egy JSON-fájlt ad vissza a kód futtatásához szükséges adatokkal.

  • A ResourceManagerEndpointUrl az Azure Stack Development Kitben (ASDK) a következő: https://management.local.azurestack.external/.
  • Az integrált rendszerekben a ResourceManagerEndpointUrl a következő: https://management.region.<fqdn>/, ahol a <fqdn> a teljesen minősített tartománynév.
  • A szükséges metaadatok lekérése: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Az elérhető API-verziókért tekintse meg az Azure rest API-specifikációit. Például a 2020-09-01 profilverziójában, az api-version-t módosíthatja 2019-10-01-re az microsoft.resources erőforrás-szolgáltatónál.

JSON-minta:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Samples

Tekintse meg ezt a mintaadattárat a naprakész (2-es változat) mintakódhoz. Az 1. mintakód nyomon követéséhez tekintse meg ezt a mintaadattárat . A gyökér README.md általános követelményeket ír le, és minden alkönyvtár tartalmaz egy saját mintát README.md , amely leírja a minta futtatásának módját.

Itt tekintheti meg az Azure Stack-verzióra 2008 vagy -profilra 2019-03-01 vonatkozó mintát, és alább.

Következő lépések

További információ az API-profilokról:

  • Last updated on