Recover Deleted Sas Definition - Recover Deleted Sas Definition

Referência

Service:: Key Vault

API Version:: 7.4

Recupera a definição de SAS eliminada para a conta de armazenamento especificada. Esta operação só pode ser efetuada num cofre com eliminação recuperável ativada. Esta operação requer a permissão de armazenamento/recuperação.

POST {vaultBaseUrl}/deletedstorage/{storage-account-name}/sas/{sas-definition-name}/recover?api-version=7.4

Parâmetros do URI

Name	Em	Necessá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 da API de Cliente.

Respostas

Name	Tipo	Description
200 OK	SasDefinitionBundle	Um pacote de definição SAS da definição de SAS original e dos respetivos atributos.
Other Status Codes	KeyVaultError	Key Vault resposta de erro que descreve a razão pela qual a operação falhou.

Exemplos

Recover Deleted Storage Sas Definition

Sample Request

HTTP

POST https://myvault.vault.azure.net//deletedstorage/recoversas01/sas/recoverStrgSasDef01/recover?api-version=7.4

Sample Response

Status code:: 200

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

Definições

Name	Description
DeletionRecoveryLevel	Reflete o nível de recuperação de eliminação atualmente em vigor para contas de armazenamento no cofre atual. Se contiver "Removível", a conta de armazenamento pode ser eliminada permanentemente por um utilizador com privilégios; caso contrário, apenas o sistema pode remover 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 gestão de definições de SAS.
SasDefinitionBundle	Um pacote de definições SAS consiste em detalhes de definição saS do cofre de chaves, bem como os atributos.
SasTokenType	O tipo de token de SAS que a definição de SAS irá criar.

DeletionRecoveryLevel

Reflete o nível de recuperação de eliminação atualmente em vigor para contas de armazenamento no cofre atual. Se contiver "Removível", a conta de armazenamento pode ser eliminada permanentemente por um utilizador com privilégios; caso contrário, apenas o sistema pode remover a conta de armazenamento, no final do intervalo de retenção.

Name	Tipo	Description
CustomizedRecoverable	string	Indica um estado do cofre no qual a eliminação é recuperável sem a possibilidade de eliminação imediata e permanente (ou seja, remover quando 7<= SoftDeleteRetentionInDays < 90). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção e enquanto a subscrição ainda está disponível.
CustomizedRecoverable+ProtectedSubscription	string	Indica um cofre e estado de subscrição no qual a eliminação é recuperável, imediata e permanente (ou seja, remoção) não é permitida e em que a subscrição em si não pode ser cancelada permanentemente quando 7<= SoftDeleteRetentionInDays < 90. Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção e também reflete o facto de a própria subscrição não poder ser cancelada.
CustomizedRecoverable+Purgeable	string	Indica um estado do cofre no qual a eliminação é recuperável e que também permite a eliminação imediata e permanente (ou seja, remover quando 7<= SoftDeleteRetentionInDays < 90). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção, a menos que seja pedida uma operação de Remoção ou a subscrição seja cancelada.
Purgeable	string	Indica um estado do cofre em que a eliminação é uma operação irreversível, sem a possibilidade de recuperação. Este nível não corresponde a nenhuma proteção disponível numa operação Eliminar; os dados são irremediavelmente perdidos ao aceitar uma operação Delete ao nível da entidade ou superior (cofre, grupo de recursos, subscrição, etc.)
Recoverable	string	Indica um estado do cofre no qual a eliminação é recuperável sem a possibilidade de eliminação imediata e permanente (ou seja, remoção). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção (90 dias) e enquanto a subscrição ainda está disponível. O sistema irá eliminá-lo permanentemente após 90 dias, se não for recuperado
Recoverable+ProtectedSubscription	string	Indica um estado do cofre e da subscrição em que a eliminação é recuperável dentro do intervalo de retenção (90 dias), a eliminação imediata e permanente (ou seja, remoção) não é permitida e na qual a subscrição em si não pode ser cancelada permanentemente. O sistema irá eliminá-lo permanentemente após 90 dias, se não for recuperado
Recoverable+Purgeable	string	Indica um estado do cofre no qual a eliminação é recuperável e que também permite a eliminação imediata e permanente (ou seja, remoção). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção (90 dias), a menos que seja pedida uma operação de Remoção ou a subscrição seja cancelada. O sistema irá eliminá-lo permanentemente após 90 dias, se não for recuperado

Error

O erro do servidor do cofre de chaves.

Name	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.

Name	Tipo	Description
error	Error	O erro do servidor do cofre de chaves.

SasDefinitionAttributes

Os atributos de gestão de definições de SAS.

Name	Tipo	Description
created	integer	Tempo de criação em UTC.
enabled	boolean	o estado ativado do objeto.
recoverableDays	integer	softDelete data retention days. O valor deve ser >=7 e <=90 quando softDelete ativado, caso contrário 0.
recoveryLevel	DeletionRecoveryLevel	Reflete o nível de recuperação de eliminação atualmente em vigor para definições de SAS no cofre atual. Se contiver "Removível", a definição de SAS pode ser eliminada permanentemente por um utilizador privilegiado; caso contrário, apenas o sistema pode remover a definição de SAS, no final do intervalo de retenção.
updated	integer	Hora da última atualização em UTC.

SasDefinitionBundle

Um pacote de definições SAS consiste em detalhes de definição saS do cofre de chaves, bem como os atributos.

Name	Tipo	Description
attributes	SasDefinitionAttributes	Os atributos de definição de SAS.
id	string	O ID de definição de SAS.
sasType	SasTokenType	O tipo de token de SAS que a definição de SAS irá criar.
sid	string	ID do segredo da definição de SAS da conta de armazenamento.
tags	object	Metadados específicos da aplicação na forma de pares chave-valor
templateUri	string	O modelo de token de definição de 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 de SAS criados de acordo com a definição de SAS.

SasTokenType

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

Name	Tipo	Description
account	string
service	string

Partilhar via