Get Secret - Get Secret

Hizmet:: Key Vault

API Sürümü:: 2025-07-01

Belirli bir anahtar kasasından belirtilen gizli diziyi alın.
GET işlemi, Azure Key Vault'ta 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=2025-07-01

İsteğe bağlı parametrelerle:

GET {vaultBaseUrl}/secrets/{secret-name}/{secret-version}?api-version=2025-07-01&outContentType={outContentType}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
secret-name	path	True	string	Gizli dizinin adı.
secret-version	path	True	string	Sırrın versiyonu. 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 (uri)
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
outContentType	query		ContentType	Sertifikanın medya türü (MIME türü). Desteklenen bir biçim belirtilirse, sertifika içeriği istenen biçime dönüştürülür. Şu anda yalnızca PFX'ten PEM'e dönüştürme desteklenmektedir. Desteklenmeyen bir biçim belirtilirse istek reddedilir. Belirtilmezse, sertifika dönüştürme yapılmadan özgün biçiminde döndürülür.

Yanıtlar

Name	Tür	Description
200 OK	SecretBundle	İstek başarılı oldu.
Other Status Codes	KeyVaultError	Beklenmeyen bir hata yanıtı.

Güvenlik

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
https://vault.azure.net/.default

Örnekler

GetSecret

Örnek isteği

HTTP

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

Ö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
ContentType	Medya türü (MIME türü).
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, bekletme aralığının sonunda yalnızca sistem gizli diziyi temizleyebilir.
Error
KeyVaultError	Anahtar kasası hata özel durumu.
SecretAttributes	Gizli dizi yönetimi öznitelikleri.
SecretBundle	Bir değer, kimlik ve özniteliklerinden oluşan bir gizli dizi.

ContentType

Listeleme

Medya türü (MIME türü).

Değer	Description
application/x-pkcs12	PKCS#12 dosya biçimi.
application/x-pem-file	PEM dosya formatı.

DeletionRecoveryLevel

Listeleme

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, bekletme aralığının sonunda yalnızca sistem gizli diziyi temizleyebilir.

Değer	Description
Purgeable	Silme işleminin, kurtarma olasılığı olmadan geri döndürülemez bir işlem olduğu bir kasa durumunu belirtir. Bu düzey, bir Delete işlemine karşı koruma sağlanmamasına karşılık gelir; varlık düzeyinde veya daha yüksek bir Silme işlemi kabul edildiğinde veriler geri alınamaz bir şekilde kaybolur (kasa, kaynak grubu, abonelik vb.)
Recoverable+Purgeable	Silme işleminin kurtarılabilir olduğu ve aynı zamanda anında ve kalıcı silmeye (yani temizlemeye) izin veren bir kasa durumunu belirtir. Bu düzey, bir Temizleme işlemi istenmediği veya abonelik iptal edilmediği sürece bekletme aralığı (90 gün) boyunca silinen varlığın kurtarılabilirliğini garanti eder. Sistem, kurtarılmazsa 90 gün sonra kalıcı olarak silecektir
Recoverable	Silme işleminin anında ve kalıcı silme (yani 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ılmazsa 90 gün sonra kalıcı olarak silecektir
Recoverable+ProtectedSubscription	Silme işleminin saklama aralığı (90 gün) içinde kurtarılabildiği, anında ve kalıcı silmeye (yani temizlemeye) izin verilmeyen ve aboneliğin kendisinin kalıcı olarak iptal edilemediği bir kasa ve abonelik durumunu belirtir. Sistem, kurtarılmazsa 90 gün sonra kalıcı olarak silecektir
CustomizedRecoverable+Purgeable	Silme işleminin kurtarılabilir olduğu ve aynı zamanda anında ve kalıcı silmeye izin veren bir kasa durumunu belirtir (örneğin, 7 <= SoftDeleteRetentionInDays < 90 olduğunda temizleme). Bu düzey, bir Temizleme işlemi istenmediği veya abonelik iptal edilmediği sürece bekletme aralığı sırasında silinen varlığın kurtarılabilirliğini garanti eder.
CustomizedRecoverable	Silme işleminin anında ve kalıcı silme olasılığı olmadan kurtarılabilir olduğu bir kasa durumunu belirtir (örneğin, 7 <= SoftDeleteRetentionInDays < 90 olduğunda temizleme). Bu düzey, saklama aralığı sırasında ve abonelik hala kullanılabilir durumdayken silinen varlığın kurtarılabilirliğini garanti eder.
CustomizedRecoverable+ProtectedSubscription	Silme işleminin kurtarılabilir olduğu, anında ve kalıcı silmeye (yani temizleme) izin verilmeyen ve 7 = SoftDeleteRetentionInDays << 90 olduğunda aboneliğin kendisinin kalıcı olarak iptal edilemediği bir kasa ve abonelik durumunu belirtir. Bu düzey, saklama aralığı sırasında silinen varlığın kurtarılabilirliğini garanti eder ve ayrıca aboneliğin kendisinin iptal edilemediği gerçeğini yansıtır.

Error

Object

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

KeyVaultError

Object

Anahtar kasası hata özel durumu.

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

SecretAttributes

Object

Gizli dizi yönetimi öznitelikleri.

Name	Tür	Description
created	integer (unixtime)	UTC'de oluşturma zamanı.
enabled	boolean	Nesnenin etkinleştirilip etkinleştirilmediğini belirler.
exp	integer (unixtime)	UTC'de son kullanma tarihi.
nbf	integer (unixtime)	UTC'deki tarihten önce değil.
recoverableDays	integer (int32)	softDelete veri saklama günleri. SoftDelete etkinleştirildiğinde değer =7 ve >=90, 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, bekletme aralığının sonunda yalnızca sistem gizli diziyi temizleyebilir.
updated	integer (unixtime)	UTC'de son güncelleme zamanı.

SecretBundle

Object

Bir 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 kimlik.
kid	string	Bu, KV sertifikasını destekleyen bir gizli diziyse, bu alan KV sertifikasını destekleyen ilgili anahtarı belirtir.
managed	boolean	Gizli dizinin ömrü anahtar kasası tarafından yönetiliyorsa True değerini belirler. Bu, sertifikayı destekleyen bir gizli diziyse, yönetilen doğru olur.
previousVersion	string	Varsa, önceki sertifikanın sürümü. Yalnızca 1 Haziran 2025'ten sonra oluşturulan sertifikalar için geçerlidir. Bu tarihten önce oluşturulan sertifikalar geriye dönük olarak güncelleştirilmez.
tags	object	Anahtar-değer çiftleri biçiminde uygulamaya özel meta veriler.
value	string	Gizli dizi değeri.