Update Storage Account - Update Storage Account

Dienst:: Key Vault

API-Version:: 2025-07-01

Aktualisiert die angegebenen Attribute, die dem angegebenen Speicherkonto zugeordnet sind. Für diesen Vorgang ist die Berechtigung storage/set/update erforderlich.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	Der Name des Speicherkontos.
vaultBaseUrl	path	True	string	Der Tresorname, z. B `https://myvault.vault.azure.net`. .
api-version	query	True	string	Client-API-Version.

Anforderungstext

Name	Typ	Beschreibung
activeKeyName	string	Der Name des aktuell aktiven Speicherkontoschlüssels.
attributes	StorageAccountAttributes	Die Attribute des Speicherkontos.
autoRegenerateKey	boolean	Gibt an, ob KeyVault das Speicherkonto für den Benutzer verwalten soll.
regenerationPeriod	string	Die Dauer der Schlüsselregenerierungszeit, die im ISO-8601-Format angegeben ist.
tags	object	Anwendungsspezifische Metadaten in Form von Schlüssel-Wert-Paaren.

Antworten

Name	Typ	Beschreibung
200 OK	StorageBundle	Das aktualisierte Speicherkonto.
Other Status Codes	KeyVaultError	Key Vault-Fehlerantwort, in der beschrieben wird, warum der Vorgang fehlgeschlagen ist.

Beispiele

Update Storage account

Beispielanforderung

HTTP

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

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

Beispiel für eine Antwort

Statuscode:: 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"
  }
}

Definitionen

Name	Beschreibung
DeletionRecoveryLevel	Gibt die Wiederherstellungsstufe für das Löschen an, die derzeit für Speicherkonten im aktuellen Tresor gilt. Wenn es "Bereinigungsfähig" enthält, kann das Speicherkonto von einem privilegierten Benutzer dauerhaft gelöscht werden. Andernfalls kann das Speicherkonto am Ende des Aufbewahrungsintervalls nur vom System gelöscht werden.
Error	Der Key Vault-Serverfehler.
KeyVaultError	Die Key Vault-Fehlerausnahme.
StorageAccountAttributes	Die Attribute für die Verwaltung des Speicherkontos.
StorageAccountUpdateParameters	Die Parameter für die Aktualisierung des Speicherkontos.
StorageBundle	Ein Speicherkonto-Bundle besteht aus den Details des Key Vault-Speicherkontos und den zugehörigen Attributen.

DeletionRecoveryLevel

Enumeration

Gibt die Wiederherstellungsstufe für das Löschen an, die derzeit für Speicherkonten im aktuellen Tresor gilt. Wenn es "Bereinigungsfähig" enthält, kann das Speicherkonto von einem privilegierten Benutzer dauerhaft gelöscht werden. Andernfalls kann das Speicherkonto am Ende des Aufbewahrungsintervalls nur vom System gelöscht werden.

Wert	Beschreibung
Purgeable	Gibt einen Tresorstatus an, in dem der Löschvorgang nicht rückgängig gemacht werden kann, ohne dass eine Wiederherstellung möglich ist. Diese Stufe entspricht dem Hintergrund, dass kein Schutz gegen einen Delete-Vorgang verfügbar ist. Die Daten gehen unwiederbringlich verloren, wenn ein Löschvorgang auf Entitätsebene oder höher (Tresor, Ressourcengruppe, Abonnement usw.) akzeptiert wird.
Recoverable+Purgeable	Gibt einen Tresorstatus an, in dem der Löschvorgang wiederhergestellt werden kann und der auch ein sofortiges und dauerhaftes Löschen (d. h. Löschen) ermöglicht. Diese Stufe garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls (90 Tage), es sei denn, es wird ein Bereinigungsvorgang angefordert oder das Abonnement gekündigt. Das System löscht es nach 90 Tagen dauerhaft, wenn es nicht wiederhergestellt wird
Recoverable	Bezeichnet einen Tresorstatus, in dem der Löschvorgang wiederhergestellt werden kann, ohne dass eine sofortige und dauerhafte Löschung möglich ist (d. h. Löschung). Diese Stufe garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls (90 Tage) und solange das Abonnement noch verfügbar ist. Das System löscht es nach 90 Tagen dauerhaft, wenn es nicht wiederhergestellt wird
Recoverable+ProtectedSubscription	Gibt einen Tresor- und Abonnementstatus an, in dem das Löschen innerhalb des Aufbewahrungsintervalls (90 Tage) wiederhergestellt werden kann, ein sofortiges und dauerhaftes Löschen (d. h. Löschung) nicht zulässig ist und in dem das Abonnement selbst nicht dauerhaft gekündigt werden kann. Das System löscht es nach 90 Tagen dauerhaft, wenn es nicht wiederhergestellt wird
CustomizedRecoverable+Purgeable	Gibt einen Tresorstatus an, in dem der Löschvorgang wiederhergestellt werden kann und der auch ein sofortiges und dauerhaftes Löschen zulässt (d. h. Bereinigung, wenn 7<= SoftDeleteRetentionInDays < 90). Diese Stufe garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls, es sei denn, es wird ein Bereinigungsvorgang angefordert oder das Abonnement gekündigt.
CustomizedRecoverable	Gibt einen Tresorstatus an, in dem der Löschvorgang ohne die Möglichkeit eines sofortigen und dauerhaften Löschens wiederhergestellt werden kann (d. h. Bereinigung, wenn 7<= SoftDeleteRetentionInDays < 90). Diese Stufe garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls und solange das Abonnement noch verfügbar ist.
CustomizedRecoverable+ProtectedSubscription	Gibt einen Tresor- und Abonnementstatus an, in dem das Löschen wiederherstellbar ist, ein sofortiges und dauerhaftes Löschen (d. h. Löschen) nicht zulässig ist und in dem das Abonnement selbst nicht dauerhaft gekündigt werden kann, wenn 7<= SoftDeleteRetentionInDays < 90 ist. Diese Stufe garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls und spiegelt auch die Tatsache wider, dass das Abonnement selbst nicht gekündigt werden kann.

