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
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

SecretListResult

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

KeyVaultError

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
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.

Error

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

KeyVaultError

A Key Vault hibakivétele.

SecretAttributes

A titkos kódok kezelési attribútumai.

SecretItem

A titkos metaadatokat tartalmazó titkos elem.

SecretListResult

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

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.

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

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.

updated

integer

Utolsó frissítés időpontja (UTC).

SecretItem

A titkos metaadatokat tartalmazó titkos elem.

Name Típus Description
attributes

SecretAttributes

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

SecretItem[]

Egy válaszüzenet, amely tartalmazza a kulcstartó titkos kulcsainak listáját, valamint a titkos kulcsok következő oldalára mutató hivatkozást.