Dela via


Avbryt kopieringsblob

Åtgärden Abort Copy Blob avbryter en väntande Copy Blob åtgärd och lämnar en målblob med noll längd och fullständiga metadata. Den här åtgärden gäller för version 2012-02-12 och senare.

Förfrågan

Konstruera åtgärden på Abort Copy Blob följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto, mycontainer med namnet på din container och myblob med namnet på din målblob. Ersätt <id> med kopierings-ID:et x-ms-copy-id som angavs i rubriken för den ursprungliga Copy Blob åtgärden.

Från och med version 2013-08-15 kan du ange en signatur för delad åtkomst för målbloben om den finns i samma konto som källbloben. Från och med version 2015-04-05 kan du också ange en signatur för delad åtkomst för målbloben om den finns i ett annat lagringskonto.

URI för PUT-metodbegäran HTTP-version
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=copy&copyid=<id> HTTP/1.1

Emulerad lagringstjänst-URI

När du gör en begäran mot den lokala lagringstjänsten anger du det lokala värdnamnet och Azure Blob Storage port som 127.0.0.1:10000följt av namnet på det lokala lagringskontot:

URI för PUT-metodbegäran HTTP-version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=copy&copyid=<id> HTTP/1.1

Mer information finns i Använda Azurite-emulatorn för lokal Azure Storage-utveckling.

URI-parametrar

Du kan ange följande ytterligare parameter i begärande-URI:n.

Parameter Beskrivning
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ställa in tidsgränser för Blob Storage-åtgärder.

Begärandehuvuden

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud Beskrivning
Authorization Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
Date eller x-ms-date Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
x-ms-version Krävs för alla auktoriserade begäranden. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
x-ms-lease-id:<ID> Krävs om målbloben har ett aktivt oändligt lån.
x-ms-copy-action: abort Krävs.
x-ms-client-request-id Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggning har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Blob Storage.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskod 204 (inget innehåll). Information om statuskoder finns i Status och felkoder.

Svarshuvuden

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan även innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.

Svarsrubrik Description
x-ms-request-id Det här huvudet identifierar unikt den begäran som har gjorts och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version Anger vilken version av Blob Storage som används för att köra begäran.
Date Ett DATUM-/tidsvärde för UTC som genereras av tjänsten som anger den tid då svaret initierades.
x-ms-client-request-id Du kan använda det här huvudet för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id rubriken om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken. x-ms-client-request-id Om rubriken inte finns i begäran finns inte det här huvudet i svaret.

Auktorisering

Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden enligt beskrivningen Abort Copy Blob nedan.

Viktigt

Microsoft rekommenderar att du använder Microsoft Entra ID med hanterade identiteter för att auktorisera begäranden till Azure Storage. Microsoft Entra ID ger överlägsen säkerhet och användarvänlighet jämfört med auktorisering med delad nyckel.

Azure Storage stöder användning av Microsoft Entra ID för att auktorisera begäranden till blobdata. Med Microsoft Entra ID kan du använda rollbaserad åtkomstkontroll i Azure (Azure RBAC) för att bevilja behörigheter till ett säkerhetsobjekt. Säkerhetsobjektet kan vara en användare, grupp, programtjänstens huvudnamn eller en hanterad Azure-identitet. Säkerhetsobjektet autentiseras av Microsoft Entra ID för att returnera en OAuth 2.0-token. Token kan sedan användas för att auktorisera en begäran mot Blob-tjänsten.

Mer information om auktorisering med Microsoft Entra ID finns i Auktorisera åtkomst till blobar med hjälp av Microsoft Entra ID.

Behörigheter

Nedan visas den RBAC-åtgärd som krävs för att en Microsoft Entra användare, grupp, hanterad identitet eller tjänstens huvudnamn ska anropa Abort Copy Blob åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som innehåller den här åtgärden:

Mer information om hur du tilldelar roller med hjälp av Azure RBAC finns i Tilldela en Azure-roll för åtkomst till blobdata.

Kommentarer

När du avbryter en väntande Copy Blob åtgärd är målblobens x-ms-copy-status huvud inställt på aborted. Om du avbryter en kopieringsåtgärd resulterar det i en målblob med noll längd för blockblobar, tilläggsblobar och sidblobar. Metadata för målbloben får dock de nya värdena kopierade från källbloben eller anges uttryckligen i åtgärdsanropet Copy Blob . Om du vill behålla ursprungliga metadata från före kopian gör du en ögonblicksbild av målbloben innan du anropar Copy Blob.

Du kan bara avbryta en kopieringsåtgärd som väntar. Om du försöker avbryta en kopia som har slutförts eller misslyckats uppstår ett konfliktfel. Om du försöker avbryta en kopieringsåtgärd med hjälp av ett felaktigt kopierings-ID uppstår också ett konfliktfel.

Fakturering

Prisbegäranden kan komma från klienter som använder Blob Storage-API:er, antingen direkt via REST-API:et för Blob Storage eller från ett Azure Storage-klientbibliotek. Dessa begäranden ackumulerar avgifter per transaktion. Typen av transaktion påverkar hur kontot debiteras. Lästransaktioner till exempel tillfaller en annan faktureringskategori än skrivtransaktioner. I följande tabell visas faktureringskategorin för Abort Copy Blob begäranden baserat på lagringskontotypen:

Åtgärd Typ av lagringskonto Faktureringskategori
Avbryt kopieringsblob Premium-blockblob
Standard generell användning v2
Andra åtgärder
Avbryt kopieringsblob Standard generell användning v1 Skrivåtgärder

Mer information om priser för den angivna faktureringskategorin finns i Azure Blob Storage Prissättning.

Se även

Auktorisera begäranden till Azure Storage
Status- och felkoder
Azure Blob Storage felkoder
Kopiera blobåtgärd