Создание учетной записи хранения Azure с помощью REST API

Статья
07/11/2023

В этом примере показано, как создать учетную запись хранения Azure с помощью REST API Azure.

Полная справочная документация и дополнительные примеры доступны в справочнике по REST API поставщика ресурсов хранилища.

Создание запроса

Используйте следующий HTTP-запрос PUT, чтобы создать учетную запись хранения Azure.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}?api-version=2018-02-01

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

Ниже приведены обязательные заголовки.

Заголовок запроса	Описание
Content-Type:	Обязательный элемент. Задайте значение `application/json`.
Authorization:	Обязательный элемент. Задайте в качестве значения допустимый токен доступа`Bearer`.

Параметры универсального кода ресурса (URI)

Имя	Описание
subscriptionId	Идентификатор подписки Azure. Если у вас несколько подписок, см. раздел Использование нескольких подписок.
имя_группы_ресурсов	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить с помощью API-интерфейса Azure Resource Manager, CLI или портала.
accountName	Имя учетной записи хранения. Рекомендуется использовать следующие рекомендации по именованию учетных записей .
api-version	Версия API для использования в запросе. В этом документе рассматривается API версии `2018-02-01`, которая включена в приведенный выше URL-адрес.

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

В таблице ниже описаны необходимые свойства JSON для текста запроса. Используйте необязательные параметры для дальнейшей настройки учетной записи хранения.

Имя	Тип	Описание
location	строка	Расположение ресурса. Получите текущий список расположений с помощью операции List Locations.
kind	Вид	Указывает тип создаваемой учетной записи хранения . В этом примере рекомендуется использовать вариант общего назначения `StorageV2` .
sku	SKU	Определяет возможности учетной записи хранения, такие как стратегия избыточности и шифрование. В этом примере используется геоизбыточное хранилище.

Примеры текста запроса

{
  "sku": {
    "name": "Standard_GRS"
  },
  "kind": "StorageV2",
  "location": "eastus2",
}

Обработка ответа

Успешные запросы на создание новой учетной записи возвращают код состояния 202 с пустым текстом ответа. Учетная запись хранения создается асинхронно. Если учетная запись уже существует или подготавливается, ответ запроса содержит код возврата 200 с конфигурацией существующей учетной записи хранения в тексте ответа.

Полный список кодов ответов, включая коды ошибок, доступен в справочной документации по коду ошибки.

Пример кода ответа 200

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/res9101/providers/Microsoft.Storage/storageAccounts/{accountName}",
  "kind": "Storage",
  "location": "eastus2",
  "name": "{accountName}",
  "properties": {
    "creationTime": "2017-05-24T13:25:33.4863236Z",
    "primaryEndpoints": {
      "blob": "https://{accountName}.blob.core.windows.net/",
      "file": "https://{accountName}.file.core.windows.net/",
      "queue": "https://{accountName}.queue.core.windows.net/",
      "table": "https://{accountName}.table.core.windows.net/"
    },
    "primaryLocation": "eastus2",
    "provisioningState": "Succeeded",
    "secondaryLocation": "centralus",
    "statusOfPrimary": "available",
    "statusOfSecondary": "available",
    "supportsHttpsTrafficOnly": false
  },
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  },
  "type": "Microsoft.Storage/storageAccounts"
}

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