EndUserMessaging / Client / update_notify_code_configuration

update_notify_code_configuration¶

EndUserMessaging.Client.update_notify_code_configuration(**kwargs)¶

Updates the mutable fields of a notify code configuration. Only the fields that you supply are changed. For the template and language fields, supplying an empty value clears the currently stored value.

Request Syntax

response = client.update_notify_code_configuration(
    notifyCodeConfigurationId='string',
    notifyCodeConfigurationName='string',
    codeConfigurationParameters={
        'codeType': 'NUMERIC'|'ALPHA'|'ALPHANUMERIC',
        'codeLength': 123,
        'validityPeriodMinutes': 123,
        'maxAttempts': 123
    },
    channelParameters={
        'text': {
            'inlineTemplateBody': 'string',
            'destinationCountryParameters': {
                'string': 'string'
            }
        },
        'voice': {
            'inlineTemplateBody': 'string',
            'languageCode': 'string',
            'voiceId': 'string',
            'voiceMessageBodyTextType': 'TEXT'|'SSML'
        },
        'notify': {
            'notifyTemplateId': 'string',
            'voiceId': 'string'
        },
        'whatsApp': {
            'whatsAppTemplateName': 'string',
            'languageCode': 'string'
        }
    },
    deletionProtectionEnabled=True|False
)

Parameters:

notifyCodeConfigurationId (string) –
[REQUIRED]

The unique identifier of the notify code configuration. You can specify either the bare ID or the full Amazon Resource Name (ARN).
notifyCodeConfigurationName (string) – The name of the notify code configuration.
codeConfigurationParameters (dict) –
The updated passcode policy parameters, including the code type, length, validity period, and maximum number of attempts. When you omit a member, its current value is preserved.
- codeType (string) –
  
  The updated character set used to generate the one-time passcode. Omit this member to preserve the current value.
- codeLength (integer) –
  
  The updated number of characters in the one-time passcode. Valid values range from 4 through 8. Omit this member to preserve the current value.
- validityPeriodMinutes (integer) –
  
  The updated length of time, in minutes, that the one-time passcode remains valid. Valid values range from 1 through 60. Omit this member to preserve the current value.
- maxAttempts (integer) –
  
  The updated maximum number of validation attempts that are allowed before the verification is locked. Valid values range from 1 through 5. Omit this member to preserve the current value.
channelParameters (dict) –
The updated channel-specific parameters used to render and deliver the one-time passcode. This is a loose, nested update: when you omit a channel, that channel’s parameters remain unchanged. Within a supplied channel, an empty string on a string member, or an empty map on the destination-country parameters, clears the currently stored value, and absent members preserve the current value.
- text (dict) –
  
  The text-channel parameters to update. Omit this member to leave the text-channel parameters unchanged.
  - inlineTemplateBody (string) –
    
    The updated freeform SMS or RCS template body. An empty string clears the previously stored value.
  - destinationCountryParameters (dict) –
    
    The updated map of country-specific parameters that control one-time passcode delivery. An empty map clears the previously stored value.
    - (string) –
      
      Key of a DestinationCountryParameters map entry. Up to 64 non-whitespace characters.
      - (string) –
        
        Value of a DestinationCountryParameters map entry. Up to 64 non-whitespace characters.
- voice (dict) –
  
  The voice-channel parameters to update. Omit this member to leave the voice-channel parameters unchanged.
  - inlineTemplateBody (string) –
    
    The updated freeform voice template body. An empty string clears the previously stored value.
  - languageCode (string) –
    
    The updated BCP 47 language code. An empty string clears the previously stored value.
  - voiceId (string) –
    
    The updated Amazon Polly voice ID. An empty string clears the previously stored value.
  - voiceMessageBodyTextType (string) –
    
    The updated format of the voice message body. Valid values are TEXT and SSML. Omit this member to preserve the current value.
- notify (dict) –
  
  The notify-template-route parameters to update. Omit this member to leave them unchanged.
  - notifyTemplateId (string) –
    
    The updated identifier of a preapproved notify template for the SMS or voice channels. An empty string clears the previously stored value.
  - voiceId (string) –
    
    The updated Amazon Polly voice ID. An empty string clears the previously stored value.
- whatsApp (dict) –
  
  The WhatsApp-channel parameters to update. Omit this member to leave the WhatsApp-channel parameters unchanged.
  - whatsAppTemplateName (string) –
    
    The updated name of the Meta-approved WhatsApp authentication template. An empty string clears the previously stored value.
  - languageCode (string) –
    
    The updated BCP 47 language code. An empty string clears the previously stored value.
deletionProtectionEnabled (boolean) – Specifies whether deletion protection is enabled. When enabled, the resource cannot be deleted until deletion protection is turned off.

Return type:

dict

Returns:

Response Syntax

