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

Задание свойств службы BLOB-объектов

Обновлено: Декабрь 2013 г.

Операция Get Blob Service Properties возвращает свойства службы BLOB-объектов учетной записи хранения, включая свойства для Storage Analytics и правил CORS (общий доступ к ресурсам независимо от источника).

Дополнительные сведения о правилах CORS и логике оценки см. в разделе Поддержка общего доступа к ресурсам независимо от источника (CORS) для служб хранилища Azure.

Запрос Get Blob Service Properties можно указать следующим образом. Рекомендуется использовать протокол HTTPS. Замените <account-name> именем нужной учетной записи хранилища.

 

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

GET

https://<account-name>.blob.core.windows.net/?restype=service&comp=properties

HTTP/1.1

Обратите внимание, что URI должен всегда включать косую черту (/) для отделения имени узла от частей пути и запроса URI. Для этой операции компонент пути в URI будет пустым.

 

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

restype=service&comp=properties

Обязательно. Для получения свойств службы хранилища требуется сочетание обеих строк запроса.

timeout

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

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

 

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

Authorization

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

Date или x-ms-date

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

x-ms-version

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

x-ms-client-request-id

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

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

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

Сведения о кодах состояния см. в разделе Service Management Status and Error Codes.

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

 

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

x-ms-request-id

Значение, которое однозначно определяет запрос к службе.

x-ms-version

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

Текст ответа для версии 2012-02-12 и более ранних имеет следующий формат:

<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>version-number</Version>
        <Delete>true|false</Delete>
        <Read>true|false</Read>
        <Write>true|false</Write>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Logging>
    <Metrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Metrics>
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</StorageServiceProperties>

Начиная с версии 2013-08-15, ответ имеет следующий формат:


<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>version-number</Version>
        <Delete>true|false</Delete>
        <Read>true|false</Read>
        <Write>true|false</Write>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Logging>
    <HourMetrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </HourMetrics>
    <MinuteMetrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </MinuteMetrics>
    <Cors>
        <CorsRule>
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>
            <AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods>
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
            <ExposedHeaders>comma-seperated-list-of-response-headers</ExposedHeaders>
            <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders>
        </CorsRule>
    </Cors>
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</StorageServiceProperties>

В следующей таблице описаны элементы текста ответа.

 

Имя элемента Описание

Logging

Группирует параметры аналитики Windows Azure Logging.

Metrics

Группирует параметры аналитики Windows Azure Metrics. Параметры Metrics предоставляют сводку статистики запросов, сгруппированную по API в почасовую статистику для больших двоичных объектов.

HourMetrics

Группирует параметры аналитики Windows Azure HourMetrics. Параметры HourMetrics предоставляют сводку статистики запросов, сгруппированную по API в почасовую статистику для больших двоичных объектов.

MinuteMetrics

Группирует параметры аналитики Windows Azure MinuteMetrics. Параметры MinuteMetrics обеспечивают статистику запроса на каждую минуту для больших двоичных объектов.

Версия

Версия аналитик хранилища в данный момент.

Удаление

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

Чтение

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

Запись

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

Активировано

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

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

IncludeAPIs

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

RetentionPolicy/Enabled

Указывает, включена ли политика сохранения для службы хранилища.

RetentionPolicy/Days

Указывает число дней, в течение которых данные метрики или журнала будут сохраняться. Данные, которые старше указанного значения, удаляются.

DefaultServiceVersion

DefaultServiceVersion указывает версию по умолчанию для использования с запросами к службе BLOB-объектов, если версия входящего запроса не указана. Значения включают версию 2008-10-27 и более поздние версии. Дополнительные сведения о применимых версиях см. в разделе Управление версиями для служб хранилища Azure.

Cors

Группирует все правила CORS.

CorsRule

Группирует параметры для правил CORS.

AllowedOrigins

Список доменов источников с разделителями-запятыми, разрешенных для CORS, либо символ «*», если разрешены все домены.

ExposedHeaders

Список заголовков ответов с разделителями-запятыми для предоставления клиентам CORS.

MaxAgeInSeconds

Число секунд, в течение которых клиент или браузер должен кэшировать предполетный ответ.

AllowedHeaders

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

AllowedMethods

Список методов HTTP с разделителями-запятыми, которые разрешено выполнять источником. Разрешенные методы для хранилища Windows Azure: DELETE, GET, HEAD, MERGE, POST, OPTIONS и PUT.

Эту операцию может вызвать только владелец учетной записи хранилища.

Следующий пример URI применяется для выполнения запроса на получение свойств службы BLOB-объектов для вымышленной учетной записи хранилища с именем myaccount:

GET https://myaccount.blob.core.windows.net/?restype=service&comp=properties HTTP/1.1

Запрос отправляется со следующими заголовками:

x-ms-version: 2013-08-15
x-ms-date: Wed, 23 Oct 2013 04:28:19 GMT
Authorization: SharedKey
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=
Host: myaccount.blob.core.windows.net

После отправки запроса возвращается следующий ответ:

HTTP/1.1 200 OK
Content-Length: 1020
Content-Type: application/xml
Date: Wed, 23 Oct 2013 04:28:20 GMT
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30
x-ms-version: 2013-08-15

Ответ включает следующий текст XML:

<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>1.0</Version>
        <Delete>true</Delete>
        <Read>false</Read>
        <Write>true</Write>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </Logging>
    <HourMetrics>
        <Version>1.0</Version>
        <Enabled>true</Enabled>
        <IncludeAPIs>false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </HourMetrics>
    <MinuteMetrics>
        <Version>1.0</Version>
        <Enabled>true</Enabled>
        <IncludeAPIs>true</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </MinuteMetrics>
    <Cors>
        <CorsRule>
      <AllowedOrigins> http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>
      <AllowedMethods>GET,PUT</AllowedMethods>
      <MaxAgeInSeconds>500</MaxAgeInSeconds>
      <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>
      <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>
  </CorsRule>
    </Cors>
    <DefaultServiceVersion>2013-08-15</DefaultServiceVersion>
</StorageServiceProperties>

См. также

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

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