你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get Deleted Sas Definitions - Get Deleted Sas Definitions

参考

Service:: Key Vault

API Version:: 7.4

Lists指定的保管库和存储帐户的已删除 SAS 定义。
“获取已删除的 Sas 定义”操作返回为启用软删除的保管库删除的 SAS 定义。此操作需要 storage/listsas 权限。

GET {vaultBaseUrl}/deletedstorage/{storage-account-name}/sas?api-version=7.4

With optional parameters:

GET {vaultBaseUrl}/deletedstorage/{storage-account-name}/sas?maxresults={maxresults}&api-version=7.4

URI 参数

名称	在	必需	类型	说明
storage-account-name	path	True	string	存储帐户的名称。 Regex pattern: `^[0-9a-zA-Z]+$`
vaultBaseUrl	path	True	string	保管库名称，例如 https://myvault.vault.azure.net。
api-version	query	True	string	客户端 API 版本。
maxresults	query		integer int32	在一页中返回的最大结果数。如果未指定，服务将返回最多 25 个结果。

响应

名称	类型	说明
200 OK	DeletedSasDefinitionListResult	一条响应消息，其中包含存储帐户的已删除 SAS 定义列表，以及指向已删除 SAS 定义的下一页的链接。
Other Status Codes	KeyVaultError	密钥保管库描述操作失败原因的错误响应。

示例

List Deleted Storage Sas Definitions

Sample Request

HTTP

GET https://myvault.vault.azure.net//deletedstorage/listsas01/sas?api-version=7.4

Sample Response

Status code:: 200

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

定义

名称	说明
DeletedSasDefinitionItem	包含有关已删除 SAS 定义的元数据的已删除 SAS 定义项。
DeletedSasDefinitionListResult	已删除的 SAS 定义列表结果
DeletionRecoveryLevel	反映当前保管库中存储帐户当前生效的删除恢复级别。如果它包含“可清除”，则特权用户可永久删除存储帐户;否则，只有系统才能在保留间隔结束时清除存储帐户。
Error	密钥保管库服务器错误。
KeyVaultError	密钥保管库错误异常。
SasDefinitionAttributes	SAS 定义管理属性。

DeletedSasDefinitionItem

包含有关已删除 SAS 定义的元数据的已删除 SAS 定义项。

名称	类型	说明
attributes	SasDefinitionAttributes	SAS 定义管理属性。
deletedDate	integer	删除 SAS 定义的时间（UTC）
id	string	存储 SAS 标识符。
recoveryId	string	恢复对象的 URL，用于标识和恢复已删除的 SAS 定义。
scheduledPurgeDate	integer	计划清除 SAS 定义的时间（UTC）
sid	string	存储帐户 SAS 定义机密 ID。
tags	object	键/值对形式的应用程序特定元数据。

DeletedSasDefinitionListResult

已删除的 SAS 定义列表结果

名称	类型	说明
nextLink	string	用于获取下一组已删除 SAS 定义的 URL。
value	DeletedSasDefinitionItem[]	包含保管库中已删除 SAS 定义的列表以及指向已删除 SAS 定义的下一页的链接的响应消息

DeletionRecoveryLevel

反映当前保管库中存储帐户当前生效的删除恢复级别。如果它包含“可清除”，则特权用户可永久删除存储帐户;否则，只有系统才能在保留间隔结束时清除存储帐户。

名称	类型	说明
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

密钥保管库服务器错误。

名称	类型	说明
code	string	错误代码。
innererror	Error	密钥保管库服务器错误。
message	string	错误消息。

KeyVaultError

密钥保管库错误异常。

名称	类型	说明
error	Error	密钥保管库服务器错误。

SasDefinitionAttributes

SAS 定义管理属性。

名称	类型	说明
created	integer	创建时间（UTC）。
enabled	boolean	对象的启用状态。
recoverableDays	integer	softDelete 数据保留天数。启用 softDelete 时，值应为 >=7 和 <=90，否则为 0。
recoveryLevel	DeletionRecoveryLevel	反映当前保管库中 SAS 定义当前生效的删除恢复级别。如果它包含“可清除”，则特权用户可以永久删除 SAS 定义;否则，只有系统才能在保留间隔结束时清除 SAS 定义。
updated	integer	上次更新时间（UTC）。

通过