Skip to main content

conference_histories

Creates, updates, deletes, gets or lists a conference_histories resource.

Overview​

Nameconference_histories
TypeResource
Idovh.telephony.conference_histories

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
idintegerThe id of the conference history
count_connectionsintegerThe count of connections to the conference (wire: countConnections)
count_participantsintegerThe count of unique participants of the conference (wire: countParticipants)
date_beginstring (date-time)The date the conference began (wire: dateBegin)
date_endstring (date-time)The date the conference end (wire: dateEnd)
durationintegerThe duration of the conference in seconds
eventsarrayThe events of the conference (participants joining/left)
record_urlstringThe audio record url if you set recording (wire: recordUrl)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectbilling_account, id, service_nameGet a past conference
listselectbilling_account, service_namedate_begin.from, date_begin.to, x_pagination_modeList past conferences

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
api_hoststringThe OVHcloud API host. Selected by OVH_ENDPOINT (ovh-eu, ovh-ca or ovh-us; default ovh-eu). (default: api.eu.ovhcloud.com, x-stackQL-envVarSelector: {"envVar":"OVH_ENDPOINT","default":"ovh-eu","values":{"ovh-eu":"api.eu.ovhcloud.com","ovh-ca":"api.ca.ovhcloud.com","ovh-us":"api.us.ovhcloud.com"}})
billing_accountstringThe name of your billingAccount (wire: billingAccount)
idintegerId of the object
service_namestring (wire: serviceName)
date_begin.fromstring (date-time)Filter the value of dateBegin property (>=) (wire: dateBegin.from)
date_begin.tostring (date-time)Filter the value of dateBegin property (<=) (wire: dateBegin.to)
x_pagination_modestringSent as CachedObjectList-Pages by default so the list returns the full objects rather than their identifiers. (wire: X-Pagination-Mode)

SELECT examples​

Get a past conference

SELECT
id,
count_connections,
count_participants,
date_begin,
date_end,
duration,
events,
record_url
FROM ovh.telephony.conference_histories
WHERE billing_account = '{{ billing_account }}' -- required
AND id = '{{ id }}' -- required
AND service_name = '{{ service_name }}' -- required
;