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

Fontos

A Python SDK az 1. számról a 2. számra frissült. Javasoljuk, hogy mihamarabb migráljon a 2. SDK-ra. Útmutatásért tekintse meg ezt a migrálási útmutatót.

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álata hibrid felhők megoldásainak létrehozásához.

A cikkben ismertetett utasításokhoz Microsoft Azure-előfizetésre van szükség. Ha nem rendelkezik ilyen fiókkal, ingyenes próbaverziós fiókot kaphat.

Python- és API-verzióprofilok

A Python SDK a következő API-profilokat támogatja:

legkésőbbi
Ez a profil az Azure-platform összes szolgáltatójának legújabb API-verzióit célozza meg.
2020_09_01_hybrid
Ez a profil az Azure Stack Hub platform összes erőforrás-szolgáltatójának legújabb API-verzióit célozza meg a 2102-es vagy újabb verziókhoz.
2019_03_01_hybrid
Ez a profil az Azure Stack Hub platform összes erőforrás-szolgáltatójának legújabb API-verzióit célozza meg az 1904-es vagy újabb verziókhoz.

Az API-profilokkal és az Azure Stack Hubbal kapcsolatos további információkért lásd: API-verzióprofilok kezelése az Azure Stack Hubban.

Az Azure Python SDK telepítése

Profilok

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 v<date>_hybrid: . A 2008-as verzió esetében például a profil az 2019_03_01, és a karakterlánc lesz v2019_03_01_hybrid. 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ó	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

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

Lásd : Python 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 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örú szolgáltatásazonosító használata ajánlott, de a mintától függően elegendő lehet a 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 <fqdn> a teljes 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óban módosíthatja a api-version értékét 2019-10-01 értékre 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"]
      }
}

Bízzon az Azure Stack Hub CA gyökértanúsítványában

Ha az ASDK-t használja, kifejezetten meg kell bíznia a CA gyökértanúsítványban a távoli gépén. Önnek nem kell megbíznia a CA gyökér-tanúsítványban az Azure Stack Hub integrált rendszereivel.

Windows

Keresse meg a Python-tanúsítványtároló helyét a számítógépen. A hely a Python telepítésének helyétől függően eltérő lehet. Nyisson meg egy parancssort vagy egy emelt szintű PowerShell-parancssort, és írja be a következő parancsot:
```
  python -c "import certifi; print(certifi.where())"
```
Jegyezze fel a tanúsítványtároló helyét; például : ~/lib/python3.5/site-packages/certifi/cacert.pem. Az adott elérési út az operációs rendszertől és a Python telepített verziójától függ.

Az Azure Stack Hub hitelesítésszolgáltató főtanúsítványának megbízhatóságához fűzze hozzá a meglévő Python-tanúsítványhoz:

$pemFile = "<Fully qualified path to the PEM certificate; for ex: C:\Users\user1\Downloads\root.pem>"

$root = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2
$root.Import($pemFile)

Write-Host "Extracting required information from the cert file"
$md5Hash    = (Get-FileHash -Path $pemFile -Algorithm MD5).Hash.ToLower()
$sha1Hash   = (Get-FileHash -Path $pemFile -Algorithm SHA1).Hash.ToLower()
$sha256Hash = (Get-FileHash -Path $pemFile -Algorithm SHA256).Hash.ToLower()

$issuerEntry  = [string]::Format("# Issuer: {0}", $root.Issuer)
$subjectEntry = [string]::Format("# Subject: {0}", $root.Subject)
$labelEntry   = [string]::Format("# Label: {0}", $root.Subject.Split('=')[-1])
$serialEntry  = [string]::Format("# Serial: {0}", $root.GetSerialNumberString().ToLower())
$md5Entry     = [string]::Format("# MD5 Fingerprint: {0}", $md5Hash)
$sha1Entry    = [string]::Format("# SHA1 Fingerprint: {0}", $sha1Hash)
$sha256Entry  = [string]::Format("# SHA256 Fingerprint: {0}", $sha256Hash)
$certText = (Get-Content -Path $pemFile -Raw).ToString().Replace("`r`n","`n")

$rootCertEntry = "`n" + $issuerEntry + "`n" + $subjectEntry + "`n" + $labelEntry + "`n" + `
$serialEntry + "`n" + $md5Entry + "`n" + $sha1Entry + "`n" + $sha256Entry + "`n" + $certText

Write-Host "Adding the certificate content to Python Cert store"
Add-Content "${env:ProgramFiles(x86)}\Python35\Lib\site-packages\certifi\cacert.pem" $rootCertEntry

Write-Host "Python Cert store was updated to allow the Azure Stack Hub CA root certificate"

Megjegyzés:

Ha Virtualenv-t használ a Python SDK-val való fejlesztéshez, az előző tanúsítványt hozzá kell adnia a virtuális környezet tanúsítványtárolójához. Az elérési út a következőhöz hasonló lehet: ..\mytestenv\Lib\site-packages\certifi\cacert.pem.

Minták

Tekintse meg ezt a mintaadattárat a naprakész (2. verzió) mintakódért. 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

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-02-25