Recover Deleted Sas Definition - Recover Deleted Sas Definition

Servizio:

Key Vault

Versione API:

7.4

Recupera la definizione di firma di accesso condiviso eliminata per l'account di archiviazione specificato. Questa operazione può essere eseguita solo su un insieme di credenziali abilitato per l'eliminazione temporanea. Questa operazione richiede l'autorizzazione di archiviazione/ripristino.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
sas-definition-name	path	True	string pattern: ^[0-9a-zA-Z]+$	Nome della definizione della firma di accesso condiviso.
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	Nome dell'account di archiviazione.
vaultBaseUrl	path	True	string	Nome dell'insieme di credenziali, ad esempio https://myvault.vault.azure.net.
api-version	query	True	string	Versione dell'API client.

Risposte

Nome	Tipo	Descrizione
200 OK	SasDefinitionBundle	Bundle di definizione della firma di accesso condiviso originale e dei relativi attributi.
Other Status Codes	KeyVaultError	Risposta di errore di Key Vault che descrive il motivo per cui l'operazione non è riuscita.

Esempio

Recover Deleted Storage Sas Definition

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
DeletionRecoveryLevel	Riflette il livello di ripristino di eliminazione attualmente attivo per gli account di archiviazione nell'insieme di credenziali corrente. Se contiene "Purgeable", l'account di archiviazione può essere eliminato definitivamente da un utente con privilegi; in caso contrario, solo il sistema può eliminare l'account di archiviazione, alla fine dell'intervallo di conservazione.
Error	Errore del server dell'insieme di credenziali delle chiavi.
KeyVaultError	Eccezione di errore dell'insieme di credenziali delle chiavi.
SasDefinitionAttributes	Attributi di gestione delle definizioni di firma di accesso condiviso.
SasDefinitionBundle	Un bundle di definizione di firma di accesso condiviso è costituito dai dettagli della definizione della firma di accesso condiviso dell'insieme di credenziali delle chiavi e dai relativi attributi.
SasTokenType	Tipo di token di firma di accesso condiviso che verrà creata dalla definizione della firma di accesso condiviso.

DeletionRecoveryLevel

Enumerazione

Riflette il livello di ripristino di eliminazione attualmente attivo per gli account di archiviazione nell'insieme di credenziali corrente. Se contiene "Purgeable", l'account di archiviazione può essere eliminato definitivamente da un utente con privilegi; in caso contrario, solo il sistema può eliminare l'account di archiviazione, alla fine dell'intervallo di conservazione.

Valore	Descrizione
CustomizedRecoverable	Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile senza la possibilità di eliminazione immediata e permanente (ad esempio, ripulire quando 7<= SoftDeleteRetentionInDays < 90). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione e mentre la sottoscrizione è ancora disponibile.
CustomizedRecoverable+ProtectedSubscription	Indica un insieme di credenziali e uno stato della sottoscrizione in cui l'eliminazione è recuperabile, l'eliminazione immediata e permanente (ad esempio l'eliminazione) non è consentita e in cui la sottoscrizione stessa non può essere annullata in modo permanente quando 7<= SoftDeleteRetentionInDays < 90. Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione e riflette anche il fatto che la sottoscrizione stessa non può essere annullata.
CustomizedRecoverable+Purgeable	Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile e che consente anche l'eliminazione immediata e permanente ,ad esempio quando 7<= SoftDeleteRetentionInDays < 90). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione, a meno che non venga richiesta un'operazione di ripulitura o che la sottoscrizione venga annullata.
Purgeable	Indica uno stato dell'insieme di credenziali in cui l'eliminazione è un'operazione irreversibile, senza la possibilità di ripristino. Questo livello corrisponde a nessuna protezione disponibile per un'operazione di eliminazione; i dati vengono persi in modo irreversibile quando si accetta un'operazione di eliminazione a livello di entità o superiore (insieme di credenziali, gruppo di risorse, sottoscrizione e così via)
Recoverable	Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile senza la possibilità di eliminazione immediata e permanente (ad esempio ripulitura). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione (90 giorni) e mentre la sottoscrizione è ancora disponibile. Il sistema lo elimini definitivamente dopo 90 giorni, se non ripristinato
Recoverable+ProtectedSubscription	Indica un insieme di credenziali e uno stato della sottoscrizione in cui l'eliminazione è recuperabile entro l'intervallo di conservazione (90 giorni), l'eliminazione immediata e permanente (ad esempio l'eliminazione) non è consentita e in cui la sottoscrizione stessa non può essere annullata definitivamente. Il sistema lo elimini definitivamente dopo 90 giorni, se non ripristinato
Recoverable+Purgeable	Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile e che consente anche l'eliminazione immediata e permanente (ad esempio ripulitura). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione (90 giorni), a meno che non venga richiesta un'operazione di ripulitura o che la sottoscrizione venga annullata. Il sistema lo elimini definitivamente dopo 90 giorni, se non ripristinato

Error

Object

Errore del server dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
code	string	Codice di errore.
innererror	Error	Errore del server dell'insieme di credenziali delle chiavi.
message	string	Messaggio di errore.

KeyVaultError

Object

Eccezione di errore dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
error	Error	Errore del server dell'insieme di credenziali delle chiavi.

SasDefinitionAttributes

Object

Attributi di gestione delle definizioni di firma di accesso condiviso.

Nome	Tipo	Descrizione
created	integer (unixtime)	Ora di creazione in formato UTC.
enabled	boolean	stato abilitato dell'oggetto.
recoverableDays	integer (int32)	softDelete i giorni di conservazione dei dati. Il valore deve essere >=7 e <=90 quando softDelete è abilitato; in caso contrario, 0.
recoveryLevel	DeletionRecoveryLevel	Riflette il livello di ripristino di eliminazione attualmente in vigore per le definizioni di firma di accesso condiviso nell'insieme di credenziali corrente. Se contiene "Purgeable" la definizione della firma di accesso condiviso può essere eliminata definitivamente da un utente con privilegi; in caso contrario, solo il sistema può eliminare la definizione di firma di accesso condiviso, alla fine dell'intervallo di conservazione.
updated	integer (unixtime)	Ora dell'ultimo aggiornamento in formato UTC.

SasDefinitionBundle

Object

Un bundle di definizione di firma di accesso condiviso è costituito dai dettagli della definizione della firma di accesso condiviso dell'insieme di credenziali delle chiavi e dai relativi attributi.

Nome	Tipo	Descrizione
attributes	SasDefinitionAttributes	Attributi di definizione della firma di accesso condiviso.
id	string	ID definizione della firma di accesso condiviso.
sasType	SasTokenType	Tipo di token di firma di accesso condiviso che verrà creata dalla definizione della firma di accesso condiviso.
sid	string	ID segreto della definizione della firma di accesso condiviso dell'account di archiviazione.
tags	object	Metadati specifici dell'applicazione sotto forma di coppie chiave-valore
templateUri	string	Il modello di token di definizione della firma di accesso condiviso firmato con una chiave arbitraria. I token creati in base alla definizione della firma di accesso condiviso avranno le stesse proprietà del modello.
validityPeriod	string	Periodo di validità dei token di firma di accesso condiviso creati in base alla definizione della firma di accesso condiviso.

SasTokenType

Enumerazione

Tipo di token di firma di accesso condiviso che verrà creata dalla definizione della firma di accesso condiviso.

Valore	Descrizione
account
service