Path - Create
Dosya Oluştur | Dizin Oluşturma | Dosyayı Yeniden Adlandır | Dizini Yeniden Adlandır
Bir dosya veya dizin oluşturun veya yeniden adlandırın. Varsayılan olarak, hedefin üzerine yazılır ve hedef zaten varsa ve kira varsa kira bozulur. Kaynak kapsayıcının da eşleşen zorunlu bir kapsayıcı şifreleme ilkesi olmadığı sürece, bir dosya veya dizini zorunlu kapsayıcı şifreleme ilkesiyle bir kapsayıcıya yeniden adlandırmaya izin verilmediğini lütfen unutmayın. Bu işlem koşullu HTTP isteklerini destekler. Daha fazla bilgi için bkz. Blob Hizmeti İşlemleri için Koşullu Üst Bilgiler Belirtme. Hedef zaten varsa başarısız olmak için If-None-Match: "*" ile bir koşullu istek kullanın.
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&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ı. Normal ifade deseni: |
path
|
path | True |
string |
Dosya veya dizin yolu. |
continuation
|
query |
string |
İsteğe bağlı. Bir dizini yeniden adlandırırken, her çağrıyla yeniden adlandırılan yol sayısı sınırlıdır. Yeniden adlandırılacak yol sayısı bu sınırı aşarsa, bu yanıt üst bilgisinde bir devamlılık belirteci döndürülür. Yanıtta bir devamlılık belirteci döndürüldüğünde, dizini yeniden adlandırmaya devam etmek için yeniden adlandırma işleminin sonraki çağrısında belirtilmesi gerekir. |
|
mode
|
query |
İsteğe bağlı. Yalnızca ad alanı etkinleştirildiğinde geçerlidir. Bu parametre, yeniden adlandırma işleminin davranışını belirler. Değerin "legacy" veya "posix" olması ve varsayılan değerin "posix" olması gerekir. |
||
resource
|
query |
Yalnızca Dosya Oluştur ve Dizin Oluştur için gereklidir. Değer "file" veya "directory" olmalıdır. |
||
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"
Name | Gerekli | Tür | Description |
---|---|---|---|
Cache-Control |
string |
İsteğe bağlı. Hizmet bu değeri depolar ve "Dosyayı Okuma" işlemleri için "Dosyayı Okuma" işlemleri için "Önbellek Denetimi" yanıt üst bilgisine ekler. |
|
Content-Encoding |
string |
İsteğe bağlı. Dosyaya hangi içerik kodlamalarının uygulandığını belirtir. "Dosyayı Okuma" işlemi gerçekleştirildiğinde bu değer istemciye döndürülür. |
|
Content-Language |
string |
İsteğe bağlı. Hedef kitle tarafından dosya için kullanılan doğal dili belirtir. |
|
Content-Disposition |
string |
İsteğe bağlı. Hizmet bu değeri depolar ve "Dosyayı Okuma" işlemleri için "Content-Disposition" yanıt üst bilgisine ekler. |
|
x-ms-cache-control |
string |
İsteğe bağlı. 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ı. Hizmet bu değeri depolar ve "Dosyayı Okuma" işlemleri için "Content-Type" yanıt üst bilgisine ekler. |
|
x-ms-content-encoding |
string |
İsteğe bağlı. Hizmet bu değeri depolar ve "Dosyayı Okuma" işlemleri için "Content-Encoding" yanıt üst bilgisine ekler. |
|
x-ms-content-language |
string |
İsteğe bağlı. Hizmet bu değeri depolar ve "Dosya Okuma" işlemleri için "content-language" yanıt üst bilgisine ekler. |
|
x-ms-content-disposition |
string |
İsteğe bağlı. Hizmet bu değeri depolar ve "Dosyayı Okuma" işlemleri için "Content-Disposition" yanıt üst bilgisine ekler. |
|
x-ms-rename-source |
string |
Yeniden adlandırılacak isteğe bağlı bir dosya veya dizin. Değerin şu biçimi olmalıdır: SAS belirteci kullanılırken "/{filesystem}/{path}" veya "/{filesystem}/{path}?sastoken". "x-ms-properties" belirtilirse, özellikler varolan özelliklerin üzerine yazar; aksi takdirde, mevcut özellikler korunur. Bu değer, yüzde url ile kodlanmış bir dize olmalıdır. Dizenin yalnızca ISO-8859-1 karakter kümesinde ASCII karakterler içerebileceğini unutmayın. |
|
x-ms-lease-id |
string |
İsteğe bağlı. URI'de belirtilen yol için kira kimliği. Üzerine yazılacak yolun etkin bir kirası olmalı ve kira kimliği eşleşmelidir. Normal ifade deseni: |
|
x-ms-source-lease-id |
string |
Yeniden adlandırma işlemleri için isteğe bağlı. Kaynak yol için kira kimliği. Kaynak yolun etkin bir kirası olmalı ve kira kimliği eşleşmelidir. Normal ifade deseni: |
|
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 ve burada her değer base64 ile kodlanmış bir dizedir. Dizenin yalnızca ISO-8859-1 karakter kümesinde ASCII karakterler içerebileceğini unutmayın. |
|
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ğer kategori için yürütme bitinin sırasıyla ayarlanıp ayarlanmadığına bağlı olarak son karakter konumunda t veya T harfiyle gösterilir (örneğin, yapışkan bitli rwxrw-rwT, rwxrw-rwT olarak 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-umask |
string |
İsteğe bağlı ve yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiyse geçerlidir. Bir dosya veya dizin oluştururken ve üst klasör varsayılan ACL'ye sahip olmadığında, umask oluşturulacak dosya veya dizinin izinlerini kısıtlar. Sonuçta elde edilen izin p & ^u tarafından verilir; burada p, izin ve siz umask'tır. Örneğin, p 0777 ve siz 0057 ise, sonuçta elde edilen izin 0720 olur. Varsayılan izin, bir dizin için 0777 ve dosya için 0666'dır. Varsayılan umask değeri 0027'dir. Umask, 4 basamaklı sekizli gösteriminde (örneğin 0766) belirtilmelidir. |
|
x-ms-owner |
string |
İsteğe bağlı ve yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiyse geçerlidir. Dosya veya dizinin sahibini ayarlar. |
|
x-ms-group |
string |
İsteğe bağlı ve yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiyse geçerlidir. Dosya veya dizinin sahip olan grubunu ayarlar. |
|
x-ms-acl |
string |
İsteğe bağlı ve yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiyse geçerlidir. Dosya ve dizinlerde POSIX erişim denetimi haklarını ayarlar. Her erişim denetimi girdisi (ACE), bir kapsam, tür, kullanıcı veya grup tanımlayıcısı ve "[kapsam:][tür]:[id]:[izinler]" 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ük olur 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 hak 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. 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' 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 sahibi ve john.doe@contoso okuma, yazma ve yürütme haklarını, sahip olan grubun okuma hakkını ve diğer herkese hiçbir şey vermemektedir: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". x-ms-permissions ile birlikte geçersiz. |
|
x-ms-proposed-lease-id |
string |
İsteğe bağlı. Bir dosya veya dizin oluşturulurken kiralama almak istiyorsanız önerilen kira kimliğini belirtin. Oluşturma başarılı olursa, bu kira kimliğiyle bir kira alınır. Normal ifade deseni: |
|
x-ms-expiry-option |
string |
İsteğe bağlı ve yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiyse ve yalnızca dosyalarda destekleniyorsa geçerlidir. Oluşturma sırasında bir dosyada süre sonu süresini ayarlamak istiyorsanız aşağıdaki süre sonu seçeneğinden birini belirtin. "RelativeToNow" Süre sonunu geçerli saate göre ayarlayın. Kullanıcı bundan sonra geçen milisaniye sayısını geçirir. RFC 1123 Biçiminde "Mutlak" Mutlak süre. "Neverexpire" Dosyayı hiçbir zaman sona ermeyecek şekilde ayarlayın, süre sonu süresinin bu seçenekle belirtilmesi gerekmez. |
|
x-ms-expiry-time |
string |
İsteğe bağlı ve yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiyse ve yalnızca dosyalarda destekleniyorsa geçerlidir. Dosyanın süresinin ne zaman dolacağını belirtin. RFC 1123 HTTP Zaman Dizesi veya süre sonu seçeneğine göre milisaniye sayısı olarak verilir. |
|
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-source-if-match |
string |
İsteğe bağlı. ETag değeri. Yeniden adlandırma işlemini 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. |
|
x-ms-source-if-none-match |
string |
İsteğe bağlı. ETag değeri veya özel joker karakter ("*") değeri. Yeniden adlandırma işlemini yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa gerçekleştirmek için bu üst bilgiyi belirtin. ETag tırnak içinde belirtilmelidir. |
|
x-ms-source-if-modified-since |
string |
İsteğe bağlı. Tarih ve saat değeri. Yeniden adlandırma işlemini yalnızca kaynak belirtilen tarih ve saatten sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi belirtin. |
|
x-ms-source-if-unmodified-since |
string |
İsteğe bağlı. Tarih ve saat değeri. Yeniden adlandırma işlemini yalnızca kaynak belirtilen tarih ve saatten sonra değiştirilmemişse 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-encryption-context |
string |
İsteğe bağlı. Varsayılan değer "Boş" şeklindedir. Değer ayarlanırsa Blob / Dosya sistemi meta verileri ayarlanır. Maksimum uzunluk- 1024. Yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiğinde geçerlidir. |
|
x-ms-client-request-id |
string |
Sorun giderme ve bağıntı için analiz günlüklerine kaydedilmiş bir UUID. Normal ifade deseni: |
|
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. |
Yanıtlar
Name | Tür | Description |
---|---|---|
201 Created |
Dosya veya dizin oluşturuldu. Üst Bilgiler
|
|
Other Status Codes |
Bir hata oluşmuştur. Olası HTTP durumu, kodu ve ileti dizeleri aşağıda listelenmiştir:
Üst Bilgiler
|
Tanımlar
Name | Description |
---|---|
Data |
|
Error |
Hizmet hatası yanıt nesnesi. |
Path |
İsteğe bağlı. Yalnızca ad alanı etkinleştirildiğinde geçerlidir. Bu parametre, yeniden adlandırma işleminin davranışını belirler. Değer "eski" veya "posix" ve varsayılan değer de "posix" olmalıdır. |
Path |
Yalnızca Dosya Oluştur ve Dizin Oluştur için gereklidir. Değer "file" veya "directory" olmalıdı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. |
PathRenameMode
İsteğe bağlı. Yalnızca ad alanı etkinleştirildiğinde geçerlidir. Bu parametre, yeniden adlandırma işleminin davranışını belirler. Değer "eski" veya "posix" ve varsayılan değer de "posix" olmalıdır.
Name | Tür | Description |
---|---|---|
legacy |
string |
|
posix |
string |
PathResourceType
Yalnızca Dosya Oluştur ve Dizin Oluştur için gereklidir. Değer "file" veya "directory" olmalıdır.
Name | Tür | Description |
---|---|---|
directory |
string |
|
file |
string |