Compartilhar via


Delete Sas Definition - Delete Sas Definition

Exclui uma definição de SAS de uma conta de armazenamento especificada. Essa operação requer a permissão storage/deletesas.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
sas-definition-name
path True

string

O nome da definição de SAS.

Regex pattern: ^[0-9a-zA-Z]+$

storage-account-name
path True

string

O nome da conta de armazenamento.

Regex pattern: ^[0-9a-zA-Z]+$

vaultBaseUrl
path True

string

O nome do cofre, por exemplo https://myvault.vault.azure.net, .

api-version
query True

string

Versão de API do cliente.

Respostas

Nome Tipo Description
200 OK

DeletedSasDefinitionBundle

A definição de SAS excluída e as informações sobre quando a definição de SAS será excluída e como recuperar a definição de SAS excluída.

Other Status Codes

KeyVaultError

Key Vault resposta de erro que descreve por que a operação falhou.

Exemplos

Delete Storage Sas Definition

Sample Request

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

Sample Response

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

Definições

Nome Description
DeletedSasDefinitionBundle

Um pacote de definição sas excluído que consiste em sua ID anterior, atributos e suas marcas, bem como informações sobre quando ele será limpo.

DeletionRecoveryLevel

Reflete o nível de recuperação de exclusão atualmente em vigor para contas de armazenamento no cofre atual. Se contiver "Purgável", a conta de armazenamento poderá ser excluída permanentemente por um usuário privilegiado; caso contrário, somente o sistema poderá limpar a conta de armazenamento no final do intervalo de retenção.

Error

O erro do servidor do cofre de chaves.

KeyVaultError

A exceção de erro do cofre de chaves.

SasDefinitionAttributes

Os atributos de gerenciamento de definição de SAS.

SasTokenType

O tipo de token SAS que a definição de SAS criará.

DeletedSasDefinitionBundle

Um pacote de definição sas excluído que consiste em sua ID anterior, atributos e suas marcas, bem como informações sobre quando ele será limpo.

Nome Tipo Description
attributes

SasDefinitionAttributes

Os atributos de definição de SAS.

deletedDate

integer

A hora em que a definição de SAS foi excluída, em UTC

id

string

A ID de definição de SAS.

recoveryId

string

A URL do objeto de recuperação, usada para identificar e recuperar a definição de SAS excluída.

sasType

SasTokenType

O tipo de token SAS que a definição de SAS criará.

scheduledPurgeDate

integer

A hora em que a definição de SAS está agendada para ser limpa, em UTC

sid

string

ID secreta de definição sas da conta de armazenamento.

tags

object

Metadados específicos do aplicativo na forma de pares chave-valor

templateUri

string

O modelo de token de definição SAS assinado com uma chave arbitrária. Os tokens criados de acordo com a definição de SAS terão as mesmas propriedades que o modelo.

validityPeriod

string

O período de validade dos tokens SAS criados de acordo com a definição de SAS.

DeletionRecoveryLevel

Reflete o nível de recuperação de exclusão atualmente em vigor para contas de armazenamento no cofre atual. Se contiver "Purgável", a conta de armazenamento poderá ser excluída permanentemente por um usuário privilegiado; caso contrário, somente o sistema poderá limpar a conta de armazenamento no final do intervalo de retenção.

Nome Tipo Description
CustomizedRecoverable

string

Indica um estado de cofre no qual a exclusão é recuperável sem a possibilidade de exclusão imediata e permanente (ou seja, limpeza quando 7<= SoftDeleteRetentionInDays < 90). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção e enquanto a assinatura ainda está disponível.

CustomizedRecoverable+ProtectedSubscription

string

Indica um cofre e um estado de assinatura no qual a exclusão é recuperável, exclusão imediata e permanente (ou seja, limpeza) não é permitida e na qual a assinatura em si não pode ser cancelada permanentemente quando 7<= SoftDeleteRetentionInDays < 90. Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção e também reflete o fato de que a própria assinatura não pode ser cancelada.

CustomizedRecoverable+Purgeable

string

Indica um estado de cofre no qual a exclusão é recuperável e que também permite exclusão imediata e permanente (ou seja, limpeza quando 7<= SoftDeleteRetentionInDays < 90). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção, a menos que uma operação de limpeza seja solicitada ou a assinatura seja cancelada.

Purgeable

string

Indica um estado de cofre no qual a exclusão é uma operação irreversível, sem a possibilidade de recuperação. Esse nível corresponde a nenhuma proteção disponível em uma operação Delete; os dados são irremediavelmente perdidos ao aceitar uma operação Delete no nível da entidade ou superior (cofre, grupo de recursos, assinatura etc.)

Recoverable

string

Indica um estado de cofre no qual a exclusão é recuperável sem a possibilidade de exclusão imediata e permanente (ou seja, limpeza). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção (90 dias) e enquanto a assinatura ainda estiver disponível. O sistema o excluirá permanentemente após 90 dias, se não for recuperado

Recoverable+ProtectedSubscription

string

Indica um cofre e um estado de assinatura no qual a exclusão é recuperável dentro do intervalo de retenção (90 dias), a exclusão imediata e permanente (ou seja, a limpeza) não é permitida e na qual a assinatura em si não pode ser cancelada permanentemente. O sistema o excluirá permanentemente após 90 dias, se não for recuperado

Recoverable+Purgeable

string

Indica um estado de cofre no qual a exclusão é recuperável e que também permite a exclusão imediata e permanente (ou seja, limpeza). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção (90 dias), a menos que uma operação de limpeza seja solicitada ou a assinatura seja cancelada. O sistema o excluirá permanentemente após 90 dias, se não for recuperado

Error

O erro do servidor do cofre de chaves.

Nome Tipo Description
code

string

O código de erro.

innererror

Error

O erro do servidor do cofre de chaves.

message

string

A mensagem de erro.

KeyVaultError

A exceção de erro do cofre de chaves.

Nome Tipo Description
error

Error

O erro do servidor do cofre de chaves.

SasDefinitionAttributes

Os atributos de gerenciamento de definição de SAS.

Nome Tipo Description
created

integer

Tempo de criação em UTC.

enabled

boolean

o estado habilitado do objeto .

recoverableDays

integer

softDelete dias de retenção de dados. O valor deve ser >=7 e <=90 quando softDelete habilitado, caso contrário, 0.

recoveryLevel

DeletionRecoveryLevel

Reflete o nível de recuperação de exclusão atualmente em vigor para definições de SAS no cofre atual. Se contiver "Purgável", a definição de SAS poderá ser excluída permanentemente por um usuário privilegiado; caso contrário, somente o sistema poderá limpar a definição de SAS no final do intervalo de retenção.

updated

integer

Hora da última atualização em UTC.

SasTokenType

O tipo de token SAS que a definição de SAS criará.

Nome Tipo Description
account

string

service

string