Tema anterior: Documentación detallada de la API

Tema siguiente: Registro de versiones de ESX


Autenticación

Para poder utilizar las API de BFC, se debe crear una sesión de autenticación. Para crear una sesión, se debe publicar un nombre de usuario y una contraseña en el recurso de inicio de sesión para la versión de la API de BFC deseada. Si el nombre del usuario y la contraseña son válidos, se devuelve un ID de sesión, el cual se deberá transferir para cada llamada de API de BFC en el encabezado de autorización. Si no hay actividad, las sesiones mantienen su validez durante 30 minutos. Cada solicitud al BFC restablecerá el tiempo de espera de la sesión, a menos que se incluya el encabezado X-CA-FC-runningClock y su valor sea true. Esto es útil para clientes con llamadas de sondeo desatendidas al BFC. Un cliente puede terminar una sesión publicando el ID de sesión en el recurso de cierre de sesión.

Cree una sesión
POST  BFC/1.0/login
Encabezados

Content-Type:application/json

Argumentos

La carga útil es un objeto JSON con dos campos: username y password.

username

Si el nombre del usuario no es el nombre completo del cliente, se utilizará el cliente principal. Actualmente, el único cliente disponible en BFC es el cliente principal.

p. ej. joe (o core/joe)

password

La contraseña del usuario.

p. ej. MyPassword

{"username":"joe","password":"MyPassword"}
Resultados

La carga útil devuelta es una cadena de JSON que representa el ID de la sesión. Por ejemplo:

"2f9b84766cdacd376125c7d57aaf6aa7"
Finalización de una sesión
POST/BFC//logout 
Encabezados

Content-Type:application/json

Autorización: su ID de sesión

Argumentos

Su ID de sesión