Anteckning
Å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 5 juni 2025 är 2025-11-05den senaste fullständigt distribuerade versionen av Azure Storage-tjänsten .
2025-07-05 och 2025-05-05 används också i stor utsträckning, vilket anges i följande tabell. Alla versioner är av GA-kvalitet.
Om tabellen anger att an x-ms-version är aktiverat i en region aktiveras även alla tidigare x-ms-versions . 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.
x-ms-version |
Regional tillgänglighet | SDK-stöd |
|---|---|---|
2025-05-05 |
Asien och östra Asiensydost Australiska australiska2 Australia East Sydöstra Australien österrike Belgien Brasilien Brasilien Södra canadacentral Kanada Öst Chilec (Chile) Danmark Europanorra Europa, Väst Franska Frances Tyska TysklandWC Indiencentrala Indien, södra Indien, västra Indonesien Israeliska Israeliska Italyn Italyn Japan Öst Västra Japan jioinc jioinc jioinw jioinw koreacentral koreasouth malaysias malaysiaw Mexiko nyzeeländska Norge Norgew Polen Qatar (Qatarc) Sydafrikanska Sydafrika SPANIEN Swedenc Sverige Schweiziska Schweizw Taiwan (Taiwan) Taiwannw (Taiwan) Förenade Arabemiraten Förenade Arabemiraten uksouth ukwest uscentral uscentral uscentraleuap uscentraleuap Öst useast2 useast2euap UsNorth (på engelska) ussouth ussouth ussouth ussouth2 ussouth2 USSOUTHEAST (Sydost) ussoutheast3 ussoutheast5 ussydväst uswest uswest uswest uswest2 uswest3 uswestcentral |
Senaste GA |
2025-07-05 |
Australiska australiska2 Australia East österrike Belgien Brasilien Brasilien Södra canadacentral Kanada Öst Chilec (Chile) Danmark Europanorra Europa, Väst Franska Frances Tyska TysklandWC Indiencentrala Indien, södra Indien, västra Indonesien Israeliska Israeliska Italyn Italyn Japan Öst Västra Japan jioinc jioinc jioinw jioinw koreasouth malaysias malaysiaw Mexiko nyzeeländska Norge Norgew Polen Qatar (Qatarc) Sydafrikanska SPANIEN Swedenc Sverige Schweiziska Schweizw Taiwan (Taiwan) Taiwannw (Taiwan) Förenade Arabemiraten Förenade Arabemiraten uksouth ukwest uscentraleuap uscentraleuap ussouth2 ussouth2 USSOUTHEAST (Sydost) ussoutheast3 ussoutheast5 ussydväst uswestcentral |
Beta-version |
2025-11-05 |
Australiska australiska2 Australia East Belgien Brasilien Brasilien Södra Chilec (Chile) Danmark Franska Frances TysklandWC Indiencentrala Indien, södra Indien, västra Indonesien Israeliska Italyn Italyn Japan Öst jioinc jioinc jioinw jioinw koreasouth malaysias malaysiaw Mexiko nyzeeländska Norgew Polen Qatar (Qatarc) SPANIEN Swedenc Sverige Schweiziska Schweizw Taiwan (Taiwan) Taiwannw (Taiwan) Förenade Arabemiraten Förenade Arabemiraten ukwest ussouth2 ussouth2 USSOUTHEAST (Sydost) ussoutheast3 ussoutheast5 ussydväst uswestcentral |
Beta-version |
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 Storage-tjänsterna är 2025-11-05, 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.
Tjänstversionen 2025-11-05 innehåller följande funktioner:
- Följande API:er returnerar
x-ms-copy-source-status-codenu ochx-ms-copy-source-error-code. Mer information finns i Status och felkoder.
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 , rscd, rsclrsce, och rsct tillämpas med hjälp av den version som rsccanges 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 |
|---|---|---|
| Inte angivet | 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 listblobar med sv=2015-04-05och utan parametern api-version.
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 listblobar med sv=2015-04-05 och med parametern api-version.
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.
Not
.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 problem
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, kan du öppna ett supportärende för att diskutera ytterligare alternativ.