Получение сведений об учетной записи
Операция 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, созданный с несуществующим BLOB-объектом и допустимыми разрешениями, будет успешно иметь URL-путь, включающий правильное имя учетной записи, правильное имя контейнера и имя несуществующего BLOB-объекта.
Выставление счетов
Запросы на ценообразование могут исходить от клиентов, использующих API хранилища BLOB-объектов, напрямую через REST API хранилища BLOB-объектов или из клиентской библиотеки службы хранилища Azure. Эти запросы начисляют плату за каждую транзакцию. Тип транзакции влияет на способ оплаты учетной записи. Например, транзакции чтения начисляются на категорию выставления счетов, отличную от категории операций записи. В следующей таблице показана категория выставления счетов для Get Account Information
запросов на основе типа учетной записи хранения.
Операция | Тип учетной записи хранения | Категория выставления счетов |
---|---|---|
Получение сведений об учетной записи | Блочный BLOB-объект (ценовая категории "Премиум") Общего назначения версии 2 (цен. категория "Стандартный") |
Другие операции |
Получение сведений об учетной записи | Стандартная общего назначения версии 1 | Операции чтения |
Дополнительные сведения о ценах для указанной категории выставления счетов см. в разделе Цены на Хранилище BLOB-объектов Azure.