Přerušení kopírování objektu blob

  • Článek

Operace Abort Copy Blob zruší čekající Copy Blob operaci a ponechá cílový objekt blob s nulovou délkou a úplnými metadaty. Tato operace se vztahuje na verzi 2012-02-12 a novější.

Žádost

Abort Copy Blob Sestavte operaci následujícím způsobem. Doporučuje se https. Nahraďte myaccount názvem vašeho účtu úložiště, mycontainer názvem kontejneru a myblob názvem cílového objektu blob. Nahraďte <id> identifikátorem kopírování zadaným x-ms-copy-id v záhlaví původní Copy Blob operace.

Počínaje verzí 2013-08-15 můžete zadat sdílený přístupový podpis pro cílový objekt blob, pokud je ve stejném účtu jako zdrojový objekt blob. Počínaje verzí 2015-04-05 můžete také zadat sdílený přístupový podpis pro cílový objekt blob, pokud je v jiném účtu úložiště.

Identifikátor URI požadavku metody PUT Verze PROTOKOLU HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=copy&copyid=<id> HTTP/1.1

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

Když vytváříte požadavek na službu místního úložiště, zadejte název místního hostitele a port Azure Blob Storage a 127.0.0.1:10000pak název místního účtu úložiště:

Identifikátor URI požadavku metody PUT Verze PROTOKOLU HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=copy&copyid=<id> HTTP/1.1

Další informace najdete v tématu Použití emulátoru Azurite pro místní vývoj služby 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 timeout je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Blob 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 Povinné pro všechny autorizované žádosti. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-lease-id:<ID> Vyžaduje se, pokud má cílový objekt blob aktivní nekonečné zapůjčení.
x-ms-copy-action: abort Povinná hodnota.
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í Azure Blob 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ématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Odpověď na tuto operaci 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 Blob Storage použitou ke spuštění požadavku.
Date Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
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ě hlavičky, x-ms-client-request-id pokud se nachází v požadavku. Hodnota je maximálně 1024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, není tato hlavička v odpovědi.

Autorizace

Při volání jakékoli operace přístupu k datům ve službě Azure Storage se vyžaduje autorizace. Operaci můžete autorizovat, Abort Copy Blob jak je popsáno níže.

Azure Storage podporuje autorizaci požadavků na data objektů blob pomocí Microsoft Entra ID. S Microsoft Entra ID můžete pomocí řízení přístupu na základě role v Azure (Azure RBAC) udělit oprávnění k objektu zabezpečení. Objektem zabezpečení může být uživatel, skupina, instanční objekt aplikace nebo spravovaná identita Azure. Objekt zabezpečení je ověřen Microsoft Entra ID, aby vrátil token OAuth 2.0. Token se pak dá použít k autorizaci požadavku na službu Blob Service.

Další informace o autorizaci pomocí Microsoft Entra ID najdete v tématu Autorizace přístupu k objektům blob pomocí Microsoft Entra ID.

Oprávnění

Níže jsou uvedené akce RBAC potřebné k volání operace Microsoft Entra uživatele, skupiny nebo instančního Abort Copy Blob objektu a předdefinované role Azure RBAC s nejnižšími oprávněními, která zahrnuje tuto akci:

Další informace o přiřazování rolí pomocí Azure RBAC najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Poznámky

Když zrušíte čekající Copy Blob operaci, hlavička cílového objektu x-ms-copy-status blob se nastaví na aborted. Zrušení operace kopírování má za následek nulovou délku cílového objektu blob pro objekty blob bloku, doplňovací objekty blob a objekty blob stránky. Metadata cílového objektu blob však budou mít nové hodnoty zkopírované ze zdrojového objektu blob nebo explicitně nastavené ve Copy Blob volání operace. Pokud chcete zachovat původní metadata před kopírováním, vytvořte snímek cílového objektu blob před voláním Copy Blobpříkazu .

Můžete zrušit pouze operaci kopírování, která čeká na vyřízení. Při pokusu o zrušení kopie, která se dokončila nebo selhala, dojde ke konfliktu. Při pokusu o zrušení operace kopírování pomocí nesprávného ID kopírování dojde také ke konfliktu.

Fakturace

Požadavky na ceny můžou pocházet od klientů, kteří používají rozhraní API služby Blob Storage, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny služby Azure Storage. Za tyto žádosti se účtují poplatky za každou transakci. Typ transakce ovlivňuje způsob účtování za účet. Například transakce čtení se načítají do jiné kategorie fakturace než transakce zápisu. Následující tabulka uvádí kategorii fakturace pro Abort Copy Blob žádosti založené na typu účtu úložiště:

Operace Typ účtu úložiště Kategorie fakturace
Přerušení kopírování objektu blob Objekt blob bloku úrovně Premium
Standard pro obecné účely v2		 Další operace
Přerušení kopírování objektu blob Standard pro obecné účely v1 Operace zápisu

Informace o cenách pro zadanou kategorii fakturace najdete v tématu Azure Blob Storage Ceny.

Viz také

Autorizace požadavků do Služby Azure Storage
Stavové kódy a kódy chyb
kódy chyb Azure Blob Storage
Operace kopírování objektu blob