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. |
vault
|
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 |
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 |
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 |
---|---|
Certificate |
A tanúsítványkezelési attribútumok. |
Certificate |
A tanúsítvány metaadatait tartalmazó tanúsítványelem. |
Certificate |
A tanúsítványlista eredménye. |
Deletion |
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. |
Key |
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 |
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 |
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 |
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 |
A Key Vault-kiszolgáló hibája. |
|
message |
string |
A hibaüzenet. |
KeyVaultError
A key vault hibakivétele.
Name | Típus | Description |
---|---|---|
error |
A Key Vault-kiszolgáló hibája. |