{
    'notifyCodeConfiguration': {
        'notifyCodeConfigurationId': 'string',
        'notifyCodeConfigurationArn': 'string',
        'notifyCodeConfigurationName': 'string',
        'codeConfigurationParameters': {
            'codeType': 'NUMERIC'|'ALPHA'|'ALPHANUMERIC',
            'codeLength': 123,
            'validityPeriodMinutes': 123,
            'maxAttempts': 123
        },
        'channelParameters': {
            'text': {
                'inlineTemplateBody': 'string',
                'destinationCountryParameters': {
                    'string': 'string'
                }
            },
            'voice': {
                'inlineTemplateBody': 'string',
                'languageCode': 'string',
                'voiceId': 'string',
                'voiceMessageBodyTextType': 'TEXT'|'SSML'
            },
            'notify': {
                'notifyTemplateId': 'string',
                'voiceId': 'string'
            },
            'whatsApp': {
                'whatsAppTemplateName': 'string',
                'languageCode': 'string'
            }
        },
        'deletionProtectionEnabled': True|False,
        'createdAt': datetime(2015, 1, 1),
        'updatedAt': datetime(2015, 1, 1)
    }
}

Response Structure

(dict) –
- notifyCodeConfiguration (dict) –
  
  The notify code configuration resource.
  - notifyCodeConfigurationId (string) –
    
    The unique identifier of the notify code configuration.
  - notifyCodeConfigurationArn (string) –
    
    The Amazon Resource Name (ARN) of the notify code configuration.
  - notifyCodeConfigurationName (string) –
    
    The name of the notify code configuration.
  - codeConfigurationParameters (dict) –
    
    The passcode policy parameters, including the code type, length, validity period, and maximum number of attempts.
    - codeType (string) –
      
      The character set used to generate the one-time passcode. Valid values are NUMERIC (digits only), ALPHA (uppercase letters only), and ALPHANUMERIC (uppercase letters and digits). When you do not specify a value, the default is applied when a passcode is sent.
    - codeLength (integer) –
      
      The number of characters in the one-time passcode. Valid values range from 4 through 8. When you do not specify a value, the default is applied when a passcode is sent.
    - validityPeriodMinutes (integer) –
      
      The length of time, in minutes, that the one-time passcode remains valid. Valid values range from 1 through 60. When you do not specify a value, the default is applied when a passcode is sent.
    - maxAttempts (integer) –
      
      The maximum number of validation attempts that are allowed before the verification is locked. Valid values range from 1 through 5. When you do not specify a value, the default is applied when a passcode is sent.
  - channelParameters (dict) –
    
    The channel-specific parameters used to render and deliver the one-time passcode. A configuration can carry parameters for every channel at once, and the send route selects the matching channel at send time.
    - text (dict) –
      
      The parameters for the text channel, which delivers over SMS or RCS.
      - inlineTemplateBody (string) –
        
        The freeform message template used to render the one-time passcode for the SMS or RCS channels. The template must contain the code placeholder.
      - destinationCountryParameters (dict) –
        
        A map of country-specific parameters that control one-time passcode delivery.
        
        (string) –
        
        Key of a DestinationCountryParameters map entry. Up to 64 non-whitespace characters.
        
        (string) –
        
        Value of a DestinationCountryParameters map entry. Up to 64 non-whitespace characters.
    - voice (dict) –
      
      The parameters for the voice channel.
      - inlineTemplateBody (string) –
        
        The freeform message template used to render the one-time passcode for the voice channel. The template must contain the code placeholder.
      - languageCode (string) –
        
        The BCP 47 language code used to render the voice message.
      - voiceId (string) –
        
        The Amazon Polly voice ID used for the voice channel.
      - voiceMessageBodyTextType (string) –
        
        The format of the voice message body. Valid values are TEXT and SSML.
    - notify (dict) –
      
      The parameters for the preapproved notify-template route over the SMS or voice channels.
      - notifyTemplateId (string) –
        
        The identifier of a preapproved notify template for the SMS or voice channels.
      - voiceId (string) –
        
        The Amazon Polly voice ID used when the notify template is delivered over the voice channel.
    - whatsApp (dict) –
      
      The parameters for the WhatsApp channel.
      - whatsAppTemplateName (string) –
        
        The name of the Meta-approved WhatsApp authentication template.
      - languageCode (string) –
        
        The BCP 47 language code used to render the template. This value is required for the WhatsApp channel.
  - deletionProtectionEnabled (boolean) –
    
    Specifies whether deletion protection is enabled. When enabled, the resource cannot be deleted until deletion protection is turned off.
  - createdAt (datetime) –
    
    The time when the resource was created, in Unix epoch time.
  - updatedAt (datetime) –
    
    The time when the resource was last updated, in Unix epoch time.

update_notify_code_configuration¶

Request Syntax

Response Syntax

Response Structure

Exceptions