Important:
Notification préalable d'une modification à venir
Cloud Services Platform (CSP) prendra en charge l'authentification avec clé de preuve pour l'échange de code (Proof Key for Code Exchange, PKCE) et déconseille l'authentification non-PKCE. Si vous êtes un utilisateur des services d'API de VMware Aria Automation et que vous disposez d'une stratégie d'autorisation IP configurée dans une organisation de client utilisant CSP, vous devrez obtenir le jeton d'actualisation en suivant les services d'API de CSP documentés dans la section Obtenir un jeton d'accès par jeton d'actualisation d'API. Le jeton obtenu en suivant le point de terminaison de connexion d'API IaaS documenté dans la section Obtenir votre jeton d'accès sera obsolète.
Lorsque la date de publication de cette modification sera connue, cette notification sera mise à jour.
Remarque : les notes de mise à jour des versions précédentes sont archivées chaque année :
Une documentation sur les API est disponible avec le produit. Pour accéder à tous les documents Swagger à partir d'une page de lancement unique, accédez à :
-
https://www.mgmt.cloud.vmware.com/automation-ui/api-docs/ pour vRealize Automation Cloud.
-
https://<appliance.domain.com>/automation-ui/api-docs for vRealize Automation 8.x, où appliance.domain.com correspond à votre dispositif vRealize Automation.
Avant d'utiliser l'API, prenez en compte les dernières mises à jour et modifications de l'API pour cette version, et notez les modifications apportées aux services d'API que vous utilisez. Si vous n'avez pas verrouillé l'API antérieurement à l'aide de la variable apiVersion, vous pouvez remarquer une modification de la réponse de l'API. Les mises à jour et modifications de l'API sont présentées dans la section Nouveautés de chaque version.
Pour les API déverrouillées, le comportement par défaut varie selon l'API.
-
Pour les API IaaS Cloud Assembly, toutes les demandes exécutées sans le paramètre apiVersion seront redirigées vers la première version 2019-01-15. Cette redirection permet à chaque utilisateur qui n'a pas précédemment spécifié le paramètre apiVersion de passer facilement à la dernière version sans subir de modification.
REMARQUE : pour les API IaaS Cloud Assembly, la dernière version a pour paramètre apiVersion=2021-07-15. Si la version est déverrouillée, les demandes d'API IaaS seront redirigées par défaut vers la dernière version qui a pour paramètre 2019-01-15. La première version est obsolète et sera prise en charge pendant 24 mois. Pour garantir une transition fluide vers la nouvelle version, verrouillez vos demandes d'API IaaS avec le paramètre apiVersion attribué à 2021-07-15.
-
Pour les autres API, les demandes d'API concernent par défaut la dernière version. Si vous sélectionnez l'une des dates de version antérieures répertoriées pour la spécification Swagger, le comportement de l'API reflète les API qui étaient en vigueur à cette date et à n'importe quelle date antérieure à celle de la version la plus récente. Les API ne font pas l'objet d'un contrôle de version pour chaque version de vRealize Automation et certaines API ne prennent pas en charge le paramètre apiVersion.
Pour plus d'informations sur l'utilisation du paramètre apiVersion, consultez les guides de programmation répertoriés dans :
Les mises à jour et modifications de l'API pour cette version font l'objet des sections suivantes :