Update Storage Account - Update Storage Account

Service:: Key Vault

Version d'API:: 2025-07-01

Met à jour les attributs spécifiés associés au compte de stockage donné. Cette opération nécessite l’autorisation storage/set/update.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	Nom du compte de stockage.
vaultBaseUrl	path	True	string	Le nom du coffre-fort, par exemple `https://myvault.vault.azure.net`.
api-version	query	True	string	Version de l’API client.

Corps de la demande

Nom	Type	Description
activeKeyName	string	Nom de la clé de compte de stockage actif actuel.
attributes	StorageAccountAttributes	Les attributs du compte de stockage.
autoRegenerateKey	boolean	Si KeyVault doit gérer le compte de stockage pour l’utilisateur.
regenerationPeriod	string	Durée du temps de régénération des touches spécifiée au format ISO-8601.
tags	object	Métadonnées spécifiques à l’application sous la forme de paires clé-valeur.

Réponses

Nom	Type	Description
200 OK	StorageBundle	Le compte de stockage mis à jour.
Other Status Codes	KeyVaultError	Réponse d’erreur Key Vault décrivant la raison de l’échec de l’opération.

Exemples

Update Storage account

Exemple de requête

HTTP

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

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

Exemple de réponse

Code d’état:: 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"
  }
}

Définitions

Nom	Description
DeletionRecoveryLevel	Reflète le niveau de récupération de suppression actuellement en vigueur pour les comptes de stockage dans le coffre-fort actuel. S’il contient « Purgable », le compte de stockage peut être définitivement supprimé par un utilisateur privilégié ; Dans le cas contraire, seul le système peut purger le compte de stockage à la fin de l’intervalle de rétention.
Error	Erreur de serveur Key Vault.
KeyVaultError	Exception d’erreur du coffre de clés.
StorageAccountAttributes	Attributs de gestion du compte de stockage.
StorageAccountUpdateParameters	Paramètres de mise à jour du compte de stockage.
StorageBundle	Un bundle de comptes de stockage se compose des détails du compte de stockage Key Vault et de ses attributs.

DeletionRecoveryLevel

Énumération

Reflète le niveau de récupération de suppression actuellement en vigueur pour les comptes de stockage dans le coffre-fort actuel. S’il contient « Purgable », le compte de stockage peut être définitivement supprimé par un utilisateur privilégié ; Dans le cas contraire, seul le système peut purger le compte de stockage à la fin de l’intervalle de rétention.

Valeur	Description
Purgeable	Désigne un état de coffre-fort dans lequel la suppression est une opération irréversible, sans possibilité de récupération. Ce niveau correspond à l’absence de protection contre une opération de suppression ; les données sont irrémédiablement perdues lors de l’acceptation d’une opération de suppression au niveau de l’entité ou supérieur (coffre-fort, groupe de ressources, abonnement, etc.)
Recoverable+Purgeable	Désigne un état de coffre-fort dans lequel la suppression est récupérable, et qui permet également une suppression immédiate et permanente (c’est-à-dire la purge). Ce niveau garantit la récupérabilité de l’entité supprimée pendant l’intervalle de rétention (90 jours), sauf si une opération de purge est demandée ou si l’abonnement est annulé. Le système le supprimera définitivement après 90 jours, s’il n’est pas récupéré
Recoverable	Désigne un état de coffre-fort dans lequel la suppression est récupérable sans possibilité de suppression immédiate et permanente (c’est-à-dire la purge). Ce niveau garantit la récupérabilité de l’entité supprimée pendant l’intervalle de rétention (90 jours) et pendant que l’abonnement est toujours disponible. Le système le supprimera définitivement après 90 jours, s’il n’est pas récupéré
Recoverable+ProtectedSubscription	Désigne un état de coffre-fort et d’abonnement dans lequel la suppression est récupérable dans un intervalle de rétention (90 jours), la suppression immédiate et définitive (c’est-à-dire la purge) n’est pas autorisée et dans lequel l’abonnement lui-même ne peut pas être annulé de manière permanente. Le système le supprimera définitivement après 90 jours, s’il n’est pas récupéré
CustomizedRecoverable+Purgeable	Désigne un état de coffre-fort dans lequel la suppression est récupérable, et qui permet également une suppression immédiate et permanente (c’est-à-dire purge lorsque 7< = SoftDeleteRetentionInDays < 90). Ce niveau garantit la récupérabilité de l’entité supprimée pendant l’intervalle de rétention, sauf si une opération de purge est demandée ou si l’abonnement est annulé.
CustomizedRecoverable	Désigne un état de coffre-fort dans lequel la suppression est récupérable sans possibilité de suppression immédiate et permanente (c’est-à-dire purge lorsque 7< = SoftDeleteRetentionInDays < 90). Ce niveau garantit la récupérabilité de l’entité supprimée pendant l’intervalle de rétention et pendant que l’abonnement est toujours disponible.
CustomizedRecoverable+ProtectedSubscription	Désigne un état de coffre-fort et d’abonnement dans lequel la suppression est récupérable, la suppression immédiate et permanente (c’est-à-dire la purge) n’est pas autorisée, et dans lequel l’abonnement lui-même ne peut pas être annulé définitivement lorsque 7<= SoftDeleteRetentionInDays < 90. Ce niveau garantit la récupérabilité de l’entité supprimée pendant l’intervalle de rétention, et reflète également le fait que l’abonnement lui-même ne peut pas être annulé.

