Get Deleted Secrets - Get Deleted Secrets

Referens

Tjänst:: Key Vault

API-version:: 7.4

Listor borttagna hemligheter för det angivna valvet.
Åtgärden Hämta borttagna hemligheter returnerar de hemligheter som har tagits bort för ett valv som är aktiverat för mjuk borttagning. Den här åtgärden kräver behörigheten hemligheter/lista.

GET {vaultBaseUrl}/deletedsecrets?api-version=7.4

Med valfria parametrar:

GET {vaultBaseUrl}/deletedsecrets?maxresults={maxresults}&api-version=7.4

URI-parametrar

Name	I	Obligatorisk	Typ	Description
vaultBaseUrl	path	True	string	Valvnamnet, till exempel https://myvault.vault.azure.net.
api-version	query	True	string	Klient-API-version.
maxresults	query		integer int32	Maximalt antal resultat som ska returneras på en sida. Om det inte anges returnerar tjänsten upp till 25 resultat.

Svar

Name	Typ	Description
200 OK	DeletedSecretListResult	Ett svarsmeddelande som innehåller en lista över borttagna hemligheter i valvet, tillsammans med en länk till nästa sida med borttagna hemligheter.
Other Status Codes	KeyVaultError	Key Vault felsvar som beskriver varför åtgärden misslyckades.

Exempel

GetDeletedSecrets

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 200

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

Definitioner

Name	Description
DeletedSecretItem	Det borttagna hemliga objektet som innehåller metadata om den borttagna hemligheten.
DeletedSecretListResult	Resultatet av listan över borttagna hemligheter
DeletionRecoveryLevel	Visar den återställningsnivå för borttagning som för närvarande gäller för hemligheter i det aktuella valvet. Om den innehåller "Purgeable" kan hemligheten tas bort permanent av en privilegierad användare. Annars kan bara systemet rensa hemligheten i slutet av kvarhållningsintervallet.
Error	Key Vault-serverns fel.
KeyVaultError	Felfelet för nyckelvalvet.
SecretAttributes	De hemliga hanteringsattributen.

DeletedSecretItem

Det borttagna hemliga objektet som innehåller metadata om den borttagna hemligheten.

Name	Typ	Description
attributes	SecretAttributes	De hemliga hanteringsattributen.
contentType	string	Typ av hemligt värde, till exempel ett lösenord.
deletedDate	integer	Tiden då hemligheten togs bort i UTC
id	string	Hemlig identifierare.
managed	boolean	Sant om hemlighetens livslängd hanteras av nyckelvalvet. Om det här är en nyckel som säkerhetskopierar ett certifikat är hanterad sant.
recoveryId	string	URL:en för återställningsobjektet som används för att identifiera och återställa den borttagna hemligheten.
scheduledPurgeDate	integer	Den tid då hemligheten är schemalagd att rensas i UTC
tags	object	Programspecifika metadata i form av nyckel/värde-par.

DeletedSecretListResult

Resultatet av listan över borttagna hemligheter

Name	Typ	Description
nextLink	string	URL:en för att hämta nästa uppsättning borttagna hemligheter.
value	DeletedSecretItem[]	Ett svarsmeddelande som innehåller en lista över borttagna hemligheter i valvet tillsammans med en länk till nästa sida med borttagna hemligheter

DeletionRecoveryLevel

Visar den återställningsnivå för borttagning som för närvarande gäller för hemligheter i det aktuella valvet. Om den innehåller "Purgeable" kan hemligheten tas bort permanent av en privilegierad användare. Annars kan bara systemet rensa hemligheten i slutet av kvarhållningsintervallet.

Name	Typ	Description
CustomizedRecoverable	string	Anger ett valvtillstånd där borttagning kan återställas utan möjlighet till omedelbar och permanent borttagning (dvs. rensa när 7<= SoftDeleteRetentionInDays < 90). Den här nivån garanterar återställningsbarheten för den borttagna entiteten under kvarhållningsintervallet och medan prenumerationen fortfarande är tillgänglig.
CustomizedRecoverable+ProtectedSubscription	string	Anger ett valv- och prenumerationstillstånd där borttagning kan återställas, omedelbar och permanent borttagning (d.v.s. rensning) tillåts inte och där själva prenumerationen inte kan avbrytas permanent när 7< = SoftDeleteRetentionInDays < 90. Den här nivån garanterar återställningen av den borttagna entiteten under kvarhållningsintervallet och återspeglar också det faktum att själva prenumerationen inte kan avbrytas.
CustomizedRecoverable+Purgeable	string	Anger ett valvtillstånd där borttagning kan återställas och som också tillåter omedelbar och permanent borttagning (dvs. rensa när 7<= SoftDeleteRetentionInDays < 90). Den här nivån garanterar återställningsmöjligheten för den borttagna entiteten under kvarhållningsintervallet, såvida inte en rensningsåtgärd begärs eller prenumerationen avbryts.
Purgeable	string	Anger ett valvtillstånd där borttagning är en oåterkallelig åtgärd, utan möjlighet till återställning. Den här nivån motsvarar att inget skydd är tillgängligt mot en borttagningsåtgärd. data går oåterkalleligt förlorade när en borttagningsåtgärd accepteras på entitetsnivå eller högre (valv, resursgrupp, prenumeration osv.)
Recoverable	string	Anger ett valvtillstånd där borttagning kan återställas utan möjlighet till omedelbar och permanent borttagning (d.v.s. rensning). Den här nivån garanterar återställning av den borttagna entiteten under kvarhållningsintervallet (90 dagar) och medan prenumerationen fortfarande är tillgänglig. Systemet tar bort det permanent efter 90 dagar, om det inte återställs
Recoverable+ProtectedSubscription	string	Anger ett valv- och prenumerationstillstånd där borttagning kan återställas inom kvarhållningsintervallet (90 dagar), omedelbar och permanent borttagning (d.v.s. rensning) inte tillåts och där själva prenumerationen inte kan avbrytas permanent. Systemet tar bort det permanent efter 90 dagar, om det inte återställs
Recoverable+Purgeable	string	Anger ett valvtillstånd där borttagning kan återställas och som också tillåter omedelbar och permanent borttagning (dvs. rensning). Den här nivån garanterar återställningsmöjligheten för den borttagna entiteten under kvarhållningsintervallet (90 dagar), såvida inte en rensningsåtgärd begärs eller prenumerationen avbryts. Systemet tar bort det permanent efter 90 dagar, om det inte återställs

Error

Key Vault-serverns fel.

Name	Typ	Description
code	string	Felkoden.
innererror	Error	Key Vault-serverns fel.
message	string	Felmeddelandet.

KeyVaultError

Felfelet för nyckelvalvet.

Name	Typ	Description
error	Error	Key Vault-serverns fel.

SecretAttributes

De hemliga hanteringsattributen.

Name	Typ	Description
created	integer	Skapandetid i UTC.
enabled	boolean	Avgör om objektet är aktiverat.
exp	integer	Förfallodatum i UTC.
nbf	integer	Inte före datum i UTC.
recoverableDays	integer	softDelete data retention days. Värdet ska vara >=7 och <=90 när softDelete är aktiverat, annars 0.
recoveryLevel	DeletionRecoveryLevel	Visar den återställningsnivå för borttagning som för närvarande gäller för hemligheter i det aktuella valvet. Om den innehåller "Purgeable" kan hemligheten tas bort permanent av en privilegierad användare. Annars kan bara systemet rensa hemligheten i slutet av kvarhållningsintervallet.
updated	integer	Senast uppdaterad tid i UTC.

Dela via