Get Secret - Get Secret

Başvuru

Hizmet:: Key Vault

API Sürümü:: 7.4

Belirli bir anahtar kasasından belirtilen gizli diziyi alın.
GET işlemi, Azure Key Vault'da depolanan tüm gizli diziler için geçerlidir. Bu işlem gizli dizileri/alma iznini gerektirir.

GET {vaultBaseUrl}/secrets/{secret-name}/{secret-version}?api-version=7.4

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
secret-name	path	True	string	Gizli dizinin adı.
secret-version	path	True	string	Gizli dizinin sürümü. Bu URI parçası isteğe bağlıdır. Belirtilmezse, gizli dizinin en son sürümü döndürülür.
vaultBaseUrl	path	True	string	Kasa adı, örneğin https://myvault.vault.azure.net.
api-version	query	True	string	İstemci API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	SecretBundle	Alınan gizli dizi.
Other Status Codes	KeyVaultError	İşlemin neden başarısız olduğunu açıklayan hata yanıtı Key Vault.

Örnekler

GetSecret

Örnek isteği

HTTP

GET https://myvault.vault.azure.net//secrets/mysecretname/4387e9f3d6e14c459867679a90fd0f79?api-version=7.4

Örnek yanıt

Durum kodu:: 200

{
  "value": "mysecretvalue",
  "id": "https://myvault.vault.azure.net/secrets/mysecretname/4387e9f3d6e14c459867679a90fd0f79",
  "attributes": {
    "enabled": true,
    "created": 1493938410,
    "updated": 1493938410,
    "recoveryLevel": "Recoverable+Purgeable"
  }
}

Tanımlar

Name	Description
DeletionRecoveryLevel	Geçerli kasadaki gizli diziler için geçerli olan silme kurtarma düzeyini yansıtır. 'Temizlenebilir' içeriyorsa gizli dizi ayrıcalıklı bir kullanıcı tarafından kalıcı olarak silinebilir; aksi takdirde, saklama aralığının sonunda yalnızca sistem gizli diziyi temizleyebilir.
Error	Anahtar kasası sunucusu hatası.
KeyVaultError	Anahtar kasası hata özel durumu.
SecretAttributes	Gizli dizi yönetimi öznitelikleri.
SecretBundle	Değer, kimlik ve özniteliklerinden oluşan bir gizli dizi.

DeletionRecoveryLevel

Geçerli kasadaki gizli diziler için geçerli olan silme kurtarma düzeyini yansıtır. 'Temizlenebilir' içeriyorsa gizli dizi ayrıcalıklı bir kullanıcı tarafından kalıcı olarak silinebilir; aksi takdirde, saklama aralığının sonunda yalnızca sistem gizli diziyi temizleyebilir.

