RedshiftServerless / Paginator / ListSnapshots

ListSnapshots#

class RedshiftServerless.Paginator.ListSnapshots#
paginator = client.get_paginator('list_snapshots')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from RedshiftServerless.Client.list_snapshots().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    endTime=datetime(2015, 1, 1),
    namespaceArn='string',
    namespaceName='string',
    ownerAccount='string',
    startTime=datetime(2015, 1, 1),
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • endTime (datetime) – The timestamp showing when the snapshot creation finished.

  • namespaceArn (string) – The Amazon Resource Name (ARN) of the namespace from which to list all snapshots.

  • namespaceName (string) – The namespace from which to list all snapshots.

  • ownerAccount (string) – The owner Amazon Web Services account of the snapshot.

  • startTime (datetime) – The time when the creation of the snapshot was initiated.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'snapshots': [
        {
            'accountsWithProvisionedRestoreAccess': [
                'string',
            ],
            'accountsWithRestoreAccess': [
                'string',
            ],
            'actualIncrementalBackupSizeInMegaBytes': 123.0,
            'adminPasswordSecretArn': 'string',
            'adminPasswordSecretKmsKeyId': 'string',
            'adminUsername': 'string',
            'backupProgressInMegaBytes': 123.0,
            'currentBackupRateInMegaBytesPerSecond': 123.0,
            'elapsedTimeInSeconds': 123,
            'estimatedSecondsToCompletion': 123,
            'kmsKeyId': 'string',
            'namespaceArn': 'string',
            'namespaceName': 'string',
            'ownerAccount': 'string',
            'snapshotArn': 'string',
            'snapshotCreateTime': datetime(2015, 1, 1),
            'snapshotName': 'string',
            'snapshotRemainingDays': 123,
            'snapshotRetentionPeriod': 123,
            'snapshotRetentionStartTime': datetime(2015, 1, 1),
            'status': 'AVAILABLE'|'CREATING'|'DELETED'|'CANCELLED'|'FAILED'|'COPYING',
            'totalBackupSizeInMegaBytes': 123.0
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • snapshots (list) –

      All of the returned snapshot objects.

      • (dict) –

        A snapshot object that contains databases.

        • accountsWithProvisionedRestoreAccess (list) –

          All of the Amazon Web Services accounts that have access to restore a snapshot to a provisioned cluster.

          • (string) –

        • accountsWithRestoreAccess (list) –

          All of the Amazon Web Services accounts that have access to restore a snapshot to a namespace.

          • (string) –

        • actualIncrementalBackupSizeInMegaBytes (float) –

          The size of the incremental backup in megabytes.

        • adminPasswordSecretArn (string) –

          The Amazon Resource Name (ARN) for the namespace’s admin user credentials secret.

        • adminPasswordSecretKmsKeyId (string) –

          The ID of the Key Management Service (KMS) key used to encrypt and store the namespace’s admin credentials secret.

        • adminUsername (string) –

          The username of the database within a snapshot.

        • backupProgressInMegaBytes (float) –

          The size in megabytes of the data that has been backed up to a snapshot.

        • currentBackupRateInMegaBytesPerSecond (float) –

          The rate at which data is backed up into a snapshot in megabytes per second.

        • elapsedTimeInSeconds (integer) –

          The amount of time it took to back up data into a snapshot.

        • estimatedSecondsToCompletion (integer) –

          The estimated amount of seconds until the snapshot completes backup.

        • kmsKeyId (string) –

          The unique identifier of the KMS key used to encrypt the snapshot.

        • namespaceArn (string) –

          The Amazon Resource Name (ARN) of the namespace the snapshot was created from.

        • namespaceName (string) –

          The name of the namepsace.

        • ownerAccount (string) –

          The owner Amazon Web Services; account of the snapshot.

        • snapshotArn (string) –

          The Amazon Resource Name (ARN) of the snapshot.

        • snapshotCreateTime (datetime) –

          The timestamp of when the snapshot was created.

        • snapshotName (string) –

          The name of the snapshot.

        • snapshotRemainingDays (integer) –

          The amount of days until the snapshot is deleted.

        • snapshotRetentionPeriod (integer) –

          The period of time, in days, of how long the snapshot is retained.

        • snapshotRetentionStartTime (datetime) –

          The timestamp of when data within the snapshot started getting retained.

        • status (string) –

          The status of the snapshot.

        • totalBackupSizeInMegaBytes (float) –

          The total size, in megabytes, of how big the snapshot is.

    • NextToken (string) –

      A token to resume pagination.