Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Az Azure Storage több verziót is támogat. A Storage-ra vonatkozó kéréshez meg kell adnia a művelethez használni kívánt verziót, kivéve, ha a kérés névtelen.
Elérhető verziók
Az Azure Storage jelenlegi verziója 2025-07-05, és lehetőség szerint ennek a verziónak a használata javasolt. További információ a legújabb verzióról: Verziószámozás az Azure Storage-hoz.
További támogatott verziók:
Közös hozzáférésű jogosultságkóddal engedélyezett kérelmek
A rendszer a közös hozzáférésű jogosultságkódon keresztül küldött kéréseket annak megfelelően dolgozza fel, hogy melyik verziót használja az SAS létrehozásához. A 2013-08-15-ös és 2012-02-12-es verziók tartalmazzák a verziószámozási paramétert (SignedVersion
vagy sv
), amely meghatározza, hogy melyik verziót használja az SAS-kérés engedélyezéséhez és futtatásához.
2012-02-12-es és újabb verzió
A 2012-02-12-es vagy újabb verzióval létrehozott közös hozzáférésű jogosultságkódokkal rendelkező kérelmekhez a SignedVersion (sv)
paraméter szükséges.
SignedVersion
az engedélyezéshez és az API-művelet meghívásához használt szolgáltatásverziót jelzi. Ha a x-ms-version
fejlécet a rendszer átadja a kérésnek, a rendszer figyelmen kívül hagyja. Csak a SignedVersion (sv)
paraméter határozza meg a megosztott hozzáférésű jogosultságkódon keresztül küldött kérés feldolgozásához használni kívánt szolgáltatásverziót.
Jegyzet
A 2013-08-15-ös és korábbi verziók esetében győződjön meg arról, hogy a közös hozzáférésű jogosultságkód URL-címeit (azaz a közös hozzáférésű jogosultságkód-szolgáltatókat vagy generátorokat) létrehozó és terjesztő szolgáltatások az ügyfélszoftverek (azaz a közös hozzáférésű jogosultságkód-felhasználók) által értelmezett Azure Storage-szolgáltatásverziókat határozzák meg.
Az alábbi táblázat azt jelzi, hogy mely szolgáltatások támogatottak a megosztott hozzáférésű jogosultságkódon keresztül küldött kérések melyik verziójához:
SignedVersion (sv) paraméter értéke |
Támogatott szolgáltatások |
---|---|
2015-12-11 | Minden (Azure Blob Storage, Azure Queue Storage, Azure Table Storage és Azure Files) |
2015-04-05 | Minden (Blob Storage, Queue Storage, Table Storage és Azure Files) |
2015-02-21 | Minden (Blob Storage, Queue Storage, Table Storage és Azure Files) |
2014-02-14 | Blob Storage, Queue Storage és Table Storage |
2013-08-15 | Blob Storage, Queue Storage és Table Storage |
2012-02-12 | Blob Storage, Queue Storage és Table Storage |
Az alábbi példa egy közös hozzáférésű jogosultságkódot mutat be, amely meghívja listablobokat a sv=2013-08-15
használatával.
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2013-08-15&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d
Ebben a példában a szolgáltatás a 2013-08-15-ös verzióval engedélyezi és futtatja a kérést. A válasz nem tartalmazza a Url
elemet a Blob
elem alatt, mert a 2013-08-15-ös verzióban el lett távolítva.
Ha egy ügyfélalkalmazás a Storage ügyfélkódtár 2012-02-12-es verzióján alapuló verzióját használja, és a megosztott hozzáférési aláírást használó kérést küld, az ügyfél a Uri
elemet várja. Ezért a kérés egy NullReferenceException
meghiúsul.
2012-02-12 előtti verziók (csak Blob Storage esetén)
A Blob Storage a 2009-07-17-es verzióban bevezette a közös hozzáférésű jogosultságkódokat. A Table Storage és a Queue Storage közös hozzáférésű jogosultságkódokat vezetett be a 2012-02-12-es verzióban, így a közös hozzáférésű jogosultságkódok viselkedése a 2012-02-12-es verzió előtt csak a Blob Storage-ra vonatkozik.
A 2012-02-12-es verzió is bevezette a SignedVersion (sv)
paramétert, amely lehetővé teszi a közös hozzáférésű jogosultságkód-generátor számára a kérés feldolgozásához használni kívánt verzió megadását. A 2012-02-12 előtti verzióval létrehozott közös hozzáférésű jogosultságkód nem tudja megadni a kérés feldolgozásához használni kívánt verziót, ezért az engedélyezés és az API-végrehajtás alábbi szabályaira támaszkodik:
Ha a kérelem érvényes
x-ms-version
fejléccel rendelkezik, a rendszer a legkorábbi érvényes verziót (2009-07-17) használja a közös hozzáférésű jogosultságkód paramétereinek értelmezésére. Azx-ms-version
által megadott verzióval hajthatja végre a Blob Storage műveletet.Ha a kérelem nem rendelkezik
x-ms-version
fejléccel, és a tulajdonos beállította az alapértelmezett verziót Blob Storage-tulajdonságokhasználatával, akkor a 2009-07-17-es verzió a paraméterek értelmezésére szolgál. A blobtároló művelet végrehajtásához a tulajdonos által megadott alapértelmezett verzió szolgál.Ha a kérés nem rendelkezik
x-ms-version
fejléccel, és a tulajdonos nem állított be alapértelmezett verziót, a Blob Storage a legkorábbi érvényes verziót (2009-07-17) használja a paraméterek értelmezéséhez. Ha a tároló nyilvános, és a hozzáférési korlátozásokat a 2009-09-19-es vagy újabb verziót használó Tároló ACL művelettel állította be, a 2009-09-19-es verzió a Blob Storage-művelet végrehajtására szolgál.Ha a kérés nem rendelkezik
x-ms-version
fejléccel, és a tulajdonos nem állított be alapértelmezett verziót, a Blob Storage a legkorábbi érvényes verziót (2009-07-17) használja a paraméterek értelmezéséhez. Ha a tárolóhozzáférési korlátozások nincsenek beállítva a 2009-09-19-es vagy újabb verziót használó Tároló ACL beállítása művelettel, a Blob Storage-műveletet a szolgáltatás legkorábbi verziójával hajtja végre.
Az alábbi táblázat ezeket a szabályokat különböző forgatókönyvekre alkalmazza, és feltételezi, hogy a SignedVersion
paraméter nem szerepel benne.
Az x-ms-version fejléc értéke | A Blob Storage engedélyezési és engedélyezési paramétereinek értelmezésére használt verzió | A Blob Storage-művelet végrehajtásához használt verzió |
---|---|---|
Egyik sem | A közös hozzáférésű jogosultság legkorábbi érvényes aláírási verziója (2009-07-17) | A 2009-09-19 akkor használatos, ha a tárolót a 2009-09-19-es vagy újabb verzióval Tároló ACL beállítása nyilvánosra állította. Ellenkező esetben a Blob Storage legkorábbi verziója lesz használatban. |
2011-08-18 | A közös hozzáférésű jogosultság legkorábbi érvényes aláírási verziója (2009-07-17) | 2011-08-18. |
Bármely XXXX-XX-XX-verzió | A közös hozzáférésű jogosultság legkorábbi érvényes aláírási verziója (2009-07-17) | XXXX-XX-XX-verzió |
Jegyzet
A Microsoft azt javasolja, hogy a 2011-08-18-es vagy újabb verziót használja olyan forgatókönyvekhez, amelyek idézőjeles ETag
értékeket vagy érvényes Accept-Ranges
válaszfejléceket igényelnek. A böngészőknek és más streamelési ügyfeleknek szükségük van ezekre a fejlécekre a hatékony letöltéshez és újrapróbálkozáshoz.