Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Az Azure Storage több verziót is támogat. A tárolási szolgáltatásokra vonatkozó kéréshez meg kell adnia a művelethez használni kívánt verziót, kivéve, ha a kérés névtelen.
2026. július 20-tól az Azure Storage szolgáltatás legfrissebb, teljesen telepített verziója .2026-04-06
2026-06-06 globálisan engedélyezett, kivéve néhány bérlőt a useast2euap és az uscentraleuap területén.
2026-10-06 a legtöbb régióban engedélyezett, és alapértelmezett a legújabb béta SDK kiadásnál.
Az SDK-k legújabb GA verziói alapértelmezetként .2026-06-06
Ha az alábbi táblázat azt mutatja, hogy engedélyezve x-ms-version van egy régióban, akkor az összes korábbi x-ms-versions is engedélyezve van. Ha olyan szolgáltatásverziót próbál használni, amely nincs teljesen üzembe helyezve a tárfiók régiójában, x-ms-version eltérési hibát okozhat.
| Régió | x-ms-version |
|---|---|
| asiaeast | 2026.10.06 |
| asiasoutheast | 2026.10.06 |
| australiac | 2026.10.06 |
| australiac2 | 2026.10.06 |
| australiaeast | 2026-06-06 |
| australiasoutheast | 2026.10.06 |
| austriae | 2026.10.06 |
| belgiumc | 2026.10.06 |
| brazilse | 2026.10.06 |
| brazilsouth | 2026.10.06 |
| canadacentral | 2026.10.06 |
| canadaeast | 2026.10.06 |
| chilec | 2026.10.06 |
| denmarke | 2026.10.06 |
| europenorth | 2026.10.06 |
| europewest | 2026-06-06 |
| EUSLV | 2026.10.06 |
| francec | 2026.10.06 |
| frances | 2026.10.06 |
| germanyn | 2026.10.06 |
| germanywc | 2026.10.06 |
| indiacentral | 2026.10.06 |
| indiasc | 2026.10.06 |
| indiasouth | 2026.10.06 |
| indiawest | 2026.10.06 |
| indonesiac | 2026.10.06 |
| israelc | 2026.10.06 |
| israelnw | 2026.10.06 |
| italyn | 2026.10.06 |
| japaneast | 2026.10.06 |
| japanwest | 2026.10.06 |
| jioinc | 2026.10.06 |
| jioinw | 2026.10.06 |
| koreacentral | 2026.10.06 |
| koreasouth | 2026.10.06 |
| malaysias | 2026.10.06 |
| malaysiaw | 2026.10.06 |
| mexicoc | 2026.10.06 |
| newzealandn | 2026.10.06 |
| norwaye | 2026.10.06 |
| norwayw | 2026.10.06 |
| polandc | 2026.10.06 |
| qatarc | 2026.10.06 |
| southafrican | 2026.10.06 |
| southafricaw | 2026.10.06 |
| spainc | 2026.10.06 |
| swedenc | 2026.10.06 |
| swedens | 2026.10.06 |
| switzerlandn | 2026.10.06 |
| switzerlandw | 2026.10.06 |
| taiwann | 2026.10.06 |
| taiwannw | 2026.10.06 |
| uaec | 2026.10.06 |
| uaen | 2026.10.06 |
| uksouth | 2026.10.06 |
| ukwest | 2026.10.06 |
| uscentral | 2026-06-06 |
| uscentraleuap | 2026-04-06 |
| useast | 2026.10.06 |
| useast2 | 2026-06-06 |
| useast2euap | 2026-04-06 |
| Useast3 | 2026.10.06 |
| usnorth | 2026.10.06 |
| Északkelet5 | 2026.10.06 |
| ussouth | 2026.10.06 |
| ussouth2 | 2026.10.06 |
| ussoutheast | 2026.10.06 |
| ussoutheast3 | 2026.10.06 |
| ussoutheast5 | 2026.10.06 |
| ussouthwest | 2026.10.06 |
| uswest | 2026.10.06 |
| uswest2 | 2026.10.06 |
| uswest3 | 2026.10.06 |
| uswestcentral | 2026.10.06 |
Az Azure Storage adatsík SDK-k által használt alapértelmezett érték x-ms-version az alábbi táblázat változásnaplóiban található:
Az adatsík Storage SDK-k nem hajtanak végre általános elérhetőségi kiadásokat a többi hivatalos csomagcsatornán, amíg a kérdéses kiadás alapértelmezett beállítása x-ms-version nem lesz teljes körű bevezetéssel az összes régióban. Ezért a hivatalos csomagkezelők legújabb GA SDK kiadása biztonságosan használható bármely régióban.
Az összes többi támogatott verzió listáját és az egyes verziók használatáról további információt Korábbi Azure Storage-szolgáltatásverziókcímű témakörben talál.
A 2026-10-06-os szolgáltatási verzió a következő funkciókat tartalmazza:
- Támogatást adtak a fájllista tartományokra való lapozáshoz az új
markerésmaxresultslekérdezési paraméterek segítségével. - A
x-ms-content-crc64válaszfejléc most akkor is visszakerül, ha ax-ms-source-content-md5kérés fejléce a következő API-kra van specifikálva:
Szolgáltatásverziók megadása a kérelmekben
A kéréshez használandó tárolási szolgáltatások verziójának megadása a kérés engedélyezésének módjával kapcsolatos. A következő szakaszok az engedélyezési beállításokat és a szolgáltatásverziók megadásának módját ismertetik.
A Microsoft EntraOAuth 2.0-jogkivonatát használó kérések: A Microsoft Entra-azonosítóval rendelkező kérések engedélyezéséhez adja át a kérelem
x-ms-versionfejlécét a 2017-11-09-es vagy újabb szolgáltatásverzióval. További információ: Storage-műveletek meghívása OAuth-jogkivonatokkalEngedélyezés Microsoft Entra-azonosítóval.Megosztott kulcsot vagy Megosztott kulcs Lite-t használó kérések: Megosztott kulccsal vagy Megosztott kulcs Lite-tal történő kérés engedélyezéséhez adja át a kérés
x-ms-versionfejlécét. Az Azure Blob Storage használata esetén a Blob Service tulajdonságainak beállítása hívásával megadhatja az összes kérés alapértelmezett verzióját.közös hozzáférésű jogosultságkódot (SAS) használó kérések: Két verziószámozási lehetőséget adhat meg a közös hozzáférésű jogosultságkódon. Az opcionális
api-versionfejléc jelzi, hogy melyik szolgáltatásverziót használja az API-művelet végrehajtásához. A szükségesSignedVersion (sv)paraméter megadja, hogy az SAS-vel küldött kérés engedélyezéséhez használt szolgáltatásverziót használja-e. Ha aapi-versionfejléc nincs megadva, aSignedVersion (sv)paraméter értéke az API-művelet végrehajtásához használandó verziót is jelzi.Névtelen hozzáférést használó kérések: Ha névtelen hozzáférést használ a Blob Storage-hoz, a rendszer nem ad át verziót. A kérelemhez használandó verzió meghatározásának heurisztikus leírása a következő szakaszokban található.
Kérelmek engedélyezése a Microsoft Entra-azonosító, a megosztott kulcs vagy a Megosztott kulcs Lite használatával
Ha engedélyezni szeretne egy kérést a Microsoft Entra-azonosítóval, a megosztott kulccsal vagy a Shared Key Lite-tal, adja meg a kérelem x-ms-version fejlécét. A x-ms-version kérelem fejlécének értékét YYYY-MM-DD formátumban kell megadni. Például:
Request Headers:
x-ms-version: 2020-04-08
Az alábbi szabályok azt írják le, hogyan történik a kérelmek kiértékelése a kérés feldolgozásához használandó verzió meghatározásához.
Ha egy kérelem érvényes
x-ms-versionfejléccel rendelkezik, a társzolgáltatás a megadott verziót használja. Az Azure Table Storage-hoz és az Azure Queue Storage-hoz nem közös hozzáférési aláírást használó összes kérésnek meg kell adnia egyx-ms-versionfejlécet. A közös hozzáférésű jogosultságkódot nem használó Blob Storage-kéréseknek meg kell adniuk egyx-ms-versionfejlécet, kivéve, ha az alapértelmezett verzió be van állítva a következő bekezdésben leírtak szerint.Ha a Blob Storage-nak küldött kérés nem tartalmaz
x-ms-versionfejlécet, de a fiók tulajdonosa beállít egy alapértelmezett verziót a Blob Service tulajdonságainak beállítása művelettel, a rendszer a megadott alapértelmezett verziót használja a kérés verziójaként.
Kérelmek engedélyezése közös hozzáférésű jogosultságkód használatával
A 2014-02-14-es vagy újabb verzióval létrehozott közös hozzáférésű jogosultságkód (SAS) két verziószámozási lehetőséget támogat:
A
api-versionlekérdezési paraméter határozza meg a SAS használatával végrehajtott kérések feldolgozásához használni kívánt REST protokollverziót.A
SignedVersion (sv)lekérdezési paraméter határozza meg az engedélyezéshez használni kívánt SAS-verziót.
A SignedVersion lekérdezési paramétert akkor használja a rendszer az engedélyezéshez, ha egy ügyfél kérést intéz az SAS használatával. Az olyan engedélyezési paraméterek, mint a si, sr, sp, sig, st, se, tn, spk, srk, epkés erk a megadott verzióval vannak értelmezve.
A REST protokoll paraméterei, például rscc, rscd, rscerscl, és rsct a paraméterfejlécben megadott api-version verzióval vannak kikényszerítve. Ha a api-version fejléc nincs megadva, a rendszer a megadott SignedVersion szolgáltatásverziót használja.
A api-version paraméter nem része az engedélyezési fejlécben található sztring-bejelentkezésnek, ahogyan az Szolgáltatás SAS-című cikkben leírtak szerint szerepel.
Az alábbi táblázat ismerteti a szolgáltatás által az engedélyezéshez és a REST protokoll meghívásához használt verziószámozási sémát, amikor a SignedVersion paraméter a 2014-02-14-es vagy újabb verzióra van állítva.
| Az api-version paraméter értéke | Engedélyezéshez használt verzió | Protokoll viselkedéséhez használt verzió |
|---|---|---|
| Nincs megadva | A sv paraméterben megadott verzió |
A sv paraméterben megadott verzió |
Bármely érvényes tárolási szolgáltatás verziója XXXX-XX-XX formátumban |
A sv paraméterben megadott verzió |
A storage-szolgáltatások érvényes verziója XXXX-XX-XX |
1. példa
Az alábbi mintakérés a List Blobs paraméterrel sv=2015-04-05és anélkül api-version hívja meg.
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2015-04-05&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d
Ebben az esetben a szolgáltatás a 2015-04-05-ös verzióval hitelesíti és engedélyezi a kérést, és a 2015-04-05 verzióval futtatja a műveletet.
2. példa
Az alábbi mintakérés a Blobok listázását a sv=2015-04-05 paraméterrel és a api-version paraméterrel hívja meg.
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
Itt a szolgáltatás a 2015-04-05-ös verzióval engedélyezi a kérést, és a 2012-02-12-es verzióval futtatja a műveletet.
Note
A .NET Storage ügyféloldali kódtár mindig az alapverzióra állítja be a REST protokoll verzióját (a api-version paraméterben).
Kérelmek névtelen hozzáféréssel
A névtelen hozzáféréssel küldött kérelmek kezelése a tárfiók típusától függően eltérően történik.
Általános célú tárfiókok
Ha egy általános célú tárfiókra irányuló névtelen kérés nem adja meg a x-ms-version fejlécet, és a szolgáltatás alapértelmezett verziója nincs beállítva a Blob Service tulajdonságainak beállítása használatával, a szolgáltatás a lehető legkorábbi verziót használja a kérés feldolgozásához. Ha a tárolót a Set Container ACL művelettel tették nyilvánossá a 2009-09-19-es vagy újabb verzióval, a kérés feldolgozása a 2009-09-19-es verzióval történik.
Blob Storage-fiókok esetén
Ha egy Blob Storage-fiókra irányuló névtelen kérés nem adja meg a x-ms-version fejlécet, és a szolgáltatás alapértelmezett verziója nincs beállítva a Blob Service tulajdonságainak beállítása használatával, a szolgáltatás a lehető legkorábbi verziót használja a kérés feldolgozásához. Blob Storage-fiók esetén a legkorábbi lehetséges verzió: 2014-02-14.
Ismert problémák
Ez a szakasz az Azure Storage REST API-kkal kapcsolatos ismert problémákat ismerteti.
InvalidHeaderValue hibaüzenet
Ritka esetekben a közvetlen REST API-hívásokat bonyolító alkalmazások InvalidHeaderValue hibaüzenetet kaphatnak. A hiba az alábbi példához hasonlóan néz ki:
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>
Javasoljuk, hogy egy korábbi REST API-verziót használjon a probléma megoldásához. Ha a probléma továbbra is fennáll, vagy ha az ajánlás nem megvalósítható, nyiss ügyfélszolgálati jegyet további lehetőségek megvitatására.