Была ли эта страница полезной?
Ваш отзыв об этом контенте важен для нас. Расскажите нам о том, что вы думаете.
Дополнительный отзыв?
1500 символов осталось
Экспорт (0) Печать
Развернуть все

Получение свойств службы очередей

Обновлено: Апрель 2015 г.

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

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

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

 

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

GET

https://<account-name>.queue.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 КБ, которое записывается в журналы аналитики, когда включено ведение журналов аналитики хранилища. Этот заголовок настоятельно рекомендуется использовать для соотнесения действий, выполняемых на стороне клиента, с запросами, получаемыми сервером. Дополнительные сведения см. в разделах Сведения о ведении журнала службы аналитики хранилища и Ведение журналов в Azure: использование журналов для отслеживания запросов к хранилищу.

Отсутствует.

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

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

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

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки 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

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

Metrics

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

HourMetrics

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

MinuteMetrics

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

Версия

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

Удалить

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

Чтение

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

Запись

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

Включено

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

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

IncludeAPIs

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

RetentionPolicy/Enabled

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

RetentionPolicy/Days

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

Cors

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

CorsRule

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

AllowedOrigins

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

ExposedHeaders

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

MaxAgeInSeconds

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

AllowedHeaders

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

AllowedMethods

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

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

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

GET https://myaccount.queue.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.queue.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-Queue/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>

См. также

Показ:
© 2015 Microsoft