Dizin Özelliklerini Alma
İşlem Get Directory Properties
, belirtilen dizin için tüm sistem özelliklerini döndürür ve bir dizinin varlığını denetlemek için de kullanılabilir. Döndürülen veriler dizindeki dosyaları veya alt dizinleri içermez.
Protokol kullanılabilirliği
Etkin dosya paylaşımı protokolü | Kullanılabilir |
---|---|
SMB | |
NFS |
İstek
İstek Get Directory Properties
aşağıdaki gibi oluşturulabilir. HTTPS kullanmanızı öneririz.
Yöntem | İstek URI'si | HTTP sürümü |
---|---|---|
GET/HEAD |
https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
GET/HEAD |
https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> |
HTTP/1.1 |
İstek URI'sinde gösterilen yol bileşenlerini aşağıdaki gibi kendinizle değiştirin:
Yol bileşeni | Description |
---|---|
myaccount |
Depolama hesabınızın adı. |
myshare |
Dosya paylaşımınızın adı. |
myparentdirectorypath |
İsteğe bağlı. Üst dizinin yolu. |
mydirectory |
Dizinin adı. |
Yol adlandırma kısıtlamaları hakkında bilgi için bkz . Ad ve başvuru paylaşımları, dizinler, dosyalar ve meta veriler.
URI parametreleri
İstek URI'sinde aşağıdaki ek parametreler belirtilebilir:
Parametre | Açıklama |
---|---|
sharesnapshot |
İsteğe bağlı. Sürüm 2017-04-17 ve üzeri.
sharesnapshot parametresi, mevcut olduğunda dizin özelliklerini sorgulayan paylaşım anlık görüntüsünü belirten opak bir DateTime değeridir |
timeout |
İsteğe bağlı.
timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Azure Dosyalar işlemleri için zaman aşımlarını ayarlama. |
İstek üst bilgileri
Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:
İstek üst bilgisi | Açıklama |
---|---|
Authorization |
Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme. |
Date veya x-ms-date |
Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme. |
x-ms-version |
Anonim istekler için isteğe bağlı olarak tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma. |
x-ms-client-request-id |
İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. İzleme Azure Dosyalar. |
x-ms-file-request-intent |
Üst bilgi bir OAuth belirteci belirtiyorsa Authorization gereklidir. Kabul edilebilir değer: backup . Bu üst bilgi, üst bilgi kullanılarak yetkilendirilmiş kimliğe atanan RBAC ilkesine dahil edildiyse veya Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action izni verilmesi Authorization gerektiğini belirtirMicrosoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action . Sürüm 2022-11-02 ve üzeri için kullanılabilir. |
x-ms-allow-trailing-dot: { <Boolean> } |
İsteğe bağlı. Sürüm 2022-11-02 ve üzeri. Boole değeri, istek URL'sinde sondaki bir noktanın kırpılıp kırpılmaması gerektiğini belirtir. Daha fazla bilgi için bkz . Paylaşımları, dizinleri, dosyaları ve meta verileri adlandırma ve buna başvurma. |
İstek gövdesi
Yok.
Örnek istek
HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
Request Headers:
x-ms-version: 2015-02-21
x-ms-date: <date>
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Yanıt
Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.
Durum kodu
Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.
Durum kodları hakkında daha fazla bilgi için bkz. Durum ve hata kodları.
Yanıt üst bilgileri
Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.
Yanıt üst bilgisi | Description |
---|---|
ETag |
ETag, işlemleri koşullu olarak gerçekleştirmek için kullanabileceğiniz bir değer içerir. Değer tırnak içine alınır. |
Last-Modified |
Dizinin en son değiştirildiği tarihi ve saati döndürür. Tarih biçimi RFC 1123'e göredir. Daha fazla bilgi için bkz. Üst bilgilerde tarih/saat değerlerini temsil edin. Dizin içindeki dosyalar üzerindeki işlemler, dizinin son değiştirilme zamanını etkilemez. |
x-ms-meta-name:value |
Dizinin meta verilerini içeren bir dizi ad-değer çifti. |
x-ms-request-id |
İsteğin benzersiz tanımlayıcısını döndürür ve bu da isteğin sorunlarını gidermenize yardımcı olabilir. Daha fazla bilgi için bkz . API işlemleriyle ilgili sorunları giderme. |
x-ms-version |
İsteği yürütmek için kullanılan hizmet sürümünü gösterir. |
Date |
Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri. |
x-ms-server-encrypted: true/false |
Sürüm 2017-04-17 ve üzeri. Dizin meta verileri belirtilen algoritma kullanılarak tamamen şifrelenirse bu üst bilginin değeri olarak ayarlanır true . Meta veriler şifrelenmemişse, değer olarak false ayarlanır. |
x-ms-file-permission-key |
Sürüm 2019-02-02 ve üzeri. Dizinin izninin anahtarı. |
x-ms-file-attributes |
Sürüm 2019-02-02 ve üzeri. Dizindeki dosya sistemi öznitelikleri. Daha fazla bilgi için kullanılabilir özniteliklerin listesine bakın. |
x-ms-file-creation-time |
Sürüm 2019-02-02 ve üzeri. Bir dizin için oluşturma zamanı özelliğini temsil eden UTC tarih/saat değeri. |
x-ms-file-last-write-time |
Sürüm 2019-02-02 ve üzeri. Dizinin son yazma zamanı özelliğini temsil eden UTC tarih/saat değeri. |
x-ms-file-change-time |
Sürüm 2019-02-02 ve üzeri. Dizinin değişiklik zamanı özelliğini temsil eden UTC tarih/saat değeri. |
x-ms-file-file-id |
Sürüm 2019-02-02 ve üzeri. Dizinin dosya kimliği. |
x-ms-file-parent-id |
Sürüm 2019-02-02 ve üzeri. Dizinin üst dosya kimliği. |
x-ms-client-request-id |
İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir.
x-ms-client-request-id Üst bilgi istekte yoksa yanıtta mevcut değildir. |
Yanıt gövdesi
Yok.
Örnek yanıt
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CAFB82EFF70C46"
Last-Modified: <date>
x-ms-version: 2015-02-21
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Yetkilendirme
Bu işlemi yalnızca hesap sahibi çağırabilir.
Açıklamalar
Belirtilen dizin yolu yoksa, istek 404 (Bulunamadı) durum koduyla başarısız olur.