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

  • Статья

Операция 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 Требуется для всех авторизованных запросов. Задает версию операции, используемой для этого запроса. Для этой операции должна быть установлена версия 28.03.2018 или более поздняя. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
x-ms-client-request-id Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером.

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

Нет.

Ответ

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

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

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

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

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

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

Заголовок ответа Описание
x-ms-request-id Однозначно идентифицирует выполненный запрос. Его можно использовать для устранения неполадок с запросом. Дополнительные сведения см. в разделе Устранение неполадок с операциями API.
x-ms-version Версия 19.09.2009 и более поздняя. Указывает версию Хранилище 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 операцию, как описано ниже.

Эта операция не поддерживает авторизацию на основе OAuth с помощью маркера доступа из Azure Active Directory или MSI или SAS делегирования пользователей.

Подписанный URL-адрес (SAS) обеспечивает безопасный делегированный доступ к ресурсам в учетной записи хранения. С помощью SAS вы можете детально контролировать, как клиент может получить доступ к данным. Вы можете указать, к какому ресурсу может обращаться клиент, какие разрешения у него есть для этих ресурсов, а также срок действия SAS.

Операция Get Account Information поддерживает авторизацию с помощью SAS учетной записи или SAS службы с по крайней мере одним доступным разрешением.

SAS для учетной записи

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

Дополнительные сведения о SAS учетной записи см. в статье Создание SAS учетной записи.

SAS для службы

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

Если доступ к общему ключу запрещен для учетной записи хранения, маркер SAS службы не будет разрешен при запросе к хранилищу BLOB-объектов. Дополнительные сведения см. в статье Общие сведения о том, как запрет общего ключа влияет на маркеры SAS.

Дополнительные сведения о SAS службы см. в статье Создание SAS службы.

Комментарии

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

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

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

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

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

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