Update Storage Account - Update Storage Account

Servicio:: Key Vault

Versión de la API:: 2025-07-01

Actualiza los atributos especificados asociados a la cuenta de almacenamiento especificada. Esta operación requiere el permiso storage/set/update.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	El nombre de la cuenta de almacenamiento.
vaultBaseUrl	path	True	string	El nombre del almacén, por ejemplo `https://myvault.vault.azure.net`.
api-version	query	True	string	Versión de la API de cliente.

Cuerpo de la solicitud

Nombre	Tipo	Description
activeKeyName	string	Nombre de clave de la cuenta de almacenamiento activa actual.
attributes	StorageAccountAttributes	Los atributos de la cuenta de almacenamiento.
autoRegenerateKey	boolean	Si Keyvault debe administrar la cuenta de almacenamiento para el usuario.
regenerationPeriod	string	La duración del tiempo de regeneración de claves especificada en formato ISO-8601.
tags	object	Metadatos específicos de la aplicación en forma de pares clave-valor.

Respuestas

Nombre	Tipo	Description
200 OK	StorageBundle	La cuenta de almacenamiento actualizada.
Other Status Codes	KeyVaultError	Respuesta de error de Key Vault que describe por qué se produjo un error en la operación.

Ejemplos

Update Storage account

Solicitud de ejemplo

HTTP

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

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

Respuesta de muestra

status code:: 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"
  }
}

Definiciones

Nombre	Description
DeletionRecoveryLevel	Refleja el nivel de recuperación de eliminación actualmente en vigor para las cuentas de almacenamiento del almacén actual. Si contiene "Purgable", un usuario con privilegios puede eliminar permanentemente la cuenta de almacenamiento; de lo contrario, solo el sistema puede purgar la cuenta de almacenamiento, al final del intervalo de retención.
Error	El error del servidor del almacén de claves.
KeyVaultError	Excepción de error de Key Vault.
StorageAccountAttributes	Los atributos de administración de cuentas de almacenamiento.
StorageAccountUpdateParameters	Los parámetros de actualización de la cuenta de almacenamiento.
StorageBundle	Un paquete de cuentas de almacenamiento consta de detalles de la cuenta de almacenamiento del almacén de claves más sus atributos.

DeletionRecoveryLevel

Enumeración

Refleja el nivel de recuperación de eliminación actualmente en vigor para las cuentas de almacenamiento del almacén actual. Si contiene "Purgable", un usuario con privilegios puede eliminar permanentemente la cuenta de almacenamiento; de lo contrario, solo el sistema puede purgar la cuenta de almacenamiento, al final del intervalo de retención.

Valor	Description
Purgeable	Denota un estado de almacén en el que la eliminación es una operación irreversible, sin posibilidad de recuperación. Este nivel corresponde a que no hay protección disponible contra una operación Delete; los datos se pierden irremediablemente al aceptar una operación de eliminación en el nivel de entidad o superior (almacén, grupo de recursos, suscripción, etc.)
Recoverable+Purgeable	Denota un estado de almacén en el que la eliminación es recuperable y que también permite la eliminación inmediata y permanente (es decir, la depuración). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención (90 días), a menos que se solicite una operación de purga o se cancele la suscripción. El sistema lo eliminará permanentemente después de 90 días, si no se recupera
Recoverable	Denota un estado de almacén en el que la eliminación es recuperable sin la posibilidad de eliminación inmediata y permanente (es decir, purga). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención (90 días) y mientras la suscripción aún esté disponible. El sistema lo eliminará permanentemente después de 90 días, si no se recupera
Recoverable+ProtectedSubscription	Indica un estado de almacén y suscripción en el que la eliminación se puede recuperar dentro del intervalo de retención (90 días), no se permite la eliminación inmediata y permanente (es decir, la purga) y en el que la suscripción en sí no se puede cancelar permanentemente. El sistema lo eliminará permanentemente después de 90 días, si no se recupera
CustomizedRecoverable+Purgeable	Indica un estado de almacén en el que la eliminación es recuperable y que también permite la eliminación inmediata y permanente (es decir, purgar cuando 7<= SoftDeleteRetentionInDays < 90). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención, a menos que se solicite una operación de purga o se cancele la suscripción.
CustomizedRecoverable	Indica un estado de almacén en el que la eliminación se puede recuperar sin posibilidad de eliminación inmediata y permanente (es decir, purgar cuando 7<= SoftDeleteRetentionInDays < 90). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención y mientras la suscripción aún esté disponible.
CustomizedRecoverable+ProtectedSubscription	Indica un estado de almacén y suscripción en el que la eliminación es recuperable, no se permite la eliminación inmediata y permanente (es decir, la purga) y en el que la suscripción en sí no se puede cancelar permanentemente cuando 7<= SoftDeleteRetentionInDays < 90. Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención y también refleja el hecho de que la suscripción en sí no se puede cancelar.

