Get Deleted Sas Definitions - Get Deleted Sas Definitions

  • Ссылка
Service:
Key Vault
API Version:
7.4

Списки удаленные определения 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

Key Vault ответ об ошибке, описывающий причину сбоя операции.

Примеры

List Deleted Storage Sas Definitions

Sample Request

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 учетной записи хранения.
tags

object

Метаданные конкретного приложения в виде пар «ключ — значение».

DeletedSasDefinitionListResult

Результат удаленного списка определений SAS

Имя Тип Описание
nextLink

string

URL-адрес для получения следующего набора удаленных определений SAS.
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 data retention days. Значение должно быть >равно =7 и <=90, если softDelete включено, в противном случае — 0.
recoveryLevel

DeletionRecoveryLevel

Отражает уровень восстановления удаления, действующий в настоящее время для определений SAS в текущем хранилище. Если он содержит "Purgeable", определение SAS может быть безвозвратно удалено привилегированным пользователем; В противном случае только система может очистить определение SAS в конце интервала хранения.
updated

integer

Время последнего обновления в формате UTC.