Get Deleted Sas Definitions - Get Deleted Sas Definitions
清單 指定保存庫和儲存體帳戶的已刪除 SAS 定義。
[取得刪除的 Sas 定義] 作業會傳回針對已啟用虛刪除之保存庫所刪除的 SAS 定義。 這項作業需要記憶體/listas 許可權。
GET {vaultBaseUrl}/deletedstorage/{storage-account-name}/sas?api-version=7.4
GET {vaultBaseUrl}/deletedstorage/{storage-account-name}/sas?maxresults={maxresults}&api-version=7.4
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
storage-account-name
|
path | True |
string |
儲存體帳戶的名稱。 Regex pattern: |
vault
|
path | True |
string |
儲存庫名稱,例如 https://myvault.vault.azure.net。 |
api-version
|
query | True |
string |
用戶端 API 版本。 |
maxresults
|
query |
integer int32 |
在頁面中傳回的結果數目上限。 如果未指定,服務最多會傳回 25 個結果。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
回應訊息,其中包含記憶體帳戶已刪除的SAS定義清單,以及已刪除SAS定義下一頁的連結。 |
|
Other Status Codes |
金鑰保存庫 錯誤回應,描述作業失敗的原因。 |
範例
List Deleted Storage Sas Definitions
Sample Request
GET https://myvault.vault.azure.net//deletedstorage/listsas01/sas?api-version=7.4
Sample Response
{
"value": [
{
"id": "https://myvault.vault.azure.net/storage/listsas01/sas/listDeletedSasDef01",
"sid": "https://myvault.vault.azure.net/secrets/listsas01-listDeletedSasDef01",
"recoveryId": "https://myvault.vault.azure.net/deletedstorage/listsas01/sas/listDeletedSasDef01",
"scheduledPurgeDate": 1490790000,
"deletedDate": 1490760000,
"attributes": {
"enabled": true,
"created": 1490738438,
"updated": 1490738438,
"recoveryLevel": "Recoverable"
}
},
{
"id": "https://myvault.vault.azure.net/storage/listsas01/sas/listDeletedSasDef02",
"sid": "https://myvault.vault.azure.net/secrets/listsas01-listDeletedSasDef02",
"recoveryId": "https://myvault.vault.azure.net/deletedstorage/listsas01/sas/listDeletedSasDef02",
"scheduledPurgeDate": 1490790000,
"deletedDate": 1490760000,
"attributes": {
"enabled": true,
"created": 1490738438,
"updated": 1490738438,
"recoveryLevel": "Recoverable"
}
}
],
"nextLink": "https://{BaseUri}/deletedstorage/listsas01/sas?api-version=7.2&%24skiptoken=<token>"
}
定義
名稱 | Description |
---|---|
Deleted |
已刪除的SAS定義專案,其中包含已刪除SAS定義的元數據。 |
Deleted |
已刪除的 SAS 定義清單結果 |
Deletion |
反映目前保存庫中記憶體帳戶目前生效的刪除復原層級。 如果記憶體帳戶包含「可清除」,則記憶體帳戶可由特殊許可權使用者永久刪除;否則,只有系統可以在保留間隔結束時清除記憶體帳戶。 |
Error |
金鑰儲存庫伺服器錯誤。 |
Key |
金鑰保存庫錯誤例外狀況。 |
Sas |
SAS 定義管理屬性。 |
DeletedSasDefinitionItem
已刪除的SAS定義專案,其中包含已刪除SAS定義的元數據。
名稱 | 類型 | Description |
---|---|---|
attributes |
SAS 定義管理屬性。 |
|
deletedDate |
integer |
以UTC刪除SAS定義的時間 |
id |
string |
記憶體 SAS 識別碼。 |
recoveryId |
string |
復原物件的 URL,用來識別和復原已刪除的 SAS 定義。 |
scheduledPurgeDate |
integer |
以UTC為單位排程清除SAS定義的時間 |
sid |
string |
儲存體帳戶 SAS 定義秘密識別碼。 |
tags |
object |
以機碼/值組的形式應用程式特定元數據。 |
DeletedSasDefinitionListResult
已刪除的 SAS 定義清單結果
名稱 | 類型 | Description |
---|---|---|
nextLink |
string |
要取得下一組已刪除 SAS 定義的 URL。 |
value |
回應訊息,其中包含保存庫中已刪除的 SAS 定義清單,以及已刪除 sas 定義下一頁的連結 |
DeletionRecoveryLevel
反映目前保存庫中記憶體帳戶目前生效的刪除復原層級。 如果記憶體帳戶包含「可清除」,則記憶體帳戶可由特殊許可權使用者永久刪除;否則,只有系統可以在保留間隔結束時清除記憶體帳戶。
名稱 | 類型 | Description |
---|---|---|
CustomizedRecoverable |
string |
表示可復原刪除的保存庫狀態,而不可能發生立即和永久刪除 (,也就是在 7<= SoftDeleteRetentionInDays < 90) 時清除。此層級保證在保留間隔期間和訂用帳戶仍可使用時,已刪除實體的復原能力。 |
CustomizedRecoverable+ProtectedSubscription |
string |
表示無法復原刪除的保存庫和訂用帳戶狀態、立即和永久刪除 (亦即不允許清除) ,而且當 7<= SoftDeleteRetentionInDays < 90 時,無法永久取消訂用帳戶本身。 此層級保證在保留間隔期間刪除的實體可復原性,同時反映無法取消訂閱本身的事實。 |
CustomizedRecoverable+Purgeable |
string |
表示可復原刪除的保存庫狀態,也允許立即和永久刪除 (,也就是在 7<= SoftDeleteRetentionInDays < 90) 時清除。 除非要求清除作業或取消訂閱,否則此層級可確保在保留間隔期間刪除實體的復原能力。 |
Purgeable |
string |
表示刪除是無法復原作業的保存庫狀態,而無法復原。 此層級對應至刪除作業沒有可用的保護;在實體層級或更高層級接受刪除作業時,數據無法復原, (保存庫、資源群組、訂用帳戶等 ) |
Recoverable |
string |
表示可復原刪除的保存庫狀態,而不需要立即和永久刪除 (亦即清除) 。 此層級可確保在保留間隔期間 (90 天) 且訂用帳戶仍可使用時,刪除實體的復原能力。 系統會在 90 天后永久刪除,如果未復原,則為 |
Recoverable+ProtectedSubscription |
string |
表示保存庫和訂用帳戶狀態,其中刪除可在保留間隔內復原 (90 天) 、立即和永久刪除 (亦即不允許清除) ,以及無法永久取消訂用帳戶本身。 系統會在 90 天后永久刪除,如果未復原,則為 |
Recoverable+Purgeable |
string |
表示可復原刪除的保存庫狀態,也允許立即和永久刪除 (,也就是清除) 。 除非要求清除作業或取消訂用帳戶,否則此層級可確保在保留間隔期間 (90 天) ,否則已刪除實體的復原能力。 系統會在 90 天后永久刪除,如果未復原,則為 |
Error
金鑰儲存庫伺服器錯誤。
名稱 | 類型 | Description |
---|---|---|
code |
string |
錯誤碼。 |
innererror |
金鑰儲存庫伺服器錯誤。 |
|
message |
string |
錯誤訊息。 |
KeyVaultError
金鑰保存庫錯誤例外狀況。
名稱 | 類型 | Description |
---|---|---|
error |
金鑰儲存庫伺服器錯誤。 |
SasDefinitionAttributes
SAS 定義管理屬性。
名稱 | 類型 | Description |
---|---|---|
created |
integer |
以 UTC 為單位的建立時間。 |
enabled |
boolean |
對象的啟用狀態。 |
recoverableDays |
integer |
softDelete 數據保留天數。 啟用 softDelete 時,值應該是 =7 和 <=90,否則為 >0。 |
recoveryLevel |
反映目前保存庫中 SAS 定義的刪除復原層級。 如果它包含「可清除」,則特殊許可權使用者可以永久刪除 SAS 定義;否則,只有系統可以在保留間隔結束時清除 SAS 定義。 |
|
updated |
integer |
上次以UTC更新的時間。 |