Předchozí verze Služby 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 služby Azure Storage je 2024-11-04 a pokud je to možné, doporučuje se použít tuto verzi. Informace o nejnovější verzi najdete v tématu Správa verzí pro službu Azure Storage.
Mezi další podporované verze patří:
Žádosti autorizované prostřednictvím sdíleného přístupového podpisu
Žádost provedená prostřednictvím sdíleného přístupového podpisu se zpracuje podle toho, jakou verzi použijete k vygenerování SAS. Verze 2013-08-15 a 2012-02-12 obsahují parametr správy verzí (SignedVersion
nebo sv
), který určuje, jakou verzi použít k autorizaci a spuštění žádosti SAS.
Verze 2012-02-12 a novější
Požadavky se sdílenými přístupovými podpisy vygenerovanými pomocí verze 2012-02-12 nebo novější vyžadují parametr SignedVersion (sv)
.
SignedVersion
označuje verzi služby používanou k autorizaci a pro volání operace rozhraní API. Pokud je hlavička x-ms-version
předána v požadavku, bude ignorována. Pouze parametr SignedVersion (sv)
určuje verzi služby, která se má použít ke zpracování požadavku provedeného prostřednictvím sdíleného přístupového podpisu.
Poznámka
Pro verzi 2013-08-15 a starší se ujistěte, že služby, které připraví a distribuují adresy URL sdíleného přístupového podpisu (to znamená zprostředkovatelé sdílených přístupových podpisů nebo generátory), určují verze služby Azure Storage, které jsou srozumitelné klientským softwarem (tedy příjemci sdílených přístupových podpisů).
Následující tabulka uvádí, které služby jsou podporované pro kterou verzi, 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 Soubory Azure) |
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á Výpis objektů blob 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 spouští požadavek pomocí verze 2013-08-15. Odpověď nebude obsahovat prvek Url
pod element Blob
, protože byl odebrán ve verzi 2013-08-15.
Pokud klientská aplikace používá verzi klientské knihovny služby 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á prvek Uri
. Požadavek proto selže s NullReferenceException
.
Verze starší než 2012-02-12 (pouze Blob Storage)
Blob Storage zavedla sdílené přístupové podpisy ve verzi 2009-07-17. Služba 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 službu Blob Storage.
Verze 2012-02-12 také zavedla parametr SignedVersion (sv)
, který umožňuje generátoru sdílených přístupových podpisů určit verzi, která se má použít ke zpracování požadavku. Sdílený přístupový podpis vygenerovaný s verzí starší než 2012-02-12 nemůže určit verzi, která se má použít ke zpracování požadavku, a proto se spoléhá na následující pravidla pro autorizaci a spouštění rozhraní API:
Pokud má požadavek platnou hlavičku
x-ms-version
, použije se k interpretaci parametrů sdíleného přístupového podpisu nejstarší platná verze (2009-07-17). Verze určenáx-ms-version
slouží k provedení operace Blob Storage.Pokud požadavek nemá hlavičku
x-ms-version
a vlastník nastavil výchozí verzi pomocí Nastavit vlastnosti služby Blob Storage, použije se k interpretaci parametrů verze 2009-07-17. K provedení operace Blob Storage se používá výchozí verze zadaná vlastníkem.Pokud požadavek nemá hlavičku
x-ms-version
a vlastník nenastavil výchozí verzi, služba Blob Storage použije k interpretaci parametrů nejstarší platnou verzi (2009-07-17). Pokud je kontejner veřejný a jeho omezení přístupu byla nastavena s Nastavit seznam ACL kontejneru operace, která používala verzi 2009-09-19 nebo novější, verze 2009-09-19 se používá k provedení operace Blob Storage.Pokud požadavek nemá hlavičku
x-ms-version
a vlastník nenastavil výchozí verzi, služba Blob Storage použije k interpretaci parametrů nejstarší platnou verzi (2009-07-17). Pokud nebyla omezení přístupu ke kontejneru nastavena pomocí operace Nastavit seznam ACL kontejneru, která používala verzi 2009-09-19 nebo novější, provede se operace Blob Storage pomocí nejstarší verze služby.
Následující tabulka tato pravidla používá pro různé scénáře a předpokládá, že parametr SignedVersion
není zahrnutý.
Hodnota hlavičky x-ms-version | Verze použitá k interpretaci parametrů pro autorizaci a autorizaci pro službu Blob Storage | Verze použitá k provedení operace Blob Storage |
---|---|---|
Žádný | Nejstarší platná verze sdíleného přístupového podpisu (2009-07-17) | 2009-09-19 se používá, pokud byl kontejner nastaven na veřejný Nastavit seznam ACL kontejneru 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žít verzi 2011-08-18 nebo novější pro scénáře, které vyžadují uvozované ETag
hodnoty nebo platné hlavičky odpovědi Accept-Ranges
. Prohlížeče a další klienti streamování vyžadují tyto hlavičky pro efektivní stahování a opakování.