Path - Update

  • Başvuru
Hizmet:
Storage Services
API Sürümü:
2023-08-03

Veri Ekleme | Verileri Temizle | Özellikleri Ayarla | Access Control ayarlama
Bir dosyaya eklenecek verileri karşıya yükler, daha önce karşıya yüklenen verileri bir dosyaya temizler (yazar), bir dosya veya dizinin özelliklerini ayarlar ya da bir dosya ya da dizin için erişim denetimini ayarlar. Veriler yalnızca bir dosyaya eklenebilir. Birden çok istemci kullanan aynı dosyaya eşzamanlı yazma işlemleri desteklenmez. Bu işlem koşullu HTTP isteklerini destekler. Daha fazla bilgi için bkz. Blob Hizmeti İşlemleri için Koşullu Üst Bilgiler Belirtme.

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}
İsteğe bağlı parametrelerle: 
PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&position={position}&retainUncommittedData={retainUncommittedData}&close={close}&mode={mode}&maxRecords={maxRecords}&forceFlag={forceFlag}&continuation={continuation}&flush={flush}&timeout={timeout}

URI Parametreleri

Name İçinde Gerekli Tür Description
accountName
 path True

string

Azure Depolama hesabı adı.
dnsSuffix
 path True

string

Azure Data Lake Storage uç noktası için DNS son eki.
filesystem
 path True

string

Dosya sistemi tanımlayıcısı.

Normal ifade deseni: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path
 path True

string

Dosya veya dizin yolu.
action
 query True

PathUpdateAction

Eylemin bir dosyaya eklenecek verileri karşıya yüklemek için "ekleme", daha önce karşıya yüklenen verileri bir dosyaya boşaltmak için "boşaltma", bir dosya veya dizinin özelliklerini ayarlamak için "setProperties", dosya veya dizin için sahip, grup, izinler veya erişim denetim listesini ayarlamak için "setAccessControl", dizin için erişim denetim listesini yinelemeli olarak ayarlamak için "setAccessControlRecursive" olması gerekir. Erişim denetimini kullanmak için hesapta Hiyerarşik Ad Alanı'nın etkinleştirilmesi gerektiğini unutmayın. Ayrıca, Access Control Listesi'nin (ACL) sahip, sahip olan grup ve diğerleri için izinleri içerdiğini, dolayısıyla x-ms-permissions ve x-ms-acl istek üst bilgilerinin birbirini dışladığını unutmayın.
close
 query

boolean

Azure Depolama Olayları, dosyalar değiştiğinde uygulamaların bildirim almasına olanak tanır. Azure Depolama Olayları etkinleştirildiğinde, dosya değişikliği olayı tetiklenir. Bu olay, bir ara temizleme ile dosya akışının son kapanışı arasındaki farkı ayırt etmek için bunun son değişiklik olup olmadığını belirten bir özelliğe sahiptir. Close query parametresi yalnızca eylem "flush" olduğunda ve değişiklik bildirimleri etkinleştirildiğinde geçerlidir. Kapatma değeri "true" ise ve temizleme işlemi başarıyla tamamlanırsa, hizmet bunun son güncelleştirme olduğunu belirten bir özellik içeren bir dosya değişikliği bildirimi oluşturur (dosya akışı kapatıldı). "False" ise dosyanın değiştiğini belirten bir değişiklik bildirimi oluşturulur. Varsayılan değer false. Bu sorgu parametresi, dosya akışının kapatıldığını belirtmek için Hadoop ABFS sürücüsü tarafından true olarak ayarlanır."
continuation
 query

string

İsteğe bağlı ve yalnızca "setAccessControlRecursive" işlemi için geçerlidir. Her çağrıyla işlenen yol sayısı sınırlıdır. İşlenecek yol sayısı bu sınırı aşarsa, x-ms-continuation yanıt üst bilgisinde bir devamlılık belirteci döndürülür. Yanıtta bir devamlılık belirteci döndürdüğünde, setAccessControlRecursive işleminin sonraki çağrısında yüzde kodlamalı ve belirtilmelidir.
flush
 query

boolean