Error

Object

El error del servidor del almacén de claves.

Nombre	Tipo	Description
code	string	Código de error.
innererror	Error	El error del servidor del almacén de claves.
message	string	El mensaje de error.

KeyVaultError

Object

Excepción de error de Key Vault.

Nombre	Tipo	Description
error	Error	El error del servidor del almacén de claves.

StorageAccountAttributes

Object

Los atributos de administración de cuentas de almacenamiento.

Nombre	Tipo	Description
created	integer (unixtime)	Hora de creación en UTC.
enabled	boolean	el estado habilitado del objeto.
recoverableDays	integer (int32)	días de retención de datos softDelete. El valor debe ser >=7 y <=90 cuando se habilita la eliminación temporal, de lo contrario 0.
recoveryLevel	DeletionRecoveryLevel	Refleja el nivel de recuperación de eliminación actualmente en vigor para las cuentas de almacenamiento del almacén actual. Si contiene "Purgable", un usuario con privilegios puede eliminar permanentemente la cuenta de almacenamiento; de lo contrario, solo el sistema puede purgar la cuenta de almacenamiento, al final del intervalo de retención.
updated	integer (unixtime)	Hora de la última actualización en UTC.

StorageAccountUpdateParameters

Object

Los parámetros de actualización de la cuenta de almacenamiento.

Nombre	Tipo	Description
activeKeyName	string	Nombre de clave de la cuenta de almacenamiento activa actual.
attributes	StorageAccountAttributes	Los atributos de la cuenta de almacenamiento.
autoRegenerateKey	boolean	Si Keyvault debe administrar la cuenta de almacenamiento para el usuario.
regenerationPeriod	string	La duración del tiempo de regeneración de claves especificada en formato ISO-8601.
tags	object	Metadatos específicos de la aplicación en forma de pares clave-valor.

StorageBundle

Object

Un paquete de cuentas de almacenamiento consta de detalles de la cuenta de almacenamiento del almacén de claves más sus atributos.

Nombre	Tipo	Description
activeKeyName	string	Nombre de clave de la cuenta de almacenamiento activa actual.
attributes	StorageAccountAttributes	Los atributos de la cuenta de almacenamiento.
autoRegenerateKey	boolean	Si Keyvault debe administrar la cuenta de almacenamiento para el usuario.
id	string	El identificador de cuenta de almacenamiento.
regenerationPeriod	string	La duración del tiempo de regeneración de claves especificada en formato ISO-8601.
resourceId	string	El identificador de recurso de la cuenta de almacenamiento.
tags	object	Metadatos específicos de la aplicación en forma de pares clave-valor

Compartir a través de

Update Storage Account - Update Storage Account

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

Update Storage account

Solicitud de ejemplo

Respuesta de muestra

Definiciones

DeletionRecoveryLevel

Error

KeyVaultError

StorageAccountAttributes

StorageAccountUpdateParameters

StorageBundle