Pinpoint / Client / list_template_versions

list_template_versions#

Pinpoint.Client.list_template_versions(**kwargs)#

Retrieves information about all the versions of a specific message template.

Request Syntax

response = client.list_template_versions(
    NextToken='string',
    PageSize='string',
    TemplateName='string',
    TemplateType='string'
)

Parameters:

NextToken (string) – The string that specifies which page of results to return in a paginated response. This parameter is not supported for application, campaign, and journey metrics.
PageSize (string) – The maximum number of items to include in each page of a paginated response. This parameter is not supported for application, campaign, and journey metrics.
TemplateName (string) –
[REQUIRED]

The name of the message template. A template name must start with an alphanumeric character and can contain a maximum of 128 characters. The characters can be alphanumeric characters, underscores (_), or hyphens (-). Template names are case sensitive.
TemplateType (string) –
[REQUIRED]

The type of channel that the message template is designed for. Valid values are: EMAIL, PUSH, SMS, and VOICE.

Return type:

dict

Returns:

Response Syntax

{
    'TemplateVersionsResponse': {
        'Item': [
            {
                'CreationDate': 'string',
                'DefaultSubstitutions': 'string',
                'LastModifiedDate': 'string',
                'TemplateDescription': 'string',
                'TemplateName': 'string',
                'TemplateType': 'string',
                'Version': 'string'
            },
        ],
        'Message': 'string',
        'NextToken': 'string',
        'RequestID': 'string'
    }
}

Response Structure

(dict) –

The request succeeded.
- TemplateVersionsResponse (dict) –
  
  Provides information about all the versions of a specific message template.
  - Item (list) –
    
    An array of responses, one for each version of the message template.
    - (dict) –
      
      Provides information about a specific version of a message template.
      - CreationDate (string) –
        
        The date, in ISO 8601 format, when the version of the message template was created.
      - DefaultSubstitutions (string) –
        
        A JSON object that specifies the default values that are used for message variables in the version of the message template. This object is a set of key-value pairs. Each key defines a message variable in the template. The corresponding value defines the default value for that variable.
      - LastModifiedDate (string) –
        
        The date, in ISO 8601 format, when the version of the message template was last modified.
      - TemplateDescription (string) –
        
        The custom description of the version of the message template.
      - TemplateName (string) –
        
        The name of the message template.
      - TemplateType (string) –
        
        The type of channel that the message template is designed for. Possible values are: EMAIL, PUSH, SMS, INAPP, and VOICE.
      - Version (string) –
        
        The unique identifier for the version of the message template. This value is an integer that Amazon Pinpoint automatically increments and assigns to each new version of a template.
  - Message (string) –
    
    The message that’s returned from the API for the request to retrieve information about all the versions of the message template.
  - NextToken (string) –
    
    The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.
  - RequestID (string) –
    
    The unique identifier for the request to retrieve information about all the versions of the message template.

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