Update Storage Account - Update Storage Account

Usługa:: Key Vault

Wersja interfejsu API:: 2025-07-01

Aktualizuje określone atrybuty skojarzone z danym kontem magazynu. Ta operacja wymaga uprawnienia do przechowywania/ustawiania/aktualizowania.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	Nazwa konta magazynu.
vaultBaseUrl	path	True	string	Nazwa magazynu, na przykład `https://myvault.vault.azure.net`.
api-version	query	True	string	Wersja interfejsu API klienta.

Treść żądania

Nazwa	Typ	Opis
activeKeyName	string	Bieżąca nazwa klucza aktywnego konta magazynu.
attributes	StorageAccountAttributes	Atrybuty konta magazynu.
autoRegenerateKey	boolean	Określa, czy usługa KeyVault powinna zarządzać kontem magazynu dla użytkownika.
regenerationPeriod	string	Czas trwania regeneracji klucza określony w formacie ISO-8601.
tags	object	Metadane specyficzne dla aplikacji w postaci par klucz-wartość.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	StorageBundle	Zaktualizowane konto magazynu.
Other Status Codes	KeyVaultError	Odpowiedź na błąd Key Vault opisująca, dlaczego operacja nie powiodła się.

Przykłady

Update Storage account

Przykładowe żądanie

HTTP

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

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

Przykładowa odpowiedź

Kod stanu:: 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"
  }
}

Definicje

Nazwa	Opis
DeletionRecoveryLevel	Odzwierciedla poziom odzyskiwania usuwania aktualnie obowiązujący dla kont magazynu w bieżącym magazynie. Jeśli zawiera wartość "Usuwalne", konto magazynu może zostać trwale usunięte przez użytkownika uprzywilejowanego; W przeciwnym razie tylko system może przeczyścić konto magazynu na końcu interwału przechowywania.
Error	Błąd serwera magazynu kluczy.
KeyVaultError	Wyjątek błędu magazynu kluczy.
StorageAccountAttributes	Atrybuty zarządzania kontem magazynu.
StorageAccountUpdateParameters	Parametry aktualizacji konta magazynu.
StorageBundle	Pakiet konta magazynu składa się ze szczegółów konta magazynu kluczy oraz jego atrybutów.

DeletionRecoveryLevel

Wyliczanie

Odzwierciedla poziom odzyskiwania usuwania aktualnie obowiązujący dla kont magazynu w bieżącym magazynie. Jeśli zawiera wartość "Usuwalne", konto magazynu może zostać trwale usunięte przez użytkownika uprzywilejowanego; W przeciwnym razie tylko system może przeczyścić konto magazynu na końcu interwału przechowywania.

Wartość	Opis
Purgeable	Oznacza stan magazynu, w którym usunięcie jest operacją nieodwracalną, bez możliwości odzyskania. Ten poziom odpowiada temu, że nie jest dostępna żadna ochrona przed operacją usuwania; dane są bezpowrotnie tracone po zaakceptowaniu operacji usuwania na poziomie encji lub wyższym (magazyn, grupa zasobów, subskrypcja itp.)
Recoverable+Purgeable	Oznacza stan repozytorium, w którym usunięcie jest możliwe do odzyskania, a także umożliwia natychmiastowe i trwałe usunięcie (tj. usunięcie). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania (90 dni), chyba że zostanie zażądana operacja przeczyszczania lub subskrypcja zostanie anulowana. System usunie go trwale po 90 dniach, jeśli nie zostanie odzyskany
Recoverable	Oznacza stan magazynu, w którym usunięcie jest możliwe do odzyskania bez możliwości natychmiastowego i trwałego usunięcia (tj. usunięcia). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania (90 dni) i gdy subskrypcja jest nadal dostępna. System usunie go trwale po 90 dniach, jeśli nie zostanie odzyskany
Recoverable+ProtectedSubscription	Oznacza stan magazynu i subskrypcji, w którym usunięcie można odzyskać w okresie przechowywania (90 dni), natychmiastowe i trwałe usunięcie (tj. czyszczenie) jest niedozwolone i w którym samej subskrypcji nie można trwale anulować. System usunie go trwale po 90 dniach, jeśli nie zostanie odzyskany
CustomizedRecoverable+Purgeable	Oznacza stan magazynu, w którym usunięcie jest możliwe do odzyskania, a także umożliwia natychmiastowe i trwałe usunięcie (tj. przeczyszczenie, gdy 7<= SoftDeleteRetentionInDays < 90). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w interwale przechowywania, chyba że zostanie zażądana operacja przeczyszczania lub subskrypcja zostanie anulowana.
CustomizedRecoverable	Oznacza stan magazynu, w którym usunięcie można odzyskać bez możliwości natychmiastowego i trwałego usunięcia (tj. czyszczenie, gdy 7<= SoftDeleteRetentionInDays < 90). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania i gdy subskrypcja jest nadal dostępna.
CustomizedRecoverable+ProtectedSubscription	Oznacza stan skarbca i subskrypcji, w którym usunięcie można odzyskać, natychmiastowe i trwałe usunięcie (tj. czyszczenie) nie jest dozwolone i w którym sama subskrypcja nie może zostać trwale anulowana, gdy 7<= SoftDeleteRetentionInDays < 90. Ten poziom gwarantuje odzyskanie usuniętej jednostki w okresie przechowywania, a także odzwierciedla fakt, że samej subskrypcji nie można anulować.

Error

Objekt

Błąd serwera magazynu kluczy.

Nazwa	Typ	Opis
code	string	Kod błędu.
innererror	Error	Błąd serwera magazynu kluczy.
message	string	Komunikat o błędzie.

KeyVaultError

Objekt

Wyjątek błędu magazynu kluczy.

Nazwa	Typ	Opis
error	Error	Błąd serwera magazynu kluczy.

StorageAccountAttributes

Objekt

Atrybuty zarządzania kontem magazynu.

Nazwa	Typ	Opis
created	integer (unixtime)	Czas utworzenia w formacie UTC.
enabled	boolean	Stan włączony obiektu.
recoverableDays	integer (int32)	softDelete data retention days(Dni przechowywania danych softDelete). Wartość powinna wynosić >=7 i <=90, gdy włączona jest funkcja softDelete, w przeciwnym razie 0.
recoveryLevel	DeletionRecoveryLevel	Odzwierciedla poziom odzyskiwania usuwania aktualnie obowiązujący dla kont magazynu w bieżącym magazynie. Jeśli zawiera wartość "Usuwalne", konto magazynu może zostać trwale usunięte przez użytkownika uprzywilejowanego; W przeciwnym razie tylko system może przeczyścić konto magazynu na końcu interwału przechowywania.
updated	integer (unixtime)	Ostatnia aktualizacja czasu w UTC.

StorageAccountUpdateParameters

Objekt

Parametry aktualizacji konta magazynu.

Nazwa	Typ	Opis
activeKeyName	string	Bieżąca nazwa klucza aktywnego konta magazynu.
attributes	StorageAccountAttributes	Atrybuty konta magazynu.
autoRegenerateKey	boolean	Określa, czy usługa KeyVault powinna zarządzać kontem magazynu dla użytkownika.
regenerationPeriod	string	Czas trwania regeneracji klucza określony w formacie ISO-8601.
tags	object	Metadane specyficzne dla aplikacji w postaci par klucz-wartość.

StorageBundle

Objekt

Pakiet konta magazynu składa się ze szczegółów konta magazynu kluczy oraz jego atrybutów.

Nazwa	Typ	Opis
activeKeyName	string	Bieżąca nazwa klucza aktywnego konta magazynu.
attributes	StorageAccountAttributes	Atrybuty konta magazynu.
autoRegenerateKey	boolean	Określa, czy usługa KeyVault powinna zarządzać kontem magazynu dla użytkownika.
id	string	Identyfikator konta magazynu.
regenerationPeriod	string	Czas trwania regeneracji klucza określony w formacie ISO-8601.
resourceId	string	Identyfikator zasobu konta magazynu.
tags	object	Metadane specyficzne dla aplikacji w postaci par klucz-wartość

Udostępnij za pośrednictwem

Update Storage Account - Update Storage Account

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

Update Storage account

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

DeletionRecoveryLevel

Error

KeyVaultError

StorageAccountAttributes

StorageAccountUpdateParameters

StorageBundle