Yalnızca ekleme çağrıları için geçerlidir. Bu parametre, çağıranın ekleme çağrısı sırasında boşaltılmasını sağlar. Varsayılan değer "false" ise, "true" ise veriler ekleme çağrısıyla temizlenir. flush=true kullanırken aşağıdaki üst bilgilerin desteklenmediğini unutmayın: "x-ms-cache-control", "x-ms-content-encoding", "x-ms-content-type", "x-ms-content-language", "x-ms-content-md5", "x-ms-content-disposition". Temizleme sırasında bu üst bilgileri ayarlamak için lütfen action=flush kullanın
forceFlag
 query

boolean

İsteğe bağlı ve yalnızca "setAccessControlRecursive" işlemi için geçerlidir. Bu "false" ise, kullanıcı hatalarıyla (4XX) karşılaşıldığında işlem hızla sonlandırılır. "True" ise API kullanıcı hatalarını yoksayar ve dizinin diğer alt varlıklarında işleme devam eder. Her iki senaryo için de yanıtta kullanıcı hatalarının ayrıntılı durumu döndürülür. Devamlılık belirteci yalnızca forceFlag kullanıcı hataları durumunda "true" olduğunda döndürülür. forceFlag için varsayılan değer false'tur.
maxRecords
 query

integer

int32

İsteğe bağlı ve yalnızca "setAccessControlRecursive" işlemi için geçerlidir. ACL değişikliğinin uygulanacağı en fazla dosya veya dizin sayısını belirtir. Atlanırsa veya 2.000'den büyükse, istek en fazla 2.000 öğeyi işler
mode
 query

string

İsteğe bağlı. "setAccessControlRecursive" işlemi için geçerli ve gerekli. Mod", dosya ve dizinlerde POSIX erişim denetimi haklarını ayarlar, "değiştir" dosya ve dizinlerde önceden var olan bir veya daha fazla POSIX erişim denetimi haklarını değiştirir, "kaldırma" daha önce dosyalarda ve dizinlerde bulunan bir veya daha fazla POSIX erişim denetimi haklarını kaldırır
position
 query

integer

int64

Bu parametre, çağıranın verileri paralel olarak karşıya yüklemesine ve dosyaya eklenme sırasını denetlemesine olanak tanır. Verilerin dosyaya eklenmesi için karşıya yüklenirken ve önceden karşıya yüklenen veriler dosyaya boşaltılırken gereklidir. Değer, verilerin eklendiği konum olmalıdır. Karşıya yüklenen veriler hemen temizlenmez veya dosyaya yazılmaz. Boşaltmak için, önceden karşıya yüklenen verilerin bitişik olması, position parametresinin belirtilmesi ve tüm veriler yazıldıktan sonra dosyanın uzunluğuna eşit olması ve istekle birlikte bir istek varlık gövdesi olmaması gerekir.
retainUncommittedData
 query

boolean

Yalnızca boşaltma işlemleri için geçerlidir. "True" ise, boşaltma işlemi tamamlandıktan sonra kaydedilmemiş veriler korunur; aksi takdirde, kaydedilmemiş veriler temizleme işleminden sonra silinir. Varsayılan değer false. Temizleme başarılı olduğunda belirtilen konumdan daha küçük uzaklıklarda bulunan veriler dosyaya yazılır, ancak bu isteğe bağlı parametre, boşaltma konumundan sonraki verilerin gelecekte boşaltma işlemi için korunmasını sağlar.
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.

İstek Başlığı

Media Types: "application/octet-stream", "text/plain"

Name Gerekli Tür Description
Content-Length

integer

int64

"Verileri Ekle" ve "Verileri Temizle" için gereklidir. "Verileri Temizle" için 0 olmalıdır. "Veri Ekle" için istek içeriğinin bayt cinsinden uzunluğu olmalıdır.
Content-MD5

string

İsteğe bağlı. İstek içeriğinin MD5 karması. Bu üst bilgi "Ekleme" ve "Temizleme" işlemlerinde geçerlidir. Bu karma, aktarım sırasında istek içeriğinin bütünlüğünü doğrulamak için kullanılır. Bu üst bilgi belirtildiğinde, depolama hizmeti bu üst bilgi değeriyle gelen içeriğin karmasıyla karşılaştırılır. İki karma eşleşmiyorsa işlem 400 (Hatalı İstek) hata koduyla başarısız olur. Bu MD5 karması dosyayla birlikte depolanmaz. Bu üst bilgi istek içeriğiyle ilişkilendirilir, dosyanın depolanan içeriğiyle ilişkili değildir.
x-ms-lease-id

