Delete Sas Definition - Delete Sas Definition

Ссылка

Service:: Key Vault

API Version:: 7.4

Удаляет определение SAS из указанной учетной записи хранения. Для этой операции требуется разрешение storage/deletesas.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
sas-definition-name	path	True	string	Имя определения SAS. Regex pattern: `^[0-9a-zA-Z]+$`
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 клиента.

Ответы

Имя	Тип	Описание
200 OK	DeletedSasDefinitionBundle	Определение удаленного SAS и сведения о том, когда будет удалено определение SAS и как восстановить удаленное определение SAS.
Other Status Codes	KeyVaultError	Key Vault ответ об ошибке, описывающий причину сбоя операции.

Примеры

Delete Storage Sas Definition

Sample Request

HTTP

DELETE https://myvault.vault.azure.net//storage/deletesas01/sas/deleteStrgSasDef01?api-version=7.4

Sample Response

Status code:: 200

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

Определения

Имя	Описание
DeletedSasDefinitionBundle	Удаленный пакет определений SAS, состоящий из предыдущего идентификатора, атрибутов и тегов, а также сведений о том, когда он будет удален.
DeletionRecoveryLevel	Отражает уровень восстановления удаления, действующий в настоящее время для учетных записей хранения в текущем хранилище. Если он содержит "Очищаемый", то привилегированный пользователь может безвозвратно удалить учетную запись хранения; В противном случае только система может очистить учетную запись хранения в конце интервала хранения.
Error	Ошибка сервера хранилища ключей.
KeyVaultError	Исключение ошибки хранилища ключей.
SasDefinitionAttributes	Атрибуты управления определением SAS.
SasTokenType	Тип маркера SAS, создаваемого определением SAS.

DeletedSasDefinitionBundle

Удаленный пакет определений SAS, состоящий из предыдущего идентификатора, атрибутов и тегов, а также сведений о том, когда он будет удален.

Имя	Тип	Описание
attributes	SasDefinitionAttributes	Атрибуты определения SAS.
deletedDate	integer	Время удаления определения SAS в формате UTC
id	string	Идентификатор определения SAS.
recoveryId	string	URL-адрес объекта восстановления, используемый для идентификации и восстановления удаленного определения SAS.
sasType	SasTokenType	Тип маркера SAS, создаваемого определением SAS.
scheduledPurgeDate	integer	Время очистки определения SAS в формате UTC
sid	string	Идентификатор секрета sas определения учетной записи хранения.
tags	object	Метаданные конкретного приложения в виде пар "ключ-значение"
templateUri	string	Шаблон маркера определения SAS, подписанный произвольным ключом. Маркеры, созданные в соответствии с определением SAS, будут иметь те же свойства, что и шаблон.
validityPeriod	string	Срок действия маркеров 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.

SasTokenType

Тип маркера SAS, создаваемого определением SAS.

Имя	Тип	Описание
account	string
service	string

Поделиться через