Error

Objekt

Der Key Vault-Serverfehler.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
innererror	Error	Der Key Vault-Serverfehler.
message	string	Die Fehlermeldung.

KeyVaultError

Objekt

Die Key Vault-Fehlerausnahme.

Name	Typ	Beschreibung
error	Error	Der Key Vault-Serverfehler.

StorageAccountAttributes

Objekt

Die Attribute für die Verwaltung des Speicherkontos.

Name	Typ	Beschreibung
created	integer (unixtime)	Erstellungszeit in UTC.
enabled	boolean	Der aktivierte Zustand des Objekts.
recoverableDays	integer (int32)	SoftDelete-Datenaufbewahrungstage. Der Wert sollte =7 und <=90 sein>, wenn softDelete aktiviert ist, andernfalls 0.
recoveryLevel	DeletionRecoveryLevel	Gibt die Wiederherstellungsstufe für das Löschen an, die derzeit für Speicherkonten im aktuellen Tresor gilt. Wenn es "Bereinigungsfähig" enthält, kann das Speicherkonto von einem privilegierten Benutzer dauerhaft gelöscht werden. Andernfalls kann das Speicherkonto am Ende des Aufbewahrungsintervalls nur vom System gelöscht werden.
updated	integer (unixtime)	Uhrzeit der letzten Aktualisierung in UTC.

StorageAccountUpdateParameters

Objekt

Die Parameter für die Aktualisierung des Speicherkontos.

Name	Typ	Beschreibung
activeKeyName	string	Der Name des aktuell aktiven Speicherkontoschlüssels.
attributes	StorageAccountAttributes	Die Attribute des Speicherkontos.
autoRegenerateKey	boolean	Gibt an, ob KeyVault das Speicherkonto für den Benutzer verwalten soll.
regenerationPeriod	string	Die Dauer der Schlüsselregenerierungszeit, die im ISO-8601-Format angegeben ist.
tags	object	Anwendungsspezifische Metadaten in Form von Schlüssel-Wert-Paaren.

StorageBundle

Objekt

Ein Speicherkonto-Bundle besteht aus den Details des Key Vault-Speicherkontos und den zugehörigen Attributen.

Name	Typ	Beschreibung
activeKeyName	string	Der Name des aktuell aktiven Speicherkontoschlüssels.
attributes	StorageAccountAttributes	Die Attribute des Speicherkontos.
autoRegenerateKey	boolean	Gibt an, ob KeyVault das Speicherkonto für den Benutzer verwalten soll.
id	string	Die ID des Speicherkontos.
regenerationPeriod	string	Die Dauer der Schlüsselregenerierungszeit, die im ISO-8601-Format angegeben ist.
resourceId	string	Die Ressourcen-ID des Speicherkontos.
tags	object	Anwendungsspezifische Metadaten in Form von Schlüssel-Wert-Paaren

Freigeben über

Update Storage Account - Update Storage Account

URI-Parameter

Anforderungstext

Antworten

Beispiele

Update Storage account

Beispielanforderung

Beispiel für eine Antwort

Definitionen

DeletionRecoveryLevel

Error

KeyVaultError

StorageAccountAttributes

StorageAccountUpdateParameters

StorageBundle