Path - Update

Veri Ekle | Verileri temizleme | Özellikleri ayarla | Access Control ayarla
Bir dosyaya eklenecek verileri karşıya yükler, Temizleme (yazma) daha önce verileri bir dosyaya yükler, bir dosya veya dizin için özellikleri ayarlar veya bir dosya ya da dizin için erişim denetimi ayarlar. Veriler yalnızca bir dosyaya eklenebilir. Birden çok istemcisini 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 işlemleri Için koşullu üstbilgiler belirtme.

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}
PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&position={position}&retainUncommittedData={retainUncommittedData}&close={close}&mode={mode}&maxRecords={maxRecords}&forceFlag={forceFlag}&continuation={continuation}&timeout={timeout}

URI Parametreleri

Name In Required Type Description
accountName
path True
  • string

Azure Depolama hesap 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ı.

Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$

path
path True
  • string

Dosya veya dizin yolu.

action
query True

Bir dosyaya eklenecek verileri yüklemek için eylem "Append" olmalıdır, "bir dosya veya dizinin özelliklerini ayarlamak için" setProperties "veya bir dosya ya da dizin için sahip, Grup, izinler veya erişim denetim listesini ayarlamak için" setAccessControl "veya" setAccessControlRecursive "veya bir dizinin erişim denetim listesini özyinelemeli olarak ayarlamak için" SetAccessControl "adlı bir dosyaya daha önce karşıya yüklenen verileri temizlemek için temizleyin. Erişim denetimini kullanmak için, hesap için hiyerarşik ad alanının etkin olması gerektiğini unutmayın. Ayrıca, Access Control listesi (ACL) sahip, sahip olan grup ve diğer kullanıcılar için izinler içerdiğinden, x-MS-Permissions ve x-MS-ACL istek üst bilgilerinin birbirini dışlamalı olduğunu unutmayın.

close
query
  • boolean

Azure Depolama olayları, uygulamaların dosyalar değiştiğinde bildirim almasına izin verir. Azure Depolama olayları etkinleştirildiğinde, bir dosya değiştirildi olayı tetiklenir. Bu olay, bir ara temizleme arasındaki farkı bir dosya akışına ve bir dosya akışının son kapanışını ayırt etmek için bunun son değişiklik olup olmadığını gösteren bir özelliğe sahiptir. Close sorgu parametresi yalnızca eylem "Flush" ve değişiklik bildirimleri etkin olduğunda geçerlidir. Close değeri "true" ise ve Temizleme işlemi başarıyla tamamlanırsa, hizmet, bu son güncelleştirme (dosya akışı kapatılmış) olduğunu belirten bir özellik ile birlikte bir dosya değişiklik bildirimi başlatır. "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ı göstermek için Hadoop ABFS sürücüsü tarafından true olarak ayarlanır. "

continuation
query
  • string

İsteğe bağlı ve yalnızca "Setaccesscontrolözyinelemeli" işlemi için geçerlidir. Her çağrılmayla işlenen yolların sayısı sınırlıdır. İşlenecek yolların sayısı bu sınırı aşarsa, yanıt üst bilgisinde x-MS-devamlılık belirteci döndürülür. Yanıtta bir devamlılık belirteci döndürüldüğünde, belirtilen Setaccesscontrolözyinelemeli işleminin sonraki çağrısında yüzde kodlamalı ve belirtilmelidir.

forceFlag
query
  • boolean

İsteğe bağlı ve yalnızca "Setaccesscontrolözyinelemeli" işlemi için geçerlidir. Bu "false" ise, Kullanıcı hatalarından (4XX) karşılaşmanız durumunda hızlı bir şekilde sona ermeyecektir. "True" ise, API kullanıcı hatalarını yoksayar ve dizinin diğer alt varlıklarındaki işleme devam eder. Kullanıcı hatalarının ayrıntılı durumu, her iki senaryo için yanıtta döndürülür. Devamlılık belirteci yalnızca Kullanıcı hataları durumunda forceFlag değeri "true" olduğunda döndürülür. ForceFlag için varsayılan değer false 'dur.

maxRecords
query
  • integer
int32

