Odstranit entitu (Azure Storage)

  • Článek

Operace Delete Entity odstraní existující entitu v tabulce.

Žádost

Požadavek můžete vytvořit Delete Entity následujícím způsobem. Doporučuje se https. Nahraďte myaccount názvem vašeho účtu úložiště, mytable názvem tabulky a myPartitionKey a myRowKey názvem klíče oddílu a klíče řádku identifikující entitu, která se má odstranit.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
DELETE https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey', RowKey='myRowKey') HTTP/1.1

Adresa entity, která se má aktualizovat, může mít v identifikátoru URI požadavku několik formulářů. Další podrobnosti najdete v tématu Protokol OData.

Identifikátor URI služby emulovaného úložiště

Když vytvoříte požadavek na službu emulovaného úložiště, zadejte název hostitele emulátoru a port Azure Table Storage jako 127.0.0.1:10002a název emulovaného účtu úložiště.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
DELETE http://127.0.0.1:10002/devstoreaccount1/myentity(PartitionKey='myPartitionKey', RowKey='myRowKey') HTTP/1.1

Table Storage v emulátoru úložiště se od služby Azure liší několika způsoby. Další informace najdete v tématu Rozdíly mezi emulátorem úložiště a službami Azure Storage.

Parametry identifikátoru URI

V identifikátoru URI požadavku můžete zadat následující další parametr.

Parametr Popis
timeout Nepovinný parametr. Parametr časového limitu je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Table Storage.

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Date nebo x-ms-date Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
x-ms-version Nepovinný parametr. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
If-Match Povinná hodnota. Klient může zadat ETag pro entitu v požadavku, aby bylo možné porovnat s tím, co ETag služba udržuje pro účely optimistické souběžnosti. Operace odstranění pokračuje pouze v ETag případě, že hodnota odeslaná klientem odpovídá hodnotě udržované serverem. Tato shoda znamená, že entita nebyla od načtení klientem změněna.

Pokud chcete vynutit bezpodmínečné odstranění, nastavte If-Match na zástupný znak (*).
x-ms-client-request-id Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování služby Azure Table Storage.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 204 (bez obsahu). Informace o stavových kódech najdete v tématech Stavové kódy a kódy chyb a Kódy chyb služby Table Storage.

Hlavičky odpovědi

Odpověď obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Description
x-ms-request-id Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a dá se použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Označuje verzi služby Table Storage použitou ke spuštění požadavku. Tato hlavička se vrátí pro požadavky provedené ve verzi 2009-09-19 a novější.
Date Hodnota data a času UTC, která označuje čas, kdy byla odpověď zahájena. Tato služba vygeneruje tuto hodnotu.
x-ms-client-request-id Tuto hlavičku můžete použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku. Hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, nebude tato hlavička v odpovědi.

Text odpovědi

Žádné

Autorizace

Tuto operaci může provést vlastník účtu. Kromě toho ji může provést kdokoli se sdíleným přístupovým podpisem, který má oprávnění k provedení této operace.

Poznámky

Po úspěšném odstranění entity se entita okamžitě označí k odstranění a přestane být přístupná klientům. Entita se později odebere ze služby Table Storage během uvolňování paměti.

Entita ETag poskytuje výchozí optimistickou souběžnost pro operace odstranění. Hodnota ETag je neprůhlhlá a neměla by se číst ani se na ně spoléhat. Než dojde k operaci odstranění, Table Storage ověří, že aktuální ETag hodnota entity je shodná ETag s hodnotou obsaženou v požadavku na odstranění v If-Match hlavičce. Pokud jsou hodnoty identické, Table Storage určí, že entita nebyla od načtení změněna, a operace odstranění pokračuje.

Pokud se entita ETag liší od entity zadané v žádosti o odstranění, operace odstranění selže se stavovým kódem 412 (Předběžná podmínka selhala). Tato chyba značí, že entita byla na serveru od načtení změněna. Pokud chcete tuto chybu vyřešit, znovu načtěte entitu a znovu spusťte požadavek.

Pokud chcete vynutit operaci bezpodmínečného odstranění, nastavte hodnotu If-Match hlavičky na zástupný znak (*) v požadavku. Předání této hodnoty operaci přepíše výchozí optimistickou souběžnost a ignoruje všechny neshody v ETag hodnotách.

If-Match Pokud v požadavku chybí hlavička, služba vrátí stavový kód 400 (Chybný požadavek). Požadavek poškozený jinými způsoby může také vrátit kód 400. Další informace najdete v tématu Kódy chyb služby Table Storage.

Entitu HTTP DELETE může odstranit jakákoli aplikace, která může autorizovat a odeslat žádost. Další informace o vytváření dotazu pomocí HTTP DELETEnajdete v tématu Přidání, úprava a odstranění entit.

Informace o provádění operací dávkového odstranění najdete v tématu Provádění transakcí skupin entit.

Viz také

Autorizace žádostí do Služby Azure Storage
Nastavení hlaviček verzí datové služby OData
Stavové kódy a kódy chyb
Kódy chyb služby Table Storage