Error

Object

Erreur de serveur Key Vault.

Nom	Type	Description
code	string	Code d’erreur.
innererror	Error	Erreur de serveur Key Vault.
message	string	Message d’erreur.

KeyVaultError

Object

Exception d’erreur du coffre de clés.

Nom	Type	Description
error	Error	Erreur de serveur Key Vault.

StorageAccountAttributes

Object

Attributs de gestion du compte de stockage.

Nom	Type	Description
created	integer (unixtime)	Heure de création en UTC.
enabled	boolean	État Enabled de l’objet.
recoverableDays	integer (int32)	Jours de conservation des données softDelete. La valeur doit être >=7 et <=90 lorsque la suppression douce est activée, sinon 0.
recoveryLevel	DeletionRecoveryLevel	Reflète le niveau de récupération de suppression actuellement en vigueur pour les comptes de stockage dans le coffre-fort actuel. S’il contient « Purgable », le compte de stockage peut être définitivement supprimé par un utilisateur privilégié ; Dans le cas contraire, seul le système peut purger le compte de stockage à la fin de l’intervalle de rétention.
updated	integer (unixtime)	Dernière mise à jour de l’heure en UTC.

StorageAccountUpdateParameters

Object

Paramètres de mise à jour du compte de stockage.

Nom	Type	Description
activeKeyName	string	Nom de la clé de compte de stockage actif actuel.
attributes	StorageAccountAttributes	Les attributs du compte de stockage.
autoRegenerateKey	boolean	Si KeyVault doit gérer le compte de stockage pour l’utilisateur.
regenerationPeriod	string	Durée du temps de régénération des touches spécifiée au format ISO-8601.
tags	object	Métadonnées spécifiques à l’application sous la forme de paires clé-valeur.

StorageBundle

Object

Un bundle de comptes de stockage se compose des détails du compte de stockage Key Vault et de ses attributs.

Nom	Type	Description
activeKeyName	string	Nom de la clé de compte de stockage actif actuel.
attributes	StorageAccountAttributes	Attributs du compte de stockage.
autoRegenerateKey	boolean	Si KeyVault doit gérer le compte de stockage pour l’utilisateur.
id	string	L’ID du compte de stockage.
regenerationPeriod	string	Durée du temps de régénération des touches spécifiée au format ISO-8601.
resourceId	string	ID de ressource du compte de stockage.
tags	object	Métadonnées spécifiques à l’application sous la forme de paires clé-valeur

Partager via

Update Storage Account - Update Storage Account

Paramètres URI

Corps de la demande

Réponses

Exemples

Update Storage account

Exemple de requête

Exemple de réponse

Définitions

DeletionRecoveryLevel

Error

KeyVaultError

StorageAccountAttributes

StorageAccountUpdateParameters

StorageBundle