Předchozí verze Azure Storage
Azure Storage podporuje více verzí. Pokud chcete vytvořit požadavek na službu Storage, musíte zadat verzi, kterou chcete pro danou operaci použít, pokud není požadavek anonymní.
Dostupné verze
Aktuální verze Azure Storage je z 3. 11. 2023 a pokud je to možné, doporučujeme ji používat. Informace o nejnovější verzi najdete v tématu Správa verzí pro Azure Storage.
Mezi další podporované verze patří:
Žádosti autorizované sdíleným přístupovým podpisem
Žádost provedená prostřednictvím sdíleného přístupového podpisu se zpracuje podle toho, jakou verzi použijete k vygenerování sdíleného přístupového podpisu. Verze 2013-08-15 a 2012-02-12 obsahují parametr správy verzí (SignedVersionnebo sv), který určuje verzi, která se má použít k autorizaci a spuštění požadavku SAS.
Verze 2012-02-12 a novější
Požadavky se sdílenými přístupovými podpisy vygenerované pomocí verze 2012-02-12 nebo novější vyžadují SignedVersion (sv) parametr . SignedVersion označuje verzi služby, která se používá k autorizaci a volání operace rozhraní API. Pokud je hlavička x-ms-version předána v požadavku, bude ignorována. SignedVersion (sv) Pouze parametr určuje verzi služby, která se má použít ke zpracování požadavku vytvořeného prostřednictvím sdíleného přístupového podpisu.
Poznámka
Ve verzi 2013-08-15 a starších se ujistěte, že služby, které připravují a distribuují adresy URL sdíleného přístupového podpisu (tedy zprostředkovatelé nebo generátory sdílených přístupových podpisů), určují verze služby Azure Storage, kterým rozumí klientský software (to znamená spotřebitelé sdíleného přístupového podpisu).
Následující tabulka uvádí, které služby jsou pro kterou verzi podporované pro žádost provedenou prostřednictvím sdíleného přístupového podpisu:
Hodnota parametru SignedVersion (sv) |
Podporované služby |
|---|---|
| 2015-12-11 | Vše (Azure Blob Storage, Azure Queue Storage, Azure Table Storage a Azure Files) |
| 2015-04-05 | Vše (Blob Storage, Queue Storage, Table Storage a Azure Files) |
| 2015-02-21 | Vše (Blob Storage, Queue Storage, Table Storage a Azure Files) |
| 2014-02-14 | Blob Storage, Queue Storage a Table Storage |
| 2013-08-15 | Blob Storage, Queue Storage a Table Storage |
| 2012-02-12 | Blob Storage, Queue Storage a Table Storage |
Následující příklad ukazuje sdílený přístupový podpis, který volá objekty blob seznamu pomocí sv=2013-08-15.
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2013-08-15&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d
V tomto příkladu služba autorizuje a spustí požadavek pomocí verze 2013-08-15. Odpověď nebude obsahovat Url element pod elementem Blob , protože byl odebrán ve verzi z 15. 8. 2013.
Pokud klientská aplikace používá verzi klientské knihovny storage založenou na verzi 2012-02-12 a odešle požadavek, který používá tento sdílený přístupový podpis, klient očekává Uri element . Proto požadavek selže s chybou NullReferenceException.
Verze před 2012-02-12 (jenom Blob Storage)
Služba Blob Storage zavedla sdílené přístupové podpisy ve verzi 2009-07-17. Table Storage a Queue Storage zavedly sdílené přístupové podpisy ve verzi 2012-02-12, takže chování sdíleného přístupového podpisu před verzí 2012-02-12 platí jenom pro Blob Storage.
Verze 2012-02-12 také zavedla SignedVersion (sv) parametr , který umožňuje generátoru sdíleného přístupového podpisu určit verzi, která se má použít ke zpracování požadavku. Sdílený přístupový podpis vygenerovaný s verzí před 2012-02-12 nemůže určit verzi, která se má použít ke zpracování požadavku, a proto spoléhá na následující pravidla pro autorizaci a spouštění rozhraní API:
Pokud má požadavek platnou
x-ms-versionhlavičku, použije se k interpretaci parametrů sdíleného přístupového podpisu nejstarší platná verze (2009-07-17). Verze určená parametremx-ms-versionslouží k provedení operace Blob Storage.Pokud požadavek nemá hlavičku
x-ms-versiona vlastník nastavil výchozí verzi pomocí nastavení vlastností služby Blob Storage, použije se k interpretaci parametrů verze 2009-07-17. K provedení operace Blob Storage se použije výchozí verze zadaná vlastníkem.Pokud požadavek nemá hlavičku
x-ms-versiona vlastník nenastavil výchozí verzi, použije Blob Storage k interpretaci parametrů nejstarší platnou verzi (2009-07-17). Pokud je kontejner veřejný a jeho přístupová omezení byla nastavena operací Nastavit seznam ACL kontejneru , která používala verzi 2009-09-19 nebo novější, použije se k provedení operace Blob Storage verze 2009-09-19.Pokud požadavek nemá hlavičku
x-ms-versiona vlastník nenastavil výchozí verzi, použije Blob Storage k interpretaci parametrů nejstarší platnou verzi (2009-07-17). Pokud nebyla omezení přístupu ke kontejneru nastavená pomocí operace Nastavit seznam ACL kontejneru , která používala verzi 2009-09-19 nebo novější, operace Blob Storage se provede pomocí nejstarší verze služby.
Následující tabulka používá tato pravidla pro různé scénáře a předpokládá, že SignedVersion parametr není zahrnutý.
| Hodnota hlavičky x-ms-version | Verze sloužící k interpretaci parametrů pro autorizaci a autorizaci služby Blob Storage | Verze používaná k provedení operace Blob Storage |
|---|---|---|
| Žádné | Nejstarší platná verze sdíleného přístupového podpisu (2009-07-17) | Aktualizace 2009-09-19 se používá, pokud byl kontejner nastavený na veřejný pomocí seznamu ACL pro kontejner pomocí verze 2009-09-19 nebo novější. V opačném případě se použije nejstarší verze služby Blob Storage. |
| 2011-08-18 | Nejstarší platná verze sdíleného přístupového podpisu (2009-07-17) | 2011-08-18. |
| Libovolná verze XXXX-XX-XX | Nejstarší platná verze sdíleného přístupového podpisu (2009-07-17) | Verze XXXX-XX-XX |
Poznámka
Microsoft doporučuje používat verzi 2011-08-18 nebo novější pro scénáře, které vyžadují hodnoty v uvozových hodnotách ETag nebo platné Accept-Ranges hlavičky odpovědi. Prohlížeče a další klienti streamování vyžadují tyto hlavičky pro efektivní stahování a opakování.