Skip to content

Restores a namespace from a snapshot

Description

Restores a namespace from a snapshot.

Usage

redshiftserverless_restore_from_snapshot(adminPasswordSecretKmsKeyId,
  maintainIntegration, manageAdminPassword, namespaceName, ownerAccount,
  snapshotArn, snapshotName, workgroupName)

Arguments

  • adminPasswordSecretKmsKeyId

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

  • maintainIntegration

    If true, maintain existing data sharing, zero-ETL and S3 event integrations when restoring. Otherwise, integrations will not be maintained after the restore operation. Integrations are only maintained when restored to the same serverless namespace.

    Default: true

  • manageAdminPassword

    If true, Amazon Redshift uses Secrets Manager to manage the restored snapshot's admin credentials. If MmanageAdminPassword is false or not set, Amazon Redshift uses the admin credentials that the namespace or cluster had at the time the snapshot was taken.

  • namespaceName

    [required] The name of the namespace to restore the snapshot to.

  • ownerAccount

    The Amazon Web Services account that owns the snapshot.

  • snapshotArn

    The Amazon Resource Name (ARN) of the snapshot to restore from. Required if restoring from a provisioned cluster to Amazon Redshift Serverless. Must not be specified at the same time as snapshotName.

    The format of the ARN is arn:aws:redshift:\<region>:\<account_id>:snapshot:\<cluster_identifier>/\<snapshot_identifier>.

  • snapshotName

    The name of the snapshot to restore from. Must not be specified at the same time as snapshotArn.

  • workgroupName

    [required] The name of the workgroup used to restore the snapshot.

Value

A list with the following syntax:

list(
  namespace = list(
    adminPasswordSecretArn = "string",
    adminPasswordSecretKmsKeyId = "string",
    adminUsername = "string",
    catalogArn = "string",
    creationDate = as.POSIXct(
      "2015-01-01"
    ),
    dbName = "string",
    defaultIamRoleArn = "string",
    iamRoles = list(
      "string"
    ),
    kmsKeyId = "string",
    lakehouseRegistrationStatus = "string",
    logExports = list(
      "useractivitylog"|"userlog"|"connectionlog"
    ),
    namespaceArn = "string",
    namespaceId = "string",
    namespaceName = "string",
    s3TablePublishStatus = list(
      enabledAll = TRUE|FALSE,
      lastIngestionTimes = list(
        "string"
      ),
      s3TableGranularity = "namespace"|"account",
      s3TableNamespace = "string",
      s3Tables = list(
        "string"
      )
    ),
    status = "AVAILABLE"|"MODIFYING"|"DELETING"
  ),
  ownerAccount = "string",
  snapshotName = "string"
)

Request syntax

svc$restore_from_snapshot(
  adminPasswordSecretKmsKeyId = "string",
  maintainIntegration = TRUE|FALSE,
  manageAdminPassword = TRUE|FALSE,
  namespaceName = "string",
  ownerAccount = "string",
  snapshotArn = "string",
  snapshotName = "string",
  workgroupName = "string"
)