AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Restores a DB cluster to an arbitrary point in time. Users can restore to any point in time before LatestRestorableTime for up to BackupRetentionPeriod days. The target DB cluster is created from the source DB cluster with the same configuration as the original DB cluster, except that the new DB cluster is created with the default DB security group.

For Aurora, this operation only restores the DB cluster, not the DB instances for that DB cluster. You must invoke the CreateDBInstance operation to create DB instances for the restored DB cluster, specifying the identifier of the restored DB cluster in DBClusterIdentifier. You can create DB instances only after the RestoreDBClusterToPointInTime operation has completed and the DB cluster is available.

For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.

For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to RestoreDBClusterToPointInTimeAsync.

Namespace: Amazon.RDS
Assembly: AWSSDK.RDS.dll
Version: 3.x.y.z

Syntax

C#
public abstract RestoreDBClusterToPointInTimeResponse RestoreDBClusterToPointInTime(
         RestoreDBClusterToPointInTimeRequest request
)

Parameters

request
Type: Amazon.RDS.Model.RestoreDBClusterToPointInTimeRequest

Container for the necessary parameters to execute the RestoreDBClusterToPointInTime service method.

Return Value


The response from the RestoreDBClusterToPointInTime service method, as returned by RDS.

Exceptions

ExceptionCondition
DBClusterAlreadyExistsException The user already has a DB cluster with the given identifier.
DBClusterAutomatedBackupNotFoundException No automated backup for this DB cluster was found.
DBClusterNotFoundException DBClusterIdentifier doesn't refer to an existing DB cluster.
DBClusterParameterGroupNotFoundException DBClusterParameterGroupName doesn't refer to an existing DB cluster parameter group.
DBClusterQuotaExceededException The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.
DBClusterSnapshotNotFoundException DBClusterSnapshotIdentifier doesn't refer to an existing DB cluster snapshot.
DBSubnetGroupNotFoundException DBSubnetGroupName doesn't refer to an existing DB subnet group.
DomainNotFoundException Domain doesn't refer to an existing Active Directory domain.
InsufficientDBClusterCapacityException The DB cluster doesn't have enough capacity for the current operation.
InsufficientDBInstanceCapacityException The specified DB instance class isn't available in the specified Availability Zone.
InsufficientStorageClusterCapacityException There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.
InvalidDBClusterSnapshotStateException The supplied value isn't a valid DB cluster snapshot state.
InvalidDBClusterStateException The requested operation can't be performed while the cluster is in this state.
InvalidDBSnapshotStateException The state of the DB snapshot doesn't allow deletion.
InvalidRestoreException Cannot restore from VPC backup to non-VPC DB instance.
InvalidSubnetException The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.
InvalidVPCNetworkStateException The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.
KMSKeyNotAccessibleException An error occurred accessing an Amazon Web Services KMS key.
OptionGroupNotFoundException The specified option group could not be found.
StorageQuotaExceededException The request would result in the user exceeding the allowed amount of storage available across all DB instances.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also