Name	Tür	Description
CustomizedRecoverable	string	Silme işleminin anında ve kalıcı silme olanağı olmadan kurtarılabilir olduğu bir kasa durumunu belirtir (örneğin, 7<= SoftDeleteRetentionInDays < 90 olduğunda temizleme). Bu düzey, saklama süresi boyunca ve abonelik hala kullanılabilir durumdayken silinen varlığın kurtarılabilirliğini garanti eder.
CustomizedRecoverable+ProtectedSubscription	string	Silme işleminin kurtarılabilir olduğu, anında ve kalıcı silmeye (temizleme) izin verilmediği ve 7<= SoftDeleteRetentionInDays < 90 olduğunda aboneliğin kendisinin kalıcı olarak iptal edilemeyeceği bir kasayı ve abonelik durumunu belirtir. Bu düzey, bekletme aralığı boyunca silinen varlığın kurtarılabilirliğini garanti eder ve ayrıca aboneliğin kendisinin iptal edilemediğini yansıtır.
CustomizedRecoverable+Purgeable	string	Silme işleminin kurtarılabilir olduğu ve anında ve kalıcı silmeye izin veren bir kasa durumunu belirtir (7<= SoftDeleteRetentionInDays < 90 olduğunda temizleme). Bu düzey, bir Temizleme işlemi istenmediği veya abonelik iptal edilmediği sürece saklama aralığı boyunca silinen varlığın kurtarılabilirliğini garanti eder.
Purgeable	string	Kurtarma olasılığı olmadan silme işleminin geri alınamaz bir işlem olduğu kasa durumunu belirtir. Bu düzey, Silme işlemine karşı hiçbir korumanın mevcut olmadığına karşılık gelir; varlık düzeyinde veya daha yüksek bir düzeyde (kasa, kaynak grubu, abonelik vb.) silme işlemi kabul edildikten sonra veriler geri alınabilir bir şekilde kaybolur.
Recoverable	string	Silme işleminin anında ve kalıcı silme (temizleme) olasılığı olmadan kurtarılabilir olduğu bir kasa durumunu belirtir. Bu düzey, saklama aralığı (90 gün) boyunca ve abonelik hala kullanılabilir durumdayken silinen varlığın kurtarılabilirliğini garanti eder. Sistem, kurtarılmadıysa 90 gün sonra kalıcı olarak siler
Recoverable+ProtectedSubscription	string	Silme işleminin saklama aralığı (90 gün) içinde kurtarılabilir olduğu, anında ve kalıcı silmeye (temizleme) izin verilmediği ve aboneliğin kendisinin kalıcı olarak iptal edilemediği bir kasayı ve abonelik durumunu belirtir. Sistem, kurtarılmadıysa 90 gün sonra kalıcı olarak siler
Recoverable+Purgeable	string	Silme işleminin kurtarılabilir olduğu ve ayrıca anında ve kalıcı silmeye (temizleme) izin veren bir kasa durumunu belirtir. Bu düzey, temizleme işlemi istenmediği veya abonelik iptal edilmediği sürece saklama aralığı (90 gün) boyunca silinen varlığın kurtarılabilirliğini garanti eder. Sistem, kurtarılmadıysa 90 gün sonra kalıcı olarak siler

Error

Anahtar kasası sunucusu hatası.

Name	Tür	Description
code	string	Hata kodu.
innererror	Error	Anahtar kasası sunucusu hatası.
message	string	Hata iletisi.

KeyVaultError

Anahtar kasası hata özel durumu.

Name	Tür	Description
error	Error	Anahtar kasası sunucusu hatası.

SecretAttributes

Gizli dizi yönetimi öznitelikleri.

Name	Tür	Description
created	integer	Oluşturma saati : UTC.
enabled	boolean	Nesnenin etkinleştirilip etkinleştirilmediğini belirler.
exp	integer	Utc'de süre sonu tarihi.
nbf	integer	UTC'deki tarihten önce değil.
recoverableDays	integer	softDelete veri saklama günleri. SoftDelete etkinleştirildiğinde değer =7 ve <=90 olmalıdır>, aksi takdirde 0 olmalıdır.
recoveryLevel	DeletionRecoveryLevel	Geçerli kasadaki gizli diziler için geçerli olan silme kurtarma düzeyini yansıtır. 'Temizlenebilir' içeriyorsa gizli dizi ayrıcalıklı bir kullanıcı tarafından kalıcı olarak silinebilir; aksi takdirde, saklama aralığının sonunda yalnızca sistem gizli diziyi temizleyebilir.
updated	integer	Son güncelleştirme saati : UTC.

SecretBundle

Değer, kimlik ve özniteliklerinden oluşan bir gizli dizi.

Name	Tür	Description
attributes	SecretAttributes	Gizli dizi yönetimi öznitelikleri.
contentType	string	Gizli dizinin içerik türü.
id	string	Gizli dizi kimliği.
kid	string	Bu bir KV sertifikasını yedekleyerek gizli diziyse, bu alan KV sertifikasını yedekleyerek ilgili anahtarı belirtir.
managed	boolean	Gizli dizinin yaşam süresi anahtar kasası tarafından yönetiliyorsa true. Bu bir sertifikayı destekleyen bir gizli diziyse, yönetilen doğru olur.
tags	object	Anahtar-değer çiftleri biçiminde uygulamaya özgü meta veriler.
value	string	Gizli dizi değeri.

Aracılığıyla paylaş