İsteğe bağlı ve yalnızca "Setaccesscontrolözyinelemeli" 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 öğe işleyebilir

mode
query
  • string

İsteğe bağlı. "Setaccesscontrolözyinelemeli" işlemi için geçerli ve gereklidir. Mod "set" 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ır", daha önce dosya 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 yüklemesine ve dosyanın eklendiği sırayı denetlemesine olanak tanır. Dosyaya eklenecek verileri karşıya yüklerken ve daha önce karşıya yüklenen veriler dosyaya boşaltılırken bu gereklidir. Değer, verilerin eklendiği konum olmalıdır. Karşıya yüklenen veriler dosyaya hemen temizlenmez veya yazılmaz. Temizlemek için, daha önce karşıya yüklenen verilerin bitişik olması gerekir, konum parametresi belirtilmelidir ve tüm veriler yazıldıktan sonra dosyanın uzunluğuna eşit olmalıdır ve isteğe eklenmiş bir istek varlığı gövdesi olmamalıdır.

retainUncommittedData
query
  • boolean

Yalnızca temizleme işlemleri için geçerlidir. "True" ise, kaydedilmemiş veriler temizleme işlemi tamamlandıktan sonra tutulur; Aksi takdirde, kaydedilmemiş veriler temizleme işleminden sonra silinir. Varsayılan değer false. Belirtilen konumdan daha az uzaklıklardan veriler, temizleme başarılı olduğunda dosyaya yazılır, ancak bu isteğe bağlı parametre, sonraki temizleme işlemi için Temizleme konumunun korunmasından sonraki verilere izin verir.

timeout
query
  • integer
int32

Saniyeler içinde isteğe bağlı bir işlem zaman aşımı değeri. Süre, istek hizmet tarafından alındığında başlar. Zaman aşımı değeri işlem tamamlanmadan önce geçtiğinde, işlem başarısız olur.

İstek Başlığı

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

Name Required Type Description
Content-Length
  • integer
int64

"Veri Ekle" ve "Verileri Boşalt" için gereklidir. "Verileri Boşalt" için 0 olması gerekir. "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 "Boşaltma" işlemleri için 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 belirtilirken, depolama hizmeti gelen içeriğin karması ile bu üst bilgi değerini karşılar. İki karma eşleşmezse, işlem 400 (Hatalı İstek) hata koduyla başarısız olur. Bu MD5 karması dosyasında depolanmaz. Bu üst bilgi, dosyanın depolanan içeriğiyle değil istek içeriğiyle ilişkilendirilmektedir.

x-ms-lease-id
  • string

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

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-cache-control
  • string

Temizleme ve ayarlama özellikleri işlemleri için isteğe bağlı ve yalnızca geçerlidir. Hizmet bu değeri depolar ve "Dosya Okuma" işlemleri için "Önbellek Denetimi" yanıt üst bilgisinde içerir.

x-ms-content-type
  • string

Temizleme ve ayarlama özellikleri işlemleri için isteğe bağlı ve yalnızca geçerlidir. Hizmet bu değeri depolar ve "Dosya Oku" işlemleri için "Content-Type" yanıt üst bilgisinde içerir.

x-ms-content-disposition
  • string

Temizleme ve ayarlama özellikleri işlemleri için isteğe bağlı ve yalnızca geçerlidir. Hizmet bu değeri depolar ve "Dosya Oku" işlemleri için "Content-Disposition" yanıt üst bilgisinde içerir.

x-ms-content-encoding
  • string

Temizleme ve ayarlama özellikleri işlemleri için isteğe bağlı ve yalnızca geçerlidir. Hizmet bu değeri depolar ve "Dosya Oku" işlemleri için "Content-Encoding" yanıt üst bilgisinde içerir.

x-ms-content-language
  • string

Temizleme ve ayarlama özellikleri işlemleri için isteğe bağlı ve yalnızca geçerlidir. Hizmet bu değeri depolar ve "Dosya Oku" işlemleri için "Content-Language" yanıt üst bilgisinde içerir.

x-ms-content-md5
  • string

