Update Storage Account - Update Storage Account

Layanan:: Key Vault

Versi API:: 2025-07-01

Memperbarui atribut yang ditentukan yang terkait dengan akun penyimpanan yang diberikan. Operasi ini memerlukan izin penyimpanan/set/update.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	Nama akun penyimpanan.
vaultBaseUrl	path	True	string	Nama brankas, misalnya `https://myvault.vault.azure.net`.
api-version	query	True	string	Versi API klien.

Isi Permintaan

Nama	Jenis	Deskripsi
activeKeyName	string	Nama kunci akun penyimpanan aktif saat ini.
attributes	StorageAccountAttributes	Atribut akun penyimpanan.
autoRegenerateKey	boolean	Apakah Keyvault harus mengelola akun penyimpanan untuk pengguna.
regenerationPeriod	string	Durasi waktu regenerasi kunci yang ditentukan dalam format ISO-8601.
tags	object	Metadata khusus aplikasi dalam bentuk pasangan kunci-nilai.

Respons

Nama	Jenis	Deskripsi
200 OK	StorageBundle	Akun penyimpanan yang diperbarui.
Other Status Codes	KeyVaultError	Respons kesalahan Key Vault yang menjelaskan mengapa operasi gagal.

Contoh

Update Storage account

Permintaan sampel

HTTP

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

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

Respon sampel

Kode status:: 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"
  }
}

Definisi

Nama	Deskripsi
DeletionRecoveryLevel	Mencerminkan tingkat pemulihan penghapusan yang saat ini berlaku untuk akun penyimpanan di brankas saat ini. Jika berisi 'Purgeable', akun penyimpanan dapat dihapus secara permanen oleh pengguna istimewa; Jika tidak, hanya sistem yang dapat menghapus akun penyimpanan, di akhir interval retensi.
Error	Kesalahan server brankas kunci.
KeyVaultError	Pengecualian kesalahan brankas kunci.
StorageAccountAttributes	Atribut manajemen akun penyimpanan.
StorageAccountUpdateParameters	Parameter pembaruan akun penyimpanan.
StorageBundle	Bundel akun Storage terdiri dari detail akun penyimpanan vault kunci ditambah atributnya.

DeletionRecoveryLevel

Enumeration

Mencerminkan tingkat pemulihan penghapusan yang saat ini berlaku untuk akun penyimpanan di brankas saat ini. Jika berisi 'Purgeable', akun penyimpanan dapat dihapus secara permanen oleh pengguna istimewa; Jika tidak, hanya sistem yang dapat menghapus akun penyimpanan, di akhir interval retensi.

Nilai	Deskripsi
Purgeable	Menunjukkan status vault di mana penghapusan adalah operasi yang tidak dapat diubah, tanpa kemungkinan pemulihan. Level ini sesuai dengan tidak ada perlindungan yang tersedia terhadap operasi Hapus; data hilang secara permanen setelah menerima operasi Hapus di tingkat entitas atau yang lebih tinggi (brankas, grup sumber daya, langganan, dll.)
Recoverable+Purgeable	Menunjukkan status vault di mana penghapusan dapat dipulihkan, dan yang juga memungkinkan penghapusan segera dan permanen (yaitu pembersihan). Tingkat ini menjamin pemulihan entitas yang dihapus selama interval retensi (90 hari), kecuali operasi Pembersihan diminta, atau langganan dibatalkan. Sistem akan menghapusnya secara permanen setelah 90 hari, jika tidak dipulihkan
Recoverable	Menunjukkan status vault di mana penghapusan dapat dipulihkan tanpa kemungkinan penghapusan segera dan permanen (yaitu pembersihan). Tingkat ini menjamin pemulihan entitas yang dihapus selama interval retensi (90 hari) dan saat langganan masih tersedia. Sistem akan menghapusnya secara permanen setelah 90 hari, jika tidak dipulihkan
Recoverable+ProtectedSubscription	Menunjukkan status vault dan langganan di mana penghapusan dapat dipulihkan dalam interval retensi (90 hari), penghapusan segera dan permanen (yaitu pembersihan) tidak diizinkan, dan di mana langganan itu sendiri tidak dapat dibatalkan secara permanen. Sistem akan menghapusnya secara permanen setelah 90 hari, jika tidak dipulihkan
CustomizedRecoverable+Purgeable	Menunjukkan status vault di mana penghapusan dapat dipulihkan, dan yang juga mengizinkan penghapusan segera dan permanen (yaitu pembersihan saat 7<= SoftDeleteRetentionInDays < 90). Tingkat ini menjamin pemulihan entitas yang dihapus selama interval retensi, kecuali operasi Pembersihan diminta, atau langganan dibatalkan.
CustomizedRecoverable	Menunjukkan status vault di mana penghapusan dapat dipulihkan tanpa kemungkinan penghapusan segera dan permanen (yaitu pembersihan ketika 7<= SoftDeleteRetentionInDays < 90). Tingkat ini menjamin pemulihan entitas yang dihapus selama interval retensi dan saat langganan masih tersedia.
CustomizedRecoverable+ProtectedSubscription	Menunjukkan status brankas dan langganan di mana penghapusan dapat dipulihkan, penghapusan langsung dan permanen (yaitu pembersihan) tidak diizinkan, dan di mana langganan itu sendiri tidak dapat dibatalkan secara permanen ketika 7<= SoftDeleteRetentionInDays < 90. Tingkat ini menjamin pemulihan entitas yang dihapus selama interval retensi, dan juga mencerminkan fakta bahwa langganan itu sendiri tidak dapat dibatalkan.

