Get Deleted Certificates - Get Deleted Certificates
Listas os certificados eliminados no cofre especificado atualmente disponível para recuperação.
A operação GetDeletedCertificates obtém os certificados no cofre atual que estão num estado eliminado e prontos para recuperação ou remoção. Esta operação inclui informações específicas de eliminação. Esta operação requer a permissão certificados/get/list. Esta operação só pode ser ativada em cofres com eliminação recuperável ativada.
GET {vaultBaseUrl}/deletedcertificates?api-version=7.4
GET {vaultBaseUrl}/deletedcertificates?maxresults={maxresults}&includePending={includePending}&api-version=7.4
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
vault
|
path | True |
string |
O nome do cofre, por exemplo https://myvault.vault.azure.net. |
api-version
|
query | True |
string |
Versão da API de Cliente. |
include
|
query |
boolean |
Especifica se pretende incluir certificados que não estão completamente aprovisionados. |
|
maxresults
|
query |
integer int32 |
Número máximo de resultados a devolver numa página. Se não for especificado, o serviço devolverá até 25 resultados. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
Uma mensagem de resposta que contém uma lista de certificados eliminados no cofre juntamente com uma ligação para a página seguinte de certificados eliminados |
|
Other Status Codes |
Key Vault resposta de erro que descreve a razão pela qual a operação falhou. |
Exemplos
GetDeletedCertificates
Sample Request
GET https://myvault.vault.azure.net//deletedcertificates?maxresults=1&api-version=7.4
Sample Response
{
"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"
}
Definições
Name | Description |
---|---|
Certificate |
Os atributos de gestão de certificados. |
Deleted |
O item de certificado eliminado que contém metadados sobre o certificado eliminado. |
Deleted |
Uma lista de certificados que foram eliminados neste cofre. |
Deletion |
Reflete o nível de recuperação de eliminação atualmente em vigor para certificados no cofre atual. Se contiver "Removível", o certificado pode ser eliminado permanentemente por um utilizador com privilégios; caso contrário, apenas o sistema pode remover o certificado, no final do intervalo de retenção. |
Error |
O erro do servidor do cofre de chaves. |
Key |
A exceção de erro do cofre de chaves. |
CertificateAttributes
Os atributos de gestão de certificados.
Name | Tipo | Description |
---|---|---|
created |
integer |
Tempo de criação em UTC. |
enabled |
boolean |
Determina se o objeto está ativado. |
exp |
integer |
Data de expiração em UTC. |
nbf |
integer |
Não antes da data em UTC. |
recoverableDays |
integer |
softDelete data retention days. O valor deve ser >=7 e <=90 quando softDelete ativado, caso contrário 0. |
recoveryLevel |
Reflete o nível de recuperação de eliminação atualmente em vigor para certificados no cofre atual. Se contiver "Removível", o certificado pode ser eliminado permanentemente por um utilizador com privilégios; caso contrário, apenas o sistema pode remover o certificado, no final do intervalo de retenção. |
|
updated |
integer |
Hora da última atualização em UTC. |
DeletedCertificateItem
O item de certificado eliminado que contém metadados sobre o certificado eliminado.
Name | Tipo | Description |
---|---|---|
attributes |
Os atributos de gestão de certificados. |
|
deletedDate |
integer |
A hora em que o certificado foi eliminado, em UTC |
id |
string |
Identificador de certificado. |
recoveryId |
string |
O URL do objeto de recuperação, utilizado para identificar e recuperar o certificado eliminado. |
scheduledPurgeDate |
integer |
A hora em que o certificado está agendado para ser removido, em UTC |
tags |
object |
Metadados específicos da aplicação na forma de pares chave-valor. |
x5t |
string |
Impressão digital do certificado. |
DeletedCertificateListResult
Uma lista de certificados que foram eliminados neste cofre.
Name | Tipo | Description |
---|---|---|
nextLink |
string |
O URL para obter o próximo conjunto de certificados eliminados. |
value |
Uma mensagem de resposta que contém uma lista de certificados eliminados no cofre juntamente com uma ligação para a página seguinte de certificados eliminados |
DeletionRecoveryLevel
Reflete o nível de recuperação de eliminação atualmente em vigor para certificados no cofre atual. Se contiver "Removível", o certificado pode ser eliminado permanentemente por um utilizador com privilégios; caso contrário, apenas o sistema pode remover o certificado, no final do intervalo de retenção.
Name | Tipo | Description |
---|---|---|
CustomizedRecoverable |
string |
Indica um estado do cofre no qual a eliminação é recuperável sem a possibilidade de eliminação imediata e permanente (ou seja, remover quando 7<= SoftDeleteRetentionInDays < 90). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção e enquanto a subscrição ainda está disponível. |
CustomizedRecoverable+ProtectedSubscription |
string |
Indica um cofre e estado de subscrição no qual a eliminação é recuperável, imediata e permanente (ou seja, remoção) não é permitida e em que a subscrição em si não pode ser cancelada permanentemente quando 7<= SoftDeleteRetentionInDays < 90. Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção e também reflete o facto de a própria subscrição não poder ser cancelada. |
CustomizedRecoverable+Purgeable |
string |
Indica um estado do cofre no qual a eliminação é recuperável e que também permite a eliminação imediata e permanente (ou seja, remover quando 7<= SoftDeleteRetentionInDays < 90). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção, a menos que seja pedida uma operação de Remoção ou a subscrição seja cancelada. |
Purgeable |
string |
Indica um estado do cofre em que a eliminação é uma operação irreversível, sem a possibilidade de recuperação. Este nível não corresponde a nenhuma proteção disponível numa operação Eliminar; os dados são irremediavelmente perdidos ao aceitar uma operação Delete ao nível da entidade ou superior (cofre, grupo de recursos, subscrição, etc.) |
Recoverable |
string |
Indica um estado do cofre no qual a eliminação é recuperável sem a possibilidade de eliminação imediata e permanente (ou seja, remoção). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção (90 dias) e enquanto a subscrição ainda está disponível. O sistema irá eliminá-lo permanentemente após 90 dias, se não for recuperado |
Recoverable+ProtectedSubscription |
string |
Indica um estado do cofre e da subscrição em que a eliminação é recuperável dentro do intervalo de retenção (90 dias), a eliminação imediata e permanente (ou seja, remoção) não é permitida e na qual a subscrição em si não pode ser cancelada permanentemente. O sistema irá eliminá-lo permanentemente após 90 dias, se não for recuperado |
Recoverable+Purgeable |
string |
Indica um estado do cofre no qual a eliminação é recuperável e que também permite a eliminação imediata e permanente (ou seja, remoção). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção (90 dias), a menos que seja pedida uma operação de Remoção ou a subscrição seja cancelada. O sistema irá eliminá-lo permanentemente após 90 dias, se não for recuperado |
Error
O erro do servidor do cofre de chaves.
Name | Tipo | Description |
---|---|---|
code |
string |
O código de erro. |
innererror |
O erro do servidor do cofre de chaves. |
|
message |
string |
A mensagem de erro. |
KeyVaultError
A exceção de erro do cofre de chaves.
Name | Tipo | Description |
---|---|---|
error |
O erro do servidor do cofre de chaves. |