apns_channels

Creates, updates, deletes, gets or lists an apns_channels resource.

Overview

Name	apns_channels
Type	Resource
Id	aws.pinpoint.apns_channels

Fields

The following fields are returned by SELECT queries:

get_apns_channel

Name	Datatype	Description
application_id	string	The unique identifier for the application that the APNs channel applies to.
creation_date	string	The date and time when the APNs channel was enabled.
default_authentication_method	string	The default authentication method that Amazon Pinpoint uses to authenticate with APNs for this channel, key or certificate.
enabled	boolean	Specifies whether the APNs channel is enabled for the application.
has_credential	boolean	(Not used) This property is retained only for backward compatibility.
has_token_key	boolean	Specifies whether the APNs channel is configured to communicate with APNs by using APNs tokens. To provide an authentication key for APNs tokens, set the TokenKey property of the channel.
id	string	(Deprecated) An identifier for the APNs channel. This property is retained only for backward compatibility.
is_archived	boolean	Specifies whether the APNs channel is archived.
last_modified_by	string	The user who last modified the APNs channel.
last_modified_date	string	The date and time when the APNs channel was last modified.
platform	string	The type of messaging or notification platform for the channel. For the APNs channel, this value is APNS.
version	integer	The current version of the APNs channel.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_apns_channel	select	application-id, region		Retrieves information about the status and settings of the APNs channel for an application.
update_apns_channel	update	application-id, region, APNSChannelRequest		Enables the APNs channel for an application or updates the status and settings of the APNs channel for an application.
delete_apns_channel	delete	application-id, region		Disables the APNs 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_apns_channel

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

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

UPDATE examples

update_apns_channel

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

UPDATE aws.pinpoint.apns_channels
SET 
APNSChannelRequest = '{{ APNSChannelRequest }}'
WHERE 
`application-id` = '{{ application-id }}' --required
AND region = '{{ region }}' --required
AND APNSChannelRequest = '{{ APNSChannelRequest }}' --required
RETURNING
apns_channel_response;

DELETE examples

delete_apns_channel

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

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