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 instance to an arbitrary point in time. You can restore to any point in time before the time identified by the LatestRestorableTime property. You can restore to a point up to the number of days specified by the BackupRetentionPeriod property.

The target database is created with most of the original configuration, but in a system-selected Availability Zone, with the default security group, the default subnet group, and the default DB parameter group. By default, the new DB instance is created as a single-AZ deployment except when the instance is a SQL Server instance that has an option group that is associated with mirroring; in this case, the instance becomes a mirrored deployment and not a single-AZ deployment.

This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For Aurora, use RestoreDBClusterToPointInTime.

Note:

For .NET Core and PCL this operation is only available in asynchronous form. Please refer to RestoreDBInstanceToPointInTimeAsync.

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

Syntax

C#
public abstract RestoreDBInstanceToPointInTimeResponse RestoreDBInstanceToPointInTime(
         RestoreDBInstanceToPointInTimeRequest request
)
Parameters
request
Type: Amazon.RDS.Model.RestoreDBInstanceToPointInTimeRequest

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

Return Value
The response from the RestoreDBInstanceToPointInTime service method, as returned by RDS.

Exceptions

ExceptionCondition
AuthorizationNotFoundException The specified CIDRIP or Amazon EC2 security group isn't authorized for the specified DB security group. RDS also may not be authorized by using IAM to perform necessary actions on your behalf.
BackupPolicyNotFoundException
DBInstanceAlreadyExistsException The user already has a DB instance with the given identifier.
DBInstanceNotFoundException DBInstanceIdentifier doesn't refer to an existing DB instance.
DBParameterGroupNotFoundException DBParameterGroupName doesn't refer to an existing DB parameter group.
DBSecurityGroupNotFoundException DBSecurityGroupName doesn't refer to an existing DB security group.
DBSubnetGroupDoesNotCoverEnoughAZsException Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
DBSubnetGroupNotFoundException DBSubnetGroupName doesn't refer to an existing DB subnet group.
DomainNotFoundException Domain doesn't refer to an existing Active Directory domain.
InstanceQuotaExceededException The request would result in the user exceeding the allowed number of DB instances.
InsufficientDBInstanceCapacityException The specified DB instance class isn't available in the specified Availability Zone.
InvalidDBInstanceStateException The specified DB instance isn't in the available state.
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 AWS KMS key.
OptionGroupNotFoundException The specified option group could not be found.
PointInTimeRestoreNotEnabledException SourceDBInstanceIdentifier refers to a DB instance with BackupRetentionPeriod equal to 0.
ProvisionedIopsNotAvailableInAZException Provisioned IOPS not available in the specified Availability Zone.
StorageQuotaExceededException The request would result in the user exceeding the allowed amount of storage available across all DB instances.
StorageTypeNotSupportedException Storage of the StorageType specified can't be associated with the DB instance.

Version Information

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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also