Frühere Azure Storage-Versionen
Azure Storage unterstützt mehrere Versionen. Um eine Anforderung für Den Speicher zu stellen, müssen Sie die Version angeben, die Sie für diesen Vorgang verwenden möchten, es sei denn, die Anforderung ist anonym.
Verfügbare Versionen
Die aktuelle Version von Azure Storage ist 2024-11-04, und die Verwendung dieser Version wird nach Möglichkeit empfohlen. Informationen zur neuesten Version finden Sie unter Versionsverwaltung für Azure Storage.
Weitere unterstützte Versionen sind:
Anforderungen, die über freigegebene Zugriffssignatur autorisiert wurden
Eine Anforderung über eine freigegebene Zugriffssignatur wird entsprechend der Version verarbeitet, die Sie zum Generieren der SAS verwenden. Die Versionen 2013-08-15 und 2012-02-12 enthalten einen Versionsverwaltungsparameter (SignedVersion
oder sv
), der angibt, welche Version zum Autorisieren und Ausführen der SAS-Anforderung verwendet werden soll.
Version 2012-02-12 und höher
Anforderungen mit freigegebenen Zugriffssignaturen, die mit Version 2012-02-12 oder höher generiert werden, erfordern den parameter SignedVersion (sv)
.
SignedVersion
gibt die Dienstversion an, die für die Autorisierung und zum Aufrufen des API-Vorgangs verwendet wird. Wenn der x-ms-version
-Header für die Anforderung übergeben wird, wird er ignoriert. Nur der parameter SignedVersion (sv)
bestimmt die Dienstversion, mit der die anforderung verarbeitet werden soll, die über die Signatur für den freigegebenen Zugriff erfolgt.
Anmerkung
Stellen Sie für Version 2013-08-15 und früher sicher, dass Dienste, die Signatur-URLs für gemeinsame Zugriffssignaturen vorbereiten und verteilen (d. r. Anbieter für gemeinsame Zugriffssignaturen oder Generatoren), Azure Storage-Dienstversionen angeben, die von Clientsoftware (d. a. Freigegebene Zugriffssignaturkunden) verstanden werden.
In der folgenden Tabelle wird angegeben, welche Dienste für welche Version unterstützt werden, für eine Anforderung über eine Gemeinsame Zugriffssignatur:
Wert des SignedVersion (sv) -Parameters |
Unterstützte Dienste |
---|---|
2015-12-11 | Alle (Azure Blob Storage, Azure Queue Storage, Azure Table Storage und Azure Files) |
2015-04-05 | Alle (Blob Storage, Warteschlangenspeicher, Tabellenspeicher und Azure-Dateien) |
2015-02-21 | Alle (Blob Storage, Warteschlangenspeicher, Tabellenspeicher und Azure-Dateien) |
2014-02-14 | Blob-Speicher, Warteschlangenspeicher und Tabellenspeicher |
2013-08-15 | Blob-Speicher, Warteschlangenspeicher und Tabellenspeicher |
2012-02-12 | Blob-Speicher, Warteschlangenspeicher und Tabellenspeicher |
Das folgende Beispiel zeigt eine Signatur für den freigegebenen Zugriff, die mithilfe von sv=2013-08-15
List Blobs aufruft.
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2013-08-15&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d
In diesem Beispiel autorisiert und führt der Dienst die Anforderung mit Version 2013-08-15 aus. Die Antwort enthält nicht das Url
-Element unter dem Blob
-Element, da es in der Version 2013-08-15 entfernt wurde.
Wenn eine Clientanwendung eine Version der Speicherclientbibliothek basierend auf Version 2012-02-12 verwendet und eine Anforderung sendet, die diese freigegebene Zugriffssignatur verwendet, erwartet der Client das Uri
-Element. Daher schlägt die Anforderung mit einem NullReferenceException
fehl.
Versionen vor 2012-02-12 (nur Blob Storage)
Blob Storage hat freigegebene Zugriffssignaturen in Version 2009-07-17 eingeführt. Tabellenspeicher und Warteschlangenspeicher haben freigegebene Zugriffssignaturen in Version 2012-02-12 eingeführt, sodass das Verhalten der gemeinsamen Zugriffssignatur vor Version 2012-02-12 nur für Blob Storage gilt.
In Version 2012-02-12 wurde auch der parameter SignedVersion (sv)
eingeführt, mit dem der Generator für gemeinsame Zugriffssignaturen die Version angeben kann, die zum Verarbeiten der Anforderung verwendet werden soll. Eine gemeinsam genutzte Zugriffssignatur, die mit einer Version vor 2012-02-12 generiert wurde, kann nicht die Version angeben, die für die Verarbeitung der Anforderung verwendet werden soll, und basiert daher auf den folgenden Regeln für die Autorisierung und API-Ausführung:
Wenn die Anforderung über einen gültigen
x-ms-version
Header verfügt, wird die früheste gültige Version (2009-07-17) verwendet, um die Signaturparameter für den freigegebenen Zugriff zu interpretieren. Die durchx-ms-version
angegebene Version wird verwendet, um den Blob Storage-Vorgang auszuführen.Wenn die Anforderung keinen
x-ms-version
Header aufweist und der Besitzer die Standardversion mithilfe von Set Blob Storage Propertiesfestgelegt hat, wird Version 2009-07-17 verwendet, um die Parameter zu interpretieren. Die vom Besitzer angegebene Standardversion wird verwendet, um den Blob Storage-Vorgang auszuführen.Wenn die Anforderung keinen
x-ms-version
Header aufweist und der Besitzer keine Standardversion festgelegt hat, verwendet Blob Storage die früheste gültige Version (2009-07-17), um die Parameter zu interpretieren. Wenn der Container öffentlich ist und seine Zugriffsbeschränkungen mit einem Set Container ACL Operation festgelegt wurden, die Version 2009-09-19 oder höher verwendet hat, wird Version 2009-09-19 verwendet, um den Blob Storage-Vorgang auszuführen.Wenn die Anforderung keinen
x-ms-version
Header aufweist und der Besitzer keine Standardversion festgelegt hat, verwendet Blob Storage die früheste gültige Version (2009-07-17), um die Parameter zu interpretieren. Wenn die Containerzugriffseinschränkungen nicht mit einem Container-ACL--Vorgang festgelegt wurden, der Version 2009-09-19 oder höher verwendet hat, wird der Blob Storage-Vorgang mit der frühesten Version des Diensts ausgeführt.
In der folgenden Tabelle werden diese Regeln auf verschiedene Szenarien angewendet, und es wird davon ausgegangen, dass der parameter SignedVersion
nicht enthalten ist.
Wert des x-ms-version-Headers | Version, die zum Interpretieren von Parametern für autorisierung und Autorisierung für Blob Storage verwendet wird | Version, die zum Ausführen eines Blob Storage-Vorgangs verwendet wird |
---|---|---|
Nichts | Früheste gültige Signaturversion des freigegebenen Zugriffs (2009-07-17) | 2009-09-19 wird verwendet, wenn der Container mithilfe von Version 2009-09-19 oder höher auf "Öffentlich" festgelegt wurde, indem Container-ACL- festgelegt wurde. Andernfalls wird die früheste Version von Blob Storage verwendet. |
2011-08-18 | Früheste gültige Signaturversion des freigegebenen Zugriffs (2009-07-17) | 2011-08-18. |
Beliebige Version XXXX-XX-XX | Früheste gültige Signaturversion des freigegebenen Zugriffs (2009-07-17) | Version XXXX-XX-XX |
Anmerkung
Microsoft empfiehlt die Verwendung von Version 2011-08-18 oder höher für Szenarien, die ETag
Werte oder gültige Accept-Ranges
Antwortheader erfordern. Browser und andere Streamingclients erfordern diese Header für effiziente Downloads und Wiederholungen.