Get Deleted Secrets - Get Deleted Secrets
Listy usuniętych wpisów tajnych dla określonego magazynu.
Operacja Pobierz usunięte wpisy tajne zwraca wpisy tajne, które zostały usunięte dla magazynu włączonego do usuwania nietrwałego. Ta operacja wymaga uprawnień do wpisów tajnych/listy.
GET {vaultBaseUrl}/deletedsecrets?api-version=7.4
GET {vaultBaseUrl}/deletedsecrets?maxresults={maxresults}&api-version=7.4
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
vault
|
path | True |
string |
Nazwa magazynu, na przykład https://myvault.vault.azure.net. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
maxresults
|
query |
integer int32 |
Maksymalna liczba wyników do zwrócenia na stronie. Jeśli usługa nie zostanie określona, zwróci maksymalnie 25 wyników. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Komunikat odpowiedzi zawierający listę usuniętych wpisów tajnych w magazynie wraz z linkiem do następnej strony usuniętych wpisów tajnych. |
|
Other Status Codes |
Key Vault odpowiedzi na błąd opisujący, dlaczego operacja nie powiodła się. |
Przykłady
GetDeletedSecrets
Sample Request
GET https://myvault.vault.azure.net//deletedsecrets?maxresults=1&api-version=7.4
Sample Response
{
"value": [
{
"recoveryId": "https://myvault.vault.azure.net/deletedsecrets/listdeletedsecrettest0",
"deletedDate": 1493937855,
"scheduledPurgeDate": 1501713855,
"contentType": "plainText",
"id": "https://myvault.vault.azure.net/secrets/listdeletedsecrettest0",
"attributes": {
"enabled": true,
"created": 1493937855,
"updated": 1493937855,
"recoveryLevel": "Recoverable+Purgeable"
}
}
],
"nextLink": "https://myvault.vault.azure.net:443/deletedsecrets?api-version=7.2&$skiptoken=eyJOZXh0TWFya2VyIjoiMiExNDQhTURBd01EWXlJWE5sWTNKbGRDOU1TVk5VUkVWTVJWUkZSRk5GUTFKRlZGUkZVMVF3THpZMU16ZERSRVJGTlRJNU5qUkRSa1pDTVRkQ1JVWXhORGszUXpSQ1JEZEVJVEF3TURBeU9DRXlNREUzTFRBMUxUQTBWREl5T2pRME9qUXdMamsxTnpZeE1UbGFJUS0tIiwiVGFyZ2V0TG9jYXRpb24iOjB9&maxresults=1"
}
Definicje
Nazwa | Opis |
---|---|
Deleted |
Usunięty element wpisu tajnego zawierający metadane dotyczące usuniętego wpisu tajnego. |
Deleted |
Wynik listy usuniętych wpisów tajnych |
Deletion |
Odzwierciedla obecnie poziom odzyskiwania usuwania dla wpisów tajnych w bieżącym magazynie. Jeśli zawiera "przeczyszczalną", wpis tajny może zostać trwale usunięty przez uprzywilejowanego użytkownika; w przeciwnym razie tylko system może przeczyścić wpis tajny na końcu interwału przechowywania. |
Error |
Błąd serwera magazynu kluczy. |
Key |
Wyjątek błędu magazynu kluczy. |
Secret |
Atrybuty zarządzania wpisami tajnymi. |
DeletedSecretItem
Usunięty element wpisu tajnego zawierający metadane dotyczące usuniętego wpisu tajnego.
Nazwa | Typ | Opis |
---|---|---|
attributes |
Atrybuty zarządzania wpisami tajnymi. |
|
contentType |
string |
Typ wartości wpisu tajnego, na przykład hasło. |
deletedDate |
integer |
Godzina usunięcia wpisu tajnego w formacie UTC |
id |
string |
Identyfikator wpisu tajnego. |
managed |
boolean |
Wartość true, jeśli okres istnienia wpisu tajnego jest zarządzany przez magazyn kluczy. Jeśli jest to klucz kopii zapasowej certyfikatu, zarządzany będzie mieć wartość true. |
recoveryId |
string |
Adres URL obiektu odzyskiwania używany do identyfikowania i odzyskiwania usuniętego wpisu tajnego. |
scheduledPurgeDate |
integer |
Godzina przeczyszczania wpisu tajnego w formacie UTC |
tags |
object |
Metadane specyficzne dla aplikacji w postaci par klucz-wartość. |
DeletedSecretListResult
Wynik listy usuniętych wpisów tajnych
Nazwa | Typ | Opis |
---|---|---|
nextLink |
string |
Adres URL umożliwiający pobranie następnego zestawu usuniętych wpisów tajnych. |
value |
Komunikat odpowiedzi zawierający listę usuniętych wpisów tajnych w magazynie wraz z linkiem do następnej strony usuniętych wpisów tajnych |
DeletionRecoveryLevel
Odzwierciedla obecnie poziom odzyskiwania usuwania dla wpisów tajnych w bieżącym magazynie. Jeśli zawiera "przeczyszczalną", wpis tajny może zostać trwale usunięty przez uprzywilejowanego użytkownika; w przeciwnym razie tylko system może przeczyścić wpis tajny na końcu interwału przechowywania.
Nazwa | Typ | Opis |
---|---|---|
CustomizedRecoverable |
string |
Określa stan magazynu, w którym można odzyskać usunięcie bez możliwości natychmiastowego i trwałego usunięcia (tj. przeczyszczania, gdy 7< = SoftDeleteRetentionInDays < 90). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania i gdy subskrypcja jest nadal dostępna. |
CustomizedRecoverable+ProtectedSubscription |
string |
Oznacza, że magazyn i stan subskrypcji, w którym usunięcie jest możliwe do odzyskania, natychmiastowe i trwałe usunięcie (tj. przeczyszczenie) jest niedozwolone i w którym sama subskrypcja nie może zostać trwale anulowana, gdy 7< = SoftDeleteRetentionInDays < 90. Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania, a także odzwierciedla fakt, że sama subskrypcja nie może zostać anulowana. |
CustomizedRecoverable+Purgeable |
string |
Określa stan magazynu, w którym można odzyskać usunięcie, a także zezwala na natychmiastowe i trwałe usunięcie (tj. przeczyszczanie, gdy 7< = SoftDeleteRetentionInDays < 90). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania, chyba że zażądano operacji przeczyszczania lub subskrypcja zostanie anulowana. |
Purgeable |
string |
Określa stan magazynu, w którym usunięcie jest operacją nieodwracalną, bez możliwości odzyskiwania. Ten poziom nie odpowiada działaniu ochrony przed operacją Usuwania; dane są nieodwracalnie utracone po zaakceptowaniu operacji Usuwania na poziomie jednostki lub wyższym (magazyn, grupa zasobów, subskrypcja itp.) |
Recoverable |
string |
Określa stan magazynu, w którym można odzyskać usunięcie bez możliwości natychmiastowego i trwałego usunięcia (tj. przeczyszczania). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania (90 dni) i gdy subskrypcja jest nadal dostępna. System zostanie trwale usunięty po 90 dniach, jeśli nie zostanie odzyskany |
Recoverable+ProtectedSubscription |
string |
Określa magazyn i stan subskrypcji, w którym usunięcie można odzyskać w okresie przechowywania (90 dni), natychmiastowe i trwałe usunięcie (tj. przeczyszczenie) jest niedozwolone i w którym sama subskrypcja nie może zostać trwale anulowana. System zostanie trwale usunięty po 90 dniach, jeśli nie zostanie odzyskany |
Recoverable+Purgeable |
string |
Określa stan magazynu, w którym można odzyskać usunięcie, a także umożliwia natychmiastowe i trwałe usunięcie (tj. przeczyszczenie). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania (90 dni), chyba że zażądano operacji przeczyszczania lub subskrypcja zostanie anulowana. System zostanie trwale usunięty po 90 dniach, jeśli nie zostanie odzyskany |
Error
Błąd serwera magazynu kluczy.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod błędu. |
innererror |
Błąd serwera magazynu kluczy. |
|
message |
string |
Komunikat o błędzie. |
KeyVaultError
Wyjątek błędu magazynu kluczy.
Nazwa | Typ | Opis |
---|---|---|
error |
Błąd serwera magazynu kluczy. |
SecretAttributes
Atrybuty zarządzania wpisami tajnymi.
Nazwa | Typ | Opis |
---|---|---|
created |
integer |
Czas utworzenia w formacie UTC. |
enabled |
boolean |
Określa, czy obiekt jest włączony. |
exp |
integer |
Data wygaśnięcia w formacie UTC. |
nbf |
integer |
Nie wcześniej niż data w formacie UTC. |
recoverableDays |
integer |
softDelete data retention days (dni przechowywania danych softDelete). Wartość powinna mieć >wartość =7 i <=90, gdy funkcja softDelete jest włączona, w przeciwnym razie 0. |
recoveryLevel |
Odzwierciedla obecnie poziom odzyskiwania usuwania dla wpisów tajnych w bieżącym magazynie. Jeśli zawiera "przeczyszczalną", wpis tajny może zostać trwale usunięty przez uprzywilejowanego użytkownika; w przeciwnym razie tylko system może przeczyścić wpis tajny na końcu interwału przechowywania. |
|
updated |
integer |
Czas ostatniej aktualizacji w formacie UTC. |