Korábbi Azure Storage-verziók
Az Azure Storage több verziót is támogat. Ha kérést szeretne küldeni a Storage-ra, 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 2023-11-03, és ha lehetséges, ez a verzió használata ajánlott. A legújabb verzióval kapcsolatos információkért lásd: 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 közös hozzáférésű jogosultságkódon keresztül küldött kérések feldolgozása az SAS létrehozásához használt verziónak megfelelően történik. A 2013-08-15-es é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óddal rendelkező kérelmekhez a SignedVersion (sv)
paramétert kell megadni. 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 közös hozzáférésű jogosultságkódon keresztül küldött kérés feldolgozásához használandó szolgáltatásverziót.
Megjegyzés
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 (vagyis a közös hozzáférésű jogosultságkód-szolgáltatókat vagy -generátorokat) előkészítő és terjesztő szolgáltatások olyan Azure Storage-szolgáltatásverziókat határoznak meg, amelyeket az ügyfélszoftverek (azaz a közös hozzáférésű jogosultságkód felhasználói) értenek.
Az alábbi táblázat azt jelzi, hogy mely szolgáltatások támogatottak a közös 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 | Mind (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éldában egy olyan közös hozzáférésű jogosultságkód látható, amely a használatával sv=2013-08-15
meghívja a list blobokat.
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 az Url
elemet az 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 kérést küld, amely ezt a közös hozzáférésű jogosultságkódot használja, az ügyfél elvárja az Uri
elemet. Ezért a kérés meghiúsul a következővel NullReferenceException
: .
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 2012-02-12-es verzió előtti közös hozzáférésű jogosultságkódok viselkedése csak a Blob Storage-ra vonatkozik.
A 2012-02-12-es verzió is bevezette a SignedVersion (sv)
paramétert, amely lehetővé teszi, hogy a közös hozzáférésű jogosultságkód-generátor megadja a kérés feldolgozásához használni kívánt verziót. A 2012-02-12 előtti verzióval létrehozott közös hozzáférésű jogosultságkód nem tudja meghatározni a kérelem feldolgozásához használandó 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. A Blob Storage-művelet végrehajtásához a megadottx-ms-version
verzió szolgál.Ha a kérelem nem tartalmaz fejlécet
x-ms-version
, és a tulajdonos a Blob Storage tulajdonságainak beállítása használatával állította be az alapértelmezett verziót, akkor a 2009-07-17-es verzió lesz használva a paraméterek értelmezéséhez. A blobtároló művelet végrehajtásához a tulajdonos által megadott alapértelmezett verzió szolgál.Ha a kérelemnek nincs
x-ms-version
fejléce, é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 beállítása 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érelemnek nincs
x-ms-version
fejléce, é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 nem a 2009-09-19-es vagy újabb verziót használó Tároló ACL beállítása művelettel lettek beállítva, 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 paraméter nem szerepel benne SignedVersion
.
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ó |
---|---|---|
None | A közös hozzáférésű jogosultságkód legkorábbi érvényes verziója (2009-07-17) | A 2009-09-19 akkor használatos, ha a Tároló ACL beállítása a 2009-09-19-es vagy újabb verzióval nyilvánosra állította a tárolót. Ellenkező esetben a Blob Storage legkorábbi verzióját használja a rendszer. |
2011-08-18 | A közös hozzáférésű jogosultságkód legkorábbi érvényes verziója (2009-07-17) | 2011-08-18. |
Bármely XXXX-XX-XX verzió | A közös hozzáférésű jogosultságkód legkorábbi érvényes verziója (2009-07-17) | XXXX-XX-XX verzió |
Megjegyzés
A Microsoft a 2011-08-18-es vagy újabb verzió használatát javasolja idézőértékeket ETag
vagy érvényes Accept-Ranges
válaszfejléceket igénylő forgatókönyvekhez. A böngészőknek és más streamelési ügyfeleknek ezeket a fejléceket kell használniuk a hatékony letöltéshez és újrapróbálkozáshoz.