Update Storage Account - Update Storage Account

Servizio:: Key Vault

Versione API:: 2025-07-01

Aggiorna gli attributi specificati associati all'account di archiviazione specificato. Questa operazione richiede l'autorizzazione di archiviazione/impostazione/aggiornamento.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	Nome dell'account di archiviazione.
vaultBaseUrl	path	True	string	Il nome dell'insieme di credenziali, ad esempio `https://myvault.vault.azure.net`.
api-version	query	True	string	Versione dell'API client.

Corpo della richiesta

Nome	Tipo	Descrizione
activeKeyName	string	Nome della chiave dell'account di archiviazione attivo corrente.
attributes	StorageAccountAttributes	Attributi dell'account di archiviazione.
autoRegenerateKey	boolean	Indica se KeyVault deve gestire l'account di archiviazione per l'utente.
regenerationPeriod	string	La durata del tempo di rigenerazione della chiave specificata nel formato ISO-8601.
tags	object	Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.

Risposte

Nome	Tipo	Descrizione
200 OK	StorageBundle	Account di archiviazione aggiornato.
Other Status Codes	KeyVaultError	Risposta all'errore di Key Vault che descrive il motivo per cui l'operazione non è riuscita.

Esempio

Update Storage account

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 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"
  }
}

Definizioni

Nome	Descrizione
DeletionRecoveryLevel	Riflette il livello di ripristino dell'eliminazione attualmente in vigore per gli account di archiviazione nell'insieme di credenziali corrente. Se contiene "Purgeable", l'account di archiviazione può essere eliminato definitivamente da un utente con privilegi; In caso contrario, solo il sistema può eliminare l'account di archiviazione al termine dell'intervallo di conservazione.
Error	Errore del server dell'insieme di credenziali delle chiavi.
KeyVaultError	Eccezione di errore dell'insieme di credenziali delle chiavi.
StorageAccountAttributes	Attributi di gestione dell'account di archiviazione.
StorageAccountUpdateParameters	Parametri di aggiornamento dell'account di archiviazione.
StorageBundle	Un bundle dell'account di archiviazione è costituito dai dettagli dell'account di archiviazione dell'insieme di credenziali delle chiavi e dai relativi attributi.

DeletionRecoveryLevel

Enumerazione

Riflette il livello di ripristino dell'eliminazione attualmente in vigore per gli account di archiviazione nell'insieme di credenziali corrente. Se contiene "Purgeable", l'account di archiviazione può essere eliminato definitivamente da un utente con privilegi; In caso contrario, solo il sistema può eliminare l'account di archiviazione al termine dell'intervallo di conservazione.

Valore	Descrizione
Purgeable	Indica uno stato dell'insieme di credenziali in cui l'eliminazione è un'operazione irreversibile, senza possibilità di ripristino. Questo livello corrisponde all'assenza di protezione contro un'operazione di eliminazione. i dati vengono irrimediabilmente persi dopo l'accettazione di un'operazione di eliminazione a livello di entità o superiore (insieme di credenziali, gruppo di risorse, sottoscrizione e così via)
Recoverable+Purgeable	Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile e che consente anche l'eliminazione immediata e permanente (ad esempio, l'eliminazione). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione (90 giorni), a meno che non venga richiesta un'operazione di ripulitura o la sottoscrizione non venga annullata. Il sistema lo eliminerà definitivamente dopo 90 giorni, se non viene ripristinato
Recoverable	Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile senza la possibilità di un'eliminazione immediata e permanente (ad esempio, l'eliminazione). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione (90 giorni) e mentre la sottoscrizione è ancora disponibile. Il sistema lo eliminerà definitivamente dopo 90 giorni, se non viene ripristinato
Recoverable+ProtectedSubscription	Indica uno stato dell'insieme di credenziali e della sottoscrizione in cui l'eliminazione è recuperabile entro l'intervallo di conservazione (90 giorni), l'eliminazione immediata e permanente (ad esempio l'eliminazione) non è consentita e in cui la sottoscrizione stessa non può essere annullata in modo permanente. Il sistema lo eliminerà definitivamente dopo 90 giorni, se non viene ripristinato
CustomizedRecoverable+Purgeable	Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile e che consente anche l'eliminazione immediata e permanente (ad esempio, l'eliminazione quando 7<= SoftDeleteRetentionInDays < 90). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione, a meno che non venga richiesta un'operazione di eliminazione o la sottoscrizione non venga annullata.
CustomizedRecoverable	Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile senza la possibilità di un'eliminazione immediata e permanente (ad esempio, l'eliminazione quando 7<= SoftDeleteRetentionInDays < 90). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione e mentre la sottoscrizione è ancora disponibile.
CustomizedRecoverable+ProtectedSubscription	Indica uno stato dell'insieme di credenziali e della sottoscrizione in cui l'eliminazione è recuperabile, l'eliminazione immediata e permanente (ad esempio l'eliminazione) non è consentita e in cui la sottoscrizione stessa non può essere annullata in modo permanente quando 7<= SoftDeleteRetentionInDays < 90. Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione e riflette anche il fatto che la sottoscrizione stessa non può essere annullata.

