Paylaşımı Sil

İşlem belirtilen Delete Share paylaşım veya paylaşım anlık görüntüsünü siler. Bu API tam olarak desteklenir, ancak bunun eski bir yönetim API'si olduğunu unutmayın.

Bunun yerine Dosya Paylaşımları - Sil'i kullanmak iyi bir fikirdir. Depolama kaynak sağlayıcısı (Microsoft.Storage) tarafından sağlanır. Depolama kaynak sağlayıcısını kullanarak kaynaklarla FileShare program aracılığıyla etkileşim kurma hakkında daha fazla bilgi edinmek için bkz. Dosya Paylaşımlarında İşlemler.

Protokol kullanılabilirliği

Etkin dosya paylaşımı protokolü Kullanılabilir
SMB Evet
NFS Yes

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Delete Share . HTTPS önerilir.

Yöntem İstek URI'si HTTP sürümü
DELETE https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
DELETE https://myaccount.file.core.windows.net/myshare?sharesnapshot=<DateTime>&restype=share 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ı.

Yol adlandırma kısıtlamalarıyla ilgili ayrıntılar 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 parametreleri belirtebilirsiniz.

Parametre Açıklama
sharesnapshot İsteğe bağlı. Sürüm 2017-04-17 ve üzeri. sharesnapshot parametresi, mevcut olduğunda silinecek paylaşım anlık görüntüsünü belirten opak DateTime bir değerdir.
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'ya istekleri 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'ya 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. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
x-ms-delete-snapshots: { include, include-leased } Paylaşımda ilişkili anlık görüntüler varsa isteğe bağlı. Aşağıdaki seçeneklerden birini belirtin:
  • include: Temel paylaşımı ve tüm anlık görüntülerini silin.
  • include-leased: Sürüm 2020-02-10 ve üzeri. Bir veya daha fazla anlık görüntünün etkin paylaşım kiralamaları olsa bile temel paylaşımı ve tüm anlık görüntülerini silin.
x-ms-client-request-id İsteğe bağlı. 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. İzleme Azure Dosyalar.
x-ms-lease-id: <ID> Hedef dosya paylaşımının etkin bir kirası varsa gereklidir. Sürüm 2020-02-10 ve üzeri için kullanılabilir. İstek kira kimliğini içermiyorsa veya geçerli değilse işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız Oldu).

Bu üst bilgi belirtilirse ve hedef dosya paylaşımının etkin kiralaması yoksa işlem 412 durum koduyla da başarısız olur (Önkoşul Başarısız oldu).

İstek gövdesi

Yok.

Örnek istek

DELETE https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1  
  
Request Headers:  
x-ms-version: 2014-02-14  
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ= TBD  

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 ü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
x-ms-request-id Bu üst bilgi, 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-client-request-id İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için bu üst bilgiyi kullanabilirsiniz. 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. İstekte x-ms-client-request-id üst bilgi yoksa, yanıtta bu üst bilgi bulunmaz.

Yanıt gövdesi

Yok.

Yetkilendirme

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

Açıklamalar

Bir paylaşımı sildiğinizde, en az 30 saniye boyunca aynı ada sahip bir paylaşım oluşturamazsınız. Paylaşım silinirken, aynı ada sahip bir paylaşımı yeniden oluşturma girişimleri 409 (Çakışma) durum koduyla başarısız olur. Hizmet, paylaşımın silindiğini belirten ek hata bilgileri döndürür. Paylaşım altındaki dosyalardaki işlemler de dahil olmak üzere diğer tüm işlemler, paylaşım silinirken durum kodu 404 (Bulunamadı) ile başarısız olur.

Şu anda anlık görüntüleri olan bir paylaşımı silmeye izin verilmiyor. Paylaşım anlık görüntüleri tek tek silinebilir veya üst bilgi kullanılarak x-ms-delete-snapshots=include paylaşımla birlikte silinebilir.

Yalnızca temel paylaşım kaynağına yönelik bir istek belirtmeniz x-ms-delete-snapshots gerekir. Tek bir anlık görüntüyü silme isteğinde bu üst bilgiyi belirtirseniz, Azure Dosyalar 400 durum kodunu (Geçersiz Sorgu Parametresi Değeri) döndürür. Silme isteğinde bu üst bilgi belirtilmemişse ve paylaşımda ilişkili anlık görüntüler varsa, Azure Dosyalar 409 durum kodunu döndürür (Paylaşımda Anlık Görüntüler Var).

Ayrıca bkz.

Paylaşımlardaki işlemler (Azure Dosyalar)