Versions précédentes de Stockage Azure

Stockage Azure prend en charge plusieurs versions. Pour effectuer une demande auprès du stockage, vous devez spécifier la version que vous souhaitez utiliser pour cette opération, sauf si la demande est anonyme.

Versions disponibles

La version actuelle de Stockage Azure est 2023-11-03, et l’utilisation de cette version est recommandée si possible. Pour plus d’informations sur la dernière version, consultez Gestion des versions pour stockage Azure.

D’autres versions prises en charge sont les suivantes :

Demandes autorisées via une signature d’accès partagé

Une requête effectuée via une signature d’accès partagé est traitée selon la version que vous utilisez pour générer la signature d’accès partagé. Les versions 2013-08-15 et 2012-02-12 incluent un paramètre de contrôle de version (SignedVersion, ou sv), qui spécifie la version à utiliser pour autoriser et exécuter la requête SAP.

Version 2012-02-12 et ultérieure

Les demandes avec des signatures d’accès partagé générées à l’aide de la version 2012-02-12 ou ultérieure nécessitent le SignedVersion (sv) paramètre . SignedVersion indique la version de service utilisée pour l’autorisation et pour appeler l’opération d’API. Si l’en-tête x-ms-version est passé sur la demande, il est ignoré. Seul le SignedVersion (sv) paramètre détermine la version de service à utiliser pour traiter la demande effectuée via la signature d’accès partagé.

Notes

Pour les versions 2013-08-15 et antérieures, assurez-vous que les services qui préparent et distribuent les URL de signature d’accès partagé (c’est-à-dire les fournisseurs ou générateurs de signature d’accès partagé) spécifient les versions du service Stockage Azure comprises par les logiciels clients (c’est-à-dire les consommateurs de signature d’accès partagé).

Le tableau suivant indique les services pris en charge pour quelle version, pour une demande effectuée via une signature d’accès partagé :

Valeur du SignedVersion (sv) paramètre Services pris en charge
2015-12-11 Tous (Stockage Blob Azure, Stockage File d’attente Azure, Stockage Table Azure et Azure Files)
2015-04-05 Tous (Stockage Blob, Stockage File d’attente, Stockage Table et Azure Files)
2015-02-21 Tous (Stockage Blob, Stockage File d’attente, Stockage Table et Azure Files)
2014-02-14 Stockage Blob, Stockage File d’attente et Stockage Table
2013-08-15 Stockage Blob, Stockage File d’attente et Stockage Table
2012-02-12 Stockage Blob, Stockage File d’attente et Stockage Table

L’exemple suivant montre une signature d’accès partagé qui appelle des objets blob de liste à l’aide de 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

Dans cet exemple, le service autorise et exécute la demande à l’aide de la version 2013-08-15. La réponse n’inclut pas l’élément Url sous l’élément Blob , car il a été supprimé dans la version 2013-08-15.

Si une application cliente utilise une version de la bibliothèque cliente de stockage basée sur la version 2012-02-12 et effectue une requête qui utilise cette signature d’accès partagé, le client attend l’élément Uri . Par conséquent, la requête échoue avec un NullReferenceException.

Versions antérieures à 2012-02-12 (Stockage Blob uniquement)

Le Stockage Blob a introduit des signatures d’accès partagé dans la version 2009-07-17. Le stockage table et le stockage file d’attente ont introduit les signatures d’accès partagé dans la version 2012-02-12, de sorte que le comportement de signature d’accès partagé antérieur à la version 2012-02-12 s’applique uniquement au stockage Blob.

La version 2012-02-12 a également introduit le SignedVersion (sv) paramètre, qui permet au générateur de signature d’accès partagé de spécifier la version à utiliser pour traiter la demande. Une signature d’accès partagé générée avec une version antérieure à 2012-02-12 ne peut pas spécifier la version à utiliser pour traiter la demande, et s’appuie donc sur les règles suivantes pour l’autorisation et l’exécution de l’API :

  1. Si la requête a un en-tête valide x-ms-version , la version valide la plus ancienne (2009-07-17) est utilisée pour interpréter les paramètres de signature d’accès partagé. La version spécifiée par x-ms-version est utilisée pour effectuer l’opération Stockage Blob.

  2. Si la demande n’a pas d’en-tête x-ms-version et que le propriétaire a défini la version par défaut à l’aide de Définir les propriétés du stockage Blob, la version 2009-07-17 est utilisée pour interpréter les paramètres. La version par défaut spécifiée par le propriétaire est utilisée pour effectuer l’opération Stockage Blob.

  3. Si la demande n’a pas d’en-tête x-ms-version et que le propriétaire n’a pas défini de version par défaut, le Stockage Blob utilise la version valide la plus ancienne (2009-07-17) pour interpréter les paramètres. Si le conteneur est public et que ses restrictions d’accès ont été définies avec une opération Set Container ACL qui utilisait la version 2009-09-19 ou ultérieure, la version 2009-09-19 est utilisée pour effectuer l’opération Stockage Blob.

  4. Si la demande n’a pas d’en-tête x-ms-version et que le propriétaire n’a pas défini de version par défaut, le Stockage Blob utilise la version valide la plus ancienne (2009-07-17) pour interpréter les paramètres. Si les restrictions d’accès au conteneur n’ont pas été définies avec une opération Set Container ACL qui utilisait la version 2009-09-19 ou ultérieure, l’opération Stockage Blob est effectuée à l’aide de la version la plus ancienne du service.

Le tableau suivant applique ces règles à différents scénarios et suppose que le SignedVersion paramètre n’est pas inclus.

Valeur de l'en-tête x-ms-version Version utilisée pour interpréter les paramètres d’autorisation et d’autorisation pour le Stockage Blob Version utilisée pour effectuer l’opération Stockage Blob
None Première version valide de signature d’accès partagé (2009-07-17) 2009-09-19 est utilisé si le conteneur a été défini sur public par Set Container ACL à l’aide de la version 2009-09-19 ou ultérieure. Sinon, la version la plus ancienne du Stockage Blob est utilisée.
2011-08-18 Première version valide de signature d’accès partagé (2009-07-17) 2011-08-18.
N'importe quelle version XXXX-XX-XX Première version valide de signature d’accès partagé (2009-07-17) Version XXXX-XX-XX

Notes

Microsoft recommande d’utiliser la version 2011-08-18 ou ultérieure pour les scénarios qui nécessitent des valeurs entre guillemets ETag ou des en-têtes de réponse valides Accept-Ranges . Les navigateurs et autres clients de streaming nécessitent ces en-têtes pour un téléchargement et des nouvelles tentatives efficaces.

Voir aussi

Contrôle de version pour stockage Azure