Delete Secret - Delete Secret

Reference

Service:: Key Vault

API Version:: 7.4

Odstraní tajný kód ze zadaného trezoru klíčů.
Operace DELETE se vztahuje na všechny tajné kódy uložené v Azure Key Vault. Příkaz DELETE nelze použít pro jednotlivé verze tajného kódu. Tato operace vyžaduje oprávnění k odstranění tajných kódů.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
secret-name	path	True	string	Název tajného kódu.
vaultBaseUrl	path	True	string	Název trezoru, například https://myvault.vault.azure.net.
api-version	query	True	string	Verze rozhraní API klienta.

Odpovědi

Name	Typ	Description
200 OK	DeletedSecretBundle	Odstraněný tajný klíč a informace o tom, kdy bude tajný kód odstraněn a jak odstraněný tajný klíč obnovit.
Other Status Codes	KeyVaultError	Key Vault chybovou odpověď popisující, proč operace selhala.

Příklady

DeleteSecret

Sample Request

HTTP

DELETE https://myvault.vault.azure.net//secrets/GetDeletedSecretTest?api-version=7.4

Sample Response

Status code:: 200

{
  "recoveryId": "https://myvault.vault.azure.net/deletedsecrets/GetDeletedSecretTest",
  "deletedDate": 1493938433,
  "scheduledPurgeDate": 1501714433,
  "id": "https://myvault.vault.azure.net/secrets/GetDeletedSecretTest/b595353d9c39413d80626575b3b5d865",
  "attributes": {
    "enabled": true,
    "created": 1493938433,
    "updated": 1493938433,
    "recoveryLevel": "Recoverable+Purgeable"
  }
}

Definice

Name	Description
DeletedSecretBundle	Odstraněný tajný klíč, který se skládá z jeho předchozího ID, atributů a značek a také informace o tom, kdy se vymaže.
DeletionRecoveryLevel	Odráží úroveň obnovení odstranění, která se aktuálně používá pro tajné kódy v aktuálním trezoru. Pokud obsahuje "Purgeable", tajný kód může být trvale odstraněn privilegovaným uživatelem; v opačném případě může tajný kód na konci intervalu uchovávání vyprázdnit pouze systém.
Error	Chyba serveru trezoru klíčů.
KeyVaultError	Výjimka chyby trezoru klíčů
SecretAttributes	Atributy správy tajných kódů.

DeletedSecretBundle

Odstraněný tajný klíč, který se skládá z jeho předchozího ID, atributů a značek a také informace o tom, kdy se vymaže.

Name	Typ	Description
attributes	SecretAttributes	Atributy správy tajných kódů.
contentType	string	Typ obsahu tajného kódu.
deletedDate	integer	Čas odstranění tajného kódu v UTC
id	string	ID tajného kódu
kid	string	Pokud se jedná o tajný kód, který zálohuje certifikát KV, určuje toto pole odpovídající klíč, který certifikát KV zálohuje.
managed	boolean	Hodnota True, pokud životnost tajného klíče spravuje trezor klíčů. Pokud se jedná o tajný kód, který certifikát zálohuje, bude spravovaná hodnota true.
recoveryId	string	Adresa URL objektu obnovení, která slouží k identifikaci a obnovení odstraněného tajného klíče.
scheduledPurgeDate	integer	Čas, kdy je naplánováno vymazání tajného kódu v UTC
tags	object	Metadata specifická pro aplikaci ve formě párů klíč-hodnota.
value	string	Hodnota tajného kódu.

DeletionRecoveryLevel

Odráží úroveň obnovení odstranění, která se aktuálně používá pro tajné kódy v aktuálním trezoru. Pokud obsahuje "Purgeable", tajný kód může být trvale odstraněn privilegovaným uživatelem; v opačném případě může tajný kód na konci intervalu uchovávání vyprázdnit pouze systém.

Name	Typ	Description
CustomizedRecoverable	string	Označuje stav trezoru, ve kterém je možné odstranění obnovit bez možnosti okamžitého a trvalého odstranění (tj. vyprázdnění při 7< = SoftDeleteRetentionInDays < 90). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání a po dobu, kdy je předplatné stále dostupné.
CustomizedRecoverable+ProtectedSubscription	string	Označuje stav trezoru a předplatného, ve kterém je odstranění obnovitelné, okamžité a trvalé odstranění (tj. vymazání) není povoleno a ve kterém samotné předplatné nelze trvale zrušit, když 7< = SoftDeleteRetentionInDays < 90. Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání a odráží také skutečnost, že samotné předplatné nelze zrušit.
CustomizedRecoverable+Purgeable	string	Označuje stav trezoru, ve kterém je možné odstranění obnovit a který také umožňuje okamžité a trvalé odstranění (tj. vyprázdnění při 7< = SoftDeleteRetentionInDays < 90). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání, pokud není vyžadována operace vyprázdnění nebo se nezruší předplatné.
Purgeable	string	Označuje stav trezoru, ve kterém je odstranění nevratnou operací bez možnosti obnovení. Tato úroveň odpovídá žádné ochraně není k dispozici proti operaci Odstranění; při přijetí operace odstranění na úrovni entity nebo vyšší (trezor, skupina prostředků, předplatné atd.) dojde k nenávratné ztrátě dat.
Recoverable	string	Označuje stav trezoru, ve kterém je možné odstranění obnovit bez možnosti okamžitého a trvalého odstranění (tj. vymazání). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání (90 dnů) a po dobu, kdy je předplatné stále dostupné. Systém ho po 90 dnech trvale odstraní, pokud se neobnoví
Recoverable+ProtectedSubscription	string	Označuje stav trezoru a předplatného, ve kterém je možné odstranění obnovit v intervalu uchovávání (90 dnů), okamžité a trvalé odstranění (tj. vyprázdnění) není povoleno a ve kterém nelze trvale zrušit samotné předplatné. Systém ho po 90 dnech trvale odstraní, pokud se neobnoví
Recoverable+Purgeable	string	Označuje stav trezoru, ve kterém je možné odstranění obnovit a který také umožňuje okamžité a trvalé odstranění (tj. vyprázdnění). Tato úroveň zaručuje obnovitelnost odstraněné entity během intervalu uchovávání (90 dnů), pokud se nevyžádá operace vyprázdnění nebo se nezruší předplatné. Systém ho po 90 dnech trvale odstraní, pokud se neobnoví

Error

Chyba serveru trezoru klíčů.

Name	Typ	Description
code	string	Kód chyby
innererror	Error	Chyba serveru trezoru klíčů.
message	string	Chybová zpráva

KeyVaultError

Výjimka chyby trezoru klíčů

Name	Typ	Description
error	Error	Chyba serveru trezoru klíčů.

SecretAttributes

Atributy správy tajných kódů.

Name	Typ	Description
created	integer	Čas vytvoření ve standardu UTC
enabled	boolean	Určuje, zda je objekt povolen.
exp	integer	Datum vypršení platnosti v UTC.
nbf	integer	Není před datem ve standardu UTC.
recoverableDays	integer	softDelete data retention days. Pokud je povolená funkce softDelete, hodnota by měla být >=7 a <=90, jinak 0.
recoveryLevel	DeletionRecoveryLevel	Odráží úroveň obnovení odstranění, která se aktuálně používá pro tajné kódy v aktuálním trezoru. Pokud obsahuje "Purgeable", tajný kód může být trvale odstraněn privilegovaným uživatelem; v opačném případě může tajný kód na konci intervalu uchovávání vyprázdnit pouze systém.
updated	integer	Čas poslední aktualizace v UTC.

Sdílet prostřednictvím