Update Storage Account - Update Storage Account

Služba:: Key Vault

Verze rozhraní API:: 2025-07-01

Aktualizuje zadané atributy přidružené k danému účtu úložiště. Tato operace vyžaduje oprávnění k ukládání/nastavení/aktualizaci.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	Název úložištního účtu.
vaultBaseUrl	path	True	string	Název úložiště, například `https://myvault.vault.azure.net`.
api-version	query	True	string	Verze rozhraní API klienta.

Text požadavku

Name	Typ	Description
activeKeyName	string	Název aktuálního aktivního klíče účtu úložiště.
attributes	StorageAccountAttributes	Atributy účtu úložiště.
autoRegenerateKey	boolean	Určuje, jestli má Trezor klíčů spravovat účet úložiště pro uživatele.
regenerationPeriod	string	Doba regenerace klíče zadaná ve formátu ISO-8601.
tags	object	Metadata specifická pro aplikaci ve formě párů klíč-hodnota.

Odpovědi

Name	Typ	Description
200 OK	StorageBundle	Aktualizovaný účet úložiště.
Other Status Codes	KeyVaultError	Chybová odpověď služby Key Vault popisující, proč se operace nezdařila.

Příklady

Update Storage account

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kó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"
  }
}

Definice

Name	Description
DeletionRecoveryLevel	Odráží úroveň obnovení odstranění, která je aktuálně platná pro účty úložiště v aktuálním trezoru. Pokud obsahuje možnost Vyprázdnit, může účet úložiště trvale odstranit privilegovaný uživatel. V opačném případě může účet úložiště na konci intervalu uchovávání vyprázdnit pouze systém.
Error	Chyba serveru trezoru klíčů.
KeyVaultError	Výjimka chyby trezoru klíčů.
StorageAccountAttributes	Atributy správy účtu úložiště.
StorageAccountUpdateParameters	Parametry aktualizace účtu úložiště.
StorageBundle	Balíček účtu úložiště se skládá z podrobností o účtu úložiště trezoru klíčů a jeho atributů.

DeletionRecoveryLevel

Výčet

Odráží úroveň obnovení odstranění, která je aktuálně platná pro účty úložiště v aktuálním trezoru. Pokud obsahuje možnost Vyprázdnit, může účet úložiště trvale odstranit privilegovaný uživatel. V opačném případě může účet úložiště na konci intervalu uchovávání vyprázdnit pouze systém.

Hodnota	Description
Purgeable	Označuje stav úschovny, ve kterém je odstranění nevratnou operací bez možnosti obnovení. Tato úroveň odpovídá tomu, že proti operaci Delete není k dispozici žádná ochrana. data jsou nenávratně ztracena při přijetí operace odstranění na úrovni entity nebo vyšší (trezor, skupina prostředků, předplatné atd.)
Recoverable+Purgeable	Označuje stav úložiště, ve kterém je odstranění obnovitelné a který také umožňuje okamžité a trvalé odstranění (tj. vyprázdnění). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání (90 dnů), pokud není požadována operace vymazání nebo není zrušeno předplatné. Systém jej trvale smaže po 90 dnech, pokud není obnoven
Recoverable	Označuje stav úložiště, ve kterém je odstranění obnovitelné bez možnosti okamžitého a trvalého odstranění (tj. vyprázdnění). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání (90 dnů) a po dobu, kdy je předplatné stále k dispozici. Systém jej trvale smaže po 90 dnech, pokud není obnoven
Recoverable+ProtectedSubscription	Označuje stav trezoru a předplatného, ve kterém je odstranění obnovitelné v intervalu uchovávání (90 dnů), okamžité a trvalé odstranění (tj. vymazání) není povoleno a ve kterém samotné předplatné nelze trvale zrušit. Systém jej trvale smaže po 90 dnech, pokud není obnoven
CustomizedRecoverable+Purgeable	Označuje stav trezoru, ve kterém je odstranění obnovitelné a který také umožňuje okamžité a trvalé odstranění (tj. vymazání, když 7< = SoftDeleteRetentionInDays < 90). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání, pokud není požadována operace vyprázdnění nebo není zrušeno předplatné.
CustomizedRecoverable	Označuje stav trezoru, ve kterém je odstranění obnovitelné bez možnosti okamžitého a trvalého odstranění (tj. vyprázdnění, když 7< = SoftDeleteRetentionInDays < 90). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání a po dobu, kdy je předplatné stále k dispozici.
CustomizedRecoverable+ProtectedSubscription	Označuje stav trezoru a předplatného, ve kterém je odstranění obnovitelné, okamžité a trvalé odstranění (tj. vymazání) není povoleno a ve kterém samotné předplatné nelze trvale zrušit, když 7< = SoftDeleteRetentionInDays < 90. Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání a také odráží skutečnost, že samotné předplatné nelze zrušit.

Error

Objekt

Chyba serveru trezoru klíčů.

Name	Typ	Description
code	string	Kód chyby.
innererror	Error	Chyba serveru trezoru klíčů.
message	string	Chybová zpráva.

KeyVaultError

Objekt

Výjimka chyby trezoru klíčů.

Name	Typ	Description
error	Error	Chyba serveru trezoru klíčů.

StorageAccountAttributes

Objekt

Atributy správy účtu úložiště.

Name	Typ	Description
created	integer (unixtime)	Čas vytvoření v UTC.
enabled	boolean	Stav Povoleno objektu.
recoverableDays	integer (int32)	Dny uchovávání dat softDelete. Hodnota by měla být >=7 a <=90, pokud je povoleno softDelete, jinak 0.
recoveryLevel	DeletionRecoveryLevel	Odráží úroveň obnovení odstranění, která je aktuálně platná pro účty úložiště v aktuálním trezoru. Pokud obsahuje možnost Vyprázdnit, může účet úložiště trvale odstranit privilegovaný uživatel. V opačném případě může účet úložiště na konci intervalu uchovávání vyprázdnit pouze systém.
updated	integer (unixtime)	Čas poslední aktualizace v UTC.

StorageAccountUpdateParameters

Objekt

Parametry aktualizace účtu úložiště.

Name	Typ	Description
activeKeyName	string	Název aktuálního aktivního klíče účtu úložiště.
attributes	StorageAccountAttributes	Atributy účtu úložiště.
autoRegenerateKey	boolean	Určuje, jestli má Trezor klíčů spravovat účet úložiště pro uživatele.
regenerationPeriod	string	Doba regenerace klíče zadaná ve formátu ISO-8601.
tags	object	Metadata specifická pro aplikaci ve formě párů klíč-hodnota.

StorageBundle

Objekt

Balíček účtu úložiště se skládá z podrobností o účtu úložiště trezoru klíčů a jeho atributů.

Name	Typ	Description
activeKeyName	string	Název aktuálního aktivního klíče účtu úložiště.
attributes	StorageAccountAttributes	Atributy účtu úložiště.
autoRegenerateKey	boolean	Určuje, jestli má Trezor klíčů spravovat účet úložiště pro uživatele.
id	string	ID účtu úložiště.
regenerationPeriod	string	Doba regenerace klíče zadaná ve formátu ISO-8601.
resourceId	string	ID prostředku účtu úložiště.
tags	object	Metadata specifická pro aplikaci ve formě párů klíč-hodnota

Sdílet prostřednictvím

Update Storage Account - Update Storage Account

Parametry identifikátoru URI

Text požadavku

Odpovědi

Příklady

Update Storage account

Ukázkový požadavek

Ukázková odpověď

Definice

DeletionRecoveryLevel

Error

KeyVaultError

StorageAccountAttributes

StorageAccountUpdateParameters

StorageBundle