Dosyayı Yeniden Adlandır
İşlem Rename File
bir dosyayı yeniden adlandırır ve isteğe bağlı olarak dosya için sistem özelliklerini ayarlayabilir. Bu API 2021-04-10 ve sonraki sürümlerde kullanılabilir.
Protokol kullanılabilirliği
Etkin dosya paylaşımı protokolü | Kullanılabilir |
---|---|
SMB | |
NFS |
İstek
İsteği aşağıdaki gibi oluşturabilirsiniz Rename File
. HTTPS önerilir.
Yöntem | İstek URI'si | HTTP sürümü |
---|---|---|
PUT | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rename |
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ı. |
mydirectorypath |
İsteğe bağlı. Üst hedef dizinin yolu. |
myfile |
Hedef dosyanın adı. |
Yol adlandırma kısıtlamaları hakkında ayrıntılı bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileri adlandırma ve buna başvurma.
URI parametreleri
İstek URI'sinde aşağıdaki ek parametreyi belirtebilirsiniz.
Parametre | Açıklama |
---|---|
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
Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadı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 isteklerini 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 isteklerini yetkilendirme. |
x-ms-version |
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-file-rename-source:name |
Gereklidir. Yeniden adlandırılacak dosyanın tam URI'sini seçin. |
x-ms-file-rename-replace-if-exists |
İsteğe bağlı. Hedef dosya zaten varsa, dosyanın üzerine yazın. |
x-ms-file-rename-ignore-readonly |
İsteğe bağlı. Hedef dosya özniteliğiyle readonly birlikte varsa, dosyanın üzerine yazın.True ise, x-ms-file-rename-replace-if-exists aynı zamanda doğru olmalıdır. |
x-ms-content-Type |
İsteğe bağlı. Dosyanın içerik türünü ayarlar. Bu özellik istekte belirtilmezse, dosya için özellik korunur. |
x-ms-file-permission |
Belirtilmezse x-ms-file-permission-key isteğe bağlı. Bu izin, Güvenlik Tanımlayıcısı Tanım Dili'nde (SDDL) belirtilen dosyanın güvenlik tanımlayıcısıdır. İzin boyutu 8 kibibayt (KiB) veya daha azsa bu üst bilgiyi kullanabilirsiniz. Aksi takdirde kullanabilirsiniz x-ms-file-permission-key . Belirtilirse, bu iznin sahip, grup ve isteğe bağlı erişim denetim listesi olmalıdır. Mevcut bir değeri preserve değişmeden tutmak istiyorsanız değerini geçirebilirsiniz.Her ikisini birden x-ms-file-permission değil veya x-ms-file-permission-key belirtebileceğinizi unutmayın. |
x-ms-file-permission-key |
Belirtilmezse x-ms-file-permission isteğe bağlı. Dosya için ayarlanacak iznin anahtarı. Api'yi kullanarak Create-Permission bunu oluşturabilirsiniz.Her ikisini birden x-ms-file-permission değil veya x-ms-file-permission-key belirtebileceğinizi unutmayın. |
x-ms-file-attributes |
İsteğe bağlı. Dosyada ayarlanacak dosya sistemi öznitelikleri.
Kullanılabilir özniteliklerin listesine bakın. Mevcut bir değeri preserve değişmeden tutmak istiyorsanız değerini geçirebilirsiniz. İstekte bu özelliği belirtmezseniz, özellik dosya için korunur. |
x-ms-file-creation-time |
İsteğe bağlı. Bir dosyanın UTC oluşturma zamanı özelliği. Mevcut bir değeri preserve değişmeden tutmak istiyorsanız değerini geçirebilirsiniz. İstekte bu özelliği belirtmezseniz, özellik dosya için korunur. |
x-ms-file-last-write-time |
İsteğe bağlı. Bir dosyanın UTC son yazma özelliği. Mevcut bir değeri preserve değişmeden tutmak istiyorsanız değerini geçirebilirsiniz. İstekte bu özelliği belirtmezseniz, özellik dosya için korunur. |
x-ms-source-lease-id:<ID> |
Kaynak dosyanın etkin bir kirası varsa gereklidir. |
x-ms-destination-lease-id:<ID> |
Hedef dosyanın etkin bir kirası varsa gereklidir. |
x-ms-client-request-id |
İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (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 Blob Depolama. |
x-ms-meta-name:value |
İsteğe bağlı. Dosya için bir ad-değer çifti ayarlar. Bu işleme yapılan her çağrı, dosyaya eklenmiş olan tüm meta verilerin yerini alır. Meta veri adları , C# tanımlayıcıları için adlandırma kurallarına uymalıdır. |
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 Authorization yetkilendirilen Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action kimliğe atanan RBAC ilkesine eklenmişse veya Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action izni verilmesi gerektiğini belirtir. 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. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
İsteğe bağlı. Sürüm 2022-11-02 ve üzeri. Boole değeri, kaynak URL'de bulunan bir noktanın kırpılıp kırpılmaması gerektiğini belirtir. Bu üst bilgi yalnızca kopyalama kaynağı bir Azure Dosyası ise belirtilmelidir. Bu üst bilgi başka bir kopyalama kaynağı türü için desteklenmez. Daha fazla bilgi için bkz . Paylaşımları, dizinleri, dosyaları ve meta verileri adlandırma ve buna başvurma. |
İstek gövdesi
Yok.
Yanıt
Yanıt bir HTTP durum kodu ve yanıt üst bilgileri kümesi içerir.
Durum kodu
Başarılı bir işlem 200 (Tamam) durum kodunu döndürür. Durum kodları hakkında 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 |
Tırnak içinde dosyanın sürümünü temsil eden bir değer içerir. |
Last-Modified |
Dosyanın son değiştirildiği tarihi ve saati döndürür. Daha fazla bilgi için bkz. Üst bilgilerde tarih-saat değerlerinin gösterimi. Dizini veya özelliklerini değiştiren tüm işlemler son değiştirme zamanını güncelleştirir. Dosyalardaki işlemler dizinin son değiştirilme zamanını etkilemez. |
x-ms-request-id |
Yapılan isteği benzersiz olarak tanımlar ve istekle ilgili sorunları gidermek için kullanılabilir. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme. |
x-ms-version |
İsteği çalıştırmak için kullanılan Azure Dosyalar sürümünü gösterir. |
Date veya x-ms-date |
Yanıtın başlatıldığı saati gösteren utc tarih/saat değeri. Hizmet bu değeri oluşturur. |
x-ms-request-server-encrypted: true/false |
İsteğin içeriği belirtilen algoritma kullanılarak başarıyla şifrelenirse bu üst bilginin değeri olarak ayarlanır true . Aksi takdirde, değer olarak false ayarlanır. |
x-ms-file-permission-key |
Dosyanın izninin anahtarı. |
x-ms-file-attributes |
Dosyadaki dosya sistemi öznitelikleri. Kullanılabilir özniteliklerin listesine bakın. |
x-ms-file-creation-time |
Dosyanın oluşturma zamanı özelliğini temsil eden UTC tarih/saat değeri. |
x-ms-file-last-write-time |
Dosyanın son yazma zamanı özelliğini temsil eden UTC tarih/saat değeri. |
x-ms-file-change-time |
Dosyanın değişiklik saati özelliğini temsil eden UTC tarih/saati. |
x-ms-file-file-id |
Dosyanın dosya kimliği. |
x-ms-file-parent-id |
Dosyanın üst dosya kimliği. |
x-ms-client-request-id |
İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa üst bilginin değerine x-ms-client-request-id eşittir. Değer en fazla 1.024 görünür ASCII karakterdir.
x-ms-client-request-id Üst bilgi istekte yoksa yanıtta bulunmaz. |
Yanıt gövdesi
Yok.
Yetkilendirme
Bu işlemi yalnızca hesap sahibi çağırabilir.
Dosya sistemi öznitelikleri
Öznitelik | Win32 dosya özniteliği | Tanım |
---|---|---|
ReadOnly |
FILE_ATTRIBUTE_READONLY | Salt okunur bir dosya. Uygulamalar dosyayı okuyabilir, ancak dosyaya yazamaz veya silemez. |
Hidden |
FILE_ATTRIBUTE_HIDDEN | Dosya gizlidir. Sıradan bir dizin listesine dahil değildir. |
System |
FILE_ATTRIBUTE_SYSTEM | İşletim sisteminin bir kısmını kullandığı veya özel olarak kullandığı bir dosya. |
None |
FILE_ATTRIBUTE_NORMAL | Ayarlanmış başka öznitelikleri olmayan bir dosya. Bu öznitelik yalnızca tek başına kullanıldığında geçerlidir. |
Archive |
FILE_ATTRIBUTE_ARCHIVE | Arşiv dosyası olan bir dosya. Uygulamalar genellikle dosyaları yedekleme veya kaldırma amacıyla işaretlemek için bu özniteliği kullanır. |
Temporary |
FILE_ATTRIBUTE_TEMPORARY | Geçici depolama için kullanılan bir dosya. |
Offline |
FILE_ATTRIBUTE_OFFLINE | Dosyanın verileri hemen kullanılamaz. Bu dosya sistemi özniteliği öncelikle Windows ile uyumluluk sağlamak için sunulur. Azure Dosyalar çevrimdışı depolama seçeneklerini desteklemez. |
NotContentIndexed |
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Dosya, içerik dizin oluşturma hizmeti tarafından dizine alınamaz. |
NoScrubData |
FILE_ATTRIBUTE_NO_SCRUB_DATA | Kullanıcı veri akışı, arka plan veri bütünlüğü tarayıcısı tarafından okunamaz. Bu dosya sistemi özniteliği öncelikle Windows ile uyumluluk sağlamak için sunulur. |
Açıklamalar
Hedef mevcut bir dizin olamaz.
Özellikleri belirtmezseniz veya now
varsayılan davranışı preserve
ayarlanır.
Not
Önceki dosya özellikleri, SMB istemcilerinin kullanabileceği dosya sistemi özelliklerinden ayrıdır. SMB istemcileri bu özellik değerlerini okuyamaz, yazamaz veya değiştiremez.
Rename File
bir paylaşımın salt okunur kopyası olan paylaşım anlık görüntüsünde desteklenmez. Bu işlemi bir paylaşım anlık görüntüsünde gerçekleştirmeye çalışırsanız, hizmet hata durumu 400 (Geçersiz Sorgu Parametresi Değeri) döndürür.
Dosyanın etkin kirası varsa, istemcinin dosyayı yeniden adlandırmak için istekte geçerli bir kira kimliği belirtmesi gerekir. İstemci bir kira kimliği belirtmezse veya geçersiz bir kira kimliği belirtirse, Azure Dosyalar durum kodu 412 'yi döndürür (Önkoşul Başarısız oldu). İstemci bir kira kimliği belirtiyorsa ancak dosyanın etkin kiralaması yoksa Azure Dosyalar durum kodu 412 'yi de döndürür (Önkoşul Başarısız oldu).