Meilleures pratiques relatives aux versions

Microsoft recommande les meilleures pratiques de contrôle de version suivantes pour Stockage Azure :

• Spécifiez explicitement la version du protocole REST à utiliser pour chaque requête.

• Définissez une version par défaut pour Stockage Blob Azure à l’aide de l’opération Définir les propriétés du service Blob. La version par défaut spécifie la version à utiliser pour les requêtes anonymes pour lesquelles l’en-tête de version ne peut pas être défini.

• Le logiciel client qui utilise une URL de signature d’accès partagé (SAS) pour accéder aux ressources de stockage peut rencontrer un comportement inattendu lorsque l’URL SAP spécifie une version de service de stockage plus récente que la version utilisée par le logiciel client. Pour garantir que vos clients fonctionnent bien avec les jetons SAP, nous vous recommandons les approches suivantes :

  • Pour les versions 2014-02-14 et ultérieures : si vous êtes un consommateur de jetons SAP qui utilise l’API REST, vous pouvez remplacer la version du protocole REST pour spécifier la version appropriée à l’aide du api-version paramètre . Pour plus d’informations, consultez Gestion de version pour Stockage Azure.

    Si vous êtes un consommateur de jetons SAP qui utilise la bibliothèque cliente Stockage Azure, la bibliothèque garantit que la version correcte du protocole REST est demandée.

  • Pour les versions 2013-08-15 et antérieures : le code qui prépare et distribue les URL de signature d’accès partagé (c’est-à-dire les fournisseurs ou générateurs DE SAP) doit spécifier les versions qui sont comprises par le logiciel client (c’est-à-dire les consommateurs SAS) qui effectue des demandes de service de stockage.

• Utilisez toujours la dernière version de Stockage Azure pour tirer parti des optimisations incluses dans chaque nouvelle version. Voici quelques exemples de telles modifications :

  • La version 2013-08-15 a introduit le format de charge utile JSON qui réduit l’utilisation de la bande passante réseau de jusqu’à 70 % par rapport au protocole OData AtomPub.

  • La version 2013-08-15 permet aux fournisseurs et générateurs SAS d’ajouter certains en-têtes de réponse, tels que cache-control, content-dispositionet content-type via des paramètres de requête SAP.

  • La version 2011-08-18 a introduit les en-têtes entre guillemets ETag et Accept-Ranges de réponse qui sont nécessaires pour optimiser le téléchargement et la diffusion en continu via les navigateurs.

Voir aussi

Contrôle de version pour Stockage Azure