Argomento precedente: Documentazione dell'API dettagliata

Argomento successivo: Record della versione di ESX


autenticazione

Prima di utilizzare le API di BFC, si deve creare una sessione di autenticazione. Si crea una sessione pubblicando un nome utente e una password per la risorsa di accesso per la versione dell'API di BFC desiderata. Se il nome utente e la password sono validi, viene restituito un ID di sessione che deve essere trasmesso per ciascuna chiamata dell'API di BFC nell'intestazione Autorizzazione. Le sessioni rimangono valide per 30 minuti senza attività. Ciascuna richiesta a BFC ripristinerà il timeout di sessione a meno che l'intestazione X-CA-FC-runningClock non sia inclusa e abbia un valore true. Ciò è utile per client con chiamate di polling senza risposta a BFC. Un client può terminare una sessione pubblicando l'ID di sessione nella risorsa di disconnessione.

Creare una sessione
POST  BFC/1.0/login
Intestazioni

Tipo di contenuto:application/json

Argomenti

Il payload è un oggetto JSON con due campi: nome utente e password.

nome utente

Se il nome utente non è qualificato per il tenant, viene considerato il tenant principale. Attualmente, l'unico tenant disponibile in BFC è il tenant principale.

ad es. joe (o core/joe)

password

La password per l'utente.

ad es. MyPassword

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

Il payload restituito è una stringa JSON che rappresenta l'ID di sessione. Ad esempio:

"2f9b84766cdacd376125c7d57aaf6aa7"
Terminare una sessione
POST/BFC//logout 
Intestazioni

Tipo di contenuto:application/json

Autorizzazione:ID di sessione

Argomenti

ID di sessione