RedshiftServerless / Client / create_snapshot

create_snapshot#

RedshiftServerless.Client.create_snapshot(**kwargs)#

Creates a snapshot of all databases in a namespace. For more information about snapshots, see Working with snapshots and recovery points.

See also: AWS API Documentation

Request Syntax

response = client.create_snapshot(
    namespaceName='string',
    retentionPeriod=123,
    snapshotName='string',
    tags=[
        {
            'key': 'string',
            'value': 'string'
        },
    ]
)
Parameters:
  • namespaceName (string) –

    [REQUIRED]

    The namespace to create a snapshot for.

  • retentionPeriod (integer) – How long to retain the created snapshot.

  • snapshotName (string) –

    [REQUIRED]

    The name of the snapshot.

  • tags (list) –

    An array of Tag objects to associate with the snapshot.

    • (dict) –

      A map of key-value pairs.

      • key (string) – [REQUIRED]

        The key to use in the tag.

      • value (string) – [REQUIRED]

        The value of the tag.

Return type:

dict

Returns:

Response Syntax

{
    'snapshot': {
        'accountsWithProvisionedRestoreAccess': [
            'string',
        ],
        'accountsWithRestoreAccess': [
            'string',
        ],
        'actualIncrementalBackupSizeInMegaBytes': 123.0,
        '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
    }
}

Response Structure

  • (dict) –

    • snapshot (dict) –

      The created snapshot object.

      • 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.

      • 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.

Exceptions

  • RedshiftServerless.Client.exceptions.InternalServerException

  • RedshiftServerless.Client.exceptions.ResourceNotFoundException

  • RedshiftServerless.Client.exceptions.ConflictException

  • RedshiftServerless.Client.exceptions.ValidationException

  • RedshiftServerless.Client.exceptions.TooManyTagsException

  • RedshiftServerless.Client.exceptions.ServiceQuotaExceededException