İsteğe bağlı ve yalnızca "Özellikleri Boşaltma ve Ayarlama" işlemleri için geçerlidir. Hizmet bu değeri depolar ve "Read and Get Properties" işlemleri için "Content-Md5" yanıt üst bilgisinde içerir. bu özellik istekte belirtilmezse, dosya için özellik temiz olur. Sonraki "Okuma ve Özellikleri Al" çağrıları, bu dosyada açıkça yeniden ayarlanmazsa bu özelliği geri dönmez.

x-ms-properties
  • string

İsteğe bağlı. Dosya veya dizinle depolanması gereken kullanıcı tanımlı özellikler, her değerin base64 ile kodlanmış bir dize olduğu virgülle ayrılmış bir ad ve değer çiftleri listesi "n1=v1, n2=v2, ..." biçiminde depolanır. Dizenin yalnızca ISO-8859-1 karakter kümesinde ASCII karakterlerini içere olduğunu unutmayın. Yalnızca setProperties işlemi için geçerlidir. Dosya veya dizin varsa, listede yer alan ö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-Etiket'i alın, ardından E-Tag ile bir koşullu istekte bulunan ve tüm özelliklere değer ekleyin.

x-ms-owner
  • string

Yalnızca setAccessControl işlemi için isteğe bağlı ve geçerli. Dosyanın veya dizinin sahibini ayarlar.

x-ms-group
  • string

Yalnızca setAccessControl işlemi için isteğe bağlı ve geçerli. 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ştirilmişse geçerlidir. Dosya sahibi, dosya sahibi olan grup ve diğerleri için POSIX erişim izinlerini ayarlar. Her sınıfa okuma, yazma veya yürütme izni verilmiş olabilir. Yapışkan bit de de destekler. Hem sembolik (rwxrw-rw-) hem de 4 basamaklı sekizli nota (örneğin, 0766) de desteklene. x-ms-acl ile birlikte geçersiz.

x-ms-acl
  • string

Yalnızca setAccessControl ve setAccessControlRecursive işlemleri için isteğe bağlı ve geçerli. setAccessControlRecursive işlemi için gereklidir. Dosyalar ve dizinler üzerinde POSIX erişim denetimi haklarını ayarlar. değer, setAccessControl ve setAccessControlRecursive"setAccessControlRecursive modunda mevcut erişim denetim listesinin (ACL) yerini alan, erişim denetimi girişlerinin virgülle ayrılmış bir listesidir. setAccessControlRecursive'ın "değiştirme" modu, önceden var olan ACLS'leri ler. Her erişim denetimi girişi (ACE) kapsam, tür, kullanıcı veya grup tanımlayıcısı ve "[scope:][type]:[id]:[permissions]" biçimindeki 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ü olur ve ACE erişim ACL'sinde yer almaktadır. Dört ACE türü vardır: "kullanıcı", sahip veya adlandırılmış kullanıcıya haklar, "grup" sahip olan gruba veya adlandırılmış gruba haklar verdi, "maskele", adlandırılmış kullanıcılara ve grupların üyelerine verilen hakları kısıtlar ve "diğer", diğer girişlerden herhangi birsinde bulun olmayan tüm kullanıcılara haklar sağlar. Kullanıcı veya grup tanımlayıcısı "maske" ve "diğer" türüne sahip girişler için atlanır. Kullanıcı veya grup tanımlayıcısı, sahip ve sahip olan grup için de atlanır. İzin alanı, okuma erişimi vermek için ilk karakterin 'r', ikinci karakteri yazma erişimi vermek için 'w' ve üçüncü karakterin yürütme izni vermek için 'x' olduğu 3 karakterli bir dizidir. Erişim verilmezse, iznin reddedilir olduğunu ifade etmek için '-' karakteri kullanılır. Örneğin, aşağıdaki ACL dosya sahibine ve , sahip olan gruba okuma hakkı ve yürütme hakları ve diğer herkese okuma, yazma ve yürütme hakları john.doe@contoso sağlar: "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 belirtilen erişim denetim listesinde izinler içermemesi gerekir: " user:john.doe@contoso: , mask:". setAccessControlRecursive"set" modu, belirtilen kapsamın önceden var olan ACL'lerini değiştirerek ACL'leri ayarlar ve erişim kapsamı ayarlanıyorsa veya erişim kapsamı ayarlanıyorsa veya sahip olan grup veya diğer biri varsayılan kapsamda ayarlanıyorsa üçünü de içermesi gerekir. setAccessControlRecursive'ın "set" ve "modify" modları, erişim denetim listesinin bir parçası olarak izinleri içermeli.

