Update Storage Account - Update Storage Account

Service:

Key Vault

API-versie:

2025-07-01

Hiermee worden de opgegeven kenmerken bijgewerkt die zijn gekoppeld aan het opgegeven opslagaccount. Voor deze bewerking is de machtiging storage/set/update vereist.

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

URI-parameters

Name	In	Vereist	Type	Description
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	De naam van het opslagaccount.
vaultBaseUrl	path	True	string	De kluisnaam, bijvoorbeeld https://myvault.vault.azure.net.
api-version	query	True	string	Client-API-versie.

Aanvraagbody

Name	Type	Description
activeKeyName	string	De huidige naam van de actieve opslagaccountsleutel.
attributes	StorageAccountAttributes	De kenmerken van het opslagaccount.
autoRegenerateKey	boolean	of KeyVault het opslagaccount voor de gebruiker moet beheren.
regenerationPeriod	string	De duur van de belangrijkste regeneratietijd gespecificeerd in ISO-8601-indeling.
tags	object	Applicatiespecifieke metadata in de vorm van sleutel-waardeparen.

Antwoorden

Name	Type	Description
200 OK	StorageBundle	Het bijgewerkte opslagaccount.
Other Status Codes	KeyVaultError	Key Vault-foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Voorbeelden

Update Storage account

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

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

Definities

Name	Description
DeletionRecoveryLevel	Geeft het herstelniveau voor verwijdering weer dat momenteel van kracht is voor opslagaccounts in de huidige kluis. Als het 'Purgeable' bevat, kan het opslagaccount permanent worden verwijderd door een geprivilegieerde gebruiker; Anders kan alleen het systeem het opslagaccount leegmaken aan het einde van het bewaarinterval.
Error	De fout van de sleutelkluisserver.
KeyVaultError	De uitzondering voor de sleutelkluisfout.
StorageAccountAttributes	De kenmerken voor het beheer van opslagaccounts.
StorageAccountUpdateParameters	De parameters van het opslagaccount worden bijgewerkt.
StorageBundle	Een opslagaccountbundel bestaat uit de gegevens van het sleutelkluisopslagaccount plus de kenmerken ervan.

DeletionRecoveryLevel

Inventarisatie

Geeft het herstelniveau voor verwijdering weer dat momenteel van kracht is voor opslagaccounts in de huidige kluis. Als het 'Purgeable' bevat, kan het opslagaccount permanent worden verwijderd door een geprivilegieerde gebruiker; Anders kan alleen het systeem het opslagaccount leegmaken aan het einde van het bewaarinterval.

Waarde	Description
Purgeable	Geeft een kluisstatus aan waarin verwijdering een onomkeerbare bewerking is, zonder de mogelijkheid tot herstel. Dit niveau komt overeen met het feit dat er geen beveiliging beschikbaar is tegen een Delete-bewerking; de gegevens zijn onherstelbaar verloren gegaan bij het accepteren van een verwijderbewerking op entiteitsniveau of hoger (kluis, resourcegroep, abonnement enz.)
Recoverable+Purgeable	Geeft een kluisstatus aan waarin verwijdering kan worden hersteld en die ook onmiddellijke en permanente verwijdering (d.w.z. opschonen) toestaat. Dit niveau garandeert de herstelbaarheid van de verwijderde entiteit tijdens het bewaarinterval (90 dagen), tenzij een opschoningsbewerking wordt aangevraagd of het abonnement wordt geannuleerd. Het systeem zal het na 90 dagen permanent verwijderen, als het niet wordt hersteld
Recoverable	Geeft een kluisstatus aan waarin verwijdering kan worden hersteld zonder de mogelijkheid van onmiddellijke en permanente verwijdering (d.w.z. opschonen). Dit niveau garandeert de herstelbaarheid van de verwijderde entiteit tijdens het bewaarinterval (90 dagen) en terwijl het abonnement nog beschikbaar is. Het systeem zal het na 90 dagen permanent verwijderen, als het niet wordt hersteld
Recoverable+ProtectedSubscription	Geeft een kluis- en abonnementsstatus aan waarin verwijdering kan worden hersteld binnen het bewaarinterval (90 dagen), onmiddellijke en permanente verwijdering (d.w.z. opschonen) niet is toegestaan en waarin het abonnement zelf niet permanent kan worden geannuleerd. Het systeem zal het na 90 dagen permanent verwijderen, als het niet wordt hersteld
CustomizedRecoverable+Purgeable	Geeft een kluisstatus aan waarin verwijdering kan worden hersteld en die ook onmiddellijke en permanente verwijdering toestaat (d.w.z. opschonen wanneer 7<= SoftDeleteRetentionInDays < 90). Dit niveau garandeert de herstelbaarheid van de verwijderde entiteit tijdens het bewaarinterval, tenzij een opschoningsbewerking wordt aangevraagd of het abonnement wordt geannuleerd.
CustomizedRecoverable	Geeft een kluisstatus aan waarin verwijdering kan worden hersteld zonder de mogelijkheid van onmiddellijke en permanente verwijdering (d.w.z. opschonen wanneer 7<= SoftDeleteRetentionInDays < 90). Dit niveau garandeert de herstelbaarheid van de verwijderde entiteit tijdens het bewaarinterval en terwijl het abonnement nog beschikbaar is.
CustomizedRecoverable+ProtectedSubscription	Geeft een kluis- en abonnementsstatus aan waarin verwijdering kan worden hersteld, onmiddellijke en permanente verwijdering (d.w.z. opschonen) niet is toegestaan en waarin het abonnement zelf niet permanent kan worden geannuleerd wanneer 7<= SoftDeleteRetentionInDays < 90. Dit niveau garandeert de herstelbaarheid van de verwijderde entiteit tijdens het bewaarinterval en weerspiegelt ook het feit dat het abonnement zelf niet kan worden geannuleerd.

