Get Secret Versions - Get Secret Versions

Referenz

Service:: Key Vault

API Version:: 7.4

Listet alle Versionen des angegebenen Geheimnisses auf.
Der vollständige geheime Bezeichner und Attribute werden in der Antwort bereitgestellt. Für die Geheimnisse werden keine Werte zurückgegeben. Für diese Vorgänge ist die Berechtigung geheimnisse/listen erforderlich.

GET {vaultBaseUrl}/secrets/{secret-name}/versions?api-version=7.4

With optional parameters:

GET {vaultBaseUrl}/secrets/{secret-name}/versions?maxresults={maxresults}&api-version=7.4

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
secret-name	path	True	string	Der Name des Geheimnisses.
vaultBaseUrl	path	True	string	Der Tresorname, z. B https://myvault.vault.azure.net. .
api-version	query	True	string	Client-API-Version.
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	SecretListResult	Eine Antwortnachricht, die eine Liste mit Geheimnissen sowie einen Link zur nächsten Seite mit Geheimnissen enthält.
Other Status Codes	KeyVaultError	Key Vault Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

GetSecretVersions

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "https://myvault.vault.azure.net/secrets/listsecretversionstest/11a536561da34d6b8b452d880df58f3a",
      "attributes": {
        "enabled": true,
        "created": 1481851699,
        "updated": 1481851699
      }
    }
  ],
  "nextLink": "https://myvault.vault.azure.net:443/secrets/listsecretversionstest/versions?api-version=7.2&$skiptoken=eyJOZXh0TWFya2VyIjoiMiExNDQhTURBd01EWXlJWE5sWTNKbGRDOU1TVk5VVTBWRFVrVlVWa1ZTVTBsUFRsTlVSVk5VTHpGRU5EazJNa0l4UlVRM09EUkVRa1k0T1RsR016TXpNa1UwTnpZNFFqY3dJVEF3TURBeU9DRTVPVGs1TFRFeUxUTXhWREl6T2pVNU9qVTVMams1T1RrNU9UbGFJUS0tIiwiVGFyZ2V0TG9jYXRpb24iOjB9&maxresults=1"
}

Definitionen

Name	Beschreibung
DeletionRecoveryLevel	Gibt die Löschwiederherstellungsebene an, die derzeit für Geheimnisse im aktuellen Tresor wirksam ist. Wenn es "Löschbar" enthält, kann das Geheimnis von einem privilegierten Benutzer endgültig gelöscht werden. Andernfalls kann nur das System das Geheimnis am Ende des Aufbewahrungsintervalls bereinigen.
Error	Der Schlüsseltresorserverfehler.
KeyVaultError	Die Schlüsseltresorfehler-Ausnahme.
SecretAttributes	Die Attribute für die Geheimnisverwaltung.
SecretItem	Das Geheimniselement, das geheime Metadaten enthält.
SecretListResult	Das Ergebnis der Geheimnisliste.

DeletionRecoveryLevel

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

Name	Typ	Beschreibung
CustomizedRecoverable	string	Gibt einen Tresorzustand an, in dem das Löschen wiederhergestellt werden kann, ohne die Möglichkeit einer sofortigen und dauerhaften Löschung zu haben (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 das sofortige und dauerhafte Löschen 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 Bereinigungsvorgang angefordert oder das Abonnement gekündigt.
Purgeable	string	Gibt einen Tresorzustand an, bei dem das Löschen ein irreversibler Vorgang ist, ohne dass eine Wiederherstellung möglich ist. Diese Ebene entspricht keinem Schutz vor einem 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 wiederhergestellt werden kann, ohne die Möglichkeit einer sofortigen und dauerhaften Löschung (d. h. Löschen) zu haben. Diese Ebene garantiert die Wiederherstellbarkeit der gelöschten Entität während des Aufbewahrungsintervalls (90 Tage) und solange das Abonnement noch verfügbar ist. System wird es nach 90 Tagen endgültig löschen, wenn es nicht wiederhergestellt wird
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. System wird es nach 90 Tagen endgültig löschen, wenn es nicht wiederhergestellt wird
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, ein Bereinigungsvorgang wird angefordert oder das Abonnement wird gekündigt. System wird es nach 90 Tagen endgültig löschen, wenn es nicht wiederhergestellt wird

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.

SecretAttributes

Die Attribute für die Geheimnisverwaltung.

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 Geheimnisse im aktuellen Tresor wirksam ist. Wenn es "Löschbar" enthält, kann das Geheimnis von einem privilegierten Benutzer endgültig gelöscht werden. Andernfalls kann nur das System das Geheimnis am Ende des Aufbewahrungsintervalls bereinigen.
updated	integer	Uhrzeit der letzten Aktualisierung in UTC.

SecretItem

Das Geheimniselement, das geheime Metadaten enthält.

Name	Typ	Beschreibung
attributes	SecretAttributes	Die Attribute für die Geheimnisverwaltung.
contentType	string	Der Typ des Geheimniswerts, z. B. ein Kennwort.
id	string	Geheimnisbezeichner.
managed	boolean	True, wenn die Lebensdauer des Geheimnisses vom Schlüsseltresor verwaltet wird. Wenn dies ein Schlüssel ist, der ein Zertifikat sichert, ist verwaltet true.
tags	object	Anwendungsspezifische Metadaten in Form von Schlüssel-Wert-Paaren.

SecretListResult

Das Ergebnis der Geheimnisliste.

Name	Typ	Beschreibung
nextLink	string	Die URL, um den nächsten Satz von Geheimnissen abzurufen.
value	SecretItem[]	Eine Antwortnachricht, die eine Liste der Geheimnisse im Schlüsseltresor sowie einen Link zur nächsten Seite mit Geheimnissen enthält.

Share via