Получение статистики службы очередей
Операция Get Queue Service Stats извлекает статистику, связанную с репликацией для хранилища очередей Azure. Он доступен только в конечной точке дополнительного расположения, если для учетной записи хранения включена геоизбыточная репликация с доступом на чтение.
Запрос
Запрос Get Queue Service Stats можно составить следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS. Замените myaccount именем учетной записи хранения и обратите внимание, что требуется суффикс -secondary :
| Метод | Универсальный код ресурса (URI) запроса | параметр "Версия HTTP" |
|---|---|---|
| GET | https://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats |
HTTP/1.1 |
Примечание
Универсальный код ресурса (URI) всегда должен содержать символ косой черты (/), чтобы отделить имя узла от частей пути и запроса URI. В этой операции путь URI пуст.
Параметры универсального кода ресурса (URI)
В URI запроса можно указать следующие дополнительные параметры:
| Параметр | Описание |
|---|---|
Timeout |
Необязательный элемент. Параметр timeout указывается в секундах. |
Заголовки запросов
В следующей таблице перечислены обязательные и необязательные заголовки запросов.
| Заголовок запроса | Описание |
|---|---|
Authorization |
Обязательный. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure. |
Date or x-ms-date |
Обязательный. Задает время запроса в формате UTC. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure. |
x-ms-version |
Требуется для всех авторизованных запросов. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure. |
x-ms-client-request-id |
Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в статье Мониторинг хранилища очередей Azure. |
Текст запроса
Нет.
Ответ
Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.
Код состояния
Успешная операция возвращает код состояния 200 (ОК). При вызове в конечной точке дополнительного расположения, которая не включена для вторичного чтения, он возвращает код состояния HTTP 403 (Недостаточно разрешений учетной записи).
Заголовки ответов
Ответ для этой операции включает следующие заголовки. Ответ также включает дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.
| Заголовок ответа | Описание |
|---|---|
x-ms-request-id |
Уникально идентифицирует выполненный запрос и может использоваться для устранения неполадок с запросом. Дополнительные сведения см. в статье Устранение неполадок с операциями API. |
x-ms-version |
Указывает версию операции, которая использовалась для ответа. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure. |
Date |
Значение даты и времени в формате UTC, созданное службой, которое указывает время инициации ответа. |
x-ms-client-request-id |
Этот заголовок можно использовать для устранения неполадок запросов и соответствующих ответов. Значение этого заголовка равно значению заголовка x-ms-client-request-id , если он присутствует в запросе и содержит не более 1024 видимых символов ASCII. Если заголовок x-ms-client-request-id отсутствует в запросе, он не будет присутствовать в ответе. |
Текст ответа
Текст ответа имеет следующий формат:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceStats>
<GeoReplication>
<Status>live|bootstrap|unavailable</Status>
<LastSyncTime>sync-time|<empty></LastSyncTime>
</GeoReplication>
</StorageServiceStats>
Элементы основного текста ответа описываются в следующей таблице.
| Заголовок ответа | Описание |
|---|---|
Status |
Состояние дополнительного расположения. Возможны следующие значения: - live: указывает, что дополнительное расположение активно и работает. - начальная загрузка. Указывает, что выполняется начальная синхронизация из основного расположения в дополнительное расположение. Обычно это происходит при первой включенной репликации. - недоступно: указывает, что дополнительное расположение временно недоступно. |
LastSyncTime |
Значение даты и времени в формате UTC в секундах. Все основные операции записи, предшествующие этому значению, гарантированно будут доступны для операций чтения на вторичной записи. Основные операции записи после этого момента времени могут быть недоступны для операций чтения. Значение может быть пустым, если LastSyncTime оно недоступно. Это может произойти, если репликация находится в состоянии начальной загрузки или недоступна.Хотя георепликация включена постоянно, LastSyncTime результат может отражать кэшированное значение из службы, которое обновляется каждые несколько минут. |
Авторизация
Вызов этой операции доступен только владельцу учетной записи.
Комментарии
Благодаря геоизбыточной репликации служба хранилища Azure поддерживает данные в двух расположениях. В обоих расположениях хранилище Azure поддерживает несколько работоспособных копий данных.
Расположение, в котором вы читаете, создаете, обновляете или удаляете данные, является первичным расположением учетной записи хранилища. Основное расположение находится в регионе, который вы выбираете при создании учетной записи с помощью классического портала Azure управления Azure (например, центрально-северная часть США).
Расположение, в которое ваши данные реплицируются, — это вторичное расположение. Дополнительное расположение находится в регионе, который автоматически географически связан с основным регионом. Во вторичном расположении предоставляется доступ только для чтения, если для вашей учетной записи хранилища включена географически избыточная репликация с доступом только для чтения.
Дополнительные сведения о геоизбыточности репликации с доступом на чтение см. в разделе Избыточность данных.
Чтобы создать запрос на операцию чтения к вторичной конечной точке, добавьте -secondary в качестве суффикса к имени учетной записи в URI, который используется для чтения из хранилища очередей. Например, дополнительный универсальный код ресурса (URI) для операции "Показать сообщения" аналогичен https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=true.
Пример запроса и ответа
Далее показан образец запроса для операции Get Queue Service Stats:
GET http://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats HTTP/1.1
Запрос передается со следующими заголовками:
x-ms-version: 2013-08-15
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=
Возвращены следующие код состояния и заголовки ответа.
HTTP/1.1 200 OK
Content-Type: application/xml
Date: Wed, 23 Oct 2013 22:08:54 GMT
x-ms-version: 2013-08-15
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
Ответ включает следующий текст XML:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceStats>
<GeoReplication>
<Status>live</Status>
<LastSyncTime> Wed, 23 Oct 2013 22:05:54 GMT</LastSyncTime>
</GeoReplication>
</StorageServiceStats>