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

Получение свойств службы таблиц

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

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

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

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

 

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

GET

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

HTTP/1.1

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

 

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

restype=service&comp=properties

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

timeout

Необязательно. Параметр timeout указывается в секундах.

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

 

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

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>
</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>
</StorageServiceProperties>

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

 

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

Logging

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

Metrics

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

HourMetrics

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

MinuteMetrics

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

Версия

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

Удаление

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

Чтение

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

Запись

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

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

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

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

IncludeAPIs

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

RetentionPolicy/Enabled

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

RetentionPolicy/Days

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

Cors

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

CorsRule

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

AllowedOrigins

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

ExposedHeaders

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

MaxAgeInSeconds

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

AllowedHeaders

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

AllowedMethods

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

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

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

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

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

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

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

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

Текст ответа подобен следующему:

<?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>
</StorageServiceProperties>

См. также

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

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