Update Storage Account - Update Storage Account

Служба:: Key Vault

Версия API:: 2025-07-01

Обновляет указанные атрибуты, связанные с данной учетной записью хранения. Для этой операции требуется разрешение storage/set/update.

PATCH {vaultBaseUrl}/storage/{storage-account-name}?api-version=2025-07-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	Имя учетной записи хранения.
vaultBaseUrl	path	True	string	Имя хранилища, например `https://myvault.vault.azure.net`.
api-version	query	True	string	Версия клиентского API.

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

Имя	Тип	Описание
activeKeyName	string	Имя ключа текущей активной учетной записи хранения.
attributes	StorageAccountAttributes	Атрибуты учетной записи хранения.
autoRegenerateKey	boolean	Должен ли Keyvault управлять учетной записью хранения для пользователя.
regenerationPeriod	string	Продолжительность времени регенерации ключа указана в формате ISO-8601.
tags	object	Метаданные, специфичные для приложения, в виде пар ключ-значение.

Ответы

Имя	Тип	Описание
200 OK	StorageBundle	Обновленная учетная запись хранения.
Other Status Codes	KeyVaultError	Ответ об ошибке Key Vault с описанием причины сбоя операции.

Примеры

Update Storage account

Образец запроса

HTTP

PATCH https://myvault.vault.azure.net//storage/patchStrg01?api-version=2025-07-01

{
  "activeKeyName": "key1",
  "regenerationPeriod": "P10D"
}

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

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

{
  "id": "https://myvault.vault.azure.net/storage/patchStrg01",
  "resourceId": "/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Storage/storageAccounts/kvstorageacc",
  "activeKeyName": "key1",
  "autoRegenerateKey": true,
  "regenerationPeriod": "P10D",
  "attributes": {
    "enabled": true,
    "created": 1490738386,
    "updated": 1490738386,
    "recoveryLevel": "Recoverable+Purgeable"
  },
  "tags": {
    "tag1": "val1",
    "tag2": "val2"
  }
}

Определения

Имя	Описание
DeletionRecoveryLevel	Отражает уровень восстановления после удаления, действующий в настоящее время для учетных записей хранения в текущем хранилище. Если она содержит значение "Очищаемый", учетная запись хранения может быть безвозвратно удалена привилегированным пользователем; В противном случае только система может очистить учетную запись хранения в конце интервала хранения.
Error	Ошибка сервера хранилища ключей.
KeyVaultError	Исключение ошибки хранилища ключей.
StorageAccountAttributes	Атрибуты управления учетной записью хранения.
StorageAccountUpdateParameters	Параметры обновления учетной записи хранения.
StorageBundle	Пакет учетной записи хранения состоит из сведений об учетной записи хранения Key Vault и ее атрибутов.

DeletionRecoveryLevel

Перечисление

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

