Update Storage Account - Update Storage Account

服务:

Key Vault

API 版本:

2025-07-01

更新与给定存储帐户关联的指定属性。 此作需要存储/设置/更新权限。

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	存储帐户捆绑包由密钥保管库存储帐户详细信息及其属性组成。

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 数据保留天数。 启用 softDelete 时，值应为 >=7 和 <=90，否则为 0。
recoveryLevel	DeletionRecoveryLevel	反映当前保管库中存储帐户当前有效的删除恢复级别。 如果它包含“可清除”，则特权用户可以永久删除存储帐户;否则，只有系统可以在保留间隔结束时清除存储帐户。
updated	integer (unixtime)	最后更新时间（UTC）。

StorageAccountUpdateParameters

Object

存储帐户更新参数。

名称	类型	说明
activeKeyName	string	当前活动存储帐户密钥名称。
attributes	StorageAccountAttributes	存储帐户的属性。
autoRegenerateKey	boolean	KeyVault 是否应管理用户的存储帐户。
regenerationPeriod	string	以 ISO-8601 格式指定的密钥重新生成持续时间。
tags	object	以键值对的形式提供特定于应用程序的元数据。

StorageBundle

Object

存储帐户捆绑包由密钥保管库存储帐户详细信息及其属性组成。

名称	类型	说明
activeKeyName	string	当前活动存储帐户密钥名称。
attributes	StorageAccountAttributes	存储帐户属性。
autoRegenerateKey	boolean	KeyVault 是否应管理用户的存储帐户。
id	string	存储帐户 ID。
regenerationPeriod	string	以 ISO-8601 格式指定的密钥重新生成持续时间。
resourceId	string	存储帐户资源 ID。
tags	object	键值对形式的应用程序特定元数据