Poprzednie wersje usługi Azure Storage
Usługa Azure Storage obsługuje wiele wersji. Aby wysłać żądanie względem usługi Storage, musisz określić wersję, której chcesz użyć dla tej operacji, chyba że żądanie jest anonimowe.
Dostępne wersje
Bieżąca wersja usługi Azure Storage to 2024-11-04 i jest zalecana, jeśli jest to możliwe. Aby uzyskać informacje na temat najnowszej wersji, zobacz Versioning for Azure Storage.
Dodatkowe obsługiwane wersje obejmują:
Żądania autoryzowane za pośrednictwem sygnatury dostępu współdzielonego
Żądanie wykonane za pośrednictwem sygnatury dostępu współdzielonego jest przetwarzane zgodnie z wersją używaną do generowania sygnatury dostępu współdzielonego. Wersje 2013-08-15 i 2012-02-12 obejmują parametr przechowywania wersji (SignedVersion
lub sv
), który określa, która wersja ma być używana do autoryzowania i uruchamiania żądania sygnatury dostępu współdzielonego.
Wersja 2012-02-12 lub nowsza
Żądania z sygnaturami dostępu współdzielonego generowane przy użyciu wersji 2012-02-12 lub nowszej wymagają parametru SignedVersion (sv)
.
SignedVersion
wskazuje wersję usługi używaną do autoryzacji i wywołując operację interfejsu API. Jeśli nagłówek x-ms-version
zostanie przekazany do żądania, zostanie on zignorowany. Tylko parametr SignedVersion (sv)
określa wersję usługi, która ma być używana do przetwarzania żądania dokonanego za pośrednictwem sygnatury dostępu współdzielonego.
Nuta
W przypadku wersji 2013-08-15 i starszych upewnij się, że usługi, które przygotowują i rozpowszechniają adresy URL sygnatur dostępu współdzielonego (czyli dostawców sygnatur dostępu współdzielonego lub generatorów) określają wersje usługi Azure Storage, które są zrozumiałe dla oprogramowania klienckiego (czyli użytkowników sygnatur dostępu współdzielonego).
W poniższej tabeli przedstawiono, które usługi są obsługiwane dla której wersji dla żądania wykonanego za pośrednictwem sygnatury dostępu współdzielonego:
Wartość parametru SignedVersion (sv) |
Obsługiwane usługi |
---|---|
2015-12-11 | Wszystkie (Azure Blob Storage, Azure Queue Storage, Azure Table Storage i Azure Files) |
2015-04-05 | Wszystkie (Blob Storage, Queue Storage, Table Storage i Azure Files) |
2015-02-21 | Wszystkie (Blob Storage, Queue Storage, Table Storage i Azure Files) |
2014-02-14 | Blob Storage, Queue Storage i Table Storage |
2013-08-15 | Blob Storage, Queue Storage i Table Storage |
2012-02-12 | Blob Storage, Queue Storage i Table Storage |
W poniższym przykładzie przedstawiono sygnaturę dostępu współdzielonego, która wywołuje list obiektów blob przy użyciu 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
W tym przykładzie usługa autoryzuje i uruchamia żądanie przy użyciu wersji 2013-08-15. Odpowiedź nie będzie zawierać elementu Url
w ramach elementu Blob
, ponieważ została usunięta w wersji 2013-08-15.
Jeśli aplikacja kliencka używa wersji biblioteki klienta usługi Storage opartej na wersji 2012-02-12 i wysyła żądanie korzystające z tego sygnatury dostępu współdzielonego, klient oczekuje elementu Uri
. W związku z tym żądanie kończy się niepowodzeniem z NullReferenceException
.
Wersje wcześniejsze niż 2012-02-12 (tylko usługa Blob Storage)
Usługa Blob Storage wprowadziła sygnatury dostępu współdzielonego w wersji 2009-07-17. Usługa Table Storage i Queue Storage wprowadziły sygnatury dostępu współdzielonego w wersji 2012-02-12, więc zachowanie sygnatury dostępu współdzielonego przed wersją 2012-02-12 dotyczy tylko usługi Blob Storage.
W wersji 2012-02-12 wprowadzono również parametr SignedVersion (sv)
, który umożliwia generatorowi sygnatur dostępu współdzielonego określenie wersji używanej do przetwarzania żądania. Sygnatura dostępu współdzielonego wygenerowana przy użyciu wersji wcześniejszej niż 2012-02-12 nie może określić wersji używanej do przetwarzania żądania, dlatego opiera się na następujących regułach autoryzacji i wykonywania interfejsu API:
Jeśli żądanie ma prawidłowy nagłówek
x-ms-version
, najwcześniejsza prawidłowa wersja (2009-07-17) jest używana do interpretowania parametrów sygnatury dostępu współdzielonego. Wersja określona przezx-ms-version
służy do wykonywania operacji usługi Blob Storage.Jeśli żądanie nie ma nagłówka
x-ms-version
, a właściciel ustawił domyślną wersję przy użyciu Ustaw właściwości usługi Blob Storage, używana jest wersja 2009-07-17 do interpretowania parametrów. Domyślna wersja określona przez właściciela służy do wykonywania operacji usługi Blob Storage.Jeśli żądanie nie ma nagłówka
x-ms-version
, a właściciel nie ustawił wersji domyślnej, usługa Blob Storage używa najwcześniejszej prawidłowej wersji (2009-07-17) w celu zinterpretowania parametrów. Jeśli kontener jest publiczny, a jego ograniczenia dostępu zostały ustawione przy użyciu Set Container ACL operacji, która używała wersji 2009-09-19 lub nowszej, wersja 2009-09-19 jest używana do wykonania operacji usługi Blob Storage.Jeśli żądanie nie ma nagłówka
x-ms-version
, a właściciel nie ustawił wersji domyślnej, usługa Blob Storage używa najwcześniejszej prawidłowej wersji (2009-07-17) w celu zinterpretowania parametrów. Jeśli ograniczenia dostępu do kontenera nie zostały ustawione przy użyciu Ustaw listę ACL kontenera operacji, która używała wersji 2009-09-19 lub nowszej, operacja usługi Blob Storage jest wykonywana przy użyciu najwcześniejszej wersji usługi.
Poniższa tabela stosuje te reguły do różnych scenariuszy i zakłada, że parametr SignedVersion
nie jest uwzględniony.
Wartość nagłówka x-ms-version | Wersja używana do interpretowania parametrów autoryzacji i autoryzacji dla usługi Blob Storage | Wersja używana do wykonywania operacji usługi Blob Storage |
---|---|---|
Żaden | Najwcześniejsza prawidłowa wersja sygnatury dostępu współdzielonego (2009-07-17) | 2009-09-19 jest używany, jeśli kontener został ustawiony na publiczny przez Set Container ACL przy użyciu wersji 2009-09-19 lub nowszej. W przeciwnym razie jest używana najwcześniejsza wersja usługi Blob Storage. |
2011-08-18 | Najwcześniejsza prawidłowa wersja sygnatury dostępu współdzielonego (2009-07-17) | 2011-08-18. |
Dowolna wersja XXXX—XX-XX | Najwcześniejsza prawidłowa wersja sygnatury dostępu współdzielonego (2009-07-17) | Wersja XXXX —XX-XX |
Nuta
Firma Microsoft zaleca używanie wersji 2011-08-18 lub nowszej w scenariuszach, które wymagają cytowanych wartości ETag
lub prawidłowych nagłówków odpowiedzi Accept-Ranges
. Przeglądarki i inni klienci przesyłania strumieniowego wymagają tych nagłówków do wydajnego pobierania i ponawiania prób.
Zobacz też
przechowywanie wersji dla usługi Azure Storage