Error

Object

De fout van de sleutelkluisserver.

Name	Type	Description
code	string	De foutcode.
innererror	Error	De fout van de sleutelkluisserver.
message	string	Het foutbericht.

KeyVaultError

Object

De uitzondering voor de sleutelkluisfout.

Name	Type	Description
error	Error	De fout van de sleutelkluisserver.

StorageAccountAttributes

Object

De kenmerken voor het beheer van opslagaccounts.

Name	Type	Description
created	integer (unixtime)	Aanmaaktijd in UTC.
enabled	boolean	de ingeschakelde status van het object.
recoverableDays	integer (int32)	softDelete-gegevensretentiedagen. De waarde moet =7 en <=90 zijn >wanneer softDelete is ingeschakeld, anders 0.
recoveryLevel	DeletionRecoveryLevel	Geeft het herstelniveau voor verwijdering weer dat momenteel van kracht is voor opslagaccounts in de huidige kluis. Als het 'Purgeable' bevat, kan het opslagaccount permanent worden verwijderd door een geprivilegieerde gebruiker; Anders kan alleen het systeem het opslagaccount leegmaken aan het einde van het bewaarinterval.
updated	integer (unixtime)	Laatst bijgewerkte tijd in UTC.

StorageAccountUpdateParameters

Object

De parameters van het opslagaccount worden bijgewerkt.

Name	Type	Description
activeKeyName	string	De huidige naam van de actieve opslagaccountsleutel.
attributes	StorageAccountAttributes	De kenmerken van het opslagaccount.
autoRegenerateKey	boolean	of KeyVault het opslagaccount voor de gebruiker moet beheren.
regenerationPeriod	string	De duur van de belangrijkste regeneratietijd gespecificeerd in ISO-8601-indeling.
tags	object	Applicatiespecifieke metadata in de vorm van sleutel-waardeparen.

StorageBundle

Object

Een opslagaccountbundel bestaat uit de gegevens van het sleutelkluisopslagaccount plus de kenmerken ervan.

Name	Type	Description
activeKeyName	string	De huidige naam van de actieve opslagaccountsleutel.
attributes	StorageAccountAttributes	De kenmerken van het opslagaccount.
autoRegenerateKey	boolean	of KeyVault het opslagaccount voor de gebruiker moet beheren.
id	string	De id van het opslagaccount.
regenerationPeriod	string	De duur van de belangrijkste regeneratietijd gespecificeerd in ISO-8601-indeling.
resourceId	string	De resource-id van het opslagaccount.
tags	object	Applicatiespecifieke metadata in de vorm van sleutel-waardeparen