Error

Object

Errore del server dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
code	string	Codice di errore.
innererror	Error	Errore del server dell'insieme di credenziali delle chiavi.
message	string	Messaggio di errore.

KeyVaultError

Object

Eccezione di errore dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
error	Error	Errore del server dell'insieme di credenziali delle chiavi.

StorageAccountAttributes

Object

Attributi di gestione dell'account di archiviazione.

Nome	Tipo	Descrizione
created	integer (unixtime)	Ora di creazione in UTC.
enabled	boolean	Stato abilitato dell'oggetto.
recoverableDays	integer (int32)	softDelete i giorni di conservazione dei dati. Il valore deve essere >=7 e <=90 quando softDelete abilitato, altrimenti 0.
recoveryLevel	DeletionRecoveryLevel	Riflette il livello di ripristino dell'eliminazione attualmente in vigore per gli account di archiviazione nell'insieme di credenziali corrente. Se contiene "Purgeable", l'account di archiviazione può essere eliminato definitivamente da un utente con privilegi; In caso contrario, solo il sistema può eliminare l'account di archiviazione al termine dell'intervallo di conservazione.
updated	integer (unixtime)	Ultimo aggiornamento dell'ora in UTC.

StorageAccountUpdateParameters

Object

Parametri di aggiornamento dell'account di archiviazione.

Nome	Tipo	Descrizione
activeKeyName	string	Nome della chiave dell'account di archiviazione attivo corrente.
attributes	StorageAccountAttributes	Attributi dell'account di archiviazione.
autoRegenerateKey	boolean	Indica se KeyVault deve gestire l'account di archiviazione per l'utente.
regenerationPeriod	string	La durata del tempo di rigenerazione della chiave specificata nel formato ISO-8601.
tags	object	Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.

StorageBundle

Object

Un bundle dell'account di archiviazione è costituito dai dettagli dell'account di archiviazione dell'insieme di credenziali delle chiavi e dai relativi attributi.

Nome	Tipo	Descrizione
activeKeyName	string	Nome della chiave dell'account di archiviazione attivo corrente.
attributes	StorageAccountAttributes	Attributi dell'account di archiviazione.
autoRegenerateKey	boolean	Indica se KeyVault deve gestire l'account di archiviazione per l'utente.
id	string	ID dell'account di archiviazione.
regenerationPeriod	string	La durata del tempo di rigenerazione della chiave specificata nel formato ISO-8601.
resourceId	string	ID risorsa dell'account di archiviazione.
tags	object	Metadati specifici dell'applicazione sotto forma di coppie chiave-valore

Condividi tramite

Update Storage Account - Update Storage Account

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Update Storage account

Esempio di richiesta

Risposta di esempio

Definizioni

DeletionRecoveryLevel

Error

KeyVaultError

StorageAccountAttributes

StorageAccountUpdateParameters

StorageBundle