If-Match
  • string

Verileri Boşaltma, KümeLeme ve Access Control için isteğe bağlı, ancak Veri Ekleme ve Küme Access Control için geçersiz. ETag değeri. Yalnızca kaynağın ETag değeri belirtilen değerle eşiliyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. ETag tırnak içinde belirtilmelidir.

If-None-Match
  • string

Verileri Boşaltma, KümeLeme ve Access Control için isteğe bağlı, ancak Veri Ekleme ve Küme Access Control 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şmezse işlemi gerçekleştirmek için bu üst bilgiyi belirtin. ETag tırnak içinde belirtilmelidir.

If-Modified-Since
  • string

Verileri Boşalt ve Özellikleri Ayarla için isteğe bağlı, ancak Veri Ekleme ve KümeLeme Access Control geçersiz. Tarih ve saat değeri. Yalnızca kaynak belirtilen tarih ve tarihten sonra değiştirilmişse işlemi gerçekleştirmek için bu üst bilgiyi belirtin.

If-Unmodified-Since
  • string

Verileri Boşalt ve Özellikleri Ayarla için isteğe bağlı, ancak Veri Ekleme ve KümeLeme Access Control geçersiz. Tarih ve saat değeri. Yalnızca kaynak belirtilen tarih ve tarihten sonra değiştirilmedi ise işlemi gerçekleştirmek için bu üst bilgiyi belirtin.

x-ms-client-request-id
  • string

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

