Comprendre les numéros de version de l'API dans Active IQ Unified Manager
Les URI de l'API REST dans Active IQ Unified Manager spécifient un numéro de version. Par exemple, /v2/datacenter/svm/svms. le numéro de version v2 dans /v2/datacenter/svm/svms indique la version de l'API utilisée dans une version spécifique. Ce numéro de version minimise l'impact des modifications de l'API sur le logiciel client en renvoyant une réponse que ce dernier peut traiter.
La partie numérique de ce numéro de version est incrémentale par rapport aux versions. Les URI comportant un numéro de version fournissent une interface cohérente qui maintient la rétrocompatibilité dans les versions futures. Vous trouvez également les mêmes API sans version, par exemple /datacenter/svm/svms,, qui indiquent les API de base sans version. Les API de base correspondent toujours à la version la plus récente des API.
|
|
Dans le coin supérieur droit de votre interface Swagger, vous pouvez sélectionner la version de l'API à utiliser. La version la plus élevée est sélectionnée par défaut. Il est recommandé d'utiliser la version la plus élevée d'une API particulière (en fonction de l'entier incrémentiel) disponible dans votre instance Unified Manager. |
Pour toutes les requêtes, vous devez demander explicitement la version de l'API que vous souhaitez utiliser. Lorsque le numéro de version est indiqué, le service ne renvoie pas d'éléments de réponse que votre application n'est pas conçue pour traiter. Dans les requêtes REST, vous devez inclure le paramètre de version. Les versions antérieures des API finissent par être dépréciées après quelques versions. Dans cette version, la version v1 des API est dépréciée.