Get Deleted Sas Definitions - Get Deleted Sas Definitions

Reference

Service:: Key Vault

API Version:: 7.4

Seznamy odstraněné definice SAS pro zadaný trezor a účet úložiště.
Operace Získat odstraněné definice SAS vrátí definice SAS, které byly odstraněny pro trezor s povoleným obnovitelné odstranění. Tato operace vyžaduje oprávnění storage/listsas.

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

With optional parameters:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
storage-account-name	path	True	string	Název účtu úložiště. Regex pattern: `^[0-9a-zA-Z]+$`
vaultBaseUrl	path	True	string	Název trezoru, například https://myvault.vault.azure.net.
api-version	query	True	string	Verze klientského rozhraní API
maxresults	query		integer int32	Maximální počet výsledků, které se mají na stránce vrátit. Pokud není zadáno, vrátí služba až 25 výsledků.

Odpovědi

Name	Typ	Description
200 OK	DeletedSasDefinitionListResult	Zpráva odpovědi obsahující seznam odstraněných definic SAS pro účet úložiště spolu s odkazem na další stránku odstraněných definic SAS.
Other Status Codes	KeyVaultError	Key Vault chybovou odpověď popisující příčinu selhání operace.

Příklady

List Deleted Storage Sas Definitions

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "https://myvault.vault.azure.net/storage/listsas01/sas/listDeletedSasDef01",
      "sid": "https://myvault.vault.azure.net/secrets/listsas01-listDeletedSasDef01",
      "recoveryId": "https://myvault.vault.azure.net/deletedstorage/listsas01/sas/listDeletedSasDef01",
      "scheduledPurgeDate": 1490790000,
      "deletedDate": 1490760000,
      "attributes": {
        "enabled": true,
        "created": 1490738438,
        "updated": 1490738438,
        "recoveryLevel": "Recoverable"
      }
    },
    {
      "id": "https://myvault.vault.azure.net/storage/listsas01/sas/listDeletedSasDef02",
      "sid": "https://myvault.vault.azure.net/secrets/listsas01-listDeletedSasDef02",
      "recoveryId": "https://myvault.vault.azure.net/deletedstorage/listsas01/sas/listDeletedSasDef02",
      "scheduledPurgeDate": 1490790000,
      "deletedDate": 1490760000,
      "attributes": {
        "enabled": true,
        "created": 1490738438,
        "updated": 1490738438,
        "recoveryLevel": "Recoverable"
      }
    }
  ],
  "nextLink": "https://{BaseUri}/deletedstorage/listsas01/sas?api-version=7.2&%24skiptoken=<token>"
}

Definice

Name	Description
DeletedSasDefinitionItem	Odstraněná položka definice SAS obsahující metadata o odstraněné definici SAS.
DeletedSasDefinitionListResult	Výsledek seznamu odstraněných definic SAS
DeletionRecoveryLevel	Odráží úroveň obnovení odstranění, která aktuálně platí pro účty úložiště v aktuálním trezoru. Pokud obsahuje vyprázdnitelný účet úložiště, může ho trvale odstranit privilegovaný uživatel. 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.

DeletedSasDefinitionItem

Odstraněná položka definice SAS obsahující metadata o odstraněné definici SAS.

Name	Typ	Description
attributes	SasDefinitionAttributes	Atributy správy definic SAS.
deletedDate	integer	Čas odstranění definice SAS v UTC
id	string	Identifikátor SAS úložiště.
recoveryId	string	Adresa URL objektu obnovení, která slouží k identifikaci a obnovení odstraněné definice SAS.
scheduledPurgeDate	integer	Č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.

DeletedSasDefinitionListResult

Výsledek seznamu odstraněných definic SAS

Name	Typ	Description
nextLink	string	Adresa URL pro získání další sady odstraněných definic SAS.
value	DeletedSasDefinitionItem[]	Zpráva odpovědi obsahující seznam odstraněných definic SAS v trezoru spolu s odkazem na další stránku odstraněných definic SAS

DeletionRecoveryLevel

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

Name	Typ	Description
CustomizedRecoverable	string	Označuje stav trezoru, ve kterém je možné odstranění obnovit bez možnosti okamžitého a trvalého odstranění (tj. vymazání při 7< = SoftDeleteRetentionInDays < 90). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání a po dobu, kdy je předplatné stále dostupné.
CustomizedRecoverable+ProtectedSubscription	string	Označuje stav trezoru a předplatného, ve kterém je odstranění obnovitelné, okamžité a trvalé odstranění (tj. vymazání) není povoleno a ve kterém samotné předplatné nelze trvale zrušit, pokud je 7< = SoftDeleteRetentionInDays < 90. Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání a odráží také skutečnost, že samotné předplatné nelze zrušit.
CustomizedRecoverable+Purgeable	string	Označuje stav trezoru, ve kterém je možné odstranění obnovit a který také umožňuje okamžité a trvalé odstranění (tj. vymazání při 7< = SoftDeleteRetentionInDays < 90). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání, pokud není požadována operace vyprázdnění nebo pokud není zrušeno předplatné.
Purgeable	string	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 k nenávratné ztrátě dat.
Recoverable	string	Označuje stav trezoru, ve kterém je možné odstranění obnovit bez možnosti okamžitého a trvalého odstranění (tj. vymazání). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání (90 dnů) a v době, kdy je předplatné stále dostupné. Systém ho po 90 dnech trvale odstraní, pokud není obnovený.
Recoverable+ProtectedSubscription	string	Označuje stav trezoru a předplatného, ve kterém je možné odstranění obnovit v intervalu uchovávání (90 dnů), okamžité a trvalé odstranění (tj. vymazání) není povoleno a ve kterém samotné předplatné nelze trvale zrušit. Systém ho po 90 dnech trvale odstraní, pokud není obnovený.
Recoverable+Purgeable	string	Označuje stav trezoru, ve kterém je možné odstranění obnovit a který také umožňuje okamžité a trvalé odstranění (tj. vymazání). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání (90 dnů), pokud není požadována operace vyprázdnění nebo pokud není předplatné zrušeno. Systém ho po 90 dnech trvale odstraní, pokud není obnovený.

Error

Chyba serveru trezoru klíčů.

Name	Typ	Description
code	string	Kód chyby
innererror	Error	Chyba serveru trezoru klíčů.
message	string	Chybová zpráva

KeyVaultError

Výjimka chyby trezoru klíčů

Name	Typ	Description
error	Error	Chyba serveru trezoru klíčů.

SasDefinitionAttributes

Atributy správy definic SAS.

Name	Typ	Description
created	integer	Čas vytvoření ve standardu UTC.
enabled	boolean	povolený stav objektu.
recoverableDays	integer	softDelete data retention days. Hodnota by měla být >=7 a <=90, pokud je povolená funkce softDelete, jinak 0.
recoveryLevel	DeletionRecoveryLevel	Odráží úroveň obnovení odstranění, která aktuálně platí pro definice SAS v aktuálním trezoru. Pokud obsahuje vyprázdnitelnou definici SAS, může být trvale odstraněna uživatelem s oprávněním; V opačném případě může definici SAS na konci intervalu uchovávání vyprázdnit pouze systém.
updated	integer	Čas poslední aktualizace v UTC.

Share via