Path - Get Properties
Get Özellikleri | Get Status | Access Control Listesini Alma | Erişimi Denetle
Get Özellikleri, bir yol için tüm sistem ve kullanıcı tanımlı özellikleri döndürür. Get Status, bir yol için tüm sistem tanımlı özellikleri döndürür. get Access Control List, bir yol için erişim denetim listesini döndürür. Bu işlem koşullu HTTP isteklerini destekler. Daha fazla bilgi için bkz. Blob Hizmeti İşlemleri için Koşullu Üst Bilgiler Belirtme.
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&upn={upn}&fsAction={fsAction}&timeout={timeout}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
account
|
path | True |
string |
Azure Depolama hesabı adı. |
dns
|
path | True |
string |
Azure Data Lake Storage uç noktası için DNS son eki. |
filesystem
|
path | True |
string |
Dosya sistemi tanımlayıcısı. Regex pattern: |
path
|
path | True |
string |
Dosya veya dizin yolu. |
action
|
query |
İsteğe bağlı. Değer "getStatus" ise yalnızca yol için sistem tarafından tanımlanan özellikler döndürülür. Değer "getAccessControl" ise, erişim denetimi listesi yanıt üst bilgilerinde döndürülür (hesap için Hiyerarşik Ad Alanı etkinleştirilmelidir), aksi takdirde özellikler döndürülür. |
||
fs
|
query |
string |
Yalnızca erişim denetimi eylemi için gereklidir. Yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiğinde geçerlidir. Dosya sistemi işlemi okuma/yazma/dize biçiminde yürütme, eşleşen '[rwx-]{3}' regex deseni |
|
timeout
|
query |
integer int32 |
saniye olarak isteğe bağlı bir işlem zaman aşımı değeri. Süre, istek hizmet tarafından alındığında başlar. İşlem tamamlanmadan önce zaman aşımı değeri geçtiğinde işlem başarısız olur. |
|
upn
|
query |
boolean |
İsteğe bağlı. Yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiğinde geçerlidir. "True" ise, x-ms-owner, x-ms-group ve x-ms-acl yanıt üst bilgilerinde döndürülen kullanıcı kimliği değerleri Azure Active Directory Nesne Kimliklerinden Kullanıcı Asıl Adları'na dönüştürülür. "false" ise, değerler Azure Active Directory Nesne Kimlikleri olarak döndürülür. Varsayılan değer false'tur. Grup ve uygulama Nesne Kimliklerinin benzersiz kolay adları olmadığından çevrilmediğini unutmayın. |
İstek Başlığı
Name | Gerekli | Tür | Description |
---|---|---|---|
x-ms-lease-id |
string |
İsteğe bağlı. Bu üst bilgi belirtilirse, işlem yalnızca aşağıdaki koşulların her ikisi de karşılandığında gerçekleştirilir: i) yolun kirası şu anda etkin ve ii) istekte belirtilen kira kimliği yolunkiyle eşleşir. Regex pattern: |
|
If-Match |
string |
İsteğe bağlı. ETag değeri. İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin. ETag tırnak içinde belirtilmelidir. |
|
If-None-Match |
string |
İsteğe bağlı. ETag değeri veya özel joker karakter ("*") değeri. yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. ETag tırnak içinde belirtilmelidir. |
|
If-Modified-Since |
string |
İsteğe bağlı. Tarih ve saat değeri. İşlemi yalnızca kaynak belirtilen tarih ve saatten sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi belirtin. |
|
If-Unmodified-Since |
string |
İsteğe bağlı. Tarih ve saat değeri. yalnızca kaynak belirtilen tarih ve saatten sonra değiştirilmediyse işlemi gerçekleştirmek için bu üst bilgiyi belirtin. |
|
x-ms-encryption-key |
string |
İsteğe bağlı. Base64 kodlu AES-256 şifreleme anahtarı. |
|
x-ms-encryption-key-sha256 |
string |
İsteğe bağlı. Şifreleme anahtarının Base64 kodlamalı SHA256 karması. |
|
x-ms-encryption-algorithm: AES256 |
string |
İsteğe bağlı. Şifreleme için kullanılacak algoritmayı belirtir. Bu üst bilginin değeri AES256 olmalıdır. |
|
x-ms-client-request-id |
string |
Sorun giderme ve bağıntı için analiz günlüklerine kaydedilmiş bir UUID. Regex pattern: |
|
x-ms-date |
string |
İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Bu, paylaşılan anahtar yetkilendirmesi kullanılırken gereklidir. |
|
x-ms-version |
string |
İsteği işlemek için kullanılan REST protokolünün sürümünü belirtir. Bu, paylaşılan anahtar yetkilendirmesi kullanılırken gereklidir. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Dosya veya dizin için tüm özellikleri döndürür. Headers
|
|
Other Status Codes |
Bir hata oluşmuştur. Olası HTTP durumu, kod ve ileti dizeleri aşağıda listelenmiştir:
Headers
|
Tanımlar
Name | Description |
---|---|
Data |
|
Error |
Hizmet hatası yanıt nesnesi. |
Path |
İsteğe bağlı. Değer "getStatus" ise yalnızca yolun sistem tanımlı özellikleri döndürülür. Değer "getAccessControl" ise, erişim denetimi listesi yanıt üst bilgilerinde döndürülür (hesap için Hiyerarşik Ad Alanı etkinleştirilmelidir), aksi takdirde özellikler döndürülür. |
DataLakeStorageError
Name | Tür | Description |
---|---|---|
error |
Hizmet hatası yanıt nesnesi. |
Error
Hizmet hatası yanıt nesnesi.
Name | Tür | Description |
---|---|---|
code |
string |
Hizmet hata kodu. |
message |
string |
Hizmet hata iletisi. |
PathGetPropertiesAction
İsteğe bağlı. Değer "getStatus" ise yalnızca yolun sistem tanımlı özellikleri döndürülür. Değer "getAccessControl" ise, erişim denetimi listesi yanıt üst bilgilerinde döndürülür (hesap için Hiyerarşik Ad Alanı etkinleştirilmelidir), aksi takdirde özellikler döndürülür.
Name | Tür | Description |
---|---|---|
checkAccess |
string |
|
getAccessControl |
string |
|
getStatus |
string |