string

Etkin bir kira varsa kira kimliği belirtilmelidir. "setAccessControlRecursive" işlemleri için geçersiz.

Normal ifade deseni: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-cache-control

string

İsteğe bağlı ve yalnızca temizleme ve ayarlama özellikleri işlemleri için geçerlidir. Hizmet bu değeri depolar ve "Dosya Okuma" işlemleri için "Önbellek Denetimi" yanıt üst bilgisine ekler.
x-ms-content-type

string

İsteğe bağlı ve yalnızca temizleme ve ayarlama özellikleri işlemleri için geçerlidir. Hizmet bu değeri depolar ve "Dosyayı Okuma" işlemleri için "Content-Type" yanıt üst bilgisine ekler.
x-ms-content-disposition

string

İsteğe bağlı ve yalnızca temizleme ve ayarlama özellikleri işlemleri için geçerlidir. Hizmet bu değeri depolar ve "Dosyayı Okuma" işlemleri için "Content-Disposition" yanıt üst bilgisine ekler.
x-ms-content-encoding

string

İsteğe bağlı ve yalnızca temizleme ve ayarlama özellikleri işlemleri için geçerlidir. Hizmet bu değeri depolar ve "Dosya Okuma" işlemleri için "Content-Encoding" yanıt üst bilgisine ekler.
x-ms-content-language

string

İsteğe bağlı ve yalnızca temizleme ve ayarlama özellikleri işlemleri için geçerlidir. Hizmet bu değeri depolar ve "Dosya Okuma" işlemleri için "content-language" yanıt üst bilgisine ekler.
x-ms-content-md5

string

İsteğe bağlı ve yalnızca "Özellikleri Temizle ve Ayarla" işlemleri için geçerlidir. Hizmet bu değeri depolar ve "Okuma ve Özellikleri Alma" işlemleri için "Content-Md5" yanıt üst bilgisine ekler. İstekte bu özellik belirtilmezse, dosya için özellik temizlenir. "Okuma ve Alma Özellikleri" için yapılan sonraki çağrılar, bu dosyada yeniden açıkça ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-properties

string

İsteğe bağlı. Dosya veya dizinle birlikte depolanacak kullanıcı tanımlı özellikler, "n1=v1, n2=v2, ..." ad ve değer çiftlerinin virgülle ayrılmış bir listesi biçiminde depolanır; burada her değer base64 ile kodlanmış bir dizedir. Dizenin yalnızca ISO-8859-1 karakter kümesindeki ASCII karakterlerini içerebileceğini unutmayın. Yalnızca setProperties işlemi için geçerlidir. Dosya veya dizin varsa, listeye dahil olmayan özellikler kaldırılır. Üst bilgi atlanırsa tüm özellikler kaldırılır. Yeni ve mevcut özellikleri birleştirmek için, önce tüm mevcut özellikleri ve geçerli E-Etiketi alın, ardından E-Tag ile bir koşullu istek yapın ve tüm özellikler için değerler ekleyin.
x-ms-owner

string

İsteğe bağlı ve yalnızca setAccessControl işlemi için geçerlidir. Dosya veya dizinin sahibini ayarlar.
x-ms-group

string

İsteğe bağlı ve yalnızca setAccessControl işlemi için geçerlidir. Dosyanın veya dizinin sahip olan grubunu ayarlar.
x-ms-permissions

string