Regex pattern: ^[{(]?[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ırken bu gereklidir.

x-ms-version
  • string

İsteği işleme için kullanılan REST protokolünün sürümünü belirtir. Bu, paylaşılan anahtar yetkilendirmesi kullanılırken gereklidir.

İstek Gövdesi

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

Name Type Description
requestBody
  • object

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

Yanıtlar

Name Type Description
200 OK

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

Headers

  • 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
202 Accepted

Karşıya yüklenen veriler kabul edildi.

Headers

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

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

  • 400 Hatalı Istek, ContentLengthMustBeZero, "Content-Length istek üst bilgisi sıfır olmalıdır."
  • 400 Hatalı Istek, ınvalidauthenticationınfo, "kimlik doğrulama bilgileri doğru biçimde verilmemiş. Yetkilendirme üst bilgisinin değerini denetleyin. "
  • 400 Hatalı Istek, ınvalidflushposition, "karşıya yüklenen veriler bitişik değil veya konum sorgusu parametre değeri karşıya yüklenen veriler eklendikten sonra dosyanın uzunluğuna eşit değil."
  • 400 Hatalı Istek, ınvalidheadervalue, "HTTP üst bilgilerinden birinin değeri doğru biçimde değil."
  • 400 Hatalı Istek, ınvalidhttpverb, "belirtilen HTTP fiili geçersiz-sunucu tarafından tanınmıyor."
  • 400 Hatalı Istek, ınvalidınput, "istek girişlerinden biri geçerli değil."
  • 400 Hatalı Istek, ınvalidpropertyname, "özellik adı boş olamaz."
  • 400 Hatalı Istek, ınvalidpropertyname, "özellik adı geçersiz karakterler içeriyor."
  • 400 istek URI 'sinde belirtilen sorgu parametrelerinden biri için hatalı Istek, InvalidQueryParameterValue, "değeri geçersiz."
  • 400 Hatalı Istek, ınvalidresourcename, "belirtilen kaynak adı geçersiz karakterler içeriyor."
  • 400 Hatalı Istek, ınvalidsourceuri, "Kaynak URI 'si geçersiz."
  • 400 Hatalı Istek, ınvaliduri, "istek URI 'SI geçersiz."
  • 400 Hatalı Istek, MissingRequiredHeader, "Bu istek için zorunlu olan bir HTTP üst bilgisi belirtilmemiş."
  • 400 Hatalı Istek, MissingRequiredQueryParameter, "Bu istek için zorunlu olan bir sorgu parametresi belirtilmemiş."
  • 400 Hatalı Istek, Çoğulconditionheadersnotsupported, "birden çok koşul üst bilgisi desteklenmiyor."
  • 400 Hatalı Istek, OutOfRangeInput, "istek girişlerinden biri Aralık dışında."
  • 400 Hatalı Istek, OutOfRangeQueryParameterValue, "istek URI 'sinde belirtilen sorgu parametrelerinden biri izin verilen aralığın dışında."
  • 400 Hatalı Istek, UnsupportedHeader, "istekte belirtilen üst bilgilerden biri desteklenmiyor."
  • 400 Hatalı Istek, UnsupportedQueryParameter, "istek URI 'sinde belirtilen sorgu parametrelerinden biri desteklenmiyor."
  • 400 Hatalı Istek, UnsupportedRestVersion, "belirtilen Rest sürümü desteklenmiyor."
  • 403 yasaklanmış, Accountıdısabled, "belirtilen hesap devre dışı."
  • 403 Yasak, AuthorizationFailure, "Bu istek bu işlemi gerçekleştirmek için yetkilendirilmemiş."
  • 403 Yasak, InsufficientAccountPermissions, "erişilmekte olan hesabın bu işlemi yürütmek için yeterli izni yok."
  • 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şlemi için kaynak yolu yok."
  • 405 yöntemine Izin verilmiyor, UnsupportedHttpVerb, "kaynak belirtilen HTTP fiilini desteklemiyor."
  • 409 çakışması, Destinationpathısbeingdeleted, "belirtilen hedef yolu silinmek üzere işaretlendi."
  • 409 çakışma, DirectoryNotEmpty, "boş olmayan bir dizini silmek için özyinelemeli sorgu parametresi değeri true olmalıdır."
  • 409 çakışması, "belirtilen dosya sistemi zaten var."
  • 409 çakışma, FilesystemBeingDeleted, "belirtilen dosya sistemi siliniyor."
  • 409 çakışma, ınvaliddestinationpath, "belirtilen yol veya yolun bir öğesi var ve bu işlem için kaynak türü geçersiz." * 409 çakışma, InvalidFlushOperation, "kaynak Blob hizmeti apı 'si tarafından oluşturuldu veya değiştirildi ve Data Lake Storage Service apı 'si tarafından yazılamıyor."
  • 409 çakışma, InvalidRenameSourcePath, "kaynak dizin hedef dizinle aynı olamaz, ya da hedef kaynak dizinin bir alt dizini olabilir."
  • 409 çakışma, ınvalidsourceordestinationresourcetype, "kaynak ve hedef kaynak türü özdeş olmalıdır."
  • 409 çakışma, Leasealreadypyeniden gönderildi, "zaten bir kira var."
  • 409 Conflict, Leaseıdmismatchwithleaseoperation, "belirtilen Kiralama KIMLIĞI, belirtilen kira işlemine sahip kaynağın kira KIMLIĞIYLE eşleşmedi."
  • 409 çakışma, Leaseısalready, "kira daha önce kesildi ve yeniden bölünemez."
  • 409 çakışma, Leaseisbreakingandcannotbealındı, "kira KIMLIĞI eşleşti, ancak kira Şu anda kesik durumda ve bozuk olana kadar elde edilemez."
  • 409 çakışma, LeaseIsBreakingAndCannotBeChanged, "kira KIMLIĞI eşleşti, ancak kira Şu anda kesme durumunda ve değiştirilemez."
  • 409 çakışma, Leaseisbrokenandcannotbereneçar, "kira KIMLIĞI eşleşti, ancak kira açıkça kesildi ve yenilenemiyor."
  • 409 çakışma, Anasenamematch, "belirtilen kira adı, var olan kira adı ile eşleşmedi."
  • 409 çakışma, Liasenotpresentwithleaseoperation, "belirtilen kira işleminde kira KIMLIĞI yok."
  • 409 çakışması, PathAlreadyExists, "belirtilen yol zaten var."
  • 409 Çakışma, 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şaretlendi."
  • 409 Çakışma, ResourceTypeMismatch, "İstekte belirtilen kaynak türü kaynağın türüyle eşle değil."
  • 412 Önkoşul Başarısız, ConditionNotMet, "HTTP koşullu üst bilgileri kullanılarak belirtilen koşul karşılanmaz."
  • 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, "Şu anda kaynakta kiralama var ve istekte kiralama kimliği belirtilmedi."
  • 412 Önkoşul Başarısız Oldu, LeaseNotPresent, "Şu anda kaynakta kiralama yok."
  • 412 Önkoşul Başarısız Oldu, LeaseLost, "Kiralama kimliği belirtildi, ancak kaynağın kiralama süresi doldu."
  • 412 Önkoşul Başarısız, SourceConditionNotMet, "HTTP koşullu üst bilgileri kullanılarak belirtilen kaynak koşul karşılanmaz."
  • 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 Uygun 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, "Egress sınırı aştı."
  • 503 Hizmet Kullanılamıyor, ServerBusy, "Giriş hesap sınırını aşıyor."
  • 503 Hizmet Kullanılamıyor, ServerBusy, "Saniye başına işlem sayısı hesap sınırını aşıyor."
  • 503 Hizmet Kullanılamıyor, Sunucuİşle, "Sunucu şu anda istekleri alamamaktadır. Lütfen isteğinizi yeniden deneyin."

Headers

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

Tanımlar

AclFailedEntryList
DataLakeStorageError
Error

Hizmet hatası yanıtı nesnesi.

PathUpdateAction

Bir dosyaya eklenecek verileri yüklemek için eylem "Append" olmalıdır, "bir dosya veya dizinin özelliklerini ayarlamak için" setProperties "veya bir dosya ya da dizin için sahip, Grup, izinler veya erişim denetim listesini ayarlamak için" setAccessControl "veya" setAccessControlRecursive "veya bir dizinin erişim denetim listesini özyinelemeli olarak ayarlamak için" SetAccessControl "adlı bir dosyaya daha önce karşıya yüklenen verileri temizlemek için temizleyin. Erişim denetimini kullanmak için, hesap için hiyerarşik ad alanının etkin olması gerektiğini unutmayın. Ayrıca, Access Control listesi (ACL) sahip, sahip olan grup ve diğer kullanıcılar için izinler içerdiğinden, x-MS-Permissions ve x-MS-ACL istek üst bilgilerinin birbirini dışlamalı olduğunu unutmayın.

SetAccessControlRecursiveResponse

AclFailedEntryList

Name Type Description
errorMessage
  • string
name
  • string
type
  • string

DataLakeStorageError

Name Type Description
error

Hizmet hatası yanıtı nesnesi.

Error

Hizmet hatası yanıtı nesnesi.

Name Type Description
code
  • string

Hizmet hata kodu.

message
  • string

Hizmet hata iletisi.

PathUpdateAction

Bir dosyaya eklenecek verileri yüklemek için eylem "Append" olmalıdır, "bir dosya veya dizinin özelliklerini ayarlamak için" setProperties "veya bir dosya ya da dizin için sahip, Grup, izinler veya erişim denetim listesini ayarlamak için" setAccessControl "veya" setAccessControlRecursive "veya bir dizinin erişim denetim listesini özyinelemeli olarak ayarlamak için" SetAccessControl "adlı bir dosyaya daha önce karşıya yüklenen verileri temizlemek için temizleyin. Erişim denetimini kullanmak için, hesap için hiyerarşik ad alanının etkin olması gerektiğini unutmayın. Ayrıca, Access Control listesi (ACL) sahip, sahip olan grup ve diğer kullanıcılar için izinler içerdiğinden, x-MS-Permissions ve x-MS-ACL istek üst bilgilerinin birbirini dışlamalı olduğunu unutmayın.

Name Type Description
append
  • string
flush
  • string
setAccessControl
  • string
setAccessControlRecursive
  • string
setProperties
  • string

SetAccessControlRecursiveResponse

Name Type Description
directoriesSuccessful
  • integer
failedEntries
failureCount
  • integer
filesSuccessful
  • integer