Dosya Sil
Delete File işlemi dosyayı depolama hesabından hemen kaldırır. Bu işlem, NFS protokolü etkinleştirilmiş Dosya Paylaşımları için 2025-05-05 ve sonraki sürümlerde desteklenir.
Protokol kullanılabilirliği
| Etkin dosya paylaşımı protokolü | Mevcut |
|---|---|
| SMB |
|
| NFS |
|
İstek
Delete File isteği aşağıdaki gibi oluşturulur. HTTPS kullanmanızı öneririz.
| Yöntem | İstek URI'si | HTTP sürümü |
|---|---|---|
| SİLMEK | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
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ı. |
myparentdirectorypath |
Opsiyonel. Üst dizinin yolu. |
myfile |
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 parametreleri belirtebilirsiniz.
| Parametre | Açıklama |
|---|---|
timeout |
Opsiyonel. Zaman aşımı 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
Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tablolarda açıklanmıştır:
Ortak istek üst bilgileri
| İstek üst bilgisi | Açıklama |
|---|---|
Authorization |
Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolama istekleri 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 depolama istekleri yetkilendirme. |
x-ms-version |
Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Bu işlem, NFS protokolü etkinleştirilmiş Dosya Paylaşımları için 2025-05-05 ve sonraki sürümlerde desteklenir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma. |
x-ms-lease-id:<ID> |
Dosyanın etkin bir kirası varsa gereklidir. 2019-02-02 ve sonraki sürümlerde kullanılabilir. Dosya, dosya kiralamalarını desteklemeyen NFS protokolü etkinleştirilmiş bir Dosya Paylaşımında bulunuyorsa bu üst bilgi yoksayılır. |
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 dosyaları izleme. |
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. Hedef, varsayılan olarak sondaki noktayı destekleyen NFS protokolü etkinleştirilmiş bir Dosya Paylaşımında bulunuyorsa bu üst bilgi yoksayılır. Daha fazla bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileriadlandırma ve başvurma. |
Yalnızca SMB istek üst bilgileri
Hiç kimse.
Yalnızca NFS istek üst bilgileri
Hiç kimse.
İ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 202 (Kabul Edildi) 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 tablolardaki ü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.
Ortak yanıt üst bilgileri
| Yanıt üst bilgisi | Açıklama |
|---|---|
x-ms-request-id |
Bu üst bilgi, yapılan isteği benzersiz olarak tanımlar ve isteğin 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 |
Yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri. Hizmet bu değeri oluşturur. |
x-ms-client-request-id |
İstekler ve karşılık gelen yanıtlarla ilgili sorunları gidermek için bu üst bilgiyi kullanabilirsiniz. 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 bu üst bilgi bulunmaz. |
Yalnızca SMB yanıt üst bilgileri
Hiç kimse.
Yalnızca NFS yanıt üst bilgileri
| Yanıt üst bilgisi | Açıklama |
|---|---|
x-ms-link-count |
Sürüm 2025-05-05 ve üzeri. Dosyanın yeni bağlantı sayısı. |
Yanıt gövdesi
Hiç kimse.
İzin
Bu işlemi yalnızca hesap sahibi çağırabilir.
Açıklamalar
Bir dosyayı başarıyla sildiğinizde, dosya depolama hesabının dizininden hemen kaldırılır ve artık erişilebilir olmaz.
Dosyanın etkin bir kirası varsa, istemcinin dosyayı silmek için istekte geçerli bir kira kimliği belirtmesi gerekir.
Dosya bir SMB istemcisinde açıksa Delete File durum kodu 409 (Çakışma) ve hata kodu SharingViolationile başarısız olur. Dosya bir NFS istemcisinde açıksa, Delete File başarılı olur ve dosya açık dosya tutamacının son kapanışıyla silinir.
Delete 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 400 (Geçersiz Sorgu Parametresi Değeri) hatasını döndürür.
Ayrıca bkz.
Dosyalarda İşlemleri