Получение статистики службы больших двоичных объектов

  • Статья

Операция Get Blob Service Stats извлекает статистику, связанную с репликацией для Хранилище BLOB-объектов Azure. Операция доступна только в конечной точке дополнительного расположения, если для учетной записи хранения включена геоизбыточная репликация с доступом на чтение.

Запрос

Запрос можно создать Get Blob Service Stats следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS. Замените myaccount именем учетной записи хранилища. Помните, что суффикс -secondary является обязательным.

Метод Универсальный код ресурса (URI) запроса параметр "Версия HTTP"
GET https://myaccount-secondary.blob.core.windows.net/?restype=service&comp=stats HTTP/1.1

Примечание

Универсальный код ресурса (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 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в разделе Мониторинг Хранилище BLOB-объектов Azure.

Текст запроса

Нет.

Ответ

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

Код состояния

Успешная операция возвращает код состояния 200 (ОК). При вызове операции в конечной точке вторичного расположения, которая не включена для вторичного чтения, она возвращает код состояния HTTP 403 с ошибкой InsufficientAccountPermissions .

Заголовки ответов

Ответ для этой операции включает следующие заголовки. Ответ также включает дополнительные стандартные заголовки 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: указывает, что дополнительное расположение активно и работает.
- bootstrap: указывает, что выполняется начальная синхронизация из основного расположения в дополнительное расположение. Обычно это происходит при первой включенной репликации.
— недоступно: указывает, что дополнительное расположение временно недоступно.
LastSyncTime Дата и время в формате GMT (до секунды). Все основные операции записи, предшествующие этому значению, гарантированно будут доступны для операций чтения на вторичном сервере. Основные операции записи после этого момента времени могут быть доступны или недоступны для операций чтения.

Значение может быть пустым, если LastSyncTime недоступно. Это может произойти, если состояние репликации — bootstrap или unavailable.

Хотя георепликация включена постоянно, LastSyncTime результат может отражать кэшированное значение службы, которое обновляется каждые несколько минут.

Авторизация

При вызове любой операции доступа к данным в службе хранилища Azure требуется авторизация. Вы можете авторизовать Get Blob Service Stats операцию, как описано ниже.

Служба хранилища Azure поддерживает использование Microsoft Entra ID для авторизации запросов к данным BLOB-объектов. С помощью Microsoft Entra ID можно использовать управление доступом на основе ролей Azure (Azure RBAC) для предоставления разрешений субъекту безопасности. Субъект безопасности может быть пользователем, группой, субъектом-службой приложения или управляемым удостоверением Azure. Субъект безопасности проходит проверку подлинности с помощью Microsoft Entra ID для возврата маркера OAuth 2.0. Затем маркер можно использовать для авторизации запроса к службе BLOB-объектов.

Дополнительные сведения об авторизации с помощью Microsoft Entra ID см. в статье Авторизация доступа к BLOB-объектам с помощью Microsoft Entra ID.

Разрешения

Ниже перечислены действия RBAC, необходимые для Microsoft Entra пользователя, группы или субъекта-службы для вызова Get Blob Service Stats операции, а также встроенная роль Azure RBAC с наименьшими привилегиями, которая включает это действие:

Дополнительные сведения о назначении ролей с помощью Azure RBAC см. в статье Назначение роли Azure для доступа к данным BLOB-объектов.

Комментарии

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

Геоизбыточная пара включает:

  • Основное расположение. Расположение, в котором вы читаете, создаете, обновляете или удаляете данные. Основное расположение находится в регионе, который вы выбираете при создании учетной записи на классическом портале Azure (например, центрально-северная часть США).

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

Расположение, в котором вы читаете, создаете, обновляете или удаляете данные, является первичным расположением учетной записи хранилища. Основное расположение находится в регионе, выбранном при создании учетной записи с помощью классического портала Azure управления Azure, например в центрально-северной части США. Расположение, в которое ваши данные реплицируются, — это вторичное расположение. Дополнительное расположение находится в регионе, который автоматически географически связан с основным регионом. Во вторичном расположении предоставляется доступ только для чтения, если для вашей учетной записи хранилища включена географически избыточная репликация с доступом только для чтения. Дополнительные сведения о геоизбыточности репликации с доступом на чтение см. в разделе Избыточность данных.

Чтобы создать запрос на операцию чтения к вторичной конечной точке, добавьте -secondary к имени учетной записи в URI, который используется для чтения из хранилища BLOB-объектов. Например, дополнительный универсальный код ресурса (URI) для операции Получения BLOB-объекта будет похож на https://myaccount-secondary.blob.core.windows.net/mycontainer/myblob.

Выставление счетов

Запросы на ценообразование могут поступать от клиентов, использующих API хранилища BLOB-объектов, напрямую через REST API хранилища BLOB-объектов или из клиентской библиотеки службы хранилища Azure. Эти запросы начисляют плату за транзакцию. Тип транзакции влияет на способ оплаты учетной записи. Например, транзакции чтения начисляются к категории выставления счетов, отличной от категории операций записи. В следующей таблице показана категория выставления счетов для Get Blob Service Stats запросов на основе типа учетной записи хранения.

Операция Тип учетной записи хранения Категория выставления счетов
Получение статистики службы больших двоичных объектов Блочный BLOB-объект (ценовая категории "Премиум")
Общего назначения версии 2 (цен. категория "Стандартный")		 Другие операции
Получение статистики службы больших двоичных объектов Стандартная общего назначения версии 1 Операции чтения

Дополнительные сведения о ценах на указанную категорию выставления счетов см. в разделе Цены на Хранилище BLOB-объектов Azure.

Пример запроса и ответа

Ниже приведен пример запроса для Get Blob Service Stats операции:

GET http://myaccount-secondary.blob.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-Blob/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>

См. также раздел

Операции с учетной записью (хранилище BLOB-объектов)