Предыдущие версии службы хранилища Azure

Служба хранилища Azure поддерживает несколько версий. Чтобы выполнить запрос к хранилищу, необходимо указать версию, которую вы хотите использовать для этой операции, если запрос не является анонимным.

Доступные версии

Текущая версия службы хранилища Azure — 2025-05-05 и рекомендуется использовать ее по возможности. Сведения о последней версии см. в разделе управление версиями для службы хранилища Azure.

К дополнительным поддерживаемым версиям относятся следующие:

• версии 2025-01-05

• версии 2024-11-04

• версии 2024-08-04

• версии 2024-05-04

• версии 2024-02-04

• версии 2023-11-03

• версии 2023-08-03

• версии 2023-05-03

• версии 2023-01-03

• версии 2022-11-02

• версии 2021-12-02

• версии 2021-10-04

• версии 2021-08-06

• версии 2021-06-08

• версии 2021-04-10

• версии 2021-02-12

• версии 2020-12-06

• версии 2020-10-02

• версии 2020-08-04

• версии 2020-06-12

• версии 2020-04-08

• версии 2020-02-10

• версии 2019-12-12

• версии 2019-07-07

• версии 2019-02-02

• версии 2018-11-09

• версии 2018-03-28

• версии 2017-11-09

• версии 2017-07-29

• версии 2017-04-17

• версии 2016-05-31

• версии 2015-12-11

• версии 2015-07-08

• версии 2015-04-05

• версии 2015-02-21

• версии 2014-02-14

• версии 2013-08-15

• версии 2012-02-12

• версии 2011-08-18

• версии 2009-09-19

• версии 2009-07-17

• версии 2009-04-14

Запросы, авторизованные с помощью подписанного URL-адреса

Запрос, сделанный с помощью подписанного URL-адреса, обрабатывается в соответствии с той версией, которую вы используете для создания SAS. Версии 2013-08-15 и 2012-02-12 включают параметр управления версиями (SignedVersionили sv), который указывает, какая версия используется для авторизации и запуска запроса SAS.

Версия 2012-02-12 и более поздних версий

Для запросов с подписанными URL-адресами, созданными с помощью версии 2012-02-12 или более поздней, требуется параметр SignedVersion (sv). SignedVersion указывает версию службы, используемую для авторизации и вызова операции API. Если x-ms-version заголовок передается по запросу, он игнорируется. Только параметр SignedVersion (sv) определяет версию службы, используемую для обработки запроса с помощью подписанного URL-адреса.

Заметка

Для версии 2013-08-15 и более ранних версий убедитесь, что службы, которые подготавливают и распространяют URL-адреса подписи общего доступа (т. е. поставщики подписанных URL-адресов общего доступа или генераторы) указывают версии службы хранилища Azure, которые понимаются клиентским программным обеспечением (т. е. потребителями подписи общего доступа).

В следующей таблице указывается, какие службы поддерживаются для какой версии, для запроса, сделанного с помощью подписанного URL-адреса:

Значение параметра SignedVersion (sv)	Поддерживаемые службы
2015-12-11	Все (хранилище BLOB-объектов Azure, хранилище очередей Azure, хранилище таблиц Azure и файлы Azure)
2015-04-05	All (хранилище BLOB-объектов, хранилище очередей, хранилище таблиц и файлы Azure)
2015-02-21	All (хранилище BLOB-объектов, хранилище очередей, хранилище таблиц и файлы Azure)
2014-02-14	Хранилище BLOB-объектов, хранилище очередей и хранилище таблиц
2013-08-15	Хранилище BLOB-объектов, хранилище очередей и хранилище таблиц
2012-02-12	Хранилище BLOB-объектов, хранилище очередей и хранилище таблиц

В следующем примере показана сигнатура общего доступа, которая вызывает список БОЛЬШИХ двоичных объектов с помощью 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

В этом примере служба авторизует и запускает запрос с помощью версии 2013-08-15. Ответ не будет включать элемент Url в элемент Blob, так как он был удален в версии 2013-08-15.

Если клиентское приложение использует версию клиентской библиотеки хранилища на основе версии 2012-02-12 и выполняет запрос, использующий эту подпись общего доступа, клиент ожидает элемент Uri. Поэтому запрос завершается ошибкой с NullReferenceException.

Версии до 2012-02-12 (только хранилище BLOB-объектов)

Хранилище BLOB-объектов представило подписанные URL-адреса в версии 2009-07-17. Хранилище таблиц и хранилище очередей представили подписанные url-адреса в версии 2012-02-12, поэтому поведение подписанного URL-адреса до версии 2012-02-12 применяется только к хранилищу BLOB-объектов.

Версия 2012-02-12 также представила параметр SignedVersion (sv), который позволяет генератору подписей общего доступа указать версию для обработки запроса. Сигнатура общего доступа, созданная с версией до 2012-02-12, не может указывать версию, используемую для обработки запроса, и поэтому использует следующие правила для авторизации и выполнения API:

1. Если запрос имеет допустимый заголовок x-ms-version, то для интерпретации параметров подписи общего доступа используется самая ранняя версия (2009-07-17). Версия, указанная x-ms-version, используется для выполнения операции хранилища BLOB-объектов.

2. Если запрос не имеет заголовка x-ms-version, а владелец установил версию по умолчанию с помощью задать свойства хранилища BLOB-объектов, то для интерпретации параметров используется версия 2009-07-17. Версия по умолчанию, указанная владельцем, используется для выполнения операции хранилища BLOB-объектов.

3. Если запрос не имеет заголовка x-ms-version, а владелец не установил версию по умолчанию, хранилище BLOB-объектов использует самую раннюю допустимую версию (2009-07-17) для интерпретации параметров. Если контейнер является общедоступным, и его ограничения доступа были установлены с помощью операции Set Container ACL, которая использовалась версией 2009-09-19 или более поздней, используется для выполнения операции хранилища BLOB-объектов версии 2009-09-19.

4. Если запрос не имеет заголовка x-ms-version, а владелец не установил версию по умолчанию, хранилище BLOB-объектов использует самую раннюю допустимую версию (2009-07-17) для интерпретации параметров. Если ограничения доступа к контейнеру не заданы с помощью операции Set Container ACL, которая использовалась версией 2009-09-19 или более поздней, операция хранилища BLOB-объектов выполняется с помощью самой ранней версии службы.

В следующей таблице применяются эти правила к различным сценариям и предполагается, что параметр SignedVersion не включен.

Значение заголовка x-ms-version	Версия, используемая для интерпретации параметров авторизации и авторизации для хранилища BLOB-объектов	Версия, используемая для выполнения операции хранилища BLOB-объектов
Никакой	Самая ранняя допустимая версия подписанного URL-адреса (2009-07-17)	2009-09-19 используется, если контейнер был установлен на общедоступный, установить набора ACL контейнера с помощью версии 2009-09-19 или более поздней. В противном случае используется самая ранняя версия хранилища BLOB-объектов.
2011-08-18	Самая ранняя допустимая версия подписанного URL-адреса (2009-07-17)	2011-08-18.
Любая версия XXXX-XX-XX	Самая ранняя допустимая версия подписанного URL-адреса (2009-07-17)	Версия XXXX-XX-XX

Заметка

Корпорация Майкрософт рекомендует использовать версию 2011-08-18 или более позднюю версию для сценариев, для которых требуются значения ETag или допустимые заголовки ответа Accept-Ranges. В браузерах и других клиентах потоковой передачи эти заголовки требуются для эффективного скачивания и повторных попыток.

См. также

Управление версиями для служба хранилища Azure