Error

Objek

Kesalahan server brankas kunci.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan.
innererror	Error	Kesalahan server brankas kunci.
message	string	Pesan kesalahan.

KeyVaultError

Objek

Pengecualian kesalahan brankas kunci.

Nama	Jenis	Deskripsi
error	Error	Kesalahan server brankas kunci.

StorageAccountAttributes

Objek

Atribut manajemen akun penyimpanan.

Nama	Jenis	Deskripsi
created	integer (unixtime)	Waktu pembuatan di UTC.
enabled	boolean	status objek yang diaktifkan.
recoverableDays	integer (int32)	softHapus hari retensi data. Nilainya harus >=7 dan <=90 saat softDelete diaktifkan, jika tidak, 0.
recoveryLevel	DeletionRecoveryLevel	Mencerminkan tingkat pemulihan penghapusan yang saat ini berlaku untuk akun penyimpanan di brankas saat ini. Jika berisi 'Purgeable', akun penyimpanan dapat dihapus secara permanen oleh pengguna istimewa; Jika tidak, hanya sistem yang dapat menghapus akun penyimpanan, di akhir interval retensi.
updated	integer (unixtime)	Waktu terakhir diperbarui di UTC.

StorageAccountUpdateParameters

Objek

Parameter pembaruan akun penyimpanan.

Nama	Jenis	Deskripsi
activeKeyName	string	Nama kunci akun penyimpanan aktif saat ini.
attributes	StorageAccountAttributes	Atribut akun penyimpanan.
autoRegenerateKey	boolean	Apakah Keyvault harus mengelola akun penyimpanan untuk pengguna.
regenerationPeriod	string	Durasi waktu regenerasi kunci yang ditentukan dalam format ISO-8601.
tags	object	Metadata khusus aplikasi dalam bentuk pasangan kunci-nilai.

StorageBundle

Objek

Bundel akun Storage terdiri dari detail akun penyimpanan vault kunci ditambah atributnya.

Nama	Jenis	Deskripsi
activeKeyName	string	Nama kunci akun penyimpanan aktif saat ini.
attributes	StorageAccountAttributes	Atribut akun penyimpanan.
autoRegenerateKey	boolean	Apakah Keyvault harus mengelola akun penyimpanan untuk pengguna.
id	string	ID akun penyimpanan.
regenerationPeriod	string	Durasi waktu regenerasi kunci yang ditentukan dalam format ISO-8601.
resourceId	string	ID sumber daya akun penyimpanan.
tags	object	Metadata khusus aplikasi dalam bentuk pasangan kunci-nilai

Bagikan melalui

Update Storage Account - Update Storage Account

Parameter URI

Isi Permintaan

Respons

Contoh

Update Storage account

Permintaan sampel

Respon sampel

Definisi

DeletionRecoveryLevel

Error

KeyVaultError

StorageAccountAttributes

StorageAccountUpdateParameters

StorageBundle