İsteğe bağlı ve yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiyse geçerlidir. Dosya sahibi, dosya sahibi grubu ve diğerleri için POSIX erişim izinlerini ayarlar. Her sınıfa okuma (4), yazma (2) veya yürütme (1) izni verilebilir. Hem sembolik (rwxrw-rw-) hem de 4 basamaklı sekizli gösterimi (ör. 0766) desteklenir. Yapışkan bit de desteklenir ve sembolik gösteriminde, diğerleri kategorisi için yürütme bitinin sırasıyla ayarlanıp ayarlanmadığına (örneğin, rwxrw-rw- yapışkan bitli rwxrw-rwT olarak temsil edilir) son karakter konumunda t veya T harfiyle temsil edilir. Yapışkan bitli bir rwxrw-rwx, rwxrw-rwt olarak temsil edilir; t veya T olmaması yapışkan bitin ayarlanmadığını gösterir. 4 basamaklı sekizli gösteriminde, 1. basamakla temsil edilir (örneğin, 1766 ruxrw-rw-yapışkan biti, 0766 ise yapışkan bit olmadan rwxrw-rw'yi temsil eder). x-ms-acl ile birlikte geçersiz.
x-ms-acl

string

İsteğe bağlı ve yalnızca setAccessControl ve setAccessControlRecursive işlemleri için geçerlidir. setAccessControlRecursive işlemi için gereklidir. Dosya ve dizinlerde POSIX erişim denetimi haklarını ayarlar. değer, setAccessControl ve setAccessControlRecursive "set" modu olması durumunda mevcut erişim denetim listesinin (ACL) yerini tamamen alan erişim denetimi girdilerinin virgülle ayrılmış bir listesidir. setAccessControlRecursive'ın "değiştirme" modu, önceden var olan ACLS'yi güncelleştirir. Her erişim denetimi girdisi (ACE) kapsam, tür, kullanıcı veya grup tanımlayıcısı ve "[kapsam:][tür]:[kimlik]:[izinler]" biçiminde izinlerden oluşur. ACE'nin bir dizin için varsayılan ACL'ye ait olduğunu belirtmek için kapsam "varsayılan" olmalıdır; aksi takdirde kapsam örtülüdür ve ACE erişim ACL'sine aittir. Dört ACE türü vardır: "kullanıcı", sahip veya adlandırılmış bir kullanıcıya haklar verir, "grup" sahip olan gruba veya adlandırılmış bir gruba haklar verir, "maske" adlandırılmış kullanıcılara ve grupların üyelerine verilen hakları kısıtlar ve "diğer" diğer girdilerin hiçbirinde bulunmayan tüm kullanıcılara haklar verir. "Maske" ve "diğer" türündeki girdiler için kullanıcı veya grup tanımlayıcısı atlanır. Sahip ve sahip olan grup için kullanıcı veya grup tanımlayıcısı da atlanır. İzin alanı, okuma erişimi vermek için ilk karakterin 'r' olduğu, ikinci karakterin yazma erişimi vermek için 'w' ve yürütme izni vermek için üçüncü karakterin 'x' olduğu 3 karakterlik bir dizidir. Erişim verilmezse, iznin reddedildiğini belirtmek için '-' karakteri kullanılır. Örneğin, aşağıdaki ACL dosya sahibine ve john.doe@contoso okuma, yazma ve yürütme hakları verir, sahip olan gruba okuma hakkı verir ve diğer herkese hiçbir şey vermez: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". x-ms-permissions ile birlikte geçersiz. setAccessControlRecursive'ın "remove" modu önceden var olan ACL'leri kaldırır ve "user:john.doe@contoso:, mask:" belirtilen erişim denetimi listesinde izinler içermemelidir. setAccessControlRecursive'ın "set" modu, belirtilen kapsamın önceden var olan ACL'lerinin yerini alan ACL'leri ayarlar ve erişim kapsamı ayarlanıyorsa veya sahip olan kullanıcı, sahip olan grup veya diğer kullanıcılardan biri varsayılan kapsamda ayarlanıyorsa sahip olan kullanıcı, sahip olan grup veya diğer bilgiler olmak üzere üçünü de içermelidir. setAccessControlRecursive'ın "set" ve "modify" modları, erişim denetimi listesinin bir parçası olarak izinler içermelidir.
If-Match

string

Verileri Temizleme, Access Control Ayarlama ve Özellikleri Ayarlama için isteğe bağlı, ancak Verileri Ekleme ve Özyinelemeli Access Control Ayarlama için geçersiz. 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

Verileri Temizleme, Access Control Ayarlama ve Özellikleri Ayarlama için isteğe bağlı, ancak Verileri Ekleme ve Özyinelemeli Access Control Ayarlama için geçersiz. 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

Verileri Temizleme ve Özellikleri Ayarlama için isteğe bağlı, ancak Veri Ekleme ve Özyinelemeli Access Control Ayarla için geçersiz. Tarih ve saat değeri. bu üst bilgiyi yalnızca kaynak belirtilen tarih ve saatten sonra değiştirilmişse işlemi gerçekleştirmek için belirtin.
If-Unmodified-Since

string

Verileri Temizleme ve Özellikleri Ayarlama için isteğe bağlı, ancak Veri Ekleme ve Özyinelemeli Access Control Ayarla için geçersiz. 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 kodlamalı 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-lease-action True

PathLeaseAction

Ekleme ve temizleme işlemlerinde 2020-08-04 sürümünden itibaren. Ekleme işlemi 'alma', 'otomatik yenileme' ve 'acquire-release' eylemlerini destekler. "Satın alırsanız" kirayı alır. 'Otomatik yenileme' durumunda kiralama yenilenir. 'acquire-release' alırsa, işlem tamamlandıktan & işlemi tamamlar & işlem tamamlandıktan sonra kirayı serbest bırakır. 'Release' eylemi yalnızca temizleme işleminde desteklenir. 'True' ise, x-ms-lease-id üst bilgisindeki kira kimliği bilgilerini kullanarak dosyadaki kiralamayı serbest bırakır.
x-ms-lease-duration

integer

int32

Kira süresi, kiralama almak için gereklidir ve kiranın süresini saniye cinsinden belirtir. Kiralama süresi 15 ile 60 saniye arasında veya sonsuz kiralama için -1 olmalıdır.
x-ms-proposed-lease-id

string

"x-ms-lease-action" "acquire" veya "change" olduğunda gereklidir. İşlem başarılı olursa bu kiralama kimliğiyle bir kiralama alınır.

Normal ifade deseni: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-client-request-id

string

Sorun giderme ve bağıntı için analiz günlüklerine kaydedilmiş bir UUID.

Normal ifade deseni: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-date

string

İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Paylaşılan anahtar yetkilendirmesi kullanılırken bu gereklidir.
x-ms-version

string

İsteği işlemek için kullanılan REST protokolünün sürümünü belirtir. Paylaşılan anahtar yetkilendirmesi kullanılırken bu gereklidir.

İstek Gövdesi

Media Types: "application/octet-stream", "text/plain"

Name Tür Description
requestBody

object

Yalnızca ekleme işlemleri için geçerlidir. Karşıya yüklenecek ve dosyaya eklenecek veriler.

Yanıtlar

Name Tür Description
200 OK

SetAccessControlRecursiveResponse

Veriler dosyaya boşaltıldı (yazıldı) veya özellikler başarıyla ayarlandı. Yanıt gövdesi isteğe bağlıdır ve yalnızca "SetAccessControlRecursive" için geçerlidir

Üst Bilgiler

  • Date: string
  • ETag: string
  • Last-Modified: string
  • Accept-Ranges: string
  • Cache-Control: string
  • Content-Disposition: string
  • Content-Encoding: string
  • Content-Language: string
  • Content-Length: integer
  • Content-Range: string
  • Content-Type: string
  • Content-MD5: string
  • x-ms-properties: string
  • x-ms-continuation: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-request-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-scope: string
  • x-ms-lease-renewed: boolean
202 Accepted

Karşıya yüklenen veriler kabul edildi.

Üst Bilgiler

  • Content-MD5: string
  • Date: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-lease-renewed: boolean
Other Status Codes

DataLakeStorageError

Bir hata oluşmuştur. Olası HTTP durumu, kodu ve ileti dizeleri aşağıda listelenmiştir:

  • 400 Hatalı İstek, ContentLengthMustBeZero, "Content-Length istek üst bilgisi sıfır olmalıdır."
  • 400 Hatalı İstek, InvalidAuthenticationInfo, "Kimlik doğrulama bilgileri doğru biçimde verilmedi. Yetkilendirme üst bilgisinin değerini denetleyin."
  • 400 Hatalı İstek, InvalidFlushPosition, "Karşıya yüklenen veriler bitişik değil veya konum sorgusu parametre değeri, karşıya yüklenen verileri ekledikten sonra dosyanın uzunluğuna eşit değil."
  • 400 Hatalı İstek, InvalidHeaderValue, "HTTP üst bilgilerinden birinin değeri doğru biçimde değil."
  • 400 Hatalı İstek, GeçersizHttpVerb, "Belirtilen HTTP fiili geçersiz - sunucu tarafından tanınmıyor."
  • 400 Hatalı İstek, InvalidInput, "İstek girişlerinden biri geçerli değil."
  • 400 Hatalı İstek, InvalidPropertyName, "Özellik adı boş olamaz."
  • 400 Hatalı İstek, InvalidPropertyName, "Özellik adı geçersiz karakterler içeriyor."
  • 400 Hatalı İstek, InvalidQueryParameterValue, "İstek URI'sinde belirtilen sorgu parametrelerinden birinin değeri geçersiz."
  • 400 Hatalı İstek, InvalidResourceName, "Belirtilen kaynak adı geçersiz karakterler içeriyor."
  • 400 Hatalı İstek, InvalidSourceUri, "Kaynak URI geçersiz."
  • 400 Hatalı İstek, InvalidUri, "İstek URI'si geçersiz."
  • 400 Hatalı İstek, MissingRequiredHeader, "Bu istek için zorunlu olan bir HTTP üst bilgisi belirtilmedi."
  • 400 Hatalı İstek, MissingRequiredQueryParameter, "Bu istek için zorunlu olan bir sorgu parametresi belirtilmedi."
  • 400 Hatalı İstek, MultipleConditionHeadersNotSupported, "Birden çok koşul üst bilgisi desteklenmiyor."
  • 400 Hatalı İstek, OutOfRangeInput, "İstek girişlerinden biri aralık dışında."
  • 400 Hatalı İstek, OutOfRangeQueryParameterValue, "İstek URI'sinde belirtilen sorgu parametrelerinden biri izin verilen aralığın dışında."
  • 400 Hatalı İstek, DesteklenmeyenBaşlık, "İstekte belirtilen üst bilgilerden biri desteklenmiyor."
  • 400 Hatalı İstek, UnsupportedQueryParameter, "İstek URI'sinde belirtilen sorgu parametrelerinden biri desteklenmiyor."
  • 400 Hatalı İstek, UnsupportedRestVersion, "Belirtilen Rest Sürümü Desteklenmiyor."
  • 403 Yasak, AccountIsDisabled, "Belirtilen hesap devre dışı."
  • 403 Yasak, AuthorizationFailure, "Bu isteğin bu işlemi gerçekleştirme yetkisi yok."
  • 403 Yasak, InsufficientAccountPermissions, "Erişilen hesap bu işlemi yürütmek için yeterli izinlere sahip değil."
  • 404 Bulunamadı, FilesystemNotFound, "Belirtilen dosya sistemi yok."
  • 404 Bulunamadı, PathNotFound, "Belirtilen yol yok."
  • 404 Bulunamadı, RenameDestinationParentPathNotFound, "Hedef yolun üst dizini yok."
  • 404 Bulunamadı, ResourceNotFound, "Belirtilen kaynak yok."
  • 404 Bulunamadı, SourcePathNotFound, "Yeniden adlandırma işleminin kaynak yolu yok."
  • 405 Yöntemine İzin Verilmiyor, DesteklenmiyorHttpVerb, "Kaynak belirtilen HTTP fiilini desteklemiyor."
  • 409 Conflict, DestinationPathIsBeingDeleted, "Belirtilen hedef yol silinecek şekilde işaretlenmiş."
  • 409 Conflict, DirectoryNotEmpty, "Boş olmayan bir dizini silmek için özyinelemeli sorgu parametre değeri true olmalıdır."
  • 409 Conflict, FilesystemAlreadyExists, "Belirtilen dosya sistemi zaten var."
  • 409 Conflict, FilesystemBeingDeleted, "Belirtilen dosya sistemi siliniyor."
  • 409 Conflict, InvalidDestinationPath, "Belirtilen yol veya yolun bir öğesi var ve kaynak türü bu işlem için geçersiz." * 409 Conflict, InvalidFlushOperation, "Kaynak Blob Hizmeti API'si tarafından oluşturuldu veya değiştirildi ve Data Lake Storage Hizmeti API'si tarafından yazılamaz."
  • 409 Conflict, InvalidRenameSourcePath, "Kaynak dizin, hedef dizinle aynı olamaz ve hedef, kaynak dizinin alt dizini olamaz."
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "Kaynak ve hedef kaynak türü aynı olmalıdır."
  • 409 Conflict, LeaseAlreadyPresent, "Zaten bir kira var."
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "Belirtilen kira kimliği belirtilen kiralama işlemine sahip kaynağın kira kimliğiyle eşleşmedi."
  • 409 Conflict, LeaseIsAlreadyBroken, "Kira zaten bozuk ve yeniden bozulamaz."
  • 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "Kira kimliği eşleşti, ancak kira şu anda bozuluyor ve bozulana kadar alınamıyor."
  • 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "Kira kimliği eşleşti, ancak kira şu anda hata durumunda ve değiştirilemez."
  • 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "Kira kimliği eşleşti, ancak kira açıkça bozuldu ve yenilenemiyor."
  • 409 Conflict, LeaseNameMismatch, "Belirtilen kira adı varolan kira adıyla eşleşmedi."
  • 409 Conflict, LeaseNotPresentWithLeaseOperation, "Kira kimliği belirtilen kiralama işlemiyle birlikte yok."
  • 409 Conflict, PathAlreadyExists, "Belirtilen yol zaten var."
  • 409 Conflict, PathConflict, "Belirtilen yol veya yolun bir öğesi var ve kaynak türü bu işlem için geçersiz."
  • 409 Conflict, SourcePathIsBeingDeleted, "Belirtilen kaynak yol silinecek şekilde işaretlenmiş."
  • 409 Çakışması, ResourceTypeMismatch, "İstekte belirtilen kaynak türü kaynağın türüyle eşleşmiyor."
  • 412 Önkoşul Başarısız Oldu, ConditionNotMet, "HTTP koşullu üst bilgileri kullanılarak belirtilen koşul karşılanmadı."
  • 412 Önkoşul Başarısız Oldu, LeaseIdMismatch, "Belirtilen kira kimliği kaynağın kira kimliğiyle eşleşmedi."
  • 412 Önkoşul Başarısız Oldu, LeaseIdMissing, "Kaynakta şu anda bir kira var ve istekte kira kimliği belirtilmedi."
  • 412 Önkoşul Başarısız Oldu, LeaseNotPresent, "Şu anda kaynakta kira yok."
  • 412 Önkoşul Başarısız Oldu, LeaseLost, "Kira kimliği belirtildi, ancak kaynağın kira süresi doldu."
  • 412 Önkoşul Başarısız Oldu, SourceConditionNotMet, "HTTP koşullu üst bilgileri kullanılarak belirtilen kaynak koşul karşılanmadı."
  • 413 İstek Varlığı Çok Büyük, RequestBodyTooLarge, "İstek gövdesi çok büyük ve izin verilen maksimum sınırı aşıyor."
  • 416 İstenen Aralık Satisfiable Değil, InvalidRange, "Belirtilen aralık kaynağın geçerli boyutu için geçersiz."
  • 500 İç Sunucu Hatası, InternalError, "Sunucu bir iç hatayla karşılaştı. Lütfen isteği yeniden deneyin."
  • 500 İç Sunucu Hatası, OperationTimedOut, "İşlem izin verilen süre içinde tamamlanamadı."
  • 503 Hizmet Kullanılamıyor, ServerBusy, "Çıkış hesap sınırını aştı."
  • 503 Hizmet Kullanılamıyor, ServerBusy, "Giriş hesap sınırını aştı."
  • 503 Hizmet Kullanılamıyor, ServerBusy, "Saniyedeki işlemler hesap sınırını aşmış."
  • 503 Hizmet Kullanılamıyor, ServerBusy, "Sunucu şu anda istekleri alamıyor. Lütfen isteğinizi yeniden deneyin."

Üst Bilgiler

  • x-ms-request-id: string
  • x-ms-version: string

Tanımlar

Name Description
AclFailedEntryList
DataLakeStorageError
Error

Hizmet hata yanıtı nesnesi.
PathLeaseAction

Ekleme ve temizleme işlemlerinde 2020-08-04 sürümünden itibaren. Ekleme işlemi 'alma', 'otomatik yenileme' ve 'acquire-release' eylemlerini destekler. "Satın alırsanız" kirayı alır. 'Otomatik yenileme' durumunda kiralama yenilenir. 'acquire-release' alırsa, işlem tamamlandıktan & işlemi tamamlar & işlem tamamlandıktan sonra kirayı serbest bırakır. 'Release' eylemi yalnızca temizleme işleminde desteklenir. 'True' ise, x-ms-lease-id üst bilgisindeki kira kimliği bilgilerini kullanarak dosyadaki kiralamayı serbest bırakır.
PathUpdateAction

Eylemin bir dosyaya eklenecek verileri karşıya yüklemek için "ekleme", daha önce karşıya yüklenen verileri bir dosyaya boşaltmak için "boşaltma", bir dosya veya dizinin özelliklerini ayarlamak için "setProperties", dosya veya dizin için sahip, grup, izinler veya erişim denetim listesini ayarlamak için "setAccessControl", dizin için erişim denetim listesini yinelemeli olarak ayarlamak için "setAccessControlRecursive" olması gerekir. Erişim denetimini kullanmak için hesapta Hiyerarşik Ad Alanı'nın etkinleştirilmesi gerektiğini unutmayın. Ayrıca, Access Control Listesi'nin (ACL) sahip, sahip olan grup ve diğerleri için izinleri içerdiğini, dolayısıyla x-ms-permissions ve x-ms-acl istek üst bilgilerinin birbirini dışladığını unutmayın.
SetAccessControlRecursiveResponse

AclFailedEntryList

Name Tür Description
errorMessage

string

name

string

type

string

DataLakeStorageError

Name Tür Description
error

Error

Hizmet hata yanıtı nesnesi.

Error

Hizmet hata yanıtı nesnesi.

Name Tür Description
code

string

Hizmet hata kodu.
message

string

Hizmet hata iletisi.

PathLeaseAction

Ekleme ve temizleme işlemlerinde 2020-08-04 sürümünden itibaren. Ekleme işlemi 'alma', 'otomatik yenileme' ve 'acquire-release' eylemlerini destekler. "Satın alırsanız" kirayı alır. 'Otomatik yenileme' durumunda kiralama yenilenir. 'acquire-release' alırsa, işlem tamamlandıktan & işlemi tamamlar & işlem tamamlandıktan sonra kirayı serbest bırakır. 'Release' eylemi yalnızca temizleme işleminde desteklenir. 'True' ise, x-ms-lease-id üst bilgisindeki kira kimliği bilgilerini kullanarak dosyadaki kiralamayı serbest bırakır.

Name Tür Description
acquire

string

acquire-release

string

auto-renew

string

release

string

PathUpdateAction

Eylemin bir dosyaya eklenecek verileri karşıya yüklemek için "ekleme", daha önce karşıya yüklenen verileri bir dosyaya boşaltmak için "boşaltma", bir dosya veya dizinin özelliklerini ayarlamak için "setProperties", dosya veya dizin için sahip, grup, izinler veya erişim denetim listesini ayarlamak için "setAccessControl", dizin için erişim denetim listesini yinelemeli olarak ayarlamak için "setAccessControlRecursive" olması gerekir. Erişim denetimini kullanmak için hesapta Hiyerarşik Ad Alanı'nın etkinleştirilmesi gerektiğini unutmayın. Ayrıca, Access Control Listesi'nin (ACL) sahip, sahip olan grup ve diğerleri için izinleri içerdiğini, dolayısıyla x-ms-permissions ve x-ms-acl istek üst bilgilerinin birbirini dışladığını unutmayın.

Name Tür Description
append

string

flush

string

setAccessControl

string

setAccessControlRecursive

string

setProperties

string

SetAccessControlRecursiveResponse

Name Tür Description
directoriesSuccessful

integer

failedEntries

AclFailedEntryList[]

failureCount

integer

filesSuccessful

integer