Best practices voor versiebeheer
Microsoft raadt de volgende best practices voor versiebeheer aan voor Azure Storage:
Geef expliciet de REST-protocolversie op die voor elke aanvraag moet worden gebruikt.
Stel een standaardversie in voor Azure Blob Storage met behulp van de bewerking Eigenschappen van blobservice instellen. De standaardversie geeft de versie op die moet worden gebruikt voor anonieme aanvragen waarvoor de versieheader niet kan worden ingesteld.
Clientsoftware die gebruikmaakt van een SAS-URL (Shared Access Signature) voor toegang tot opslagresources, kan onverwacht gedrag ondervinden wanneer de SAS-URL een opslagserviceversie specificeert die nieuwer is dan de versie die wordt gebruikt door de clientsoftware. Om ervoor te zorgen dat uw clients goed werken met SAS-tokens, raden we de volgende benaderingen aan:
Voor versie 2014-02-14 en hoger: als u een SAS-tokengebruiker bent die de REST API gebruikt, kunt u de REST-protocolversie overschrijven om de juiste versie op te geven met behulp van de
api-version
parameter . Zie Versiebeheer voor Azure Storage voor meer informatie.Als u een SAS-tokengebruiker bent die de Azure Storage-clientbibliotheek gebruikt, zorgt de bibliotheek ervoor dat de juiste REST-protocolversie wordt aangevraagd.
Voor versie 2013-08-15 en eerder: Code waarmee SHARED Access Signature-URL's (SAS-providers of -generatoren) worden voorbereid en gedistribueerd, moet versies opgeven die worden begrepen door de clientsoftware (sas-consumenten) die opslagserviceaanvragen doet.
Gebruik altijd de nieuwste versie van Azure Storage om te profiteren van optimalisaties die zijn opgenomen in elke nieuwe versie. Enkele voorbeelden van dergelijke wijzigingen zijn:
In versie 2013-08-15 is de JSON-nettoladingindeling geïntroduceerd die het gebruik van de netwerkbandbreedte met maximaal 70 procent vermindert in vergelijking met het OData AtomPub-protocol.
Met versie 2013-08-15 kunnen SAS-providers en -generatoren bepaalde antwoordheaders toevoegen, zoals
cache-control
,content-disposition
encontent-type
via SAS-queryparameters.In versie 2011-08-18 zijn de aanhalingstekens
ETag
enAccept-Ranges
antwoordheaders geïntroduceerd die vereist zijn voor geoptimaliseerd downloaden en streamen via browsers.