Get Secrets - Get Secrets
Titkos kulcsok listázása egy adott kulcstartóban.
A Titkos kódok lekérése művelet a teljes tárolóra érvényes. A válaszban azonban csak az alaptitkos azonosító és annak attribútumai vannak megadva. Az egyes titkos kódverziók nem szerepelnek a válaszban. Ehhez a művelethez titkos kódokra/listákra vonatkozó engedély szükséges.
GET {vaultBaseUrl}/secrets?api-version=7.4
GET {vaultBaseUrl}/secrets?maxresults={maxresults}&api-version=7.4
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
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 |
Egy válaszüzenet, amely tartalmazza a tároló titkos kulcsainak listáját, valamint a titkos kulcsok következő oldalára mutató hivatkozást. |
|
Other Status Codes |
Key Vault hibaválasz leírja, hogy miért hiúsult meg a művelet. |
Példák
GetSecrets
Sample Request
GET https://myvault.vault.azure.net//secrets?maxresults=1&api-version=7.4
Sample Response
{
"value": [
{
"contentType": "plainText",
"id": "https://myvault.vault.azure.net/secrets/listsecrettest0",
"attributes": {
"enabled": true,
"created": 1482189047,
"updated": 1482189047
}
}
],
"nextLink": "https://myvault.vault.azure.net:443/secrets?api-version=7.2&$skiptoken=eyJOZXh0TWFya2VyIjoiMiE4OCFNREF3TURJeUlYTmxZM0psZEM5TVNWTlVVMFZEVWtWVVZFVlRWREVoTURBd01ESTRJVEl3TVRZdE1USXRNVGxVTWpNNk1UQTZORFV1T0RneE9ERXhNRm9oIiwiVGFyZ2V0TG9jYXRpb24iOjB9&maxresults=1"
}
Definíciók
Name | Description |
---|---|
Deletion |
Az aktuális tároló titkos kulcsainak törlési helyreállítási szintjét tükrözi. Ha tartalmazza a "Véglegesen törölhető" elemet, a titkos kódot véglegesen törölheti egy kiemelt felhasználó; ellenkező esetben csak a rendszer törölheti a titkos kódot a megőrzési időtartam végén. |
Error |
A Key Vault-kiszolgáló hibája. |
Key |
A Key Vault hibakivétele. |
Secret |
A titkos kódok kezelési attribútumai. |
Secret |
A titkos metaadatokat tartalmazó titkos elem. |
Secret |
A titkos kódlista eredménye. |
DeletionRecoveryLevel
Az aktuális tároló titkos kulcsainak törlési helyreállítási szintjét tükrözi. Ha tartalmazza a "Véglegesen törölhető" elemet, a titkos kódot véglegesen törölheti egy kiemelt felhasználó; ellenkező esetben csak a rendszer törölheti a titkos kódot a megőrzési időtartam végén.
Name | Típus | Description |
---|---|---|
CustomizedRecoverable |
string |
Azt a tárolóállapotot jelöli, amelyben a törlés azonnali és végleges törlés nélkül helyreállítható (azaz 7<= SoftDeleteRetentionInDays < 90 esetén végleges törlés). Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időtartam 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őtartam 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 7<= SoftDeleteRetentionInDays < 90 utáni 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, 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 azt jelenti, hogy a törlési műveletekkel szemben nem áll rendelkezésre védelem; az adatok helyrehozhatatlanul elvesznek egy Törlés művelet elfogadásakor az entitás szintjén vagy annál magasabb szinten (tároló, erőforráscsoport, előfizetés stb.) |
Recoverable |
string |
Azt a tárolóállapotot jelöli, 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) lennének 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őtartam (90 nap) alatt, és amíg az előfizetés továbbra is elérhető. A rendszer 90 nap után 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 megőrzési időtartamon (90 napon) belül helyreállítható, 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 után véglegesen törli, ha nem állítható helyre |
Recoverable+Purgeable |
string |
Egy tároló állapotát jelöli, 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 után 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. |
SecretAttributes
A titkos kódok kezelési attribútumai.
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) |
nbf |
integer |
Időpont előtt utc. |
recoverableDays |
integer |
softDelete adatmegőrzési napok. Az érték =7 és <=90 lehet>, ha a softDelete engedélyezve van, ellenkező esetben 0. |
recoveryLevel |
Az aktuális tároló titkos kulcsainak törlési helyreállítási szintjét tükrözi. Ha tartalmazza a "Véglegesen törölhető" elemet, a titkos kódot véglegesen törölheti egy kiemelt felhasználó; ellenkező esetben csak a rendszer törölheti a titkos kódot a megőrzési időtartam végén. |
|
updated |
integer |
Utolsó frissítés időpontja (UTC). |
SecretItem
A titkos metaadatokat tartalmazó titkos elem.
Name | Típus | Description |
---|---|---|
attributes |
A titkos kódok kezelési attribútumai. |
|
contentType |
string |
A titkos kód értékének típusa, például jelszó. |
id |
string |
Titkos kód azonosítója. |
managed |
boolean |
Igaz, ha a titkos kulcstartó kezeli a titkos kód élettartamát. Ha ez egy tanúsítványt alátámasztó kulcs, akkor a felügyelt érték igaz lesz. |
tags |
object |
Alkalmazásspecifikus metaadatok kulcs-érték párok formájában. |
SecretListResult
A titkos kódlista eredménye.
Name | Típus | Description |
---|---|---|
nextLink |
string |
A titkos kulcsok következő készletének lekéréséhez tartozó URL-cím. |
value |
Egy válaszüzenet, amely tartalmazza a kulcstartó titkos kulcsainak listáját, valamint a titkos kulcsok következő oldalára mutató hivatkozást. |