Поделиться через

Получение сведений об учетной записи

  • Статья

Операция Get Account Information возвращает имя SKU и тип учетной записи для указанной учетной записи. Она доступна в версии 2018-03-28 и более поздних версиях службы.

Просьба

Вы можете создать запрос Get Account Information с помощью допустимого запроса, авторизованного через общий ключ или авторизацию подписанного URL-адреса (SAS).

Если добавить restype значение account и comp значение properties, запрос будет использовать операцию Get Account Information. В следующей таблице показаны примеры:

Метод URI запроса ВЕРСИЯ HTTP
GET/HEAD https://myaccount.blob.core.windows.net/?restype=account&comp=properties HTTP/1.1
GET/HEAD https://myaccount.blob.core.windows.net/?restype=account&comp=properties&sv=myvalidsastoken HTTP/1.1
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/?restype=account&comp=properties&sv=myvalidsastoken HTTP/1.1
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?restype=account&comp=properties&sv=myvalidsastoken HTTP/1.1

Параметры URI

Можно указать следующие дополнительные параметры в URI запроса:

Параметр Описание
restype Обязательно. Значение параметра restype должно быть account.
comp Обязательно. Значение параметра comp должно быть properties.

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

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

Заголовок запроса Описание
Authorization Обязательно. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
Date or x-ms-date Обязательно. Указывает универсальное время (UTC) для запроса. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
x-ms-version Требуется для всех авторизованных запросов. Указывает версию операции, используемой для этого запроса. Для этой операции версия должна быть 2018-03-28 или более поздней. Дополнительные сведения см. в разделе Управление версиями служб хранилища Azure.
x-ms-client-request-id Необязательный. Предоставляет созданное клиентом непрозрачное значение с ограничением символов 1-kibibyte (KiB), записанным в журналах при настройке ведения журнала. Настоятельно рекомендуется использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером.

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

Никакой.

Ответ

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

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

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

Сведения о кодах состояния см. в коды состояния и коды ошибок.

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

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

Заголовок ответа Описание
x-ms-request-id Уникально идентифицирует выполненный запрос. Его можно использовать для устранения неполадок запроса. Дополнительные сведения см. в статье Устранение неполадок с операциями API.
x-ms-version Версия 2009-09-19 и более поздних версий. Указывает версию хранилища BLOB-объектов Azure, которая используется для выполнения запроса.
Date Значение даты и времени в формате UTC, указывающее время отправки ответа службой.
Content-Length Указывает длину текста запроса. Для этой операции длина содержимого всегда будет равна нулю.
x-ms-sku-name Определяет имя номера SKU указанной учетной записи.
x-ms-account-kind Определяет тип учетной записи указанной учетной записи. Возможные значения: Storage, BlobStorageи StorageV2. Заголовок различает учетные записи хранения общего назначения версии 1 (GPv1) и учетные записи хранения общего назначения версии 2 (GPv2) с помощью подстроки V2 для учетных записей GPv2.
x-ms-client-request-id Можно использовать для устранения неполадок запросов и соответствующих ответов. Значение этого заголовка равно значению заголовка x-ms-client-request-id, если оно присутствует в запросе, а значение — не более 1024 видимых символов ASCII. Если в запросе отсутствует заголовок x-ms-client-request-id, этот заголовок не будет присутствовать в ответе.
x-ms-is-hns-enabled Версия 2019-07-07 и более поздних версий. Указывает, включена ли учетная запись иерархического пространства имен.

Текст ответа

Никакой.

Пример ответа

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Date: Sat, 28 Mar 2018 12:43:08 GMT  
x-ms-version: 2018-03-28  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0  
x-ms-sku-name: Standard_LRS  
x-ms-account-kind: StorageV2

Авторизация

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

Важный

Корпорация Майкрософт рекомендует использовать идентификатор Microsoft Entra с управляемыми удостоверениями для авторизации запросов в службу хранилища Azure. Идентификатор Microsoft Entra обеспечивает более высокую безопасность и удобство использования по сравнению с авторизацией общего ключа.

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

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

Разрешения

Ниже приведено действие RBAC, необходимое для пользователя Microsoft Entra, группы, управляемого удостоверения или субъекта-службы для вызова операции Get Account Information:

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

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

Замечания

Путь URL-адреса запроса не влияет на сведения, которые предоставляет эта операция. Его цель — разрешить запрос правильно авторизовать с помощью маркера SAS, указывающего разрешенный ресурс.

Указанный ресурс не должен существовать для успешной операции. Например, маркер SAS, созданный с несуществующим большим двоичным объектом и допустимыми разрешениями, будет успешно выполнен с url-адресом, который содержит правильное имя учетной записи, правильное имя контейнера и имя несуществующего большого двоичного объекта.

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

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

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

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