Sdílet prostřednictvím

Get Deleted Sas Definition - Get Deleted Sas Definition

  • Reference
Služba:
Key Vault
Verze rozhraní API:
7.4

Získá zadanou definici odstraněného sas.
Operace Get Deleted SAS Definition vrátí zadanou definici odstraněného SAS spolu s jeho atributy. Tato operace vyžaduje oprávnění úložiště nebo získání.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
sas-definition-name
 path True

string

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

Název definice SAS.
storage-account-name
 path True

string

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

Název účtu úložiště.
vaultBaseUrl
 path True

string

Název trezoru, například https://myvault.vault.azure.net.
api-version
 query True

string

Verze rozhraní API klienta.

Odpovědi

Name Typ Description
200 OK

DeletedSasDefinitionBundle

Odstraněná definice SAS a informace o tom, kdy se vyprázdní a jak obnovit odstraněnou definici SAS.
Other Status Codes

KeyVaultError

Odpověď na chybu služby Key Vault popisující, proč operace selhala.

Příklady

Get Deleted Storage Sas Definition

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
  }
}

Definice

Name Description
DeletedSasDefinitionBundle

Odstraněná sada definic SAS, která se skládá z předchozího ID, atributů a jejích značek, a také informací o tom, kdy se vyprázdní.
DeletionRecoveryLevel

Odráží úroveň obnovení odstranění, která je aktuálně platná pro účty úložiště v aktuálním trezoru. Pokud účet úložiště obsahuje "vyprázdnit", může ho privilegovaný uživatel trvale odstranit; v opačném případě může účet úložiště na konci intervalu uchovávání vyprázdnit pouze systém.
Error

Chyba serveru trezoru klíčů.
KeyVaultError

Výjimka chyby trezoru klíčů.
SasDefinitionAttributes

Atributy správy definic SAS.
SasTokenType

Typ tokenu SAS, který definice SAS vytvoří.

DeletedSasDefinitionBundle

Objekt

Odstraněná sada definic SAS, která se skládá z předchozího ID, atributů a jejích značek, a také informací o tom, kdy se vyprázdní.

Name Typ Description
attributes

SasDefinitionAttributes

Atributy definice SAS.
deletedDate

integer (unixtime)

Čas odstranění definice SAS v UTC
id

string

ID definice SAS.
recoveryId

string

Adresa URL objektu obnovení sloužící k identifikaci a obnovení definice odstraněného SAS.
sasType

SasTokenType

Typ tokenu SAS, který definice SAS vytvoří.
scheduledPurgeDate

integer (unixtime)

Čas, kdy je naplánováno vymazání definice SAS v UTC
sid

string

ID tajného klíče SAS účtu úložiště
tags

object

Metadata specifická pro aplikaci ve formě párů klíč-hodnota
templateUri

string

Šablona tokenu definice SAS podepsaná libovolným klíčem. Tokeny vytvořené podle definice SAS budou mít stejné vlastnosti jako šablona.
validityPeriod

string

Doba platnosti tokenů SAS vytvořená podle definice SAS.

DeletionRecoveryLevel

Výčet

Odráží úroveň obnovení odstranění, která je aktuálně platná pro účty úložiště v aktuálním trezoru. Pokud účet úložiště obsahuje "vyprázdnit", může ho privilegovaný uživatel trvale odstranit; v opačném případě může účet úložiště na konci intervalu uchovávání vyprázdnit pouze systém.

Hodnota Description
CustomizedRecoverable

Označuje stav trezoru, ve kterém je odstranění možné obnovit bez možnosti okamžitého a trvalého odstranění (tj. vymazání, když 7<= SoftDeleteRetentionInDays < 90). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání a v době, kdy je předplatné stále dostupné.
CustomizedRecoverable+ProtectedSubscription

Označuje stav trezoru a předplatného, ve kterém je odstranění obnovitelné, okamžité a trvalé odstranění (tj. vyprázdnění) povoleno a ve kterém samotné předplatné nelze trvale zrušit, když 7<= SoftDeleteRetentionInDays < 90. Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání a také odráží skutečnost, že samotné předplatné nelze zrušit.
CustomizedRecoverable+Purgeable

Označuje stav trezoru, ve kterém se odstranění dá obnovit, a umožňuje také okamžité a trvalé odstranění (tj. vymazání, když 7<= SoftDeleteRetentionInDays < 90). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání, pokud se nepožaduje operace vyprázdnění nebo se předplatné zruší.
Purgeable

Označuje stav trezoru, ve kterém je odstranění nevratnou operací bez možnosti obnovení. Tato úroveň odpovídá tomu, že není k dispozici žádná ochrana proti operaci odstranění; při přijetí operace odstranění na úrovni entity nebo vyšší (trezor, skupina prostředků, předplatné atd.) dojde ke ztrátě dat.
Recoverable

Označuje stav trezoru, ve kterém se odstranění dá obnovit bez možnosti okamžitého a trvalého odstranění (tj. vyprázdnění). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání informací (90 dnů) a v době, kdy je předplatné stále dostupné. Systém ho trvale odstraní po 90 dnech, pokud ho neobnoví.
Recoverable+ProtectedSubscription

Označuje stav trezoru a předplatného, ve kterém je odstranění možné obnovit v intervalu uchovávání (90 dnů), okamžitém a trvalém odstranění (tj. vymazání) není povoleno a ve kterém samotné předplatné nelze trvale zrušit. Systém ho trvale odstraní po 90 dnech, pokud ho neobnoví.
Recoverable+Purgeable

Označuje stav trezoru, ve kterém je odstranění obnovitelné, a umožňuje také okamžité a trvalé odstranění (tj. vyprázdnění). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání informací (90 dnů), pokud se nepožaduje operace vyprázdnění nebo se předplatné zruší. Systém ho trvale odstraní po 90 dnech, pokud ho neobnoví.

Error

Objekt

Chyba serveru trezoru klíčů.

Name Typ Description
code

string

Kód chyby.
innererror

Error

Chyba serveru trezoru klíčů.
message

string

Chybová zpráva.

KeyVaultError

Objekt

Výjimka chyby trezoru klíčů.

Name Typ Description
error

Error

Chyba serveru trezoru klíčů.

SasDefinitionAttributes

Objekt

Atributy správy definic SAS.

Name Typ Description
created

integer (unixtime)

Čas vytvoření ve standardu UTC
enabled

boolean

povolený stav objektu.
recoverableDays

integer (int32)

softDelete data retention days. Hodnota by měla být >=7 a <=90, pokud je povolený softDelete, jinak 0.
recoveryLevel

DeletionRecoveryLevel

Odráží úroveň obnovení odstranění, která je aktuálně platná pro definice SAS v aktuálním trezoru. Pokud obsahuje "vyprázdnit", definice SAS může být trvale odstraněna privilegovaným uživatelem; v opačném případě může definici SAS na konci intervalu uchovávání vyprázdnit pouze systém.
updated

integer (unixtime)

Čas poslední aktualizace ve standardu UTC

SasTokenType

Výčet

Typ tokenu SAS, který definice SAS vytvoří.

Hodnota Description
account
service