Продажи: 1-800-867-1389

Получение свойств контейнера

Обновлено: Февраль 2014 г.

Операция Get Container Properties возвращает все определяемые пользователем метаданные и системные свойства для указанного контейнера. Возвращаемые данные не включают список BLOB-объектов контейнера.

Запрос Get Container Properties можно составить следующим образом. Рекомендуется использовать протокол HTTPS. Замените myaccount именем нужной учетной записи хранения.

 

Метод URI запроса Версия HTTP

GET/HEAD

https://myaccount.blob.core.windows.net/mycontainer?restype=container

HTTP/1.1

При построении запроса к эмулированной службе хранилища укажите имя узла эмулятора и порт службы BLOB-объектов как 127.0.0.1:10000, затем укажите имя эмулированной учетной записи хранилища.

 

Метод URI запроса Версия HTTP

GET/HEAD

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container

HTTP/1.1

Дополнительные сведения см. в Использование эмулятора хранилища Azure для разработки и тестирования.

В URI запроса могут быть заданы следующие дополнительные параметры.

 

Параметр Описание

timeout

Необязательно. Параметр timeout указывается в секундах. Дополнительные сведения см. в Задание времени ожидания для операций службы BLOB-объектов.

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

 

Заголовок запроса Описание

Authorization

Обязательно. Указывает схему проверки подлинности, имя учетной записи и подпись. Дополнительные сведения см. в Проверка подлинности для служб хранения Azure.

Date или x-ms-date

Обязательно. Задает время в формате UTC для запроса. Дополнительные сведения см. в Проверка подлинности для служб хранения Azure.

x-ms-lease-id: <ID>

Необязательно, версия 2012-02-12 и более поздняя. Если задано, то Get Container Properties успешно завершится только в том случае, если аренда контейнера активна и совпадает с данным идентификатором. Если отсутствует активная аренда или идентификатор не совпадает, то будет возвращена ошибка 412 (Precondition Failed).

x-ms-version

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

x-ms-client-request-id

Необязательно. Предоставляет сформированное клиентом непрозрачное значение с ограничением в 1 КБ, которое записывается в журналы аналитики, когда включено ведение журналов аналитики хранилища. Этот заголовок настоятельно рекомендуется использовать для соотнесения действий, выполняемых на стороне клиента, с запросами, получаемыми сервером. Дополнительные сведения см. в разделах Сведения о ведении журнала службы аналитики хранилища и Ведение журналов в Windows Azure: использование журналов для отслеживания запросов к хранилищу.

Ответ включает код состояния HTTP и набор заголовков ответа.

Успешная операция возвращает код состояния 200 (ОК).

Сведения о кодах состояния см. в разделе Коды состояний и ошибок.

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют Спецификации протокола HTTP/1.1.

 

Заголовок ответа Описание

x-ms-meta-name:value

Возвращает строку, содержащую пару «имя-значение», связанную с контейнером как метаданные.

ETag

Тег сущности для контейнера. Если версия запроса 2011-08-18 или более поздняя, то значение ETag будет указано в кавычках.

Last-Modified

Возвращает дату и время последнего изменения контейнера. Дата в формате согласно RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках.

Любая операция, которая изменяет контейнер или его свойства или обновляет время последнего изменения. Операции с BLOB-объектами не влияют на время последнего изменения контейнера.

x-ms-lease-status: <locked | unlocked>

Версия 2012-02-12 и более поздние. Состояние аренды контейнера.

x-ms-lease-state: <available | leased | expired | breaking | broken>

Версия 2012-02-12 и более поздние. Состояние аренды контейнера.

x-ms-lease-duration: <infinite | fixed >

Версия 2012-02-12 и более новые, только если контейнер арендован. Указывает, является ли аренда контейнера бесконечной или фиксированной.

x-ms-request-id

Этот заголовок однозначно определяет выполненный запрос, его также можно использовать для устранения связанных с запросом неполадок. Дополнительные сведения см. в Устранение неполадок при API-операциях.

x-ms-version

Версия 19.09.09 и более поздние. Указывает версию службы BLOB-объектов, используемую для выполнения запроса.

Кроме того, этот заголовок также возвращается для анонимных запросов без указания версии, если контейнер был помечен как доступный для общего доступа с помощью версии 2009-09-19 службы BLOB-объектов.

Date

Значение даты и времени в формате UTC, сформированное службой и указывающее время, когда был инициирован ответ.

Response Status:
HTTP/1.1 200 OK

Response Headers:
Transfer-Encoding: chunked
x-ms-meta-Name: StorageSample
Date: Sun, 25 Sep 2011 12:43:08 GMT
ETag: "0x8CAFB82EFF70C46"
Last-Modified: Sun, 25 Sep 2011 10:42:18 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

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

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

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