Kopiera blob
Åtgärden Copy Blob kopierar en blob till ett mål i lagringskontot.
I version 2012-02-12 och senare kan källan för en kopieringsblobåtgärd vara en indelade blob i val annat Azure Storage-konto.
Från och med version 2015-02-21 kan källan för en åtgärd vara en Copy Blob Azure-fil i alla Azure Storage-konton.
Anteckning
Endast lagringskonton som skapats den 7 juni 2012 eller senare tillåter att åtgärden Copy Blob kopieras från ett annat lagringskonto.
Förfrågan
Begäran Copy Blob kan konstrueras på följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto, med namnet på din container och med namnet på din mycontainer myblob målblob.
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 |
HTTP/1.1 |
Emulerad lagringstjänst-URI
När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorns värdnamn och Blob Service-port som följt av namnet på det 127.0.0.1:10000 emulerade lagringskontot:
| URI för PUT-metodbegäran | HTTP-version |
|---|---|
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob |
HTTP/1.1 |
Mer information finns i Använda Azure Storage Emulator för utveckling och testning.
URI-parametrar
Följande ytterligare parametrar kan anges för URI:en för begäran.
| Parameter | Beskrivning |
|---|---|
timeout |
Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Service-åtgärder. |
Rubriker för begäran
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 Authorize requests to Azure Storage. |
Date eller x-ms-date |
Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Authorize requests to Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Mer information finns i Versionshantering för Azure Storage Services. |
x-ms-meta-name:value |
Valfritt. Anger ett användardefinierat namn/värde-par som är associerat med bloben. Om inga namn/värde-par anges kopierar åtgärden metadata från källbloben eller filen till målbloben. Om ett eller flera namn/värde-par anges skapas målbloben med angivna metadata och metadata kopieras inte från källbloben eller filen. Observera att från och med version 2009-09-19 måste metadatanamn följa namngivningsreglerna för C#-identifierare. Mer information finns i Namnge och referera till containrar, blobar och metadata. |
x-ms-tags |
Valfritt. Anger de angivna frågesträngskodade taggarna på bloben. Taggar kopieras inte från kopieringskällan. Mer information finns i Kommentarer. Stöds i version 2019-12-12 och senare. |
x-ms-source-if-modified-since |
Valfritt. Ett DateTime värde. Ange det här villkorliga huvudet om du bara vill kopiera bloben om källbloben har ändrats sedan det angivna datumet/tiden. Om källbloben inte har ändrats returnerar Blob Service statuskod 412 (förhandsvillkoret misslyckades). Det går inte att specificera det här huvudet om källan är en Azure-fil. |
x-ms-source-if-unmodified-since |
Valfritt. Ett DateTime värde. Ange det här villkorsstyrda huvudet om du bara vill kopiera bloben om källbloben inte har ändrats sedan det angivna datumet/tiden. Om källbloben har ändrats returnerar Blob Service statuskod 412 (förhandsvillkoret misslyckades). Det går inte att specificera det här huvudet om källan är en Azure-fil. |
x-ms-source-if-match |
Valfritt. Ett ETag-värde. Ange det här villkorsstyrda huvudet om du bara vill kopiera källbloben om dess ETag matchar det angivna värdet. Om ETag-värdena inte matchar returnerar Blob Service statuskod 412 (förhandsvillkoret misslyckades). Det går inte att specificera det här huvudet om källan är en Azure-fil. |
x-ms-source-if-none-match |
Valfritt. Ett ETag-värde. Ange det här villkorsstyrda huvudet om du bara vill kopiera bloben om dess ETag inte matchar det angivna värdet. Om värdena är identiska returnerar Blob Service statuskod 412 (förhandsvillkoret misslyckades). Det går inte att specificera det här huvudet om källan är en Azure-fil. |
If-Modified-Since |
Valfritt. Ett DateTime värde. Ange det här villkorsstyrda huvudet om du bara vill kopiera bloben om målbloben har ändrats sedan det angivna datumet/tiden. Om målbloben inte har ändrats returnerar Blob Service statuskod 412 (förhandsvillkoret misslyckades). |
If-Unmodified-Since |
Valfritt. Ett DateTime värde. Ange det här villkorsstyrda huvudet om du bara vill kopiera bloben om målbloben inte har ändrats sedan det angivna datumet/tiden. Om målbloben har ändrats returnerar Blob Service statuskod 412 (förhandsvillkoret misslyckades). |
If-Match |
Valfritt. Ett ETag-värde. Ange ett ETag-värde för den här villkorliga rubriken om du bara vill kopiera bloben om det angivna ETag-värdet matchar ETag värdet för en befintlig målblob. Om ETag för målbloben inte matchar den ETag som angetts för If-Match returnerar Blob Service statuskod 412 (förhandsvillkoret misslyckades). |
If-None-Match |
Valfritt. Ett ETag-värde eller jokertecknet (*). Ange ett ETag-värde för det här villkorsstyrda huvudet för att endast kopiera bloben om det angivna ETag-värdet inte matchar ETag-värdet för målbloben. Ange jokertecknet ( * ) för att endast utföra åtgärden om målbloben inte finns. Om det angivna villkoret inte uppfylls returnerar Blob Service statuskod 412 (förhandsvillkoret misslyckades). |
x-ms-copy-source:name |
Krävs. Anger namnet på källbloben eller filen. Från och med version 2012-02-12 kan det här värdet vara en URL med en längd på upp till 2 KiB som anger en blob. Värdet ska vara URL-kodat som det skulle visas i en begärande-URI. En källblob i samma lagringskonto kan auktoriseras via delad nyckel. Men om källan är en blob i ett annat konto måste källbloben antingen vara offentlig eller ha behörighet via en signatur för delad åtkomst. Om källbloben är offentlig krävs ingen auktorisering för att utföra kopieringen. Från och med version 2015-02-21 kan källobjektet vara en fil i Azure File-tjänsten. Om källobjektet är en fil som ska kopieras till en blob måste källfilen auktoriseras med hjälp av en signatur för delad åtkomst, oavsett om den finns i samma konto eller i ett annat konto. Endast lagringskonton som skapats den 7 juni 2012 eller senare tillåter att åtgärden Copy Blob kopieras från ett annat lagringskonto.Här följer några exempel på url:er för källobjekt: - https://myaccount.blob.core.windows.net/mycontainer/myblob- https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>- https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>När källobjektet är en fil i Azure File-tjänsten använder käll-URL:en följande format: Observera att URL:en måste innehålla en giltig SAS-token för filen: - https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sastokenI versioner före 2012-02-12 kan blobar endast kopieras inom samma konto, och ett källnamn kan använda följande format: – Blob i namngiven container: /accountName/containerName/blobName– Ögonblicksbild i namngiven container: /accountName/containerName/blobName?snapshot=<DateTime>– Blob i rotcontainern: /accountName/blobName– Ögonblicksbild i rotcontainern: /accountName/blobName?snapshot=<DateTime> |
x-ms-lease-id:<ID> |
Krävs om målbloben har ett aktivt lån. Låne-ID:t som anges för den här rubriken måste matcha målblobens låne-ID. Om begäran inte innehåller låne-ID eller om den inte är giltig misslyckas åtgärden med statuskod 412 (förhandsvillkoret misslyckades). Om det här huvudet anges och målbloben för närvarande inte har ett aktivt lån misslyckas åtgärden också med statuskod 412 (förhandsvillkoret misslyckades). I version 2012-02-12 och senare måste det här värdet ange ett aktivt, obegränsat lån för en hyrd blob. Ett låne-ID med begränsad varaktighet misslyckas med 412 (förhandsvillkoret misslyckades). |
x-ms-source-lease-id: <ID> |
Valfria versioner före 2012-02-12 (stöds inte i 2012-02-12 och senare). Ange det här huvudet om du bara vill Copy Blob utföra åtgärden om det angivna låne-ID:t matchar källblobens aktiva låne-ID.Om det här huvudet anges och källbloben för närvarande inte har ett aktivt lån misslyckas åtgärden också med statuskod 412 (förhandsvillkoret misslyckades). |
x-ms-client-request-id |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en gräns på 1 KiB-tecken som registreras i analysloggarna när loggning av lagringsanalys är aktiverat. Användning av det här huvudet rekommenderas starkt för korrelering av aktiviteter på klientsidan med begäranden som tas emot av servern. Mer information finns i Om Storage Analytics-loggning och Azure Logging: Använda loggar för att spåra Storage begäranden. |
x-ms-access-tier |
Valfritt. Anger vilken nivå som ska anges för målbloben. För sidblobar på ett premiumkonto endast med version 2017-04-17 och senare. En fullständig lista över nivåer Premium Storage och hanterade diskar för virtuella datorer finns i Högpresterande enheter och hanterade diskar. Version 2018-11-09 och senare för blockblobar. Blockblobnivåindelade stöds på bloblagringskonton eller konton för generell användning v2, och giltiga värden är Hot / Cool / Archive . Detaljerad information om blockblobnivåer finns i Lagringsnivåer för hot, cool och arkiv. |
x-ms-rehydrate-priority |
Valfritt. Anger med vilken prioritet en arkiverad blob ska rehydreras. Stöds i version 2019-02-02 och senare för blockblobar. Giltiga värden är High / Standard . Prioriteten kan bara anges för en blob en gång. Det här huvudet ignoreras vid efterföljande begäranden till samma blob. Standardprioritet utan det här huvudet är Standard . |
x-ms-seal-blob |
Valfritt. Stöds i version 2019-12-12 eller senare. Gäller endast för tilläggsblobar. Förseglar målbloben när kopieringen är klar. |
x-ms-immutability-policy-until-date |
Version 2020-06-12 och senare. Anger datumet för "kvarhållning tills" som ska anges för bloben. Det här är det datum då bloben kan skyddas från att ändras eller tas bort. Följer RFC1123-format. |
x-ms-immutability-policy-mode |
Version 2020-06-12 och senare. Anger vilket oföränderlighetsprincipläge som ska anges för bloben. Giltiga värden är unlocked / locked . unlocked anger att användaren kan ändra principen genom att öka eller minska kvarhållningsdatumet fram till datumet. locked anger att dessa åtgärder är förbjudna. |
x-ms-legal-hold |
Version 2020-06-12 och senare. Anger det juridiska kvarbvärdet som ska anges för bloben. Giltiga värden är true/false . |
Den här åtgärden stöder x-ms-if-tags endast x-ms-source-if-tags - och -villkorliga huvuden om det angivna villkoret är uppfyllt. Mer information finns i Ange villkorsstyrda huvuden för Blob Service-åtgärder.
Begärandetext
Inga.
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
I version 2012-02-12 och senare returnerar en lyckad åtgärd statuskod 202 (accepterad).
I versioner före 2012-02-12 returnerar en lyckad åtgärd statuskod 201 (skapad).
Information om statuskoder finns i Status och Felkoder.
Svarsrubriker
Svaret för den här åtgärden innehåller följande huvuden. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden följer protokollspecifikationen HTTP/1.1.
| Svarshuvud | Beskrivning |
|---|---|
ETag |
I version 2012-02-12 och senare, om kopieringen är klar, innehåller ETag för målbloben. Om kopieringen inte är klar innehåller ETag för den tomma bloben som skapades i början av kopian. I versioner före 2012-02-12 returnerar ETag för målbloben. I version 2011-08-18 och senare är ETag-värdet inom citattecken. |
Last-Modified |
Returnerar datum/tid som kopieringsåtgärden till målbloben slutfördes. |
x-ms-request-id |
Det här huvudet identifierar unikt den begäran som har gjorts och kan användas för felsökning av begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger vilken version av blobtjänsten som används för att köra begäran. Det här huvudet returneras för begäranden som görs mot version 2009-09-19 och senare. |
Date |
Ett datum-/tidsvärde för UTC som genereras av tjänsten och som anger när svaret initierades. |
x-ms-copy-id: <id> |
Version 2012-02-12 och senare. Strängidentifierare för den här kopieringsåtgärden. Använd med Get Blob eller för att kontrollera status för den här Get Blob Properties kopieringsåtgärden eller skicka för Abort Copy Blob att avbryta en väntande kopia. |
x-ms-copy-status: <success | pending> |
Version 2012-02-12 och senare. Tillståndet för kopieringsåtgärden med följande värden: - success: kopieringen har slutförts.- pending: kopian pågår. |
x-ms-version-id: <DateTime> |
Version 2019-12-12 och senare. Ett DateTime-värde som returneras av tjänsten och som unikt identifierar bloben. Värdet för den här rubriken anger blobversionen och kan användas i efterföljande begäranden för att få åtkomst till den här versionen av bloben. Det här värdet ska behandlas som täckande. |
x-ms-client-request-id |
Det här huvudet kan användas 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 rubriken om det finns i begäran och värdet är högst x-ms-client-request-id 1 024 synliga ASCII-tecken. Om x-ms-client-request-id -huvudet inte finns i begäran kommer det här huvudet inte att finnas i svaret. |
Svarstext
Inga.
Exempelsvar
Följande är ett exempelsvar för en begäran om att kopiera en blob:
Response Status:
HTTP/1.1 202 Accepted
Response Headers:
Last-Modified: <date>
ETag: "0x8CEB669D794AFE2"
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402
x-ms-version: 2015-02-21
x-ms-copy-id: 1f812371-a41d-49e6-b123-f4b542e851c5
x-ms-copy-status: pending
x-ms-version-id: <DateTime>
Date: <date>
Auktorisering
Den här åtgärden kan anropas av kontoägaren. För begäranden som görs mot version 2013-08-15 och senare stöds en signatur för delad åtkomst som har behörighet att skriva till målbloben eller dess container för kopieringsåtgärder inom samma konto. Observera att signaturen för delad åtkomst som anges i begäran endast gäller för målbloben.
Åtkomst till källbloben eller -filen auktoriserats separat, enligt beskrivningen i informationen för begärandehuvudet x-ms-copy-source .
I följande tabell beskrivs hur mål- och källobjekten för en kopieringsblobåtgärd kan auktoriseras.
| Blob | Auktorisering med delad nyckel/delad nyckel Lite | Auktorisering med signatur för delad åtkomst | Offentligt objekt som inte kräver auktorisering |
|---|---|---|---|
| Målblob | Ja | Ja | Inga |
| Källblob i samma konto | Ja | Ja | Ja |
| Källblob i ett annat konto | Inga | Ja | Ja |
| Källfil i samma konto eller ett annat konto | Inga | Ja | Ej tillämpligt |
Om en begäran anger taggar med x-ms-tags begärandehuvudet måste anroparen uppfylla auktoriseringskraven för åtgärden Ange blobtaggar.
Kommentarer
I version 2012-02-12 och senare kan Copy Blob åtgärden slutföras asynkront. Den här åtgärden returnerar ett kopierings-ID som du kan använda för att kontrollera eller avbryta kopieringsåtgärden. Blob-tjänsten kopierar blobar efter bästa försök.
Källbloben för en kopieringsåtgärd kan vara en blockblob, en tilläggsblob, en sidblob eller en ögonblicksbild. Om målbloben redan finns måste den vara av samma blobtyp som källbloben. En befintlig målblob skrivs över. Målbloben kan inte ändras medan en kopiering pågår.
I version 2015-02-21 och senare kan källan för kopieringsåtgärden också vara en fil i Azure File-tjänsten. Om källan är en fil måste målet vara en blockblob.
Flera väntande Copy Blob åtgärder i ett konto kan bearbetas sekventiellt. En målblob kan bara ha en utestående kopieringsblobåtgärd. Med andra ord kan en blob inte vara målet för flera väntande Copy Blob åtgärder. Ett försök till Copy Blob en målblob som redan har en väntande kopia misslyckas med statuskod 409 (konflikt).
Endast lagringskonton som skapats den 7 juni 2012 eller senare tillåter att åtgärden Copy Blob kopieras från ett annat lagringskonto. Ett försök att kopiera från ett annat lagringskonto till ett konto som skapats före den 7 juni 2012 misslyckas med statuskod 400 (felaktig begäran).
Åtgärden Copy Blob kopierar alltid hela källbloben eller -filen. Kopiering av ett intervall med byte eller en uppsättning block stöds inte.
En Copy Blob åtgärd kan ha något av följande formulär:
Du kan kopiera en källblob till en målblob med ett annat namn. Målbloben kan vara en befintlig blob av samma blobtyp (block, tillägg eller sida) eller kan vara en ny blob som skapas av kopieringsåtgärden.
Du kan kopiera en källblob till en målblob med samma namn, vilket effektivt ersätter målbloben. En sådan kopieringsåtgärd tar bort eventuella ogenomfördelade block och skriver över blobens metadata.
Du kan kopiera en källfil i Azure File Service till en målblob. Målbloben kan vara en befintlig blockblob eller en ny blockblob som skapats av kopieringsåtgärden. Det går inte att kopiera från filer till sidblobar eller tilläggsblobar.
Du kan kopiera en ögonblicksbild över dess basblob. Genom att befordra en ögonblicksbild till basblobens position kan du återställa en tidigare version av en blob.
Du kan kopiera en ögonblicksbild till en målblob med ett annat namn. Den resulterande målbloben är en skrivbar blob och inte en ögonblicksbild.
När du kopierar från en sidblob skapar Blob Service en målsideblob med källblobens längd, som ursprungligen innehåller alla nollor. Därefter räknas källsidans intervall upp och intervall som inte är tomma kopieras.
För en blockblob eller en tilläggsblob skapar Blob Service en degraderad blob med längden noll innan den returneras från den här åtgärden.
Vid kopiering från en blockblob kopieras alla indelade block och deras block-ID:er. Ogenomsagda block kopieras inte. I slutet av kopieringsåtgärden har målbloben samma indelade blockantal som källan.
När du kopierar från en tilläggsblob kopieras alla indelade block. I slutet av kopieringsåtgärden har målbloben samma indelade blockantal som källan.
För alla blobtyper kan du anropa Get Blob eller Get Blob Properties på målbloben för att kontrollera kopieringsåtgärdens status. Den slutliga bloben kommer att slutföras när kopieringen är klar.
När källan för en kopieringsåtgärd tillhandahåller ETags misslyckas kopieringen om det finns några ändringar i källan medan kopieringen pågår. Ett försök att ändra målbloben medan en kopia pågår misslyckas med 409-konflikt. Om målbloben har ett oändligt lån måste låne-ID:t skickas till Copy Blob . Lån med begränsad varaktighet tillåts inte.
ETag för en blockblob ändras när Copy Blob åtgärden initieras och när kopieringen är klar. ETag för en sidblob ändras när Copy Blob åtgärden initieras och fortsätter att ändras ofta under kopieringen. Innehållet i en blockblob visas bara med hjälp av get när den fullständiga kopian har slutförts.
Kopiera blobegenskaper, taggar och metadata
När en blob kopieras kopieras följande systemegenskaper till målbloben med samma värden:
Content-TypeContent-EncodingContent-LanguageContent-LengthCache-ControlContent-MD5Content-Dispositionx-ms-blob-sequence-number (for page blobs only)x-ms-committed-block-count (for append blobs only, and for version 2015-02-21 only)
Källblobens indelade blocklista kopieras också till målbloben om bloben är en blockblob. Eventuella ogenomsagda block kopieras inte.
Målbloben har alltid samma storlek som källbloben, så värdet för rubriken för målbloben matchar värdet Content-Length för källbloben.
När källbloben och målbloben är desamma tar Copy Blob bort eventuella ogenomlästa block. Om metadata anges i det här fallet skrivs befintliga metadata över med de nya metadata.
Om taggar för målbloben anges i x-ms-tags rubriken måste de vara kodade med frågesträngar. Taggnycklar och värden måste följa namngivnings- och längdkraven som anges i Ange blobtaggar. Dessutom kan x-ms-tags rubriken innehålla upp till 2 kb taggar. Om fler taggar krävs använder du åtgärden Ange blobtaggar.
Om taggarna inte anges i x-ms-tags rubriken kopieras de inte från källbloben.
Kopiera en hyrd blob
Åtgärden Copy Blob läses bara från källbloben, så källblobens lånetillstånd spelar ingen roll. Åtgärden sparar Copy Blob dock ETag för källbloben när kopieringen initieras. Om ETag-värdet ändras innan kopieringen är klar misslyckas kopieringen. Du kan förhindra ändringar i källbloben genom att leasa den under kopieringen.
Om målbloben har ett aktivt oändligt lån måste du ange dess låne-ID i anropet till Copy Blob åtgärden. Om lånet som du anger är ett aktivt lån med begränsad varaktighet misslyckas anropet med statuskoden 412 (förhandsvillkoret misslyckades). Medan kopieringen väntar misslyckas alla lånåtgärder på målbloben med statuskod 409 (konflikt). Ett oändligt lån på målbloben låses på det här sättet under kopieringsåtgärden, oavsett om du kopierar till en målblob med ett annat namn än källan, kopierar till en målblob med samma namn som källan eller befordrar en ögonblicksbild över dess basblob. Om klienten anger ett låne-ID på en blob som ännu inte finns returnerar blobtjänsten statuskod 412 (förhandsvillkoret misslyckades) för begäranden som görs mot version 2013-08-15 och senare. för tidigare versioner returnerar Blob Service statuskod 201 (skapad).
Kopiera ögonblicksbilder
När en källblob kopieras kopieras inga ögonblicksbilder eller versioner av källbloben till målet. När en målblob skrivs över med en kopia förblir alla ögonblicksbilder eller versioner som är associerade med målbloben intakta under dess namn.
Du kan utföra en kopieringsåtgärd för att höja upp en ögonblicksbildsblob via dess basblob. På så sätt kan du återställa en tidigare version av en blob. Ögonblicksbilden är kvar, men målet skrivs över med en kopia som kan läsas och skrivas.
Kopiera versioner
Du kan utföra en kopieringsåtgärd för att höja upp en versionsblob via dess basblob. På så sätt kan du återställa en tidigare version av en blob. Versionen finns kvar, men målet skrivs över med en kopia som kan både läsas och skrivas.
Kopiera arkiverad blob (version 2018-11-09 och senare)
En arkiverad blob kan kopieras till en ny blob inom samma lagringskonto. Detta lämnar fortfarande den ursprungliga arkiverade bloben som den är. När du kopierar en arkiverad blob som källa måste begäran innehålla huvudet x-ms-access-tier som anger nivån för målbloben. Data kopieras så småningom till målbloben.
Kopieringskällan och -målet ska vara samma lagringskonto när källan arkiveras. Begäran misslyckas med Konflikt om källan för kopian fortfarande är i ett väntande tillstånd för återhydrering.
Detaljerad information om blockblobnivåindelade finns i Lagringsnivåer för Hot, Cool och Arkiv.
Arbeta med en väntande kopia (version 2012-02-12 och senare)
Om åtgärden slutför kopieringen asynkront använder du följande tabell för att fastställa nästa steg baserat på Copy Blob statuskoden som returneras av Copy Blob :
| Statuskod | Innebörd |
|---|---|
| 202 (accepterad), x-ms-copy-status: success | Kopieringen har slutförts. |
| 202 (accepterad), x-ms-copy-status: väntar | Kopieringen har inte slutförts. Avsök målbloben Get Blob Properties med hjälp av för att undersöka x-ms-copy-status tills kopieringen har slutförts eller misslyckas. |
| 4xx, 500 eller 503 | Kopieringen misslyckades. |
Under och efter Copy Blob en åtgärd innehåller egenskaperna för målbloben kopierings-ID för åtgärden och Copy Blob URL:en för källbloben. När kopieringen är klar skriver Blob Service tids- och utfallsvärdet ( success , eller ) till failed aborted målblobegenskaperna. Om åtgärden failed innehåller -huvudet x-ms-copy-status-description en feldetaljinformationssträng.
En väntande Copy Blob åtgärd har en tidsgräns på 2 veckor. Ett kopieringsförsök som inte har slutförts efter två veckor och lämnar en tom blob med fältet inställt på och inställt på x-ms-copy-status failed x-ms-copy-status-description 500 (OperationCancelled). Tillfälliga, icke-allvarliga fel som kan inträffa under en kopia kan hindra kopieringens förlopp men inte orsaka fel. I dessa fall x-ms-copy-status-description beskrivs de tillfälliga felen.
Alla försök att ändra eller ögonblicksbilder av målbloben under kopieringen misslyckas med 409 (konflikt) Kopieringsbloben pågår.
Om du anropar åtgärden visas ett -huvud och målbloben har intakta metadata och Abort Copy Blob x-ms-copy-status:aborted en bloblängd på noll byte. Du kan upprepa det ursprungliga anropet till Copy Blob för att försöka kopiera igen.
Om åtgärden Copy Blob slutförs synkront använder du följande tabell för att fastställa kopieringsåtgärdens status:
| Statuskod | Innebörd |
|---|---|
| 202 (accepterad), x-ms-copy-status: success | Kopieringen har slutförts. |
| 4xx, 500 eller 503 | Kopieringen misslyckades. |
Nivån ärvs för premiumlagringsnivåer. För blockblobar ärver överskrivning av målbloben nivån Hot/Cool från målet om x-ms-access-tier inte anges. Det går inte att skriva över en arkiverad blob. Detaljerad information om blockblobnivåindelade finns i Lagringsnivåer för Hot, Cool och Arkiv.
Billing
Målkontot för en åtgärd debiteras för en transaktion för att initiera kopieringen och ådrar sig även en transaktion för varje begäran om att avbryta eller begära status för Copy Blob kopieringsåtgärden.
När källbloben finns i ett annat konto medför källkontot transaktionskostnader. Om käll- och målkontona finns i olika regioner (t.ex. USA, norra och USA, södra) debiteras dessutom den bandbredd som används för att överföra begäran till källlagringskontot som utgående. Egress mellan konton inom samma region är kostnadsfri.
När du kopierar en källblob till en målblob med ett annat namn inom samma konto använder du ytterligare lagringsresurser för den nya bloben, så kopieringsåtgärden resulterar i en avgift mot lagringskontots kapacitetsanvändning för dessa ytterligare resurser. Men om käll- och målblobnamnet är samma inom samma konto (till exempel när du befordrar en ögonblicksbild till dess basblob) tillkommer ingen extra avgift än de extra kopieringsmetadata som lagras i version 2012-02-12 och senare.
När du befordrar en ögonblicksbild för att ersätta dess basblob blir ögonblicksbilden och basbloben identiska. De delar block eller sidor, så kopieringen resulterar inte i en extra avgift mot lagringskontots kapacitetsanvändning. Men om du kopierar en ögonblicksbild till en målblob med ett annat namn tillkommer en extra avgift för de lagringsresurser som används av den nya bloben som resulterar. Två blobar med olika namn kan inte dela block eller sidor även om de är identiska. Mer information om kostnadsscenarier för ögonblicksbilder finns i Förstå hur ögonblicksbilder påförs avgifter.
Se även
Auktorisera begäranden till Azure Storage
Status och felkoder
Felkoder för Blob Service
Förstå hur ögonblicksbilder påförs avgifter
Avbryt kopieringsblob