Pinpoint / Client / update_apns_voip_channel

update_apns_voip_channel#

Pinpoint.Client.update_apns_voip_channel(**kwargs)#

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

See also: AWS API Documentation

Request Syntax

response = client.update_apns_voip_channel(
    APNSVoipChannelRequest={
        'BundleId': 'string',
        'Certificate': 'string',
        'DefaultAuthenticationMethod': 'string',
        'Enabled': True|False,
        'PrivateKey': 'string',
        'TeamId': 'string',
        'TokenKey': 'string',
        'TokenKeyId': 'string'
    },
    ApplicationId='string'
)
Parameters:
  • APNSVoipChannelRequest (dict) –

    [REQUIRED]

    Specifies the status and settings of the APNs (Apple Push Notification service) VoIP channel for an application.

    • BundleId (string) –

      The bundle identifier that’s assigned to your iOS app. This identifier is used for APNs tokens.

    • Certificate (string) –

      The APNs client certificate that you received from Apple, if you want Amazon Pinpoint to communicate with APNs by using an APNs certificate.

    • DefaultAuthenticationMethod (string) –

      The default authentication method that you want Amazon Pinpoint to use when authenticating with APNs, key or certificate.

    • Enabled (boolean) –

      Specifies whether to enable the APNs VoIP channel for the application.

    • PrivateKey (string) –

      The private key for the APNs client certificate that you want Amazon Pinpoint to use to communicate with APNs.

    • TeamId (string) –

      The identifier that’s assigned to your Apple developer account team. This identifier is used for APNs tokens.

    • TokenKey (string) –

      The authentication key to use for APNs tokens.

    • TokenKeyId (string) –

      The key identifier that’s assigned to your APNs signing key, if you want Amazon Pinpoint to communicate with APNs by using APNs tokens.

  • ApplicationId (string) –

    [REQUIRED]

    The unique identifier for the application. This identifier is displayed as the Project ID on the Amazon Pinpoint console.

Return type:

dict

Returns:

Response Syntax

{
    'APNSVoipChannelResponse': {
        'ApplicationId': 'string',
        'CreationDate': 'string',
        'DefaultAuthenticationMethod': 'string',
        'Enabled': True|False,
        'HasCredential': True|False,
        'HasTokenKey': True|False,
        'Id': 'string',
        'IsArchived': True|False,
        'LastModifiedBy': 'string',
        'LastModifiedDate': 'string',
        'Platform': 'string',
        'Version': 123
    }
}

Response Structure

  • (dict) –

    The request succeeded.

    • APNSVoipChannelResponse (dict) –

      Provides information about the status and settings of the APNs (Apple Push Notification service) VoIP channel for an application.

      • ApplicationId (string) –

        The unique identifier for the application that the APNs VoIP channel applies to.

      • CreationDate (string) –

        The date and time when the APNs VoIP channel was enabled.

      • DefaultAuthenticationMethod (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 VoIP channel is enabled for the application.

      • HasCredential (boolean) –

        (Not used) This property is retained only for backward compatibility.

      • HasTokenKey (boolean) –

        Specifies whether the APNs VoIP 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 VoIP channel. This property is retained only for backward compatibility.

      • IsArchived (boolean) –

        Specifies whether the APNs VoIP channel is archived.

      • LastModifiedBy (string) –

        The user who last modified the APNs VoIP channel.

      • LastModifiedDate (string) –

        The date and time when the APNs VoIP channel was last modified.

      • Platform (string) –

        The type of messaging or notification platform for the channel. For the APNs VoIP channel, this value is APNS_VOIP.

      • Version (integer) –

        The current version of the APNs VoIP channel.

Exceptions

  • Pinpoint.Client.exceptions.BadRequestException

  • Pinpoint.Client.exceptions.InternalServerErrorException

  • Pinpoint.Client.exceptions.PayloadTooLargeException

  • Pinpoint.Client.exceptions.ForbiddenException

  • Pinpoint.Client.exceptions.NotFoundException

  • Pinpoint.Client.exceptions.MethodNotAllowedException

  • Pinpoint.Client.exceptions.TooManyRequestsException