Versions précédentes du Stockage Azure

Stockage Azure prend en charge plusieurs versions. Pour effectuer une demande sur le 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 du Stockage Azure est 2024-11-04 et l’utilisation de cette version est recommandée si possible. Pour plus d’informations sur la dernière version, consultez Contrôle de version pour le stockage Azure.

Les versions prises en charge supplémentaires sont les suivantes :

• version 2024-08-04

• version 2024-05-04

• version 2024-02-04

• version 2023-11-03

• 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

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

Une demande effectuée via une signature d’accès partagé est traitée en fonction de 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 (SignedVersionou 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 paramètre SignedVersion (sv). SignedVersion indique la version du service utilisée pour l’autorisation et pour appeler l’opération d’API. Si l’en-tête x-ms-version est transmis à la demande, il est ignoré. Seul le paramètre SignedVersion (sv) détermine la version du service à utiliser pour traiter la demande effectuée via la signature d’accès partagé.

Note

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

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

Valeur du paramètre SignedVersion (sv)	Services pris en charge
2015-12-11	Tout (Stockage Blob Azure, Stockage File d’attente Azure, Stockage Table Azure et Azure Files)
2015-04-05	Tout (Stockage Blob, Stockage File d’attente, Stockage Table et Azure Files)
2015-02-21	Tout (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 requête à 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-02-12 et effectue une demande 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 des signatures d’accès partagé dans la version 2012-02-12. Par conséquent, le comportement de signature d’accès partagé avant la version 2012-02-12 s’applique uniquement au stockage Blob.

La version 2012-02-12 a également introduit le paramètre SignedVersion (sv), 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 x-ms-version valide, la version 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 requête 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 requête 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 Définir une liste de contrôle d’accès du conteneur opération qui a utilisé 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 requête 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 Définir l’ACL conteneur opération qui a utilisé 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 paramètre SignedVersion n’est pas inclus.

Valeur de l’en-tête x-ms-version	Version utilisée pour interpréter les paramètres pour l’autorisation et l’autorisation pour le stockage Blob	Version utilisée pour effectuer l’opération Stockage Blob
Aucun	Version de signature d’accès partagé valide la plus ancienne (2009-07-17)	2009-09-19 est utilisé si le conteneur a été défini sur public par Définir la liste de contrôle d’accès du conteneur à l’aide de la version 2009-09-19 ou ultérieure. Sinon, la version la plus ancienne du stockage d’objets blob est utilisée.
2011-08-18	Version de signature d’accès partagé valide la plus ancienne (2009-07-17)	2011-08-18.
Toute version XXXX-XX-XX	Version de signature d’accès partagé valide la plus ancienne (2009-07-17)	Version XXXX -XX-XX

Note

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

Voir aussi

contrôle de version pour le stockage Azure