Update Sas Definition - Update Sas Definition

Layanan:: Key Vault

Versi API:: 7.4

Memperbarui atribut yang ditentukan yang terkait dengan definisi SAS yang diberikan. Operasi ini memerlukan izin penyimpanan/setsas.

PATCH {vaultBaseUrl}/storage/{storage-account-name}/sas/{sas-definition-name}?api-version=7.4

Parameter URI

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

Isi Permintaan

Nama	Jenis	Deskripsi
attributes	SasDefinitionAttributes	Atribut definisi SAS.
sasType	SasTokenType	Jenis token SAS yang akan dibuat definisi SAS.
tags	object	Metadata khusus aplikasi dalam bentuk pasangan kunci-nilai.
templateUri	string	Templat token definisi SAS ditandatangani dengan kunci arbitrer. Token yang dibuat sesuai dengan definisi SAS akan memiliki properti yang sama dengan templat.
validityPeriod	string	Periode validitas token SAS yang dibuat sesuai dengan definisi SAS.

Respons

Nama	Jenis	Deskripsi
200 OK	SasDefinitionBundle	Definisi SAS yang diperbarui.
Other Status Codes	KeyVaultError	Respons kesalahan Key Vault yang menjelaskan mengapa operasi gagal.

Contoh

Update Storage Sas definition

Permintaan sampel

HTTP

PATCH https://myvault.vault.azure.net//storage/patchsas01/sas/patchStrgSasDef01?api-version=7.4

{
  "templateUri": "se=2018-02-01T00%3A00Z&spr=https&sv=2017-04-17&sr=b&sig=XXFNfuMCHYrBx0bhemJ7PWn0xGfImMXT6LfbXWvtRUk%3D",
  "sasType": "service",
  "validityPeriod": "P15D",
  "attributes": {
    "enabled": true
  }
}

Respon sampel

Kode status:: 200

{
  "id": "https://myvault.vault.azure.net/storage/patchsas01/sas/patchStrgSasDef01",
  "sid": "https://myvault.vault.azure.net/secrets/patchsas01-patchStrgSasDef01",
  "templateUri": "se=2018-02-01T00%3A00Z&spr=https&sv=2017-04-17&sr=b&sig=XXFNfuMCHYrBx0bhemJ7PWn0xGfImMXT6LfbXWvtRUk%3D",
  "sasType": "service",
  "validityPeriod": "P15D",
  "attributes": {
    "enabled": true,
    "created": 1490738438,
    "updated": 1490738438,
    "recoveryLevel": "Recoverable"
  }
}

Definisi

Nama	Deskripsi
DeletionRecoveryLevel	Mencerminkan tingkat pemulihan penghapusan yang saat ini berlaku untuk akun penyimpanan di vault saat ini. Jika berisi 'Dapat Dibersihkan', akun penyimpanan dapat dihapus secara permanen oleh pengguna istimewa; jika tidak, hanya sistem yang dapat menghapus menyeluruh akun penyimpanan, di akhir interval retensi.
Error	Kesalahan server brankas kunci.
KeyVaultError	Pengecualian kesalahan brankas kunci.
SasDefinitionAttributes	Atribut manajemen definisi SAS.
SasDefinitionBundle	Bundel definisi SAS terdiri dari detail definisi SAS brankas kunci ditambah atributnya.
SasDefinitionUpdateParameters	Parameter pembaruan definisi SAS.
SasTokenType	Jenis token SAS yang akan dibuat definisi SAS.

DeletionRecoveryLevel

Enumeration

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

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

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.

SasDefinitionAttributes

Objek

Atribut manajemen definisi SAS.

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

SasDefinitionBundle

Objek

Bundel definisi SAS terdiri dari detail definisi SAS brankas kunci ditambah atributnya.

Nama	Jenis	Deskripsi
attributes	SasDefinitionAttributes	Atribut definisi SAS.
id	string	Id definisi SAS.
sasType	SasTokenType	Jenis token SAS yang akan dibuat definisi SAS.
sid	string	Id rahasia definisi SAS akun penyimpanan.
tags	object	Metadata khusus aplikasi dalam bentuk pasangan kunci-nilai
templateUri	string	Templat token definisi SAS ditandatangani dengan kunci arbitrer. Token yang dibuat sesuai dengan definisi SAS akan memiliki properti yang sama dengan templat.
validityPeriod	string	Periode validitas token SAS yang dibuat sesuai dengan definisi SAS.

SasDefinitionUpdateParameters

Objek

Parameter pembaruan definisi SAS.

Nama	Jenis	Deskripsi
attributes	SasDefinitionAttributes	Atribut definisi SAS.
sasType	SasTokenType	Jenis token SAS yang akan dibuat definisi SAS.
tags	object	Metadata khusus aplikasi dalam bentuk pasangan kunci-nilai.
templateUri	string	Templat token definisi SAS ditandatangani dengan kunci arbitrer. Token yang dibuat sesuai dengan definisi SAS akan memiliki properti yang sama dengan templat.
validityPeriod	string	Periode validitas token SAS yang dibuat sesuai dengan definisi SAS.

SasTokenType

Enumeration

Jenis token SAS yang akan dibuat definisi SAS.

Nilai	Deskripsi
account
service

Bagikan melalui

Update Sas Definition - Update Sas Definition

Parameter URI

Isi Permintaan

Respons

Contoh

Update Storage Sas definition

Permintaan sampel

Respon sampel

Definisi

DeletionRecoveryLevel

Error

KeyVaultError

SasDefinitionAttributes

SasDefinitionBundle

SasDefinitionUpdateParameters

SasTokenType