Vorige Versies van Azure Storage

Azure Storage ondersteunt meerdere versies. Als u een aanvraag wilt indienen bij Storage, moet u de versie opgeven die u voor die bewerking wilt gebruiken, tenzij de aanvraag anoniem is.

Beschikbare versies

De huidige versie van Azure Storage is 2024-11-04 en het gebruik van die versie wordt waar mogelijk aanbevolen. Zie Versiebeheer voor Azure Storagevoor meer informatie over de nieuwste versie.

Aanvullende ondersteunde versies zijn onder andere:

• versie 2024-08-04

• versie 2024-05-04

• versie 2024-02-04

• versie 2023-11-03

• versie 2023-08-03

• versie 2023-05-03

• versie 2023-01-03

• versie 2022-11-02

• versie 2021-12-02

• versie 2021-10-04

• versie 2021-08-06

• versie 2021-06-08

• versie 2021-04-10

• versie 2021-02-12

• versie 2020-12-06

• versie 2020-10-02

• versie 2020-08-04

• versie 2020-06-12

• versie 2020-04-08

• versie 2020-02-10

• versie 2019-12-12

• versie 2019-07-07

• versie 2019-02-02

• versie 2018-11-09

• versie 2018-03-28

• versie 2017-11-09

• versie 2017-07-29

• versie 2017-04-17

• versie 2016-05-31

• versie 2015-12-11

• versie 2015-07-08

• versie 2015-04-05

• versie 2015-02-21

• versie 2014-02-14

• versie 2013-08-15

• versie 2012-02-12

• versie 2011-08-18

• versie 2009-09-19

• versie 2009-07-17

• versie 2009-04-14

Aanvragen die zijn geautoriseerd via handtekening voor gedeelde toegang

Een aanvraag die wordt gedaan via een handtekening voor gedeelde toegang, wordt verwerkt volgens welke versie u gebruikt om de SAS te genereren. Versies 2013-08-15 en 2012-02-12 bevatten een versiebeheerparameter (SignedVersionof sv), waarmee wordt opgegeven welke versie moet worden gebruikt om de SAS-aanvraag te autoriseren en uit te voeren.

Versie 2012-02-12 en hoger

Voor aanvragen met handtekeningen voor gedeelde toegang die zijn gegenereerd met versie 2012-02-12 of hoger, is de parameter SignedVersion (sv) vereist. SignedVersion geeft de serviceversie aan die wordt gebruikt voor autorisatie en voor het aanroepen van de API-bewerking. Als de x-ms-version header wordt doorgegeven aan de aanvraag, wordt deze genegeerd. Alleen de parameter SignedVersion (sv) bepaalt de serviceversie die moet worden gebruikt voor het verwerken van de aanvraag die via de handtekening voor gedeelde toegang is gedaan.

Notitie

Voor versie 2013-08-15 en eerder moet u ervoor zorgen dat services die handtekening-URL's voor gedeelde toegang voorbereiden en distribueren (dat wil zeggen shared access signature providers of generators) Azure Storage-serviceversies opgeven die worden begrepen door clientsoftware (dat wil zeggen: consumenten van handtekeningen voor gedeelde toegang).

De volgende tabel geeft aan welke services worden ondersteund voor welke versie, voor een aanvraag die wordt gedaan via een handtekening voor gedeelde toegang:

Waarde van SignedVersion (sv) parameter	Ondersteunde services
2015-12-11	Alle (Azure Blob Storage, Azure Queue Storage, Azure Table Storage en Azure Files)
2015-04-05	Alle (Blob Storage, Queue Storage, Table Storage en Azure Files)
2015-02-21	Alle (Blob Storage, Queue Storage, Table Storage en Azure Files)
2014-02-14	Blob Storage, Queue Storage en Table Storage
2013-08-15	Blob Storage, Queue Storage en Table Storage
2012-02-12	Blob Storage, Queue Storage en Table Storage

In het volgende voorbeeld ziet u een handtekening voor gedeelde toegang die lijstblobs aanroept met behulp van sv=2013-08-15.

https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2013-08-15&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d

In dit voorbeeld autoriseert en voert de service de aanvraag uit met versie 2013-08-15. Het antwoord bevat het Url element niet onder het Blob-element, omdat het is verwijderd in de versie 2013-08-15.

Als een clienttoepassing gebruikmaakt van een versie van de Storage-clientbibliotheek op basis van versie 2012-02-12 en een aanvraag indient die gebruikmaakt van deze shared access signature, verwacht de client het Uri element. Daarom mislukt de aanvraag met een NullReferenceException.

Versies vóór 2012-02-12 (alleen Blob Storage)

Blob Storage heeft handtekeningen voor gedeelde toegang geïntroduceerd in versie 2009-07-17. Table Storage en Queue Storage hebben handtekeningen voor gedeelde toegang geïntroduceerd in versie 2012-02-12, dus het gedrag van handtekeningen voor gedeelde toegang vóór versie 2012-02-12 is alleen van toepassing op Blob Storage.

Versie 2012-02-12 heeft ook de parameter SignedVersion (sv) geïntroduceerd, waarmee de shared access signature generator de versie kan opgeven die moet worden gebruikt om de aanvraag te verwerken. Een handtekening voor gedeelde toegang die is gegenereerd met een versie vóór 2012-02-12, kan niet de versie opgeven die moet worden gebruikt om de aanvraag te verwerken, en is dus afhankelijk van de volgende regels voor autorisatie en API-uitvoering:

1. Als de aanvraag een geldige x-ms-version header heeft, wordt de vroegste geldige versie (2009-07-17) gebruikt om de handtekeningparameters voor gedeelde toegang te interpreteren. De versie die is opgegeven door x-ms-version wordt gebruikt om de Blob Storage-bewerking uit te voeren.

2. Als de aanvraag geen x-ms-version header heeft en de eigenaar de standaardversie heeft ingesteld met behulp van Blob Storage-eigenschappen instellen, wordt versie 2009-07-17 gebruikt om de parameters te interpreteren. De door de eigenaar opgegeven standaardversie wordt gebruikt om de Blob Storage-bewerking uit te voeren.

3. Als de aanvraag geen x-ms-version header heeft en de eigenaar geen standaardversie heeft ingesteld, gebruikt Blob Storage de vroegste geldige versie (2009-07-17) om de parameters te interpreteren. Als de container openbaar is en de toegangsbeperkingen zijn ingesteld met een Container-ACL instellen bewerking die versie 2009-09-19 of hoger heeft gebruikt, wordt versie 2009-09-19 gebruikt om de Blob Storage-bewerking uit te voeren.

4. Als de aanvraag geen x-ms-version header heeft en de eigenaar geen standaardversie heeft ingesteld, gebruikt Blob Storage de vroegste geldige versie (2009-07-17) om de parameters te interpreteren. Als de toegangsbeperkingen voor containers niet zijn ingesteld met een Container-ACL instellen bewerking die versie 2009-09-19 of hoger heeft gebruikt, wordt de Blob Storage-bewerking uitgevoerd met behulp van de vroegste versie van de service.

In de volgende tabel worden deze regels toegepast op verschillende scenario's en wordt ervan uitgegaan dat de parameter SignedVersion niet is opgenomen.

Waarde van header x-ms-version	Versie die wordt gebruikt voor het interpreteren van parameters voor autorisatie en autorisatie voor Blob Storage	Versie die wordt gebruikt om de Blob Storage-bewerking uit te voeren
Geen	Vroegste geldige handtekeningversie voor gedeelde toegang (2009-07-17)	2009-09-19 wordt gebruikt als de container is ingesteld op openbaar door Container-ACL instellen met versie 2009-09-19 of hoger. Anders wordt de vroegste versie van Blob Storage gebruikt.
2011-08-18	Vroegste geldige handtekeningversie voor gedeelde toegang (2009-07-17)	2011-08-18.
Elke versie XXXX-XX-XX	Vroegste geldige handtekeningversie voor gedeelde toegang (2009-07-17)	Versie XXXX-XX-XX

Notitie

Microsoft raadt aan om versie 2011-08-18 of hoger te gebruiken voor scenario's waarvoor ETag waarden zijn opgegeven of geldige Accept-Ranges antwoordheaders. Browsers en andere streamingclients vereisen deze headers voor efficiënte download en nieuwe pogingen.

Zie ook

versiebeheer voor Azure Storage-