Skip to main content

call_recording

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

Overview

Namecall_recording
TypeResource
Idazure.communication_call_automation.call_recording

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
recordingIdstring:vartype recording_id: str
recordingKindstringKnown values are: "azureCommunicationServices", "teams", and "teamsCompliance".
recordingStatestringKnown values are: "active" and "inactive".

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_recording_propertiesselectrecording_id, endpointGet call recording properties. Get call recording properties.
stop_recordingdeleterecording_id, endpointStop recording the call. Stop recording the call.
start_recordingexecendpointStart recording the call. Start recording the call.
pause_recordingexecrecording_id, endpointPause recording the call. Pause recording the call.
resume_recordingexecrecording_id, endpointResume recording the call. Resume recording the call.

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
endpointstringThe service endpoint host (no scheme), e.g. myaccount.table.cosmos.azure.com:443 - value of the client endpoint parameter. (default: )
recording_idstringThe recording id. Required.

SELECT examples

Get call recording properties. Get call recording properties.

SELECT
recordingId,
recordingKind,
recordingState
FROM azure.communication_call_automation.call_recording
WHERE recording_id = '{{ recording_id }}' -- required
AND endpoint = '{{ endpoint }}' -- required
;

DELETE examples

Stop recording the call. Stop recording the call.

DELETE FROM azure.communication_call_automation.call_recording
WHERE recording_id = '{{ recording_id }}' --required
AND endpoint = '{{ endpoint }}' --required
;

Lifecycle Methods

Start recording the call. Start recording the call.

EXEC azure.communication_call_automation.call_recording.start_recording 
@endpoint='{{ endpoint }}' --required
@@json=
'{
"callLocator": "{{ callLocator }}",
"callConnectionId": "{{ callConnectionId }}",
"recordingStateCallbackUri": "{{ recordingStateCallbackUri }}",
"recordingContentType": "{{ recordingContentType }}",
"recordingChannelType": "{{ recordingChannelType }}",
"recordingFormatType": "{{ recordingFormatType }}",
"audioChannelParticipantOrdering": "{{ audioChannelParticipantOrdering }}",
"channelAffinity": "{{ channelAffinity }}",
"pauseOnStart": {{ pauseOnStart }},
"externalStorage": "{{ externalStorage }}"
}'
;