Get Sas Definitions - Get Sas Definitions

Başvuru

Service:: Key Vault

API Version:: 7.4

Verilen depolama hesabı için depolama SAS tanımlarını listeleyin. Bu işlem için depolama/listsas izni gerekir.

GET {vaultBaseUrl}/storage/{storage-account-name}/sas?api-version=7.4

With optional parameters:

GET {vaultBaseUrl}/storage/{storage-account-name}/sas?maxresults={maxresults}&api-version=7.4

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
storage-account-name	path	True	string	Depolama hesabının adı. Regex pattern: `^[0-9a-zA-Z]+$`
vaultBaseUrl	path	True	string	Kasa adı, örneğin https://myvault.vault.azure.net.
api-version	query	True	string	İstemci API sürümü.
maxresults	query		integer int32	Sayfada döndürülecek en fazla sonuç sayısı. Belirtilmezse hizmet en fazla 25 sonuç döndürür.

Yanıtlar

Name	Tür	Description
200 OK	SasDefinitionListResult	SAS tanımlarının listesinin yanı sıra SAS tanımlarının sonraki sayfasına bağlantı içeren bir yanıt iletisi.
Other Status Codes	KeyVaultError	İşlemin neden başarısız olduğunu açıklayan hata yanıtı Key Vault.

Örnekler

List Storage Sas Definition

Sample Request

HTTP

GET https://myvault.vault.azure.net//storage/listsas01/sas?api-version=7.4

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "https://myvault.vault.azure.net/storage/listsas01/sas/listStrgSasDef01",
      "sid": "https://myvault.vault.azure.net/secrets/listsas01-listStrgSasDef01",
      "attributes": {
        "enabled": true,
        "created": 1490738438,
        "updated": 1490738438,
        "recoveryLevel": "Recoverable"
      }
    },
    {
      "id": "https://myvault.vault.azure.net/storage/listsas01/sas/listStrgSasDef02",
      "sid": "https://myvault.vault.azure.net/secrets/listsas01-listStrgSasDef02",
      "attributes": {
        "enabled": true,
        "created": 1490738438,
        "updated": 1490738438,
        "recoveryLevel": "Recoverable"
      }
    }
  ],
  "nextLink": "https://{BaseUri}/storage/listsas01/sas?api-version=7.2&%24skiptoken=<token>"
}

Tanımlar

Name	Description
DeletionRecoveryLevel	Geçerli kasadaki depolama hesapları için geçerli olan silme kurtarma düzeyini yansıtır. 'Temizlenebilir' içeriyorsa, depolama hesabı ayrıcalıklı bir kullanıcı tarafından kalıcı olarak silinebilir; aksi takdirde, saklama aralığının sonunda depolama hesabını yalnızca sistem temizleyebilir.
Error	Anahtar kasası sunucusu hatası.
KeyVaultError	Anahtar kasası hata özel durumu.
SasDefinitionAttributes	SAS tanım yönetimi öznitelikleri.
SasDefinitionItem	Depolama SAS tanımı meta verilerini içeren SAS tanım öğesi.
SasDefinitionListResult	Depolama hesabı SAS tanım listesi sonucu.

DeletionRecoveryLevel

Geçerli kasadaki depolama hesapları için geçerli olan silme kurtarma düzeyini yansıtır. 'Temizlenebilir' içeriyorsa, depolama hesabı ayrıcalıklı bir kullanıcı tarafından kalıcı olarak silinebilir; aksi takdirde, saklama aralığının sonunda depolama hesabını yalnızca sistem 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 aralığı 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 ayrıca 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ığı 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 bir kasa durumunu belirtir. Bu düzey, Silme işlemine karşı kullanılabilir koruma olmamasını ifade eder; varlık düzeyinde veya daha yüksek bir düzeyde (kasa, kaynak grubu, abonelik vb.) silme işlemi kabul edildikten sonra veriler kurtarılamaz ş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) 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, 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ı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ı.

SasDefinitionAttributes

SAS tanım yönetimi öznitelikleri.

Name	Tür	Description
created	integer	OLUŞTURMA saati : UTC.
enabled	boolean	nesnenin etkin durumu.
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 SAS tanımları için geçerli olan silme kurtarma düzeyini yansıtır. 'Temizlenebilir' içeriyorsa SAS tanımı ayrıcalıklı bir kullanıcı tarafından kalıcı olarak silinebilir; aksi takdirde, bekletme aralığının sonunda SAS tanımını yalnızca sistem temizleyebilir.
updated	integer	Son güncelleştirme saati : UTC.

SasDefinitionItem

Depolama SAS tanımı meta verilerini içeren SAS tanım öğesi.

Name	Tür	Description
attributes	SasDefinitionAttributes	SAS tanım yönetimi öznitelikleri.
id	string	Depolama SAS tanımlayıcısı.
sid	string	Depolama hesabı SAS tanımı gizli anahtarı kimliği.
tags	object	Anahtar-değer çiftleri biçiminde uygulamaya özgü meta veriler.

SasDefinitionListResult

Depolama hesabı SAS tanım listesi sonucu.

Name	Tür	Description
nextLink	string	Sonraki SAS tanımları kümesini almak için URL.
value	SasDefinitionItem[]	SAS tanımlarının listesinin yanı sıra SAS tanımlarının sonraki sayfasına bağlantı içeren bir yanıt iletisi.

Share via