Set Storage Account - Set Storage Account

Tjänst:: Key Vault

API-version:: 2025-07-01

Skapar eller uppdaterar ett nytt lagringskonto. Den här åtgärden kräver lagrings-/uppsättningsbehörighet.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	Namnet på lagringskontot. Det värde du anger kan kopieras globalt i syfte att köra tjänsten. Det angivna värdet får inte innehålla personligt identifierbar eller känslig information.
vaultBaseUrl	path	True	string	Valvnamnet, till exempel `https://myvault.vault.azure.net`.
api-version	query	True	string	Klient-API-version.

Begärandetext

Name	Obligatorisk	Typ	Description
activeKeyName	True	string	Aktuellt namn på nyckeln för det aktiva lagringskontot.
autoRegenerateKey	True	boolean	Om KeyVault ska hantera lagringskontot för användaren.
resourceId	True	string	Resurs-ID för lagringskonto.
attributes		StorageAccountAttributes	Attributen för lagringskontot.
regenerationPeriod		string	Varaktigheten för nyckelregenerering som anges i ISO-8601-format.
tags		object	Programspecifika metadata i form av nyckel/värde-par.

Svar

Name	Typ	Description
200 OK	StorageBundle	Det skapade lagringskontot.
Other Status Codes	KeyVaultError	密钥保管库 felsvar som beskriver varför åtgärden misslyckades.

Exempel

Set Storage account

Exempelbegäran

HTTP

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

{
  "resourceId": "/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Storage/storageAccounts/kvstorageacc",
  "activeKeyName": "key2",
  "autoRegenerateKey": true,
  "regenerationPeriod": "P15D",
  "attributes": {
    "enabled": true
  },
  "tags": {
    "tag1": "val1",
    "tag2": "val2"
  }
}

Exempelsvar

Statuskod:: 200

{
  "id": "https://myvault.vault.azure.net/storage/setStrg01",
  "resourceId": "/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Storage/storageAccounts/kvstorageacc",
  "activeKeyName": "key2",
  "autoRegenerateKey": true,
  "regenerationPeriod": "P15D",
  "attributes": {
    "enabled": true,
    "created": 1490738386,
    "updated": 1490738386,
    "recoveryLevel": "Recoverable+Purgeable"
  },
  "tags": {
    "tag1": "val1",
    "tag2": "val2"
  }
}

Definitioner

Name	Description
DeletionRecoveryLevel	Återspeglar den återställningsnivå för borttagning som för närvarande gäller för lagringskonton i det aktuella valvet. Om det innehåller "Rensningsbar" kan lagringskontot tas bort permanent av en privilegierad användare. Annars kan bara systemet rensa lagringskontot i slutet av kvarhållningsintervallet.
Error	Felet på nyckelvalvsservern.
KeyVaultError	Felundantaget för nyckelvalvet.
StorageAccountAttributes	Attributen för hantering av lagringskontot.
StorageAccountCreateParameters	Lagringskontot skapar parametrar.
StorageBundle	Ett lagringskontopaket består av information om nyckelvalvslagringskontot plus dess attribut.

DeletionRecoveryLevel

Uppräkning

Återspeglar den återställningsnivå för borttagning som för närvarande gäller för lagringskonton i det aktuella valvet. Om det innehåller "Rensningsbar" kan lagringskontot tas bort permanent av en privilegierad användare. Annars kan bara systemet rensa lagringskontot i slutet av kvarhållningsintervallet.

