Dosyayı Yeniden Adlandır

Makale
08/07/2024

Rename File işlemi 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ü	Mevcut
SMB
NFS	Yok

İstek

Rename File isteğini aşağıdaki gibi oluşturabilirsiniz. HTTPS önerilir.

Yöntem	İstek URI'si	HTTP sürümü
KOYMAK	`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	Açıklama
`myaccount`	Depolama hesabınızın adı.
`myshare`	Dosya paylaşımınızın adı.
`mydirectorypath`	Opsiyonel. Ü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 verileriadlandırma ve başvurma.

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreyi belirtebilirsiniz.

Parametre	Açıklama
`timeout`	Opsiyonel. `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`	Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme .
`Date` veya `x-ms-date`	Gerekli. İstek için Eşgüdümlü Evrensel Saati (UTC) belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri 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`	Gerekli. Yeniden adlandırılacak dosyanın tam URI'sini.
`x-ms-file-rename-replace-if-exists`	Opsiyonel. Hedef dosya zaten varsa, dosyanın üzerine yazın.
`x-ms-file-rename-ignore-readonly`	Opsiyonel. Hedef dosya `readonly` özniteliğiyle varsa, dosyanın üzerine yazın. True ise, `x-ms-file-rename-replace-if-exists` de doğru olmalıdır.
`x-ms-content-Type`	Opsiyonel. Dosyanın içerik türünü ayarlar. Bu özellik istekte belirtilmezse, özellik dosya için korunur.
`x-ms-file-permission: { preserve ¦ <SDDL> ¦ <binary> }`	`x-ms-file-permission-key` belirtilmezse isteğe bağlı. Bu izin, base64 ile kodlanmış ikili güvenlik tanımlayıcısı biçiminde Güvenlik Tanımlayıcısı Tanım Dili (SDDL) veya (sürüm 2024-11-04 veya üzeri) içinde belirtilen dosyanın güvenlik tanımlayıcısıdır. `x-ms-file-permission-format` üst bilgisi ile hangi biçimin kullanılacağını belirtebilirsiniz. İzin boyutu 8 kibibayt (KiB) veya daha azsa bu üst bilgiyi kullanabilirsiniz. Aksi takdirde, `x-ms-file-permission-key`kullanabilirsiniz. Belirtilirse, bu iznin sahip, grup ve isteğe bağlı erişim denetimi listesiolmalıdır. Mevcut bir değeri değişmeden tutmak istiyorsanız `preserve` değerini geçirebilirsiniz. her ikisini de değil, `x-ms-file-permission` veya `x-ms-file-permission-key`belirtebileceğinizi unutmayın.
`x-ms-file-permission-format: { sddl ¦ binary }`	Opsiyonel. Sürüm 2024-11-04 veya üzeri. `x-ms-file-permission` geçirilen değerin SDDL'de mi yoksa ikili biçimde mi olduğunu belirtir. `x-ms-file-permission-key` `preserve`olarak ayarlandıysa, bu üst bilgi ayarlanmamalıdır. `x-ms-file-permission-key` `preserve`dışında bir değere ayarlanırsa ve bu üst bilgi ayarlanmadıysa varsayılan `sddl` değeri kullanılır.
`x-ms-file-permission-key`	`x-ms-file-permission` belirtilmezse isteğe bağlı. Dosya için ayarlanacak iznin anahtarı. `Create-Permission` API'sini kullanarak bunu oluşturabilirsiniz. her ikisini de değil, `x-ms-file-permission` veya `x-ms-file-permission-key`belirtebileceğinizi unutmayın.
`x-ms-file-attributes`	Opsiyonel. Dosyada ayarlanacak dosya sistemi öznitelikleri. kullanılabilir özniteliklerin listesine bakın. Mevcut bir değeri değişmeden tutmak istiyorsanız `preserve` değerini geçirebilirsiniz. İstekte bu özelliği belirtmezseniz, özellik dosya için korunur.
`x-ms-file-creation-time`	Opsiyonel. Bir dosyanın UTC oluşturma zamanı özelliği. Mevcut bir değeri değişmeden tutmak istiyorsanız `preserve` değerini geçirebilirsiniz. İstekte bu özelliği belirtmezseniz, özellik dosya için korunur.
`x-ms-file-last-write-time`	Opsiyonel. Bir dosyanın UTC son yazma özelliği. Mevcut bir değeri değişmeden tutmak istiyorsanız `preserve` 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`	Opsiyonel. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibayt (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. azure blob depolamaizleme .
`x-ms-meta-name:value`	Opsiyonel. 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`	`Authorization` üst bilgisi bir OAuth belirteci belirtiyorsa gereklidir. Kabul edilebilir değer `backup`. Bu üst bilgi, `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` veya `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action`, `Authorization` üst bilgisi kullanılarak yetkilendirilmiş kimliğe atanan RBAC ilkesine eklenmişse verilmesi gerektiğini belirtir. Sürüm 2022-11-02 ve üzeri için kullanılabilir.
`x-ms-allow-trailing-dot: { <Boolean> }`	Opsiyonel. Sürüm 2022-11-02 ve üzeri. Boole değeri, istek URL'sinde bulunan 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 verileriadlandırma ve başvurma.
`x-ms-source-allow-trailing-dot: { <Boolean> }`	Opsiyonel. Sürüm 2022-11-02 ve üzeri. Boole değeri, kaynak URL'de bulunan sondaki 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 verileriadlandırma ve başvurma.

İstek gövdesi

Hiç kimse.

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.

Durum kodu

Başarılı bir işlem 200 durum kodunu döndürür (Tamam). 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 bilgilerHTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi	Açıklama
`ETag`	Tırnak içinde dosyanın sürümünü temsil eden bir değer içerir.
`Last-Modified`	Dosyanın en son değiştirildiği tarih 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ştirme zamanını etkilemez.
`x-ms-request-id`	Yapılan isteği benzersiz olarak tanımlar ve istek sorunlarını 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 `true` olarak ayarlanır. Aksi takdirde, değeri `false`olarak 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 zamanı özelliğini temsil eden UTC tarihi/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`	İsteklerde ve ilgili yanıtlarda sorun gidermek için kullanılabilir. bu üst bilginin değeri, istekte varsa `x-ms-client-request-id` üst bilgisinin değerine eşittir. Değer en fazla 1.024 görünür ASCII karakterdir. İstekte `x-ms-client-request-id` üst bilgisi yoksa yanıtta bulunmaz.

Yanıt gövdesi

Hiç kimse.

İzin

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	Başka öznitelikleri ayarlı 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	Bir 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, preserve veya now varsayılan davranışı ayarlanır.

Not

Önceki dosya özellikleri, SMB istemcileri tarafından kullanılabilen dosya sistemi özelliklerinden ayrıdır. SMB istemcileri bu özellik değerlerini okuyamaz, yazamaz veya değiştiremez.

Rename File, paylaşımın salt okunur bir 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 bir 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(Önkoşul Başarısız) döndürür. İstemci bir kira kimliği belirtiyorsa ancak dosyanın etkin bir kirası yoksa, Azure Dosyalar durum kodu 412'yi de döndürür (Önkoşul Başarısız oldu).

Ayrıca bkz.

dosyalarda İşlemleri

Aracılığıyla paylaş