list_template_versions

list_template_versions(**kwargs)

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

See also: AWS API Documentation

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, 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