Freigeben über


Update Storage Account - Update Storage Account

Aktualisiert die angegebenen Attribute, die dem angegebenen Speicherkonto zugeordnet sind. Für diesen Vorgang ist die Speicher-/Set/Update-Berechtigung erforderlich.

PATCH {vaultBaseUrl}/storage/{storage-account-name}?api-version=7.4

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 aktuellen 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 im ISO-8601-Format angegebene Dauer der Schlüsselregenerierungszeit.

tags

object

Anwendungsspezifische Metadaten in Form von Schlüsselwertpaaren.

Antworten

Name Typ Beschreibung
200 OK

StorageBundle

Das aktualisierte Speicherkonto.

Other Status Codes

KeyVaultError

Key Vault-Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

Update Storage account

Beispielanforderung

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

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

Beispiel für eine Antwort

{
  "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 Löschwiederherstellungsebene wieder, die derzeit für Speicherkonten im aktuellen Tresor wirksam ist. Wenn es "Löschbar" enthält, kann das Speicherkonto von einem privilegierten Benutzer endgültig gelöscht werden. andernfalls kann nur das System das Speicherkonto am Ende des Aufbewahrungsintervalls löschen.

Error

Der Schlüsseltresorserverfehler.

KeyVaultError

Ausnahme des Schlüsseltresorfehlers.

StorageAccountAttributes

Die Attribute für die Speicherkontoverwaltung.

StorageAccountUpdateParameters

Die Parameter für die Aktualisierung des Speicherkontos.

StorageBundle

Ein Speicherkontobundle besteht aus Details des Schlüsseltresor-Speicherkontos sowie seinen Attributen.

DeletionRecoveryLevel

Gibt die Löschwiederherstellungsebene wieder, die derzeit für Speicherkonten im aktuellen Tresor wirksam ist. Wenn es "Löschbar" enthält, kann das Speicherkonto von einem privilegierten Benutzer endgültig gelöscht werden. andernfalls kann nur das System das Speicherkonto am Ende des Aufbewahrungsintervalls löschen.

Wert Beschreibung
CustomizedRecoverable

Gibt einen Tresorstatus an, in dem die Löschung ohne sofortige und dauerhafte Löschung wiederhergestellt werden kann (d. h. löschen, wenn 7<= SoftDeleteRetentionInDays < 90). Diese Stufe garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls und während der Verfügbarkeit des Abonnements.

CustomizedRecoverable+ProtectedSubscription

Gibt einen Tresor- und Abonnementstatus an, in dem das Löschen wiederherstellbar, sofortige und dauerhafte Löschung (d. h. Löschvorgang) nicht zulässig ist und in dem das Abonnement selbst nicht dauerhaft gekündigt werden kann, wenn 7<= SoftDeleteRetentionInDays < 90. 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 storniert werden kann.

CustomizedRecoverable+Purgeable

Gibt einen Tresorstatus an, in dem die Löschung wiederhergestellt werden kann und die auch sofortige und dauerhafte Löschung ermöglicht (d. h. Löschvorgang bei 7<= SoftDeleteRetentionInDays < 90). Diese Stufe garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls, es sei denn, ein Löschvorgang wird angefordert, oder das Abonnement wird gekündigt.

Purgeable

Gibt einen Tresorstatus an, in dem das Löschen ein unumkehrbarer Vorgang ist, ohne dass die Wiederherstellung möglich ist. Diese Stufe entspricht keinem Schutz vor einem Löschvorgang; die Daten werden unwiderruflich verloren, wenn sie einen Löschvorgang auf Entitätsebene oder höher akzeptieren (Tresor, Ressourcengruppe, Abonnement usw.)

Recoverable

Gibt einen Tresorstatus an, in dem die Löschung ohne die Möglichkeit zum sofortigen und dauerhaften Löschen (d. h. Löschen) wiederhergestellt werden kann. Diese Stufe garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls (90 Tage) und während das Abonnement noch verfügbar ist. Das System löscht es nach 90 Tagen dauerhaft, falls nicht wiederhergestellt.

Recoverable+ProtectedSubscription

Gibt einen Tresor- und Abonnementstatus an, in dem die Löschung innerhalb des Aufbewahrungsintervalls (90 Tage), sofortige und dauerhafte Löschung (d. h. Löschvorgang) nicht zulässig ist und in dem das Abonnement selbst nicht dauerhaft storniert werden kann. Das System löscht es nach 90 Tagen dauerhaft, falls nicht wiederhergestellt.

Recoverable+Purgeable

Gibt einen Tresorstatus an, in dem die Löschung wiederhergestellt werden kann und die auch sofortige und dauerhafte Löschung (d. h. Löschvorgang) zulässt. Diese Stufe garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls (90 Tage), es sei denn, ein Bereinigungsvorgang wird angefordert, oder das Abonnement wird gekündigt. Das System löscht es nach 90 Tagen dauerhaft, falls nicht wiederhergestellt.

Error

Der Schlüsseltresorserverfehler.

Name Typ Beschreibung
code

string

Der Fehlercode.

innererror

Error

Der Schlüsseltresorserverfehler.

message

string

Die Fehlermeldung.

KeyVaultError

Ausnahme des Schlüsseltresorfehlers.

Name Typ Beschreibung
error

Error

Der Schlüsseltresorserverfehler.

StorageAccountAttributes

Die Attribute für die Speicherkontoverwaltung.

Name Typ Beschreibung
created

integer (unixtime)

Erstellungszeit in UTC.

enabled

boolean

der aktivierte Status des Objekts.

recoverableDays

integer (int32)

SoftDelete-Datenaufbewahrungstage. Der Wert sollte >=7 und <=90 sein, wenn "softDelete" aktiviert ist, andernfalls 0.

recoveryLevel

DeletionRecoveryLevel

Gibt die Löschwiederherstellungsebene wieder, die derzeit für Speicherkonten im aktuellen Tresor wirksam ist. Wenn es "Löschbar" enthält, kann das Speicherkonto von einem privilegierten Benutzer endgültig gelöscht werden. andernfalls kann nur das System das Speicherkonto am Ende des Aufbewahrungsintervalls löschen.

updated

integer (unixtime)

Uhrzeit der letzten Aktualisierung in UTC.

StorageAccountUpdateParameters

Die Parameter für die Aktualisierung des Speicherkontos.

Name Typ Beschreibung
activeKeyName

string

Der name des aktuellen 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 im ISO-8601-Format angegebene Dauer der Schlüsselregenerierungszeit.

tags

object

Anwendungsspezifische Metadaten in Form von Schlüsselwertpaaren.

StorageBundle

Ein Speicherkontobundle besteht aus Details des Schlüsseltresor-Speicherkontos sowie seinen Attributen.

Name Typ Beschreibung
activeKeyName

string

Der name des aktuellen aktiven Speicherkontoschlüssels.

attributes

StorageAccountAttributes

Die Speicherkontoattribute.

autoRegenerateKey

boolean

gibt an, ob keyvault das Speicherkonto für den Benutzer verwalten soll.

id

string

Die Speicherkonto-ID.

regenerationPeriod

string

Die im ISO-8601-Format angegebene Dauer der Schlüsselregenerierungszeit.

resourceId

string

Die Ressourcen-ID des Speicherkontos.

tags

object

Anwendungsspezifische Metadaten in Form von Schlüsselwertpaaren