Get Certificate Versions - Get Certificate Versions

Servizio:
Key Vault
Versione API:
2025-07-01

Elencare le versioni di un certificato.
L'operazione GetCertificateVersions restituisce le versioni di un certificato nell'insieme di credenziali delle chiavi specificato. Questa operazione richiede l'autorizzazione certificates/list.

GET {vaultBaseUrl}/certificates/{certificate-name}/versions?api-version=2025-07-01
Con parametri facoltativi: 
GET {vaultBaseUrl}/certificates/{certificate-name}/versions?api-version=2025-07-01&maxresults={maxresults}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
certificate-name
 path True

string

Nome del certificato.
vaultBaseUrl
 path True

string (uri)

api-version
 query True

string

minLength: 1

Versione dell'API da usare per questa operazione.
maxresults
 query

integer (int32)

minimum: 1
maximum: 25

Numero massimo di risultati da restituire in una pagina. Se non specificato, il servizio restituirà fino a 25 risultati.

Risposte

Nome Tipo Descrizione
200 OK

CertificateListResult

La richiesta ha avuto esito positivo.
Other Status Codes

KeyVaultError

Risposta di errore imprevista.

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
https://vault.azure.net/.default

Esempio

GetCertificateVersions

Esempio di richiesta

GET https://myvault.vault.azure.net//certificates/listVersionsCert01/versions?api-version=2025-07-01

Risposta di esempio

Codice di stato:
200 
{
  "value": [
    {
      "id": "https://myvault.vault.azure.net/certificates/listVersionsCert01/002ade539442463aba45c0efb42e3e84",
      "x5t": "fLi3U52HunIVNXubkEnf8tP6Wbo",
      "attributes": {
        "enabled": true,
        "nbf": 1430344421,
        "exp": 2208988799,
        "created": 1482189534,
        "updated": 1482189534
      }
    },
    {
      "id": "https://myvault.vault.azure.net/certificates/listVersionsCert01/7fcb3e9eb8bf43f3a6ff4b9c3740801d",
      "x5t": "fLi3U52HunIVNXubkEnf8tP6Wbo",
      "attributes": {
        "enabled": true,
        "nbf": 1430344421,
        "exp": 2208988799,
        "created": 1482189532,
        "updated": 1482189532
      }
    }
  ],
  "nextLink": null
}

Definizioni

Nome Descrizione
CertificateAttributes

Gli attributi di gestione dei certificati.
CertificateItem

Elemento del certificato contenente i metadati del certificato.
CertificateListResult

Risultato dell'elenco dei certificati.
DeletionRecoveryLevel

Riflette il livello di recupero dell'eliminazione attualmente in vigore per i segreti nell'insieme di credenziali corrente. Se contiene "Purgeable", il segreto può essere eliminato definitivamente da un utente privilegiato; In caso contrario, solo il sistema può eliminare il segreto al termine dell'intervallo di conservazione.
Error
KeyVaultError

Eccezione di errore dell'insieme di credenziali delle chiavi.

CertificateAttributes

Object

Gli attributi di gestione dei certificati.

Nome Tipo Descrizione
created

integer (unixtime)

Ora di creazione in UTC.
enabled

boolean

Determina se l'oggetto è abilitato.
exp

integer (unixtime)

Data di scadenza in UTC.
nbf

integer (unixtime)

Non prima della data in UTC.
recoverableDays

integer (int32)

softDelete i giorni di conservazione dei dati. Il valore deve essere >=7 e <=90 quando softDelete abilitato, altrimenti 0.
recoveryLevel

DeletionRecoveryLevel

Riflette il livello di recupero dell'eliminazione attualmente in vigore per i certificati nell'insieme di credenziali corrente. Se contiene "Purgeable", il certificato può essere eliminato definitivamente da un utente privilegiato; In caso contrario, solo il sistema può eliminare il certificato, al termine dell'intervallo di conservazione.
updated

integer (unixtime)

Ultimo aggiornamento dell'ora in UTC.

CertificateItem

Object

Elemento del certificato contenente i metadati del certificato.

