Varlığı Silme (Azure Depolama)

  • Makale

İşlem, Delete Entity bir tablodaki var olan bir varlığı siler.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Delete Entity . HTTPS önerilir. myaccount değerini depolama hesabınızın adıyla, mytable değerini tablonuzun adıyla, myPartitionKey ve myRowKey değerini silinecek varlığı tanımlayan bölüm anahtarının ve satır anahtarının adıyla değiştirin.

Yöntem İstek URI'si HTTP sürümü
DELETE https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey', RowKey='myRowKey') HTTP/1.1

Güncelleştirilecek varlığın adresi, istek URI'sinde bir dizi form alabilir. Ek ayrıntılar için bkz. OData Protokolü.

Öykünülmüş depolama hizmeti URI'si

Öykünülmüş depolama hizmetine yönelik bir istekte bulunurken öykünücü konak adını ve Azure Tablo Depolama bağlantı noktasını olarak 127.0.0.1:10002ve ardından öykünülen depolama hesabı adını belirtin.

Yöntem İstek URI'si HTTP sürümü
DELETE http://127.0.0.1:10002/devstoreaccount1/myentity(PartitionKey='myPartitionKey', RowKey='myRowKey') HTTP/1.1

Depolama öykünücüsündeki Tablo Depolama, Azure hizmetinden çeşitli yollarla farklıdır. Daha fazla bilgi için bkz. Depolama öykünücüsü ile Azure Depolama hizmetleri arasındaki farklar.

URI parametreleri

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

Parametre Açıklama
timeout İsteğe bağlı. Zaman aşımı parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz . Tablo Depolama 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 İsteğe bağlı. 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.
If-Match Gereklidir. İstemci, iyimser eşzamanlılık amacıyla hizmet tarafından tutulan ile karşılaştırmak ETag üzere istekteki varlık için öğesini belirtebilirETag. Silme işlemi yalnızca istemci tarafından gönderilen değerin sunucu tarafından tutulan değerle eşleşmesi durumunda ETag devam eder. Bu eşleşme, varlığın istemci tarafından alındığından beri değiştirilmediğini gösterir.

Koşulsuz silmeyi zorlamak için (*) joker karakterine ayarlayın If-Match .
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. Azure Tablo Depolama'yı izleme.

İstek gövdesi

Yok.

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ı ve Tablo Depolama hata kodları.

Yanıt üst bilgileri

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 Tablo Depolama sürümünü gösterir. Bu üst bilgi, 2009-09-19 ve sonraki sürümlerde yapılan istekler için döndürülür.
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

Hesap sahibi bu işlemi gerçekleştirebilir. Ayrıca, paylaşılan erişim imzasına sahip olan ve bu işlemi gerçekleştirme izni olan herkes bunu gerçekleştirebilir.

Açıklamalar

Bir varlığı başarıyla sildiğinizde varlık silinmek üzere hemen işaretlenir ve artık erişilemez.

Bir varlığın ETag silme işlemleri için varsayılan iyimser eşzamanlılık sağlar. Değer ETag opaktır ve okunmamalıdır veya bu değere dayanılmamalıdır. Silme işlemi gerçekleşmeden önce Tablo Depolama, varlığın geçerli ETag değerinin üst bilgideki If-Match silme isteğine dahil edilen değerle aynı ETag olduğunu doğrular. Değerler aynıysa Tablo Depolama, varlığın alındıktan sonra değiştirilmediğini belirler ve silme işlemi devam eder.

Varlığın ETag değerleri silme isteğiyle belirtilenden farklıysa silme işlemi 412 (Önkoşul Başarısız Oldu) durum koduyla başarısız olur. Bu hata, varlığın sunucuda alındıktan sonra değiştirildiğini gösterir. Bu hatayı çözmek için varlığı yeniden alın ve isteği yeniden oluşturun.

Koşulsuz silme işlemini zorlamak için, üst bilginin değerini If-Match istekte joker karakter (*) olarak ayarlayın. Bu değerin işleme geçirilmesi varsayılan iyimser eşzamanlılığı geçersiz kılar ve değerlerdeki ETag uyuşmazlıkları yoksayar.

İstekte If-Match üst bilgi eksikse, hizmet 400 (Hatalı İstek) durum kodunu döndürür. Başka şekillerde hatalı biçimlendirilmiş bir istek de 400 kodunu döndürebilir. Daha fazla bilgi için bkz. Tablo Depolama hata kodları.

Bir isteği yetkilendirilebilen ve gönderebilen tüm uygulamalar bir HTTP DELETE varlığı silebilir. kullanarak HTTP DELETEsorgu oluşturma hakkında daha fazla bilgi için bkz. Varlık ekleme, değiştirme ve silme.

Toplu silme işlemlerini gerçekleştirme hakkında bilgi için bkz. Varlık grubu işlemleri gerçekleştirme.

Ayrıca bkz.

Azure Depolama'ya yönelik istekleri yetkilendirme
OData veri hizmeti sürüm üst bilgilerini ayarlama
Durum ve hata kodları
Tablo Depolama hata kodları