Importante:
Aviso anticipado de un próximo cambio
Cloud Services Platform (CSP) admitirá la autenticación de clave de prueba para el intercambio de código (Proof Key for Code Exchange, PKCE) y dejará de utilizar la autenticación que no es PKCE. Si es un usuario de API de VMware Aria Automation y tiene una directiva de autorización de IP configurada en una organización de cliente mediante CSP, deberá obtener el token de actualización siguiendo la API de CSP documentada en Obtener un token de acceso mediante un token de actualización de API. El token obtenido al seguir el endpoint de inicio de sesión de la API de IaaS documentado en Obtener el token de acceso quedará obsoleto.
Cuando se conozca la fecha de publicación de este cambio, se actualizará este aviso.
Aviso: Las notas de las versiones anteriores se archivan anualmente:
La documentación de la API está disponible con el producto. Para acceder a todos los documentos de Swagger desde una sola página de destino, vaya a:
-
https://www.mgmt.cloud.vmware.com/automation-ui/api-docs/ para vRealize Automation Cloud.
-
https://<appliance.domain.com>/automation-ui/api-docs para vRealize Automation 8.x, donde appliance.domain.com es su dispositivo de vRealize Automation.
Antes de utilizar la API, tenga en cuenta las actualizaciones y los cambios de API más recientes de esta versión, y observe los cambios en los servicios de API que utiliza. Si no bloqueó la API usando la variable apiVersion antes, es posible que vea un cambio en una respuesta de la API. Los cambios y las actualizaciones de la API se proporcionan en la sección Novedades de cada versión.
Para las API desbloqueadas, el comportamiento predeterminado varía en función de la API.
-
Para las API de IaaS de Cloud Assembly, todas las solicitudes que se ejecuten sin el parámetro apiVersion se redireccionarán a la primera versión, que es 2019-01-15. Este redireccionamiento permitirá que todos los usuarios que no especificaron previamente el parámetro apiVersion transicionen sin problemas a la versión más reciente sin experimentar cambios disruptivos.
NOTA: Para las API de IaaS de Cloud Assembly, la versión más reciente es apiVersion=2021-07-15. Si se dejan desbloqueadas, las solicitudes de las API de IaaS se redireccionarán a la primera versión, que es 2019-01-15. La primera versión está obsoleta y se admitirá durante 24 meses. Para garantizar una transición sin problemas a la nueva versión, bloquee las solicitudes de las API de IaaS con el parámetro apiVersion asignado en 2021-07-15.
-
Para otras API, las solicitudes de API utilizarán la versión más reciente de forma predeterminada. Si selecciona una de las fechas de versión anteriores enumeradas para la especificación Swagger, el comportamiento de la API reflejará las API que estaban en vigor a partir de dicha fecha y cualquier fecha hasta la siguiente de la versión más reciente. Las API no tienen versiones para cada versión de vRealize Automation y no todas las API admiten el parámetro apiVersion.
Para obtener más información sobre el uso del parámetro apiVersion, consulte las guías de programación:
Las actualizaciones y los cambios de API para esta versión se proporcionan en las siguientes secciones: