Update Storage Account - Update Storage Account

Szolgáltatás:

Key Vault

API-verzió:

2025-07-01

Frissíti az adott tárfiókhoz társított megadott attribútumokat. Ehhez a művelethez a storage/set/update engedély szükséges.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	A tárfiók neve.
vaultBaseUrl	path	True	string	A tároló neve, például https://myvault.vault.azure.net.
api-version	query	True	string	Ügyfél API-verzió.

Kérelem törzse

Name	Típus	Description
activeKeyName	string	Az aktuális aktív tárfiók kulcsának neve.
attributes	StorageAccountAttributes	A tárfiók attribútumai.
autoRegenerateKey	boolean	Azt határozza meg, hogy a KeyVault kezelje-e a felhasználó tárfiókját.
regenerationPeriod	string	A kulcs újragenerálási időtartama ISO-8601 formátumban megadva.
tags	object	Alkalmazásspecifikus metaadatok kulcs-érték párok formájában.

Válaszok

Name	Típus	Description
200 OK	StorageBundle	A frissített tárfiók.
Other Status Codes	KeyVaultError	Key Vault hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Példák

Update Storage account

Mintakérelem

HTTP

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

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

Mintaválasz

Állapotkód:

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

Definíciók

Name	Description
DeletionRecoveryLevel	Az aktuális tárolóban lévő tárfiókokra jelenleg érvényben lévő törlési helyreállítási szintet tükrözi. Ha a "Törölhető" értéket tartalmazza, a tárfiókot egy kiemelt felhasználó véglegesen törölheti; Ellenkező esetben csak a rendszer tudja kiüríteni a tárfiókot a megőrzési időköz végén.
Error	A kulcstartó-kiszolgáló hibája.
KeyVaultError	A kulcstartó hibakivétele.
StorageAccountAttributes	A tárfiók-kezelési attribútumok.
StorageAccountUpdateParameters	A tárfiók frissítési paraméterei.
StorageBundle	A Storage-fiók csomagja a Key Vault tárfiók adataiból és attribútumaiból áll.

DeletionRecoveryLevel

Enumerálás

Az aktuális tárolóban lévő tárfiókokra jelenleg érvényben lévő törlési helyreállítási szintet tükrözi. Ha a "Törölhető" értéket tartalmazza, a tárfiókot egy kiemelt felhasználó véglegesen törölheti; Ellenkező esetben csak a rendszer tudja kiüríteni a tárfiókot a megőrzési időköz végén.

Érték	Description
Purgeable	Olyan tárolóállapotot jelöl, amelyben a törlés visszafordíthatatlan művelet, helyreállítás lehetősége nélkül. Ez a szint azt jelenti, hogy nincs védelem a törlési műveletekkel szemben; az adatok helyrehozhatatlanul elvesznek, ha elfogad egy törlési műveletet entitásszintű vagy magasabb szinten (tároló, erőforráscsoport, előfizetés stb.)
Recoverable+Purgeable	Olyan tárolóállapotot jelöl, amelyben a törlés helyreállítható, és amely lehetővé teszi az azonnali és végleges törlést (azaz a törlést). Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időköz (90 nap) alatt, kivéve, ha a rendszer végleges törlési műveletet kér, vagy az előfizetést megszakítja. A rendszer 90 nap elteltével véglegesen törli, ha nem áll helyre
Recoverable	Olyan tárolóállapotot jelöl, amelyben a törlés helyreállítható azonnali és végleges törlés (pl. törlés) lehetősége nélkül. Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időköz alatt (90 nap), és amíg az előfizetés még elérhető. A rendszer 90 nap elteltével véglegesen törli, ha nem áll helyre
Recoverable+ProtectedSubscription	Olyan tároló- és előfizetési állapotot jelöl, amelyben a törlés a megőrzési időközön belül (90 nap) helyreállítható, az azonnali és végleges törlés (azaz a törlés) nem engedélyezett, és amelyben maga az előfizetés nem mondható le véglegesen. A rendszer 90 nap elteltével véglegesen törli, ha nem áll helyre
CustomizedRecoverable+Purgeable	Olyan tárolóállapotot jelöl, amelyben a törlés helyreállítható, és amely azonnali és végleges törlést is lehetővé tesz (azaz törlés, ha 7<= SoftDeleteRetentionInDays < 90). Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időköz alatt, kivéve, ha a rendszer végleges törlési műveletet kér, vagy az előfizetést megszakítja.
CustomizedRecoverable	Olyan tárolóállapotot jelöl, amelyben a törlés helyreállítható az azonnali és végleges törlés lehetősége nélkül (azaz törlés, ha 7<= SoftDeleteRetentionInDays < 90). Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időköz alatt, és amíg az előfizetés még elérhető.
CustomizedRecoverable+ProtectedSubscription	Olyan tároló és előfizetési állapotot jelöl, amelyben a törlés helyreállítható, az azonnali és végleges törlés (azaz a törlés) nem engedélyezett, és amelyben maga az előfizetés nem mondható le véglegesen, ha 7<= SoftDeleteRetentionInDays < 90. Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időszak alatt, és azt is tükrözi, hogy maga az előfizetés nem mondható le.

Error

Objektum

A kulcstartó-kiszolgáló hibája.

Name	Típus	Description
code	string	A hibakód.
innererror	Error	A kulcstartó-kiszolgáló hibája.
message	string	A hibaüzenet.

KeyVaultError

Objektum

A kulcstartó hibakivétele.

Name	Típus	Description
error	Error	A kulcstartó-kiszolgáló hibája.

StorageAccountAttributes

Objektum

A tárfiók-kezelési attribútumok.

Name	Típus	Description
created	integer (unixtime)	Létrehozás ideje UTC-ben.
enabled	boolean	az objektum engedélyezett állapota.
recoverableDays	integer (int32)	softDelete adatmegőrzési napok. Az értéknek =7 és <=90-nek kell lennie>, ha a softDelete engedélyezve van, ellenkező esetben 0.
recoveryLevel	DeletionRecoveryLevel	Az aktuális tárolóban lévő tárfiókokra jelenleg érvényben lévő törlési helyreállítási szintet tükrözi. Ha a "Törölhető" értéket tartalmazza, a tárfiókot egy kiemelt felhasználó véglegesen törölheti; Ellenkező esetben csak a rendszer tudja kiüríteni a tárfiókot a megőrzési időköz végén.
updated	integer (unixtime)	Utolsó frissítés időpontja UTC-ben.

StorageAccountUpdateParameters

Objektum

A tárfiók frissítési paraméterei.

Name	Típus	Description
activeKeyName	string	Az aktuális aktív tárfiók kulcsának neve.
attributes	StorageAccountAttributes	A tárfiók attribútumai.
autoRegenerateKey	boolean	Azt határozza meg, hogy a KeyVault kezelje-e a felhasználó tárfiókját.
regenerationPeriod	string	A kulcs újragenerálási időtartama ISO-8601 formátumban megadva.
tags	object	Alkalmazásspecifikus metaadatok kulcs-érték párok formájában.

StorageBundle

Objektum

A Storage-fiók csomagja a Key Vault tárfiók adataiból és attribútumaiból áll.

Name	Típus	Description
activeKeyName	string	Az aktuális aktív tárfiók kulcsának neve.
attributes	StorageAccountAttributes	A tárfiók attribútumai.
autoRegenerateKey	boolean	Azt határozza meg, hogy a KeyVault kezelje-e a felhasználó tárfiókját.
id	string	A tárfiók azonosítója.
regenerationPeriod	string	A kulcs újragenerálási időtartama ISO-8601 formátumban megadva.
resourceId	string	A tárfiók erőforrás-azonosítója.
tags	object	Alkalmazásspecifikus metaadatok kulcs-érték párok formájában