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

Задание свойств службы таблиц

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

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

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

 

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

PUT

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: использование журналов для отслеживания запросов к хранилищу.

Текст запроса для версии 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>

Начиная с версии 2013-08-15, можно вызвать метод Set Table Service Properties с одним или несколькими корневыми элементами, указанными в тексте запроса. Корневые элементы включают:

  • Logging

  • HourMetrics

  • MinuteMetrics

  • Cors

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

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

 

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

Logging

Не обязательно начиная с версии 2013-08-15. Обязательно для предыдущих версий. Группирует параметры аналитики Windows Azure Logging.

Metrics

В версии 2012-02-12 и более ранних обязателен. Неприменимо для версии 2013-08-15 и более поздних. Группирует параметры аналитики Windows Azure Metrics. Параметры Metrics предоставляют сводку статистики запросов, сгруппированную по API в почасовую статистику для таблиц.

HourMetrics

Необязательно для версии 2013-08-15 и более поздних; неприменимо для более ранних версий. Группирует параметры аналитики Windows Azure HourMetrics. Параметры HourMetrics предоставляют сводку статистики запросов, сгруппированную по API в почасовую статистику для таблиц.

MinuteMetrics

Необязательно для версии 2013-08-15 и более поздних; неприменимо для более ранних версий. Группирует параметры аналитики Windows Azure MinuteMetrics. Параметры MinuteMetrics обеспечивают статистику запроса на каждую минуту для таблиц. В версиях, предшествующих 2013-08-15, MinuteMetrics не включаются в тексте ответа.

Версия

Обязательно. Настраиваемая версия аналитики хранилища.

Удаление

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

Чтение

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

Запись

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

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

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

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

IncludeAPIs

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

RetentionPolicy/Enabled

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

RetentionPolicy/Days

Обязательно, если политика сохранения включена. Указывает число дней, в течение которых данные метрики или журнала должны сохраняться. Данные, которые старше указанного значения, удаляются. Минимальное значение - 1; наибольшее значение - 365 (один год).

Cors

Необязательно. Элемент Cors поддерживается для версии 2013-08-15 и для последующих версий. Группирует все правила CORS.

При пропуске этой группы элементов существующие параметры CORS перезаписаны не будут.

CorsRule

Необязательно. Задает правило CORS для службы таблиц. В запрос может быть включено до 5 элементов CorsRule. Если ни один элемент CorsRule не включен в текст запроса, то будут удалены все правила CORS, а CORS будет отключен для службы таблиц.

AllowedOrigins

Обязательно, если присутствует элемент CorsRule. Список доменов источников с разделителями-запятыми, которые будут разрешены согласно CORS, либо символ «*», чтобы разрешить все домены. Ограничен 64 доменами источников. Каждый разрешенный источник может содержать до 256 символов.

ExposedHeaders

Обязательно, если присутствует элемент CorsRule. Список заголовков ответов с разделителями-запятыми для предоставления клиентам CORS. Ограничен 64 определенными заголовками и 2 заголовками с префиксами. Каждый заголовок может содержать до 256 символов.

MaxAgeInSeconds

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

AllowedHeaders

Обязательно, если элемент CorsRule существует. Список допустимых заголовков с разделителями-запятыми, которые должны быть частью запроса общего доступа. Ограничен 64 определенными заголовками и 2 заголовками с префиксами. Каждый заголовок может содержать до 256 символов.

AllowedMethods

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

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

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

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

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

 

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

x-ms-request-id

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

x-ms-version

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

Вызов этой операции доступен только владельцу учетной записи.

К правилам CORS в хранилище Windows Azure применяются следующие ограничения.

  • Можно сохранить не более 5 правил.

  • Максимальный размер всех параметров правил CORS в запросе, за исключением XML-тегов, не должен превышать 2 КБ.

  • Длина разрешенного заголовка, представленного заголовка или разрешенного источника не должна превышать 256 символов.

  • Разрешенные и представленные заголовки могут быть следующими.

    • Литеральные заголовки, где предоставляется точное имя заголовка, например x-ms-meta-processed. В запросе может быть указано не более 64 литеральных заголовков.

    • Заголовки с префиксом, где указан префикс заголовка, например x-ms-meta-data*. Указанный таким образом префикс разрешает или предоставляет любой заголовок, который начинается с этого префикса. В запросе можно указать не более 2 заголовков с префиксами.

  • Методы (или HTTP-команды), указанные в элементе AllowedMethods, должны соответствовать методам, поддерживаемым API службы хранилища Windows Azure. Поддерживаемые методы: DELETE, GET, HEAD, MERGE, POST, OPTIONS и PUT.

Указание правил CORS в запросе не обязательно. При вызове метода Set Table Service Properties без указания элемента Cors в тексте запроса все существующие правила CORS сохраняются.

Чтобы отключить CORS, вызовите Set Table Service Properties с пустыми параметрами правил CORS (то есть </Cors>) и без внутренних правил CORS. В результате этого вызова будут удалены все существующие правила, отключающие CORS для службы таблиц.

Все элементы правила CORS обязательны, если задан элемент CorsRule. Запрос завершится ошибкой с кодом 400 (Bad Request), если какой-либо элемент отсутствует.

Начиная с версии 2013-08-15, элементы параметров XML являются необязательными, поэтому обновление указанного элемента можно делать с помощью отправки XML, который содержит только обновленный элемент, и другие параметры не затрагиваются.

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

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

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

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

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

Запрос отправляется со следующим текстом 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>
</StorageServiceProperties>

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

HTTP/1.1 202 Accepted
Connection: Keep-Alive
Transfer-Encoding: chunked
Date: Mon, 21 Oct 2013 04:38:24 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

См. также

Показ:
© 2014 Microsoft