API-verzióprofilok használata a Go-val az Azure Stack Hubban

  • Cikk

Go és version profilok

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ója. A profil használata segít a különböző erőforrástípusok keveredésében és egyezésében. A profilok a következő előnyöket nyújtják:

  • Az alkalmazás stabilitása adott API-verziókhoz való zárolással.
  • Az alkalmazás kompatibilitása az Azure Stack Hubbal és a regionális Azure-adatközpontokkal.

A Go SDK-ban a profilok a profilok elérési útja alatt érhetők el. A profil verziószámai YYYY-MM-DD formátumban vannak címkézve. Az Azure Stack Hub API-profil 2020-09-01-es verziója például az Azure Stack Hub 2102-es vagy újabb verzióihoz készült. Ha egy adott szolgáltatást egy profilból szeretne importálni, importálja a megfelelő modult a profilból. Ha például a Számítási szolgáltatást 2020-09-01-ről szeretné importálni, használja a következő kódot:

import "github.com/Azure/azure-sdk-for-go/profiles/2020-09-01/compute/mgmt/compute"

A Góhoz készült Azure SDK telepítése

  1. Telepítse a Gitet. Lásd: Első lépések – Git telepítése.
  2. Telepítse a Go-t. Az Azure API-profiljaihoz a Go 1.9-es vagy újabb verziója szükséges. Lásd: Go programozási nyelv.

Profilok

Ha másik SDK-profilt vagy verziót szeretne használni, cserélje le a dátumot egy importálási utasításban, például github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage: . A 2008-es verzió esetében például a profil a 2019-03-01, a sztring pedig a lesz github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. 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 egy másik dátumra való lecserélése 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ó Profil
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020-09-01
2102 2020-09-01
2008 2019-03-01

Az Azure Stack Hubról és az API-profilokról további információt az API-profilok összegzése című témakörben talál.

Lásd: Go SDK-profilok.

Előfizetés

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 lásd ezt a dokumentumot.

Szolgáltatásnév

Létre kell hozni és menteni kell egy szolgáltatásnevet és annak kapcsolódó környezeti adatait. A szerepkörrel rendelkező owner szolgáltatásnév 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 minden é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ójára van szükség.

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 egyenként, hanem csoportként kezelheti egyetlen műveletben. A metaadat-adatokat a Resource Manager végpontról szerezheti be. A végpont egy JSON-fájlt ad vissza a kód futtatásához szükséges adatokkal.

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

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"]
      }
}

Példák

A frissítési mintakódhoz tekintse meg 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 a minta futtatásához.

Lásd itt 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: