Tidigare Azure Storage-versioner
Azure Storage stöder flera versioner. Om du vill göra en begäran mot Storage måste du ange den version som du vill använda för den åtgärden, såvida inte begäran är anonym.
Tillgängliga versioner
Den aktuella versionen av Azure Storage är 2023-11-03, och användning av den versionen rekommenderas där det är möjligt. Information om den senaste versionen finns i Versionshantering för Azure Storage.
Ytterligare versioner som stöds är:
Begäranden som auktoriseras via signatur för delad åtkomst
En begäran som görs via en signatur för delad åtkomst bearbetas enligt vilken version du använder för att generera SAS. Versionerna 2013-08-15 och 2012-02-12 innehåller en versionsparameter (SignedVersioneller sv), som anger vilken version som ska användas för att auktorisera och köra SAS-begäran.
Version 2012-02-12 och senare
Begäranden med signaturer för delad åtkomst som genereras med hjälp av version 2012-02-12 eller senare kräver parametern SignedVersion (sv) . SignedVersion anger den tjänstversion som används för auktorisering och för att anropa API-åtgärden. x-ms-version Om rubriken skickas på begäran ignoreras den. Endast parametern SignedVersion (sv) avgör vilken tjänstversion som ska användas för att bearbeta begäran som görs via signaturen för delad åtkomst.
Anteckning
För version 2013-08-15 och tidigare kontrollerar du att tjänster som förbereder och distribuerar url:er för signatur för delad åtkomst (dvs. signaturer för delad åtkomst eller generatorer) anger Azure Storage-tjänstversioner som förstås av klientprogramvaran (dvs. signaturer för delad åtkomst).
Följande tabell anger vilka tjänster som stöds för vilken version, för en begäran som görs via en signatur för delad åtkomst:
Parameterns SignedVersion (sv) värde |
Tjänster som stöds |
|---|---|
| 2015-12-11 | Alla (Azure Blob Storage, Azure Queue Storage, Azure Table Storage och Azure Files) |
| 2015-04-05 | Alla (Blob Storage, Queue Storage, Table Storage och Azure Files) |
| 2015-02-21 | Alla (Blob Storage, Queue Storage, Table Storage och Azure Files) |
| 2014-02-14 | Blob Storage, Queue Storage och Table Storage |
| 2013-08-15 | Blob Storage, Queue Storage och Table Storage |
| 2012-02-12 | Blob Storage, Queue Storage och Table Storage |
I följande exempel visas en signatur för delad åtkomst som anropar listblobar med hjälp sv=2013-08-15av .
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2013-08-15&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d
I det här exemplet auktoriserar och kör tjänsten begäran med hjälp av version 2013-08-15. Svaret inkluderar inte elementet Url under elementet Blob eftersom det togs bort i versionen 2013-08-15.
Om ett klientprogram använder en version av Storage-klientbiblioteket baserat på version 2012-02-12 och gör en begäran som använder signaturen för delad åtkomst förväntar sig klienten elementet Uri . Begäran misslyckas därför med en NullReferenceException.
Versioner före 2012-02-12 (endast Blob Storage)
Blob Storage introducerade signaturer för delad åtkomst i version 2009-07-17. Table Storage och Queue Storage introducerade signaturer för delad åtkomst i version 2012-02-12, så signaturbeteendet för delad åtkomst före version 2012-02-12 gäller endast för Blob Storage.
Version 2012-02-12 introducerade också parametern SignedVersion (sv) , som gör det möjligt för signaturgeneratorn för delad åtkomst att ange vilken version som ska användas för att bearbeta begäran. En signatur för delad åtkomst som genererats med en version före 2012-02-12 kan inte ange vilken version som ska användas för att bearbeta begäran och förlitar sig därför på följande regler för auktorisering och API-körning:
Om begäran har ett giltigt
x-ms-versionhuvud används den tidigaste giltiga versionen (2009-07-17) för att tolka parametrarna för signatur för delad åtkomst. Den version som anges avx-ms-versionanvänds för att utföra bloblagringsåtgärden.Om begäran inte har något
x-ms-versionhuvud och ägaren har angett standardversionen med hjälp av Ange bloblagringsegenskaper används version 2009-07-17 för att tolka parametrarna. Den ägarspecifika standardversionen används för att utföra bloblagringsåtgärden.Om begäran inte har något
x-ms-versionhuvud och ägaren inte har angett någon standardversion använder Blob Storage den tidigaste giltiga versionen (2009-07-17) för att tolka parametrarna. Om containern är offentlig och dess åtkomstbegränsningar har angetts med en Set Container ACL-åtgärd som använde version 2009-09-19 eller senare, används version 2009-09-19 för att utföra bloblagringsåtgärden.Om begäran inte har något
x-ms-versionhuvud och ägaren inte har angett någon standardversion använder Blob Storage den tidigaste giltiga versionen (2009-07-17) för att tolka parametrarna. Om begränsningarna för containeråtkomst inte har angetts med en ACL-åtgärd för uppsättningscontainer som använde version 2009-09-19 eller senare, utförs Blob Storage-åtgärden med hjälp av den tidigaste versionen av tjänsten.
Följande tabell tillämpar dessa regler på olika scenarier och förutsätter att parametern SignedVersion inte ingår.
| Värdet för rubriken x-ms-version | Version som används för att tolka parametrar för auktorisering och auktorisering för Blob Storage | Version som används för att utföra bloblagringsåtgärd |
|---|---|---|
| Ingen | Tidigaste giltiga signaturversion för delad åtkomst (2009-07-17) | 2009-09-19 används om containern har angetts till offentlig av Ange container-ACL med version 2009-09-19 eller senare. Annars används den tidigaste versionen av Blob Storage. |
| 2011-08-18 | Tidigaste giltiga signaturversion för delad åtkomst (2009-07-17) | 2011-08-18. |
| Valfri version XXXX-XX-XX | Tidigaste giltiga signaturversion för delad åtkomst (2009-07-17) | Version XXXX-XX-XX |
Anteckning
Microsoft rekommenderar att du använder version 2011-08-18 eller senare för scenarier som kräver citerade ETag värden eller giltiga Accept-Ranges svarshuvuden. Webbläsare och andra strömmande klienter kräver dessa huvuden för effektiv nedladdning och återförsök.