Värde	Description
Purgeable	Anger ett valvtillstånd där borttagning är en oåterkallelig åtgärd, utan möjlighet till återställning. Den här nivån motsvarar att det inte finns något skydd mot en borttagningsåtgärd. data går oåterkalleligt förlorade när du accepterar en borttagningsåtgärd på entitetsnivå eller högre (valv, resursgrupp, prenumeration osv.)
Recoverable+Purgeable	Betecknar ett valvtillstånd där borttagning kan återställas och som även tillåter omedelbar och permanent borttagning (d.v.s. rensning). Den här nivån garanterar återställningen av den borttagna entiteten under kvarhållningsintervallet (90 dagar), såvida inte en rensningsåtgärd begärs eller om prenumerationen avbryts. Systemet kommer att ta bort det permanent efter 90 dagar, om det inte återställs
Recoverable	Betecknar ett valvtillstånd där borttagning kan återställas utan möjlighet till omedelbar och permanent borttagning (d.v.s. rensning). Den här nivån garanterar återställningen av den borttagna entiteten under kvarhållningsintervallet (90 dagar) och medan prenumerationen fortfarande är tillgänglig. Systemet kommer att ta bort det permanent efter 90 dagar, om det inte återställs
Recoverable+ProtectedSubscription	Anger ett valv- och prenumerationstillstånd där borttagningen kan återställas inom kvarhållningsintervallet (90 dagar), omedelbar och permanent borttagning (d.v.s. rensning) inte tillåts och där själva prenumerationen inte kan avbrytas permanent. Systemet kommer att ta bort det permanent efter 90 dagar, om det inte återställs
CustomizedRecoverable+Purgeable	Betecknar ett valvtillstånd där borttagning kan återställas och som också tillåter omedelbar och permanent borttagning (d.v.s. rensning när 7<= SoftDeleteRetentionInDays < 90). Den här nivån garanterar återställningen av den borttagna entiteten under kvarhållningsintervallet, såvida inte en rensningsåtgärd begärs eller prenumerationen avbryts.
CustomizedRecoverable	Betecknar ett valvtillstånd där borttagning kan återställas utan möjlighet till omedelbar och permanent borttagning (d.v.s. rensning när 7<= SoftDeleteRetentionInDays < 90). Den här nivån garanterar återställningen av den borttagna entiteten under kvarhållningsintervallet och medan prenumerationen fortfarande är tillgänglig.
CustomizedRecoverable+ProtectedSubscription	Betecknar ett valv- och prenumerationstillstånd där borttagning kan återställas, omedelbar och permanent borttagning (d.v.s. rensning) inte är tillåten och där själva prenumerationen inte kan avbrytas permanent när 7<= SoftDeleteRetentionInDays < 90. Den här nivån garanterar återställningen av den borttagna entiteten under kvarhållningsintervallet och återspeglar även det faktum att själva prenumerationen inte kan avbrytas.

Error

Objekt

Felet på nyckelvalvsservern.

Name	Typ	Description
code	string	Felkoden.
innererror	Error	Felet på nyckelvalvsservern.
message	string	Felmeddelandet.

KeyVaultError

Objekt

Felundantaget för nyckelvalvet.

Name	Typ	Description
error	Error	Felet på nyckelvalvsservern.

StorageAccountAttributes

Objekt

Attributen för hantering av lagringskontot.

Name	Typ	Description
created	integer (unixtime)	Skapandetid i UTC.
enabled	boolean	Objektets aktiverade tillstånd.
recoverableDays	integer (int32)	softTa bort datakvarhållningsdagar. Värdet ska vara >=7 och <=90 när softDelete är aktiverat, annars 0.
recoveryLevel	DeletionRecoveryLevel	Återspeglar den återställningsnivå för borttagning som för närvarande gäller för lagringskonton i det aktuella valvet. Om det innehåller "Rensningsbar" kan lagringskontot tas bort permanent av en privilegierad användare. Annars kan bara systemet rensa lagringskontot i slutet av kvarhållningsintervallet.
updated	integer (unixtime)	Tid för senaste uppdatering i UTC.

StorageAccountCreateParameters

Objekt

Lagringskontot skapar parametrar.

Name	Typ	Description
activeKeyName	string	Aktuellt namn på nyckeln för det aktiva lagringskontot.
attributes	StorageAccountAttributes	Attributen för lagringskontot.
autoRegenerateKey	boolean	Om KeyVault ska hantera lagringskontot för användaren.
regenerationPeriod	string	Varaktigheten för nyckelregenerering som anges i ISO-8601-format.
resourceId	string	Resurs-ID för lagringskonto.
tags	object	Programspecifika metadata i form av nyckel/värde-par.

StorageBundle

Objekt

Ett lagringskontopaket består av information om nyckelvalvslagringskontot plus dess attribut.

Name	Typ	Description
activeKeyName	string	Namnet på den aktuella aktiva lagringskontonyckeln.
attributes	StorageAccountAttributes	Attributen för lagringskontot.
autoRegenerateKey	boolean	Om KeyVault ska hantera lagringskontot för användaren.
id	string	ID:t för lagringskontot.
regenerationPeriod	string	Varaktigheten för nyckelregenerering som anges i ISO-8601-format.
resourceId	string	Resurs-ID:t för lagringskontot.
tags	object	Programspecifika metadata i form av nyckel/värde-par

Dela via

Set Storage Account - Set Storage Account

URI-parametrar

Begärandetext

Svar

Exempel

Set Storage account

Exempelbegäran

Exempelsvar

Definitioner

DeletionRecoveryLevel

Error

KeyVaultError

StorageAccountAttributes

StorageAccountCreateParameters

StorageBundle