Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Azure Storage stöder flera versioner. Om du vill göra en begäran mot lagringstjänsterna måste du ange den version som du vill använda för den åtgärden, såvida inte begäran är anonym.
Från och med den 3 juni 2026 är den senaste fullt utplacerade versionen av Azure Storage-tjänsten 2026-04-06.
2026-06-06 är också globalt aktiverad, med undantag för ett litet antal hyresgäster i useast2euap och uscentraleuap. De senaste GA-versionerna av SDK:erna är som standard .2026-06-06
Om tabellen nedan visar att ett x-ms-version är aktiverat i en region, är alla tidigare x-ms-versions också aktiverade. Försök att använda en tjänstversion som inte är fullständigt distribuerad i lagringskontots region kan generera ett x-ms-version matchningsfel.
| Region | x-ms-version |
|---|---|
| asiaeast | 2026-06-06 |
| asiasoutheast | 2026-06-06 |
| australiac | 2026-06-06 |
| australiac2 | 2026-06-06 |
| australiaeast | 2026-06-06 |
| australiasoutheast | 2026-06-06 |
| austriae | 2026-06-06 |
| belgiumc | 2026-06-06 |
| brazilse | 2026-06-06 |
| brazilsouth | 2026-06-06 |
| canadacentral | 2026-06-06 |
| canadaeast | 2026-06-06 |
| chilec | 2026-06-06 |
| denmarke | 2026-06-06 |
| europenorth | 2026-06-06 |
| europewest | 2026-06-06 |
| EUSSLV | 2026-06-06 |
| francec | 2026-06-06 |
| frances | 2026-06-06 |
| germanyn | 2026-06-06 |
| germanywc | 2026-06-06 |
| indiacentral | 2026-06-06 |
| Indien | 2026-06-06 |
| indiasouth | 2026-06-06 |
| indiawest | 2026-06-06 |
| indonesiac | 2026-06-06 |
| israelc | 2026-06-06 |
| israelnw | 2026-06-06 |
| italyn | 2026-06-06 |
| japaneast | 2026-06-06 |
| japanwest | 2026-06-06 |
| jioinc | 2026-06-06 |
| jioinw | 2026-06-06 |
| koreacentral | 2026-06-06 |
| koreasouth | 2026-06-06 |
| malaysias | 2026-06-06 |
| malaysiaw | 2026-06-06 |
| mexicoc | 2026-06-06 |
| newzealandn | 2026-06-06 |
| norwaye | 2026-06-06 |
| norwayw | 2026-06-06 |
| polandc | 2026-06-06 |
| qatarc | 2026-06-06 |
| southafrican | 2026-06-06 |
| southafricaw | 2026-06-06 |
| spainc | 2026-06-06 |
| swedenc | 2026-06-06 |
| swedens | 2026-06-06 |
| switzerlandn | 2026-06-06 |
| switzerlandw | 2026-06-06 |
| taiwann | 2026-06-06 |
| taiwannw | 2026-06-06 |
| uaec | 2026-06-06 |
| uaen | 2026-06-06 |
| uksouth | 2026-06-06 |
| ukwest | 2026-06-06 |
| uscentral | 2026-06-06 |
| uscentraleuap | 2026-04-06 |
| useast | 2026-06-06 |
| useast2 | 2026-06-06 |
| useast2euap | 2026-04-06 |
| useast3 | 2026-06-06 |
| usnorth | 2026-06-06 |
| usnortheast5 | 2026-06-06 |
| ussouth | 2026-06-06 |
| ussouth2 | 2026-06-06 |
| ussoutheast | 2026-06-06 |
| ussoutheast3 | 2026-06-06 |
| ussoutheast5 | 2026-06-06 |
| ussouthwest | 2026-06-06 |
| uswest | 2026-06-06 |
| uswest2 | 2026-06-06 |
| uswest3 | 2026-06-06 |
| uswestcentral | 2026-06-06 |
Standardvärdet x-ms-version som används av SDK:er för Azure Storage-dataplanet finns i ändringsloggarna i följande tabell:
Lagrings-SDK:erna för dataplanet utför inte GA-versioner till de andra officiella paketfeedsen förrän standardvärdet x-ms-version för den aktuella versionen har fullständig distribution i alla regioner. Därför kan den senaste GA SDK-versionen från de officiella pakethanterarna användas på ett säkert sätt i vilken region som helst.
Den senaste versionen av Azure-lagringstjänsterna är 2026-06-06, och vi rekommenderar att du använder den där det är möjligt. En lista över alla andra versioner som stöds och information om hur du använder varje version finns i Tidigare Azure Storage-tjänstversioner.
Serviceversionen 2026-06-06 inkluderar följande funktioner:
- Stöd för strukturerat meddelande för Create File.
Ange tjänstversioner i begäranden
Hur du anger vilken version av lagringstjänsterna som ska användas för en begäran relaterar till hur begäran är auktoriserad. I följande avsnitt beskrivs auktoriseringsalternativ och hur tjänstversionen anges för var och en.
Begäranden som använder en OAuth 2.0-token från Microsoft Entra: Om du vill auktorisera en begäran med Microsoft Entra-ID skickar du
x-ms-version-huvudet på begäran med en tjänstversion av 2017-11-09 eller senare. Mer information finns i Anropa lagringsåtgärder med OAuth-token i Auktorisera med Microsoft Entra ID.begäranden som använder delad nyckel eller delad nyckel Lite: Skicka
x-ms-version-huvudet på begäran om du vill auktorisera en begäran med delad nyckel eller delad nyckel lite. När du använder Azure Blob Storage kan du ange standardversionen för alla begäranden genom att anropa Set Blob Service Properties.Begäranden som använder en signatur för delad åtkomst (SAS): Du kan ange två versionsalternativ för en signatur för delad åtkomst. Det valfria
api-version-huvudet anger vilken tjänstversion som ska användas för att köra API-åtgärden. Den obligatoriskaSignedVersion (sv)-parametern anger den tjänstversion som ska användas för att auktorisera den begäran som görs med SAS. Omapi-version-huvudet inte har angetts anger värdet för parameternSignedVersion (sv)också vilken version som ska användas för att köra API-åtgärden.Begäranden som använder anonym åtkomst: När du använder anonym åtkomst mot Blob Storage skickas ingen version. Heuristiken för att avgöra vilken version som ska användas för begäran beskrivs i nästa avsnitt.
Auktorisera begäranden med hjälp av Microsoft Entra-ID, delad nyckel eller delad nyckel lite
Om du vill auktorisera en begäran med Microsoft Entra ID, Delad nyckel eller Delad nyckel Lite anger du x-ms-version-huvudet på begäran. Värdet för x-ms-version begärandehuvud måste anges i formatet ÅÅÅÅ-MM-DD. Till exempel:
Request Headers:
x-ms-version: 2020-04-08
Följande regler beskriver hur dessa begäranden utvärderas för att avgöra vilken version som ska användas för att bearbeta begäran.
Om en begäran har ett giltigt
x-ms-versionhuvud använder lagringstjänsten den angivna versionen. Alla begäranden till Azure Table Storage och Azure Queue Storage som inte använder en signatur för delad åtkomst måste ange ettx-ms-version-huvud. Alla begäranden till Blob Storage som inte använder en signatur för delad åtkomst måste ange enx-ms-versionrubrik om inte standardversionen har angetts, enligt beskrivningen i nästa stycke.Om en begäran till Blob Storage inte innehåller ett
x-ms-versionhuvud, men kontoägaren anger en standardversion med hjälp av åtgärden Ange egenskaper för Blob Service , används den angivna standardversionen som version för begäran.
Auktorisera begäranden med hjälp av en signatur för delad åtkomst
En signatur för delad åtkomst (SAS) som genereras med hjälp av version 2014-02-14 eller senare stöder två versionsalternativ:
Frågeparametern
api-versiondefinierar restprotokollversionen som ska användas för bearbetning av en begäran som görs med hjälp av SAS.Frågeparametern
SignedVersion (sv)definierar den SAS-version som ska användas för auktorisering.
Frågeparametern SignedVersion används för auktorisering när en klient gör en begäran med hjälp av SAS. Auktoriseringsparametrar som si, sr, sp, sig, st, se, tn, spk, srk, epkoch erk tolkas med den angivna versionen.
REST-protokollparametrar som , rscc, rscdrsce, och rscl tillämpas med hjälp av den version som rsctanges i api-version parameterhuvudet. Om rubriken api-version inte anges används den tjänstversion som angetts för SignedVersion .
Parametern api-version är inte en del av sträng-till-inloggningen i auktoriseringshuvudet, enligt beskrivningen i Create a service SAS.
I följande tabell beskrivs versionsschemat som används av tjänsten för auktorisering och för att anropa REST-protokollet när parametern SignedVersion anges till version 2014-02-14 eller senare.
| Värdet för parametern api-version | Version som används för auktorisering | Version som används för protokollbeteende |
|---|---|---|
| Har inte angetts | Version som anges i parametern sv |
Version som anges i parametern sv |
Alla giltiga lagringstjänster i format XXXX-XX-XX |
Version som anges i parametern sv |
Giltig version av lagringstjänster XXXX-XX-XX |
Exempel 1
Följande exempelbegäran anropar List Blobs med sv=2015-04-05och utan api-version parametern .
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2015-04-05&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d
I det här fallet autentiserar och auktoriserar tjänsten begäran med hjälp av version 2015-04-05, och den kör åtgärden med hjälp av version 2015-04-05.
Exempel 2
Följande exempelbegäran anropar List Blobs med sv=2015-04-05 och med api-version parametern .
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2015-04-05&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d&api-version=2012-02-12
Här auktoriserar tjänsten begäran med hjälp av version 2015-04-05 och kör åtgärden med hjälp av version 2012-02-12.
Note
.NET Storage-klientbiblioteket anger alltid REST-protokollversionen (i parametern api-version ) till basversionen.
Begäranden via anonym åtkomst
Begäranden som görs via anonym åtkomst hanteras på olika sätt, beroende på vilken typ av lagringskonto de görs mot.
Lagringskonton för generell användning
Om en anonym begäran till ett allmänt lagringskonto inte anger rubriken x-ms-version , och standardversionen för tjänsten inte anges med hjälp av Set Blob Service Properties, använder tjänsten den tidigaste möjliga versionen för att bearbeta begäran. Om containern har offentliggjorts med hjälp av åtgärden Set Container ACL med version 2009-09-19 eller senare bearbetas begäran med hjälp av version 2009-09-19.
För Blob Storage-konton
Om en anonym begäran till ett Blob Storage-konto inte anger rubriken x-ms-version , och standardversionen för tjänsten inte anges med hjälp av Set Blob Service Properties, använder tjänsten den tidigaste möjliga versionen för att bearbeta begäran. För ett Blob Storage-konto är den tidigaste möjliga versionen 2014-02-14.
Kända problemområden
I det här avsnittet beskrivs kända problem för REST-API:er för Azure Storage.
InvalidHeaderValue felmeddelande
I sällsynta fall kan program som gör direkta REST API-anrop få ett InvalidHeaderValue felmeddelande. Felet ser ut ungefär som i följande exempel:
HTTP/1.1 400 The value for one of the HTTP headers is not in the correct format.
Content-Length: 328
Content-Type: application/xml
Server: Microsoft-HTTPAPI/2.0
x-ms-request-id: <REMOVED>
Date: Fri, 19 May 2023 17:10:33 GMT
<?xml version="1.0" encoding="utf-8"?><Error><Code>InvalidHeaderValue</Code><Message>The value for one of the HTTP headers is not in the correct format.
RequestId:<REMOVED>
Time:2023-05-19T17:10:34.2972651Z</Message><HeaderName>x-ms-version</HeaderName><HeaderValue>yyyy-mm-dd</HeaderValue></Error>
Vi rekommenderar att du använder en tidigare REST API-version för att försöka lösa problemet. Om problemet kvarstår, eller om rekommendationen inte är genomförbar, öppna ett supportärende för att diskutera vidare alternativ.