Skip to main content

voice_channels

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

Overview

Namevoice_channels
TypeResource
Idaws.pinpoint.voice_channels

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
application_idstringThe unique identifier for the application that the voice channel applies to.
creation_datestringThe date and time, in ISO 8601 format, when the voice channel was enabled.
enabledbooleanSpecifies whether the voice channel is enabled for the application.
has_credentialboolean(Not used) This property is retained only for backward compatibility.
idstring(Deprecated) An identifier for the voice channel. This property is retained only for backward compatibility.
is_archivedbooleanSpecifies whether the voice channel is archived.
last_modified_bystringThe user who last modified the voice channel.
last_modified_datestringThe date and time, in ISO 8601 format, when the voice channel was last modified.
platformstringThe type of messaging or notification platform for the channel. For the voice channel, this value is VOICE.
versionintegerThe current version of the voice channel.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_voice_channelselectapplication-id, regionRetrieves information about the status and settings of the voice channel for an application.
update_voice_channelupdateapplication-id, region, VoiceChannelRequestEnables the voice channel for an application or updates the status and settings of the voice channel for an application.
delete_voice_channeldeleteapplication-id, regionDisables the voice channel for an application and deletes any existing settings for the channel.

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
application-idstringThe unique identifier for the application. This identifier is displayed as the Project ID on the Amazon Pinpoint console.
regionstringAWS region (default: us-east-1)

SELECT examples

Retrieves information about the status and settings of the voice channel for an application.

SELECT
application_id,
creation_date,
enabled,
has_credential,
id,
is_archived,
last_modified_by,
last_modified_date,
platform,
version
FROM aws.pinpoint.voice_channels
WHERE `application-id` = '{{ application-id }}' -- required
AND region = '{{ region }}' -- required
;

UPDATE examples

Enables the voice channel for an application or updates the status and settings of the voice channel for an application.

UPDATE aws.pinpoint.voice_channels
SET
VoiceChannelRequest = '{{ VoiceChannelRequest }}'
WHERE
`application-id` = '{{ application-id }}' --required
AND region = '{{ region }}' --required
AND VoiceChannelRequest = '{{ VoiceChannelRequest }}' --required
RETURNING
voice_channel_response;

DELETE examples

Disables the voice channel for an application and deletes any existing settings for the channel.

DELETE FROM aws.pinpoint.voice_channels
WHERE `application-id` = '{{ application-id }}' --required
AND region = '{{ region }}' --required
;