Nome Tipo Descrizione
attributes

CertificateAttributes

Gli attributi di gestione dei certificati.
id

string

Identificatore del certificato.
tags

object

Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.
x5t

string (base64url)

Impronta digitale del certificato.

CertificateListResult

Object

Risultato dell'elenco dei certificati.

Nome Tipo Descrizione
nextLink

string

L'URL per ottenere il set successivo di certificati.
value

CertificateItem[]

Un messaggio di risposta contenente un elenco di certificati nell'insieme di credenziali delle chiavi insieme a un collegamento alla pagina successiva dei certificati.

DeletionRecoveryLevel

Enumerazione

Riflette il livello di recupero dell'eliminazione attualmente in vigore per i segreti nell'insieme di credenziali corrente. Se contiene "Purgeable", il segreto può essere eliminato definitivamente da un utente privilegiato; In caso contrario, solo il sistema può eliminare il segreto al termine dell'intervallo di conservazione.

Valore Descrizione
Purgeable

Indica uno stato dell'insieme di credenziali in cui l'eliminazione è un'operazione irreversibile, senza possibilità di ripristino. Questo livello corrisponde all'assenza di protezione contro un'operazione di eliminazione. i dati vengono irrimediabilmente persi dopo l'accettazione di un'operazione di eliminazione a livello di entità o superiore (insieme di credenziali, gruppo di risorse, sottoscrizione e così via)
Recoverable+Purgeable

Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile e che consente anche l'eliminazione immediata e permanente (ad esempio, l'eliminazione). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione (90 giorni), a meno che non venga richiesta un'operazione di ripulitura o la sottoscrizione non venga annullata. Il sistema lo eliminerà definitivamente dopo 90 giorni, se non viene ripristinato
Recoverable

Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile senza la possibilità di un'eliminazione immediata e permanente (ad esempio, l'eliminazione). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione (90 giorni) e mentre la sottoscrizione è ancora disponibile. Il sistema lo eliminerà definitivamente dopo 90 giorni, se non viene ripristinato
Recoverable+ProtectedSubscription

Indica uno stato dell'insieme di credenziali e della sottoscrizione in cui l'eliminazione è recuperabile entro l'intervallo di conservazione (90 giorni), l'eliminazione immediata e permanente (ad esempio l'eliminazione) non è consentita e in cui la sottoscrizione stessa non può essere annullata in modo permanente. Il sistema lo eliminerà definitivamente dopo 90 giorni, se non viene ripristinato
CustomizedRecoverable+Purgeable

Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile e che consente anche l'eliminazione immediata e permanente (ad esempio, l'eliminazione quando 7 <= SoftDeleteRetentionInDays < 90). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione, a meno che non venga richiesta un'operazione di eliminazione o la sottoscrizione non venga annullata.
CustomizedRecoverable

Indica uno stato dell'insieme di credenziali in cui l'eliminazione è recuperabile senza la possibilità di un'eliminazione immediata e permanente (ad esempio, l'eliminazione quando 7 <= SoftDeleteRetentionInDays < 90). Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione e mentre la sottoscrizione è ancora disponibile.
CustomizedRecoverable+ProtectedSubscription

Indica uno stato dell'insieme di credenziali e della sottoscrizione in cui l'eliminazione è recuperabile, l'eliminazione immediata e permanente (ovvero l'eliminazione) non è consentita e in cui la sottoscrizione stessa non può essere annullata in modo permanente quando 7 <= SoftDeleteRetentionInDays < 90. Questo livello garantisce la recuperabilità dell'entità eliminata durante l'intervallo di conservazione e riflette anche il fatto che la sottoscrizione stessa non può essere annullata.

Error

Object
Nome Tipo Descrizione
code

string

Codice di errore.
innererror

Error

Errore del server dell'insieme di credenziali delle chiavi.
message

string

Messaggio di errore.

KeyVaultError

Object

Eccezione di errore dell'insieme di credenziali delle chiavi.

Nome Tipo Descrizione
error

Error

Errore del server dell'insieme di credenziali delle chiavi.