voice_channels
Creates, updates, deletes, gets or lists a voice_channels resource.
Overview
| Name | voice_channels |
| Type | Resource |
| Id | aws.pinpoint.voice_channels |
Fields
The following fields are returned by SELECT queries:
- get_voice_channel
| Name | Datatype | Description |
|---|---|---|
application_id | string | The unique identifier for the application that the voice channel applies to. |
creation_date | string | The date and time, in ISO 8601 format, when the voice channel was enabled. |
enabled | boolean | Specifies whether the voice channel is enabled for the application. |
has_credential | boolean | (Not used) This property is retained only for backward compatibility. |
id | string | (Deprecated) An identifier for the voice channel. This property is retained only for backward compatibility. |
is_archived | boolean | Specifies whether the voice channel is archived. |
last_modified_by | string | The user who last modified the voice channel. |
last_modified_date | string | The date and time, in ISO 8601 format, when the voice channel was last modified. |
platform | string | The type of messaging or notification platform for the channel. For the voice channel, this value is VOICE. |
version | integer | The current version of the voice channel. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_voice_channel | select | application-id, region | Retrieves information about the status and settings of the voice channel for an application. | |
update_voice_channel | update | application-id, region, VoiceChannelRequest | Enables the voice channel for an application or updates the status and settings of the voice channel for an application. | |
delete_voice_channel | delete | application-id, region | Disables 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.
| Name | Datatype | Description |
|---|---|---|
application-id | string | The unique identifier for the application. This identifier is displayed as the Project ID on the Amazon Pinpoint console. |
region | string | AWS region (default: us-east-1) |
SELECT examples
- get_voice_channel
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
- update_voice_channel
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
- delete_voice_channel
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
;