Экспорт (0) Печать
Развернуть все

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

Обновлено: Май 2014 г.

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

Текущая версия служб хранилища Azure — 2014-02-14, рекомендуется использовать ее, где это возможно. Список всех других поддерживаемых версий и сведения об использовании каждой версии см. в разделе Azure Storage Services Versions 2013-08-15 and Earlier.

Версия 14.02.14 включает следующие изменения.

  • В новой службе файлов Microsoft Azure виртуальные машины, работающие в центре обработки данных Microsoft Azure, могут подключать общую файловую систему по протоколу SMB и получать доступ к ней с помощью стандартных файловых API Windows. Несколько ВМ (или ролей, запущенных в облачной службе), могут параллельно подключаться к этим файловым системам, чтобы вы могли легко делиться данными между различными ролями и экземплярами. API REST службы файлов похож на API службы BLOB-объектов и предлагает другие средства для доступа к файлам, в дополнение к файловым API Windows. Дополнительные сведения см. в разделе File Service REST API.

  • Подписанные URL-адреса теперь поддерживают параметр api-version, в дополнение к параметру SignedVersion (sv). Они позволяют управлять тем, какая версия служб хранилища используется для проверки подлинности и авторизации запроса, а также указания версии, используемой для выполнения операции API. См. раздел Запросы, проверка подлинности которых выполняется с помощью подписанного URL-адреса ниже.

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

  1. Запросы, использующие схему Shared Key или Shared Key Lite. Для проверки подлинности с помощью схемы Shared Key или Shared Key Lite необходимо передать в запросе заголовок x-ms-version. Для службы BLOB-объектов можно указать версию по умолчанию для всех запросов, вызвав Задание свойств службы BLOB-объектов.

  2. Запросы, использующие подписанный URL-адрес (SAS). В подписанном URL-адресе можно указать два параметра версии . Если необязательный заголовок api-version указан, он определяет, какая версия службы будет использоваться для выполнения операции API. Параметр SignedVersion (sv) указывает версию службы, используемую для авторизации и проверки подлинности запроса, выполненного с помощью SAS. Если заголовок api-version не указан, значение параметра SignedVersion (sv) также задает версию, используемую для выполнения операции API.

  3. Запросы, использующие анонимный доступ. При анонимном доступе к службе BLOB-объектов, версия не передается. Эвристика для определения версии, используемой для запроса, описана ниже.

Для проверки подлинности с помощью схемы Shared Key или Shared Key Lite необходимо передать в запросе заголовок x-ms-version. Значение заголовка запроса x-ms-version необходимо указывать в формате ГГГГ-ММ-ДД. Например:

Request Headers:
x-ms-version: 2014-02-14

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

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

  • Если запрос к службе BLOB-объектов не содержит заголовка x-ms-version, но владелец учетной записи установил версию по умолчанию с помощью Задание свойств службы BLOB-объектов, для запроса используется указанная владельцем версия по умолчанию.

Подписанный URL-адрес (SAS), созданный в версии 2014-02-14, поддерживает два параметра версий:

  • Параметр запроса api-version определяет версию протокола REST, используемую для обработки запроса, выполненного с помощью SAS.

  • Параметр запроса SignedVersion (sv) определяет версию SAS, используемую для проверки подлинности и авторизации.

Параметр запроса SignedVersion используется для проверки подлинности и авторизации, если клиент выполняет запрос с помощью SAS. Параметры авторизации и проверки подлинности, такие как si, sr, sp, sig, st, se, tn, spk, srk, epk и erk, интерпретируются с использованием версии 2014-02-14.

Параметры протокола REST, такие как rscc, rscd, rsce, rscl и rsct, применяются с использованием версии, указанной в заголовке параметра api-version. Если заголовок api-version не указан, используется версия службы, заданная дляSignedVersion.

Обратите внимание, что параметр api-version не является частью строки для подписи при проверке подлинности, как описано в разделе Создание URI подписанного URL-адреса.

В следующей таблице описывается схема управления версиями, используемая службой для проверки подлинности, авторизации и вызова протокола REST, если в параметре SignedVersion задана версия 2014-02-14 или более поздняя версия.

 

Значение параметра api-version Версия, используемая для проверки подлинности и авторизации Версия, используемая для определения поведения протокола

Не указано

Версия, заданная в параметре sv

Версия, заданная в параметре sv

Любая допустимая версия служб хранилища в формате XXXX-XX-XX

Версия, заданная в параметре sv

Допустимая версия служб хранилища XXXX-XX-XX

Пример 1

Следующий пример запроса вызывает Перечисление больших двоичных объектов с параметром sv=2014-02-14 и без параметра api-version.

https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2014-02-14&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d

В этом случае служба проверяет подлинность запроса и авторизует его с помощью версии 2014-02-14 и выполняет операцию с помощью версии 2014-02-14.

Пример 2

Следующий пример запроса вызывает Перечисление больших двоичных объектов с параметром sv=2014-02-14 и с параметром api-version.

https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2014-02-14&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d&api-version=2012-02-12

В этом случае служба проверяет подлинность запроса и авторизует его с помощью версии 2014-02-14 и выполняет операцию с помощью версии 2012-02-12.

noteПримечание
Клиентская библиотека хранилища .NET всегда задает версию протокола REST (в параметреapi-version) в соответствии с базовой версией.

Если в запросе к службе BLOB-объектов не указан заголовок x-ms-version, а версия для службы по умолчанию не была задана с помощью Задание свойств службы BLOB-объектов, для обработки запроса будет использоваться самая ранняя версия службы BLOB-объектов. Однако если контейнер был сделан общедоступным с помощью операции Задание списка управления доступом для контейнера, выполненной с использованием версии 2009-09-19 или более поздней версии, запрос обрабатывается с помощью версии 2009-09-19.

См. также

Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft