Frühere Azure Storage-Versionen

Azure Storage unterstützt mehrere Versionen. Um eine Anforderung für Storage 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 lautet 2023-11-03, 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:

• Version 2023-08-03

• Version 2023-05-03

• Version 2023-01-03

• Version 2022-11-02

• Version 2021-12-02

• Version 2021-10-04

• Version 2021-08-06

• Version 2021-06-08

• Version 2021-04-10

• Version 2021-02-12

• Version 2020-12-06

• Version 2020-10-02

• Version 2020-08-04

• Version 2020-06-12

• Version 2020-04-08

• Version 2020-02-10

• Version 2019-12-12

• Version 2019-07-07

• Version 2019-02-02

• Version 2018-11-09

• Version 2018-03-28

• Version 2017-11-09

• Version 2017-07-29

• Version 2017-04-17

• Version 2016-05-31

• Version 2015-12-11

• Version 2015-07-08

• Version 2015-04-05

• Version 2015-02-21

• Version 2014-02-14

• Version 2013-08-15

• Version 2012-02-12

• Version 2011-08-18

• Version 2009-09-19

• Version 2009-07-17

• Version 2009-04-14

Über Shared Access Signature autorisierte Anforderungen

Eine Anforderung, die über eine Shared Access Signature erfolgt, wird entsprechend der Version verarbeitet, die Sie zum Generieren der SAS verwenden. Die Versionen 2013-08-15 und 2012-02-12 enthalten einen Versionsverwaltungsparameter (SignedVersionoder 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 Shared Access Signatures, die mit Version 2012-02-12 oder höher generiert wurden, erfordern den SignedVersion (sv) Parameter. SignedVersion gibt die Dienstversion an, die für die Autorisierung und den Aufruf des API-Vorgangs verwendet wird. Wenn der x-ms-version Header für die Anforderung übergeben wird, wird er ignoriert. Nur der SignedVersion (sv) -Parameter bestimmt die Dienstversion, die verwendet werden soll, um die über die Shared Access Signature durchgeführte Anforderung zu verarbeiten.

Hinweis

Stellen Sie für Version 2013-08-15 und früher sicher, dass Dienste, die Shared Access Signature-URLs vorbereiten und verteilen (d. b. Shared Access Signature-Anbieter oder Generatoren), Azure Storage-Dienstversionen angeben, die von Clientsoftware (d. a. Shared Access Signature-Consumern) verstanden werden.

Die folgende Tabelle gibt an, welche Dienste für welche Version für eine Anforderung über eine Shared Access Signature unterstützt werden:

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 Files)
2015-02-21	Alle (Blob Storage, Warteschlangenspeicher, Tabellenspeicher und Azure Files)
2014-02-14	Blob Storage, Queue Storage und Table Storage
2013-08-15	Blob Storage, Queue Storage und Table Storage
2012-02-12	Blob Storage, Queue Storage und Table Storage

Das folgende Beispiel zeigt eine Shared Access Signature, die Listenblobs mithilfe sv=2013-08-15von 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 mithilfe von Version 2013-08-15 aus. Die Antwort enthält Url das -Element nicht unter dem Blob -Element, da es in der Version 2013-08-15 entfernt wurde.

Wenn eine Clientanwendung eine Version der Storage-Clientbibliothek basierend auf Version 2012-02-12 verwendet und eine Anforderung sendet, die diese Shared Access Signature verwendet, erwartet der Client das Uri -Element. Daher schlägt die Anforderung mit einem fehl NullReferenceException.

Versionen vor 2012-02-12 (nur Blob Storage)

Blob Storage hat shared access signatures in Version 2009-07-17 eingeführt. Table Storage und Queue Storage haben shared access signatures in Version 2012-02-12 eingeführt, sodass das Verhalten von Shared Access Signaturen vor Version 2012-02-12 nur für Blob Storage gilt.

In Version 2012-02-12 wurde auch der SignedVersion (sv) Parameter eingeführt, mit dem der Shared Access Signature-Generator die Version angeben kann, die zum Verarbeiten der Anforderung verwendet werden soll. Eine Shared Access Signature, die mit einer Version vor 2012-02-12 generiert wurde, kann die Version, die zum Verarbeiten der Anforderung verwendet werden soll, nicht angeben und basiert daher auf den folgenden Regeln für die Autorisierung und API-Ausführung:

1. 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 Shared Access Signature-Parameter zu interpretieren. Die von x-ms-version angegebene Version wird verwendet, um den Blob Storage-Vorgang auszuführen.

2. Wenn die Anforderung keinen Header enthält x-ms-version und der Besitzer die Standardversion mithilfe von Blob Storage-Eigenschaften festlegen festgelegt 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.

3. Wenn die Anforderung keinen Header enthält x-ms-version 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-Vorgang festgelegt wurden, der Version 2009-09-19 oder höher verwendet hat, wird Version 2009-09-19 verwendet, um den Blob Storage-Vorgang auszuführen.

4. Wenn die Anforderung keinen Header enthält x-ms-version 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 Set 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 SignedVersion Parameter nicht enthalten ist.

Wert des "x-ms-version"-Headers	Version, die zum Interpretieren von Parametern für die Autorisierung und Autorisierung für Blob Storage verwendet wird	Version, die zum Ausführen von Blob Storage-Vorgängen verwendet wird
Keine	Früheste gültige Shared Access Signature-Version (2009-07-17)	2009-09-19 wird verwendet, wenn der Container durch Festlegen der Container-ACL mit Version 2009-09-19 oder höher auf öffentlich festgelegt wurde. Andernfalls wird die früheste Version von Blob Storage verwendet.
2011-08-18	Früheste gültige Shared Access Signature-Version (2009-07-17)	18.08.2011
Beliebige Version XXXX-XX-XX	Früheste gültige Version der Shared Access-Signatur (2009-07-17)	Version XXXX-XX-XX

Hinweis

Microsoft empfiehlt die Verwendung von Version 2011-08-18 oder höher für Szenarien, die Anführungszeichenwerte ETag oder gültige Accept-Ranges Antwortheader erfordern. Browser und andere Streamingclients erfordern diese Header für effiziente Downloads und Wiederholungen.

Weitere Informationen

Versionsverwaltung für Azure Storage