API-verzióprofilok használata a Go-val az Azure Stack Hubban
Go- és verzió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ójai. A profilok 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.
- Kompatibilitás az alkalmazással az Azure Stack Hubbal és a regionális Azure-adatközpontokkal.
A Go SDK-ban a profilok a profilok elérési útján é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óira vonatkozik. Ha egy adott szolgáltatást egy profilból szeretne importálni, importálja annak megfelelő modulját a profilból. Ha például a 2020-09-01 profilból szeretné importálni a Compute szolgáltatást, 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
- Telepítse a Gitet. Lásd: Első lépések – A Git telepítése.
- 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, helyettesítse be 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 , 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ázatban találja.
Azure Stack-verzió | Profil |
---|---|
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.
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ések létrehozásával kapcsolatos további információkért tekintse meg ezt a dokumentumot.
Szolgáltatásnév
A szolgáltatásnevet és a hozzá tartozó környezeti információkat valahol létre kell hozni és menteni kell. 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- 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
Regisztrálja a szükséges erőforrás-szolgáltatókat a dokumentum követésével. 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 tudja kezelni 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 információkkal.
- 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óban2020-09-01
módosíthatja a értéket azapi-version
2019-10-01
erőforrás-szolgáltatómicrosoft.resources
esetében.
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
Az update-to-date mintakódért 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.
Tekintse meg 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:
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan: 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: