Share via

Get Deleted Certificates - Get Deleted Certificates

  • Referenz
Service:
Key Vault
API Version:
7.4

Listen die gelöschten Zertifikate im angegebenen Tresor, der derzeit für die Wiederherstellung verfügbar ist.
Der GetDeletedCertificates-Vorgang ruft die Zertifikate im aktuellen Tresor ab, die sich in einem gelöschten Zustand befinden und für die Wiederherstellung oder Das Löschen bereit sind. Dieser Vorgang enthält löschspezifische Informationen. Für diesen Vorgang ist die Berechtigung zertifikate/get/list erforderlich. Dieser Vorgang kann nur für vorläufiges Löschen aktivierter Tresore aktiviert werden.

GET {vaultBaseUrl}/deletedcertificates?api-version=7.4
With optional parameters: 
GET {vaultBaseUrl}/deletedcertificates?maxresults={maxresults}&includePending={includePending}&api-version=7.4

URI-Parameter

Name In Erforderlich Typ Beschreibung
vaultBaseUrl
 path True

string

Der Tresorname, z. B https://myvault.vault.azure.net. .
api-version
 query True

string

Client-API-Version.
includePending
 query

boolean

Gibt an, ob Zertifikate eingeschlossen werden sollen, die nicht vollständig bereitgestellt werden.
maxresults
 query

integer

int32

Maximale Anzahl von Ergebnissen, die auf einer Seite zurückgegeben werden sollen. Wenn nicht angegeben, gibt der Dienst bis zu 25 Ergebnisse zurück.

Antworten

Name Typ Beschreibung
200 OK

DeletedCertificateListResult

Eine Antwortnachricht mit einer Liste gelöschter Zertifikate im Tresor sowie einem Link zur nächsten Seite gelöschter Zertifikate
Other Status Codes

KeyVaultError

Key Vault Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

GetDeletedCertificates

Sample Request

GET https://myvault.vault.azure.net//deletedcertificates?maxresults=1&api-version=7.4

Sample Response

Status code:
200 
{
  "value": [
    {
      "recoveryId": "https://myvault.vault.azure.net/deletedcertificates/listdeletedcerttest0",
      "deletedDate": 1493937659,
      "scheduledPurgeDate": 1501713659,
      "id": "https://myvault.vault.azure.net/certificates/listdeletedcerttest0",
      "x5t": "fLi3U52HunIVNXubkEnf8tP6Wbo",
      "attributes": {
        "enabled": true,
        "nbf": 1430344421,
        "exp": 2208988799,
        "created": 1493937658,
        "updated": 1493937658,
        "recoveryLevel": "Recoverable+Purgeable"
      }
    }
  ],
  "nextLink": "https://myvault.vault.azure.net:443/deletedcertificates?api-version=7.2&$skiptoken=eyJOZXh0TWFya2VyIjoiMiExMTIhTURBd01ETTVJV05sY25ScFptbGpZWFJsTDB4SlUxUkVSVXhGVkVWRVEwVlNWRlJGVTFRd0wxQlBURWxEV1NFd01EQXdNamdoT1RrNU9TMHhNaTB6TVZReU16bzFPVG8xT1M0NU9UazVPVGs1V2lFLSIsIlRhcmdldExvY2F0aW9uIjowfQ&maxresults=1"
}

Definitionen

Name Beschreibung
CertificateAttributes

Die Zertifikatverwaltungsattribute.
DeletedCertificateItem

Das gelöschte Zertifikatelement, das Metadaten zum gelöschten Zertifikat enthält.
DeletedCertificateListResult

Eine Liste der Zertifikate, die in diesem Tresor gelöscht wurden.
DeletionRecoveryLevel

Gibt die Löschwiederherstellungsebene an, die derzeit für Zertifikate im aktuellen Tresor wirksam ist. Wenn es "Löschbar" enthält, kann das Zertifikat von einem privilegierten Benutzer endgültig gelöscht werden. andernfalls kann nur das System das Zertifikat am Ende des Aufbewahrungsintervalls bereinigen.
Error

Der Schlüsseltresorserverfehler.
KeyVaultError

Die Schlüsseltresorfehler-Ausnahme.

CertificateAttributes

Die Zertifikatverwaltungsattribute.

Name Typ Beschreibung
created

integer

Erstellungszeit in UTC.
enabled

boolean

Bestimmt, ob das Objekt aktiviert ist.
exp

integer

Ablaufdatum in UTC.
nbf

integer

Nicht vor Datum in UTC.
recoverableDays

integer

softDelete Datenaufbewahrungstage. Der Wert sollte =7 und <=90 sein>, wenn softDelete aktiviert ist, andernfalls 0.
recoveryLevel

DeletionRecoveryLevel

Gibt die Löschwiederherstellungsebene an, die derzeit für Zertifikate im aktuellen Tresor wirksam ist. Wenn es "Löschbar" enthält, kann das Zertifikat von einem privilegierten Benutzer endgültig gelöscht werden. andernfalls kann nur das System das Zertifikat am Ende des Aufbewahrungsintervalls bereinigen.
updated

integer

Uhrzeit der letzten Aktualisierung in UTC.

DeletedCertificateItem

Das gelöschte Zertifikatelement, das Metadaten zum gelöschten Zertifikat enthält.

Name Typ Beschreibung
attributes

CertificateAttributes

Die Zertifikatverwaltungsattribute.
deletedDate

integer

Der Zeitpunkt, zu dem das Zertifikat gelöscht wurde, in UTC
id

string

Zertifikatsbezeichner.
recoveryId

string

Die URL des Wiederherstellungsobjekts, das zum Identifizieren und Wiederherstellen des gelöschten Zertifikats verwendet wird.
scheduledPurgeDate

integer

Der Zeitpunkt, zu dem das Zertifikat gelöscht werden soll, in UTC
tags

object

Anwendungsspezifische Metadaten in Form von Schlüssel-Wert-Paaren.
x5t

string

Fingerabdruck des Zertifikats

DeletedCertificateListResult

Eine Liste der Zertifikate, die in diesem Tresor gelöscht wurden.

Name Typ Beschreibung
nextLink

string

Die URL, um den nächsten Satz gelöschter Zertifikate abzurufen.
value

DeletedCertificateItem[]

Eine Antwortnachricht mit einer Liste gelöschter Zertifikate im Tresor sowie einem Link zur nächsten Seite gelöschter Zertifikate

DeletionRecoveryLevel

Gibt die Löschwiederherstellungsebene an, die derzeit für Zertifikate im aktuellen Tresor wirksam ist. Wenn es "Löschbar" enthält, kann das Zertifikat von einem privilegierten Benutzer endgültig gelöscht werden. andernfalls kann nur das System das Zertifikat am Ende des Aufbewahrungsintervalls bereinigen.

Name Typ Beschreibung
CustomizedRecoverable

string

Gibt einen Tresorzustand an, in dem das Löschen ohne die Möglichkeit zum sofortigen und dauerhaften Löschen wiederhergestellt werden kann (d. h. löschen, wenn 7< = SoftDeleteRetentionInDays < 90). Diese Ebene garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls und solange das Abonnement noch verfügbar ist.
CustomizedRecoverable+ProtectedSubscription

string

Gibt einen Tresor- und Abonnementstatus an, in dem das Löschen wiederhergestellt werden kann, das sofortige und dauerhafte Löschen (d. h. löschen) nicht zulässig ist und in dem das Abonnement selbst nicht dauerhaft gekündigt werden kann, wenn 7<= SoftDeleteRetentionInDays < 90. Diese Ebene garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls und spiegelt auch die Tatsache wider, dass das Abonnement selbst nicht gekündigt werden kann.
CustomizedRecoverable+Purgeable

string

Gibt einen Tresorzustand an, in dem das Löschen wiederhergestellt werden kann und der auch eine sofortige und dauerhafte Löschung zulässt (d. h. löschen, wenn 7< = SoftDeleteRetentionInDays < 90). Diese Ebene garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls, es sei denn, es wird ein Löschvorgang angefordert oder das Abonnement gekündigt.
Purgeable

string

Gibt einen Tresorzustand an, in dem das Löschen ein irreversibler Vorgang ist, ohne dass die Möglichkeit zur Wiederherstellung besteht. Diese Ebene entspricht keinem Schutz gegen einen Löschvorgang. Die Daten sind unwiederbringlich verloren, wenn sie einen Löschvorgang auf Entitätsebene oder höher (Tresor, Ressourcengruppe, Abonnement usw.) akzeptieren.
Recoverable

string

Gibt einen Tresorzustand an, in dem das Löschen ohne die Möglichkeit zum sofortigen und dauerhaften Löschen (d. h. löschen) wiederhergestellt werden kann. Diese Ebene garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungszeitraums (90 Tage) und solange das Abonnement noch verfügbar ist. Das System wird es nach 90 Tagen endgültig löschen, wenn es nicht wiederhergestellt wurde
Recoverable+ProtectedSubscription

string

Gibt einen Tresor- und Abonnementstatus an, in dem das Löschen innerhalb eines Aufbewahrungsintervalls (90 Tage) wiederhergestellt werden kann, das sofortige und dauerhafte Löschen (d. h. löschen) nicht zulässig ist und in dem das Abonnement selbst nicht dauerhaft gekündigt werden kann. Das System wird es nach 90 Tagen endgültig löschen, wenn es nicht wiederhergestellt wurde
Recoverable+Purgeable

string

Gibt einen Tresorzustand an, in dem das Löschen wiederhergestellt werden kann und der auch das sofortige und dauerhafte Löschen (d. h. Löschen) zulässt. Diese Ebene garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls (90 Tage), es sei denn, es wird ein Löschvorgang angefordert oder das Abonnement gekündigt. Das System wird es nach 90 Tagen endgültig löschen, wenn es nicht wiederhergestellt wurde

Error

Der Schlüsseltresorserverfehler.

Name Typ Beschreibung
code

string

Der Fehlercode.
innererror

Error

Der Schlüsseltresorserverfehler.
message

string

Die Fehlermeldung.

KeyVaultError

Die Schlüsseltresorfehler-Ausnahme.

Name Typ Beschreibung
error

Error

Der Schlüsseltresorserverfehler.