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 |
|
| NFS |
|
İ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:
|
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).