create_snapshot

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