Предыдущие версии службы хранилища Azure
Служба хранилища Azure поддерживает несколько версий. Чтобы выполнить запрос к хранилищу, необходимо указать версию, которую вы хотите использовать для этой операции, если запрос не является анонимным.
Доступные версии
Текущая версия службы хранилища Azure — 2023-11-03. По возможности рекомендуется использовать ее. Сведения о последней версии см. в статье Управление версиями для службы хранилища Azure.
К дополнительным поддерживаемым версиям относятся:
Запросы, авторизованные с помощью подписанного URL-адреса
Запрос, сделанный через подписанный URL-адрес, обрабатывается в соответствии с версией, используемой для создания SAS. Версии 2013-08-15 и 2012-02-12 включают параметр управления версиями (SignedVersionили sv), который указывает, какую версию использовать для авторизации и выполнения запроса SAS.
Версия 12.02.2012 и более поздняя
Для запросов с подписанными URL-адресами, созданными с помощью версии 2012-02-12 или более поздней, требуется SignedVersion (sv) параметр . SignedVersion указывает версию службы, используемую для авторизации и вызова операции API. Если заголовок x-ms-version передается в запросе, он игнорируется. SignedVersion (sv) Только параметр определяет версию службы, используемую для обработки запроса, сделанного с помощью подписанного URL-адреса.
Примечание
Для версии 2013-08-15 и более ранних убедитесь, что службы, которые подготавливают и распространяют URL-адреса подписанных URL-адресов (то есть поставщики или генераторы подписанных URL-адресов), указывают версии службы хранилища Azure, которые распознаются клиентским программным обеспечением (т. е. потребителями подписей общего доступа).
В следующей таблице указано, какие службы поддерживаются для определенной версии запроса, выполненного с помощью подписанного URL-адреса:
Значение параметра SignedVersion (sv) |
Поддерживаемые службы |
|---|---|
| 2015-12-11 | Все (Хранилище BLOB-объектов Azure, хранилище очередей Azure, хранилище таблиц Azure и Файлы Azure) |
| 2015-04-05 | Все (хранилище BLOB-объектов, хранилище очередей, хранилище таблиц и Файлы Azure) |
| 2015-02-21 | Все (хранилище BLOB-объектов, хранилище очередей, хранилище таблиц и Файлы Azure) |
| 2014-02-14 | Хранилище BLOB-объектов, Хранилище очередей и Хранилище таблиц |
| 2013-08-15 | Хранилище BLOB-объектов, Хранилище очередей и Хранилище таблиц |
| 2012-02-12 | Хранилище BLOB-объектов, Хранилище очередей и Хранилище таблиц |
В следующем примере показана подписанный URL-адрес, который вызывает список 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 , так как он был удален в версии 15.08.2013.
Если клиентское приложение использует версию клиентской библиотеки хранилища на основе версии 2012-02-12 и выполняет запрос, использующий эту подписанный URL-адрес, клиент ожидает Uri элемент . Таким образом, запрос завершается ошибкой с .NullReferenceException
Версии до 12.02.2012 (только для хранилища BLOB-объектов)
В хранилище BLOB-объектов появились подписанные URL-адреса в версии 2009-07-17. В хранилище таблиц и хранилище очередей введены подписанные URL-адреса в версии 2012-02-12, поэтому поведение подписанного URL-адреса до версии 2012-02-12 применялось только к хранилищу BLOB-объектов.
В версии 2012-02-12 также появился SignedVersion (sv) параметр , который позволяет генератору подписанных url-адресов указать версию, используемую для обработки запроса. Подписанный URL-адрес, созданный с версией до 2012-02-12, не может указать версию, используемую для обработки запроса, и поэтому использует следующие правила для авторизации и выполнения API:
Если у запроса есть допустимый
x-ms-versionзаголовок, для интерпретации параметров подписанного URL-адреса используется самая ранняя допустимая версия (2009-07-17). Версия, указанная параметромx-ms-version, используется для выполнения операции хранилища BLOB-объектов.Если у запроса нет заголовка
x-ms-version, а владелец установил версию по умолчанию с помощью параметра Задать свойства хранилища BLOB-объектов, для интерпретации параметров используется версия 2009-07-17. Указанная владельцем версия по умолчанию используется для выполнения операции хранилища BLOB-объектов.Если у запроса нет заголовка
x-ms-versionи владелец не установил версию по умолчанию, хранилище BLOB-объектов использует самую раннюю допустимую версию (2009-07-17) для интерпретации параметров. Если контейнер является общедоступным и его ограничения доступа были заданы с помощью операции Set Container ACL,которая использовала версию 2009-09-19 или более позднюю, для выполнения операции хранилища BLOB-объектов используется версия 2009-09-19.Если у запроса нет заголовка
x-ms-versionи владелец не установил версию по умолчанию, хранилище BLOB-объектов использует самую раннюю допустимую версию (2009-07-17) для интерпретации параметров. Если ограничения доступа к контейнерам не были заданы с помощью операции Set Container ACL,которая использовала версию 2009-09-19 или более позднюю, то операция хранилища BLOB-объектов выполняется с использованием самой ранней версии службы.
В следующей таблице эти правила применяются к различным сценариям и предполагается SignedVersion , что параметр не включен.
| Значение заголовка x-ms-version | Версия, используемая для интерпретации параметров авторизации и авторизации хранилища BLOB-объектов | Версия, используемая для выполнения операции с хранилищем BLOB-объектов |
|---|---|---|
| Нет | Самая ранняя допустимая версия подписанного URL-адреса (17.07.2009) | 2009-09-19 используется, если контейнер был установлен в качестве общедоступного путем задания списка ACL контейнера в версии 2009-09-19 или более поздней. В противном случае используется самая ранняя версия хранилища BLOB-объектов. |
| 2011-08-18 | Самая ранняя допустимая версия подписанного URL-адреса (17.07.2009) | 2011-08-18. |
| Любая версия XX.XX.XXXX | Самая ранняя допустимая версия подписанного URL-адреса (17.07.2009) | Версия XX.XX.XXXX |
Примечание
Корпорация Майкрософт рекомендует использовать версию 2011-08-18 или более позднюю для сценариев, требующих значений в ETag кавычках или допустимых Accept-Ranges заголовков ответов. Браузеры и другие клиенты потоковой передачи требуют эти заголовки для эффективного скачивания и повторных попыток.