Share via


Get Certificate Versions - Get Certificate Versions

A tanúsítványok verzióinak listázása.
A GetCertificateVersions művelet a megadott kulcstartóban lévő tanúsítvány verzióit adja vissza. Ehhez a művelethez a tanúsítványok/listák engedélyére van szükség.

GET {vaultBaseUrl}/certificates/{certificate-name}/versions?api-version=7.4
GET {vaultBaseUrl}/certificates/{certificate-name}/versions?maxresults={maxresults}&api-version=7.4

URI-paraméterek

Name In Kötelező Típus Description
certificate-name
path True

string

A tanúsítvány neve.

vaultBaseUrl
path True

string

A tároló neve, például https://myvault.vault.azure.net.

api-version
query True

string

Ügyfél API-verziója.

maxresults
query

integer

int32

Egy lapon visszaadandó eredmények maximális száma. Ha nincs megadva, a szolgáltatás legfeljebb 25 eredményt ad vissza.

Válaszok

Name Típus Description
200 OK

CertificateListResult

A kulcstartóban található tanúsítványok listáját és a kulcsok következő oldalára mutató hivatkozást tartalmazó válaszüzenet.

Other Status Codes

KeyVaultError

Key Vault hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Példák

GetCertificateVersions

Sample Request

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

Sample Response

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

Definíciók

Name Description
CertificateAttributes

A tanúsítványkezelési attribútumok.

CertificateItem

A tanúsítvány metaadatait tartalmazó tanúsítványelem.

CertificateListResult

A tanúsítványlista eredménye.

DeletionRecoveryLevel

Az aktuális tárolóban lévő tanúsítványok törlési helyreállítási szintjét tükrözi. Ha a "Helyreállítható" értéket tartalmazza, a tanúsítványt véglegesen törölheti egy kiemelt felhasználó; ellenkező esetben csak a rendszer törölheti a tanúsítványt a megőrzési időköz végén.

Error

A Key Vault-kiszolgáló hibája.

KeyVaultError

A key vault hibakivétele.

CertificateAttributes

A tanúsítványkezelési attribútumok.

Name Típus Description
created

integer

Létrehozás időpontja UTC-ben.

enabled

boolean

Meghatározza, hogy az objektum engedélyezve van-e.

exp

integer

Lejárati dátum UTC-ben.

nbf

integer

Dátum előtt nem UTC-ben.

recoverableDays

integer

softDelete adatmegőrzési napok. Ha a softDelete engedélyezve van >, akkor az érték =7 és <=90 lehet, ellenkező esetben 0.

recoveryLevel

DeletionRecoveryLevel

Az aktuális tárolóban lévő tanúsítványok törlési helyreállítási szintjét tükrözi. Ha a "Helyreállítható" értéket tartalmazza, a tanúsítványt véglegesen törölheti egy kiemelt felhasználó; ellenkező esetben csak a rendszer törölheti a tanúsítványt a megőrzési időköz végén.

updated

integer

Utolsó frissítés időpontja UTC-ben.

CertificateItem

A tanúsítvány metaadatait tartalmazó tanúsítványelem.

Name Típus Description
attributes

CertificateAttributes

A tanúsítványkezelési attribútumok.

id

string

Tanúsítványazonosító.

tags

object

Alkalmazásspecifikus metaadatok kulcs-érték párok formájában.

x5t

string

A tanúsítványhoz tartozó ujjlenyomat.

CertificateListResult

A tanúsítványlista eredménye.

Name Típus Description
nextLink

string

A következő tanúsítványkészlet lekérésének URL-címe.

value

CertificateItem[]

Egy válaszüzenet, amely tartalmazza a kulcstartóban található tanúsítványok listáját, valamint a tanúsítványok következő oldalára mutató hivatkozást.

DeletionRecoveryLevel

Az aktuális tárolóban lévő tanúsítványok törlési helyreállítási szintjét tükrözi. Ha a "Helyreállítható" értéket tartalmazza, a tanúsítványt véglegesen törölheti egy kiemelt felhasználó; ellenkező esetben csak a rendszer törölheti a tanúsítványt a megőrzési időköz végén.

Name Típus Description
CustomizedRecoverable

string

Olyan tárolóállapotot jelöl, amelyben a törlés helyreállítható anélkül, hogy azonnali és végleges törlésre van lehetőség (azaz törlés, ha 7< = SoftDeleteRetentionInDays < 90). Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időköz alatt, és amíg az előfizetés továbbra is elérhető.

CustomizedRecoverable+ProtectedSubscription

string

Azt a tárolót és előfizetési állapotot jelöli, amelyben a törlés helyreállítható, az azonnali és végleges törlés (azaz a végleges törlés) nem engedélyezett, és amelyben maga az előfizetés nem mondható le véglegesen, ha 7<= SoftDeleteRetentionInDays < 90. Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időköz alatt, és azt is tükrözi, hogy maga az előfizetés nem mondható le.

CustomizedRecoverable+Purgeable

string

Azt a tárolóállapotot jelöli, amelyben a törlés helyreállítható, és amely lehetővé teszi az azonnali és végleges törlést is (azaz a törlést, amikor 7< = SoftDeleteRetentionInDays < 90). Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időtartam alatt, kivéve, ha törlési műveletet kérnek, vagy az előfizetést lemondják.

Purgeable

string

Olyan tárolóállapotot jelöl, amelyben a törlés visszafordíthatatlan művelet, a helyreállítás lehetősége nélkül. Ez a szint nem felel meg a Törlés művelet elleni védelemnek; az adatok helyrehozhatatlanul elvesznek egy törlési művelet entitásszinten vagy magasabb szinten (tároló, erőforráscsoport, előfizetés stb.) elfogadásakor.

Recoverable

string

Olyan tárolóállapotot jelöl, amelyben a törlés helyreállítható anélkül, hogy azonnali és végleges törlésre (azaz végleges törlésre) van lehetőség. Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időköz (90 nap) alatt, és amíg az előfizetés továbbra is elérhető. A rendszer 90 nap elteltével véglegesen törli, ha nem állítható helyre

Recoverable+ProtectedSubscription

string

Azt a tárolót és előfizetési állapotot jelöli, amelyben a törlés helyreállítható a megőrzési időtartamon belül (90 nap), az azonnali és végleges törlés (azaz végleges törlés) nem engedélyezett, és amelyben maga az előfizetés nem mondható le véglegesen. A rendszer 90 nap elteltével véglegesen törli, ha nem állítható helyre

Recoverable+Purgeable

string

Olyan tárolóállapotot jelöl, amelyben a törlés helyreállítható, és amely lehetővé teszi az azonnali és végleges törlést (azaz a végleges törlést). Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időtartam alatt (90 nap), kivéve, ha törlési műveletet kérnek, vagy az előfizetést lemondják. A rendszer 90 nap elteltével véglegesen törli, ha nem állítható helyre

Error

A Key Vault-kiszolgáló hibája.

Name Típus Description
code

string

A hibakód.

innererror

Error

A Key Vault-kiszolgáló hibája.

message

string

A hibaüzenet.

KeyVaultError

A key vault hibakivétele.

Name Típus Description
error

Error

A Key Vault-kiszolgáló hibája.