Aracılığıyla paylaş

Dosyayı Kopyalamayı Durdur

  • Makale

Abort Copy File işlemi bekleyen bir Copy File işlemini iptal eder ve hedef dosyayı sıfır uzunluk ve tam meta veriyle bırakır. Bu işlem, SMB protokolü etkinleştirilmiş Dosya Paylaşımları için 2015-02-21 ve sonraki sürümlerde ve 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 Evet
NFS Evet

İstek

Abort Copy File isteği aşağıdaki gibi oluşturulur. HTTPS kullanmanızı öneririz.

2013-08-15 sürümünden başlayarak, kaynak dosyayla aynı hesaptaysa hedef dosya için paylaşılan erişim imzası belirtebilirsiniz. 2015-04-05 sürümünden başlayarak, farklı bir depolama hesabındaysa hedef dosya için paylaşılan erişim imzası da belirtebilirsiniz.

Yöntem İstek URI'si HTTP sürümü
KOYMAK https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=copy&copyid=<id> 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 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 parametreyi 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, SMB protokolü etkinleştirilmiş Dosya Paylaşımları için 2015-02-21 ve sonraki sürümlerde ve 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-copy-action:abort Gerekli.
x-ms-lease-id:<ID> Hedef dosyanın etkin bir kirası varsa gereklidir. 2019-02-02 ve sonraki sürümlerde kullanılabilir.

Hedef 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 204 (İçerik Yok) 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.
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-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 1024 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

Hiç kimse.

Yanıt gövdesi

Hiç kimse.

İzin

Bu işlemi yalnızca hesap sahibi çağırabilir.

Açıklamalar

Bekleyen bir Copy File işlemini iptal ettiğinizde, hedef dosyanın x-ms-copy-status üst bilgisi abortedolarak ayarlanır. Kopyalama işleminin iptali, sıfır uzunlukta bir hedef dosyaya neden olur. Ancak hedef dosyanın meta verilerinde yeni değerler kaynak blobdan veya dosyadan kopyalanır veya Copy File işlem çağrısında açıkça ayarlanır.

Yalnızca bekleyen bir kopyalama işlemini iptal edebilirsiniz. Tamamlanmış veya başarısız olan bir kopyayı iptal etmeye çalışmak çakışma hatasına neden olur. Yanlış bir kopyalama kimliği kullanarak kopyalama işlemini iptal etmeye çalışmak da çakışma hatasına neden olur.

Ayrıca bkz.

dosyalarda İşlemleri