Значение	Описание
Purgeable	Обозначает состояние хранилища, при котором удаление является необратимой операцией без возможности восстановления. Этот уровень соответствует отсутствию защиты от операции удаления; данные безвозвратно теряются при принятии операции удаления на уровне сущности или выше (хранилище, группа ресурсов, подписка и т. д.)
Recoverable+Purgeable	Обозначает состояние хранилища, при котором удаление можно восстановить, а также позволяет немедленное и окончательное удаление (т. е. очистку). Этот уровень гарантирует возможность восстановления удаленной сущности в течение интервала хранения (90 дней), если не будет запрошена операция очистки или подписка не будет отменена. Система навсегда удалит его через 90 дней, если он не будет восстановлен
Recoverable	Обозначает состояние хранилища, при котором удаление можно восстановить без возможности немедленного и окончательного удаления (т. е. очистки). Этот уровень гарантирует возможность восстановления удаленной сущности в течение интервала хранения (90 дней) и пока подписка все еще доступна. Система навсегда удалит его через 90 дней, если он не будет восстановлен
Recoverable+ProtectedSubscription	Обозначает состояние хранилища и подписки, при котором удаление можно восстановить в течение интервала хранения (90 дней), немедленное и окончательное удаление (т. е. очистка) не допускается, а сама подписка не может быть отменена навсегда. Система навсегда удалит его через 90 дней, если он не будет восстановлен
CustomizedRecoverable+Purgeable	Обозначает состояние хранилища, при котором удаление можно восстановить, а также позволяет немедленное и окончательное удаление (т. е. очистка, когда 7<= SoftDeleteRetentionInDays < 90). Этот уровень гарантирует возможность восстановления удаленной сущности в течение интервала хранения, если не будет запрошена операция очистки или подписка не будет отменена.
CustomizedRecoverable	Обозначает состояние хранилища, при котором удаление можно восстановить без возможности немедленного и окончательного удаления (т. е. очистка, когда 7<= SoftDeleteRetentionInDays < 90). Этот уровень гарантирует возможность восстановления удаленной сущности в течение интервала хранения и пока подписка все еще доступна.
CustomizedRecoverable+ProtectedSubscription	Обозначает состояние хранилища и подписки, при котором удаление можно восстановить, немедленное и окончательное удаление (т. е. очистка) не допускается, и при котором сама подписка не может быть отменена окончательно, когда 7<= SoftDeleteRetentionInDays < 90. Этот уровень гарантирует возможность восстановления удаленной сущности в течение интервала хранения, а также отражает тот факт, что сама подписка не может быть отменена.

Error

Object

Ошибка сервера хранилища ключей.

Имя	Тип	Описание
code	string	Код ошибки.
innererror	Error	Ошибка сервера хранилища ключей.
message	string	Сообщение об ошибке.

KeyVaultError

Object

Исключение ошибки хранилища ключей.

Имя	Тип	Описание
error	Error	Ошибка сервера хранилища ключей.

StorageAccountAttributes

Object

Атрибуты управления учетной записью хранения.

Имя	Тип	Описание
created	integer (unixtime)	Время создания в UTC.
enabled	boolean	включенное состояние объекта.
recoverableDays	integer (int32)	Дни хранения данных softDelete. Значение должно быть >=7 и <=90 при включенном softDelete, в противном случае 0.
recoveryLevel	DeletionRecoveryLevel	Отражает уровень восстановления после удаления, действующий в настоящее время для учетных записей хранения в текущем хранилище. Если она содержит значение "Очищаемый", учетная запись хранения может быть безвозвратно удалена привилегированным пользователем; В противном случае только система может очистить учетную запись хранения в конце интервала хранения.
updated	integer (unixtime)	Последнее обновление времени в UTC.

StorageAccountUpdateParameters

Object

Параметры обновления учетной записи хранения.

Имя	Тип	Описание
activeKeyName	string	Имя ключа текущей активной учетной записи хранения.
attributes	StorageAccountAttributes	Атрибуты учетной записи хранения.
autoRegenerateKey	boolean	Должен ли Keyvault управлять учетной записью хранения для пользователя.
regenerationPeriod	string	Продолжительность времени регенерации ключа указана в формате ISO-8601.
tags	object	Метаданные, специфичные для приложения, в виде пар ключ-значение.

StorageBundle

Object

Пакет учетной записи хранения состоит из сведений об учетной записи хранения Key Vault и ее атрибутов.

Имя	Тип	Описание
activeKeyName	string	Имя ключа текущей активной учетной записи хранения.
attributes	StorageAccountAttributes	Атрибуты учетной записи хранения.
autoRegenerateKey	boolean	Должен ли Keyvault управлять учетной записью хранения для пользователя.
id	string	Идентификатор учетной записи хранения.
regenerationPeriod	string	Продолжительность времени регенерации ключа указана в формате ISO-8601.
resourceId	string	Идентификатор ресурса учетной записи хранения.
tags	object	Метаданные, специфичные для приложения, в виде пар ключ-значение

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

Update Storage Account - Update Storage Account

Параметры URI

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

Ответы

Примеры

Update Storage account

Образец запроса

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

Определения

DeletionRecoveryLevel

Error

KeyVaultError

StorageAccountAttributes

StorageAccountUpdateParameters

StorageBundle