Delete Sas Definition - Delete Sas Definition

Служба:: Key Vault

Версия API:: 2025-07-01

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

DELETE {vaultBaseUrl}/storage/{storage-account-name}/sas/{sas-definition-name}?api-version=2025-07-01

Параметры URI

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

Образец запроса

HTTP

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

Пример ответа

Код состояния:: 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=REDACTED",
  "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

Object

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

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

DeletionRecoveryLevel

Перечисление

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

Значение	Описание
Purgeable	Обозначает состояние хранилища, при котором удаление является необратимой операцией без возможности восстановления. Этот уровень соответствует отсутствию защиты от операции удаления; данные безвозвратно теряются при принятии операции удаления на уровне сущности или выше (хранилище, группа ресурсов, подписка и т. д.)
Recoverable+Purgeable	Обозначает состояние хранилища, при котором удаление можно восстановить, а также позволяет немедленное и окончательное удаление (т. е. очистку). Этот уровень гарантирует возможность восстановления удаленной сущности в течение интервала хранения (90 дней), если не будет запрошена операция очистки или подписка не будет отменена. Система навсегда удалит его через 90 дней, если он не будет восстановлен
Recoverable	Обозначает состояние хранилища, при котором удаление можно восстановить без возможности немедленного и окончательного удаления (т. е. очистки). Этот уровень гарантирует возможность восстановления удаленной сущности в течение интервала хранения (90 дней) и пока подписка все еще доступна. Система навсегда удалит его через 90 дней, если он не будет восстановлен
Recoverable+ProtectedSubscription	Обозначает состояние хранилища и подписки, при котором удаление можно восстановить в течение интервала хранения (90 дней), немедленное и окончательное удаление (т. е. очистка) не допускается, а сама подписка не может быть отменена навсегда. Система навсегда удалит его через 90 дней, если он не будет восстановлен
CustomizedRecoverable+Purgeable	Обозначает состояние хранилища, при котором удаление можно восстановить, а также позволяет немедленное и окончательное удаление (т. е. очистка, когда 7<= SoftDeleteRetentionInDays < 90). Этот уровень гарантирует возможность восстановления удаленной сущности в течение интервала хранения, если не будет запрошена операция очистки или подписка не будет отменена.
CustomizedRecoverable	Обозначает состояние хранилища, при котором удаление можно восстановить без возможности немедленного и окончательного удаления (т. е. очистка, когда 7<= SoftDeleteRetentionInDays < 90). Этот уровень гарантирует возможность восстановления удаленной сущности в течение интервала хранения и пока подписка все еще доступна.
CustomizedRecoverable+ProtectedSubscription	Обозначает состояние хранилища и подписки, при котором удаление можно восстановить, немедленное и окончательное удаление (т. е. очистка) не допускается, и при котором сама подписка не может быть отменена окончательно, когда 7<= SoftDeleteRetentionInDays < 90. Этот уровень гарантирует возможность восстановления удаленной сущности в течение интервала хранения, а также отражает тот факт, что сама подписка не может быть отменена.

Error

Object

Ошибка сервера хранилища ключей.

Имя	Тип	Описание
code	string	Код ошибки.
innererror	Error	Ошибка сервера хранилища ключей.
message	string	Сообщение об ошибке.

KeyVaultError

Object

Исключение ошибки хранилища ключей.

Имя	Тип	Описание
error	Error	Ошибка сервера хранилища ключей.

SasDefinitionAttributes

Object

Атрибуты управления определениями SAS.

Имя	Тип	Описание
created	integer (unixtime)	Время создания в UTC.
enabled	boolean	включенное состояние объекта.
recoverableDays	integer (int32)	Дни хранения данных softDelete. Значение должно быть >=7 и <=90 при включенном softDelete, в противном случае 0.
recoveryLevel	DeletionRecoveryLevel	Отражает уровень восстановления после удаления, действующий в настоящее время для определений SAS в текущем хранилище. Если оно содержит «Очищаемый», определение SAS может быть безвозвратно удалено привилегированным пользователем; в противном случае только система сможет очистить определение SAS в конце интервала хранения.
updated	integer (unixtime)	Последнее обновление времени в UTC.

SasTokenType

Перечисление

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

Значение	Описание
account
service

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

Delete Sas Definition - Delete Sas Definition

Параметры URI

Ответы

Примеры

Delete Storage Sas Definition

Образец запроса

Пример ответа

Определения

DeletedSasDefinitionBundle

DeletionRecoveryLevel

Error

KeyVaultError

SasDefinitionAttributes

SasTokenType