Share via


Get Deleted Sas Definitions - Get Deleted Sas Definitions

Listen gelöschte SAS-Definitionen für den angegebenen Tresor und das angegebene Speicherkonto.
Der Vorgang "Gelöschte Sas-Definitionen abrufen" gibt die SAS-Definitionen zurück, die für einen Tresor gelöscht wurden, der für vorläufiges Löschen aktiviert ist. Für diesen Vorgang ist die Berechtigung storage/lists erforderlich.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
storage-account-name
path True

string

Der Name des Speicherkontos.

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

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

DeletedSasDefinitionListResult

Eine Antwortnachricht mit einer Liste gelöschter SAS-Definitionen für das Speicherkonto sowie einen Link zur nächsten Seite gelöschter SAS-Definitionen.

Other Status Codes

KeyVaultError

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

Beispiele

List Deleted Storage Sas Definitions

Sample Request

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

Sample Response

{
  "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>"
}

Definitionen

Name Beschreibung
DeletedSasDefinitionItem

Das gelöschte SAS-Definitionselement, das Metadaten zur gelöschten SAS-Definition enthält.

DeletedSasDefinitionListResult

Das Ergebnis der gelöschten SAS-Definitionsliste

DeletionRecoveryLevel

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

Error

Der Schlüsseltresorserverfehler.

KeyVaultError

Die Schlüsseltresorfehler-Ausnahme.

SasDefinitionAttributes

Die SAS-Definitionsverwaltungsattribute.

DeletedSasDefinitionItem

Das gelöschte SAS-Definitionselement, das Metadaten zur gelöschten SAS-Definition enthält.

Name Typ Beschreibung
attributes

SasDefinitionAttributes

Die SAS-Definitionsverwaltungsattribute.

deletedDate

integer

Der Zeitpunkt, zu dem die SAS-Definition in UTC gelöscht wurde

id

string

Der SAS-Bezeichner des Speichers.

recoveryId

string

Die URL des Wiederherstellungsobjekts, das zum Identifizieren und Wiederherstellen der gelöschten SAS-Definition verwendet wird.

scheduledPurgeDate

integer

Der Zeitpunkt, zu dem die SAS-Definition gelöscht werden soll, in UTC

sid

string

Die SAS-Definitionsgeheimnis-ID des Speicherkontos.

tags

object

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

DeletedSasDefinitionListResult

Das Ergebnis der gelöschten SAS-Definitionsliste

Name Typ Beschreibung
nextLink

string

Die URL, um den nächsten Satz gelöschter SAS-Definitionen abzurufen.

value

DeletedSasDefinitionItem[]

Eine Antwortnachricht, die eine Liste der gelöschten SAS-Definitionen im Tresor sowie einen Link zur nächsten Seite gelöschter SAS-Definitionen enthält.

DeletionRecoveryLevel

Gibt die Löschwiederherstellungsebene an, die derzeit für Speicherkonten im aktuellen Tresor wirksam ist. Wenn es "Löschbar" enthält, kann das Speicherkonto von einem privilegierten Benutzer endgültig gelöscht werden. andernfalls kann nur das System das Speicherkonto 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.

SasDefinitionAttributes

Die SAS-Definitionsverwaltungsattribute.

Name Typ Beschreibung
created

integer

Erstellungszeit in UTC.

enabled

boolean

der aktivierte Zustand des Objekts.

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 SAS-Definitionen im aktuellen Tresor wirksam ist. Wenn sie "Löschbar" enthält, kann die SAS-Definition von einem privilegierten Benutzer endgültig gelöscht werden. andernfalls kann nur das System die SAS-Definition am Ende des Aufbewahrungsintervalls bereinigen.

updated

integer

Uhrzeit der letzten Aktualisierung in UTC.