Poprzednie wersje usługi Azure Storage

  • Artykuł

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 2023-11-03 i jest zalecana, jeśli jest to możliwe. Aby uzyskać informacje o najnowszej wersji, zobacz Przechowywanie wersji dla usługi 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 zawierają parametr przechowywania wersji (SignedVersionlub sv), który określa wersję używaną do autoryzacji i uruchamiania żądania SAS.

Wersja 2012-02-12 i nowsze

Żądania z sygnaturami dostępu współdzielonego wygenerowane przy użyciu wersji 2012-02-12 lub nowszej wymagają parametru SignedVersion (sv) . SignedVersion wskazuje wersję usługi używaną do autoryzacji i wywoływanie operacji interfejsu API. x-ms-version Jeśli nagłówek jest przekazywany w żądaniu, jest ignorowany. SignedVersion (sv) Tylko parametr określa wersję usługi, która ma być używana do przetwarzania żądania wykonanego za pośrednictwem sygnatury dostępu współdzielonego.

Uwaga

W przypadku wersji 2013-08-15 i starszych upewnij się, że usługi, które przygotowują i rozpowszechniają adresy URL sygnatury dostępu współdzielonego (czyli dostawcy sygnatur dostępu współdzielonego lub generatory) określają wersje usługi Azure Storage zrozumiałe dla oprogramowania klienckiego (czyli użytkowników sygnatur dostępu współdzielonego).

Poniższa tabela wskazuje, 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 pokazano sygnaturę dostępu współdzielonego, która wywołuje obiekty blob listy przy użyciu polecenia 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ć Url elementu w elemecie 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 Uri elementu. W związku z tym żądanie kończy się niepowodzeniem z elementem 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ługi Table Storage i Queue Storage wprowadziły sygnatury dostępu współdzielonego w wersji 2012-02-12, dlatego zachowanie sygnatury dostępu współdzielonego przed wersją 2012-02-12 dotyczy tylko usługi Blob Storage.

W wersji 2012-02-12 wprowadzono SignedVersion (sv) również parametr, który umożliwia generatorowi sygnatur dostępu współdzielonego określenie wersji, która ma być używana 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:

  1. Jeśli żądanie ma prawidłowy x-ms-version nagłówek, najwcześniejsza prawidłowa wersja (2009-07-17) jest używana do interpretowania parametrów sygnatury dostępu współdzielonego. Wersja określona przez x-ms-version jest używana do wykonywania operacji usługi Blob Storage.

  2. Jeśli żądanie nie ma nagłówka, a właściciel ustawił domyślną x-ms-version wersję przy użyciu polecenia Ustaw właściwości usługi Blob Storage, do interpretacji parametrów jest używana wersja 2009-07-17. Domyślna wersja określona przez właściciela służy do wykonywania operacji usługi Blob Storage.

  3. Jeśli żądanie nie ma nagłówka x-ms-version , a właściciel nie ustawił domyślnej wersji, 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 ograniczenia dostępu zostały ustawione za pomocą operacji ustawiania listy kontroli dostępu kontenera , 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.

  4. Jeśli żądanie nie ma nagłówka x-ms-version , a właściciel nie ustawił domyślnej wersji, 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 za pomocą operacji Ustaw listę kontroli dostępu kontenera , 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 SignedVersion , że parametr 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
Brak 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 ustawienie listy ACL kontenera 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

Uwaga

Firma Microsoft zaleca używanie wersji 2011-08-18 lub nowszej w scenariuszach wymagających wartości cytowanych ETag lub prawidłowych Accept-Ranges nagłówków odpowiedzi. 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